Module
jinks/watch
src/jinks/watch.pookaA portable watcher that asks whether the words changed, not merely their timestamp. Two matching observations debounce a save. Publication stays serial; an edit made during a build is noticed on the next observation.
API reference
class State(
root: String,
server: server.Running,
observed: List(#(String, BitArray)),
pending: Option(List(#(String, BitArray))),
revision: Int,
problem: String,
selected: request.Request
)
root: String
INFERRED
Stringserver: server.Running
INFERRED
jinks/server.Runningobserved: List(#(String, BitArray))
INFERRED
List(#(String, BitArray))pending: Option(List(#(String, BitArray)))
INFERRED
Option(List(#(String, BitArray)))revision: Int
INFERRED
Intproblem: String
INFERRED
Stringselected: request.Request
INFERRED
jinks/request.Request
INFERRED
fn(String, jinks/server.Running, List(#(String, BitArray)), Option(List(#(String, BitArray))), Int, String, jinks/request.Request) -> jinks/watch.Statesnapshot(root: String) -> Result(List(#(String, BitArray)), String)
INFERRED
fn(String) -> Result(List(#(String, BitArray)), String)Ignore output, staging, manifests and caches by enumerating only inputs. Hashing detects same-length edits even when filesystem times are unchanged.
snapshot_selected(selected: request.Request) -> Result(
List(#(String, BitArray)),
String
)
INFERRED
fn(jinks/request.Request) -> Result(List(#(String, BitArray)), String)start(root: String, host: String, port: Int, live: Bool) -> Result(
State,
String
)
INFERRED
fn(String, String, Int, Bool) -> Result(jinks/watch.State, String)start_selected(selected: request.Request, host: String, port: Int, live: Bool) -> Result(
State,
String
)
INFERRED
fn(jinks/request.Request, String, Int, Bool) -> Result(jinks/watch.State, String)tick(state: State) -> Result(State, String)
INFERRED
fn(jinks/watch.State) -> Result(jinks/watch.State, String)Tick is exposed separately from sleeping so saves, failures and recovery can be regression-tested without a timing race or an infinite CLI process.
css_only(before: List(#(String, BitArray)), after: List(#(String, BitArray))) -> Bool
INFERRED
fn(List(#(String, BitArray)), List(#(String, BitArray))) -> BoolOnly edits to existing CSS assets can be swapped without reloading HTML. Added, removed or renamed files may change generated links, so rebuilds containing those changes retain the conservative full-page reload.
rebuild(state: State, current: List(#(String, BitArray))) -> Result(
State,
String
)
INFERRED
fn(jinks/watch.State, List(#(String, BitArray))) -> Result(jinks/watch.State, String)failed(state: State, current: List(#(String, BitArray)), problem: String) -> Result(
State,
String
)
INFERRED
fn(jinks/watch.State, List(#(String, BitArray)), String) -> Result(jinks/watch.State, String)run(root: String, host: String, port: Int, live: Bool) -> Result(String, String)
INFERRED
fn(String, String, Int, Bool) -> Result(String, String)run_selected(selected: request.Request, host: String, port: Int, live: Bool) -> Result(
String,
String
)
INFERRED
fn(jinks/request.Request, String, Int, Bool) -> Result(String, String)wait(state: State) -> Result(String, String)
INFERRED
fn(jinks/watch.State) -> Result(String, String)