yamlover 0.3.55 → 0.3.58

package/dist/builtin-taxonomy/$defs/annotation

@@ -1,4 +1,6 @@
-# $defs/annotation — ONE TAG APPLICATION on the host node (a whole document, or a fragment within
+# $defs/annotation — RETIRED (docs/annotations: applications are membership bookmarks now).
+# Kept because legacy trees still carry it — read forever, never written anew.
+# ONE TAG APPLICATION on the host node (a whole document, or a fragment within
 # it). It lives as an element of the host's `yamlover-annotations` array. Two forms:
 #   • parameterless — a bare tag pointer (`- *::ontos:…`): the host simply HAS this tag.
 #   • parametrized  — an object carrying `tag: *::ontos:…` plus parameters (e.g. `description`).

package/dist/builtin-taxonomy/$defs/decision

@@ -0,0 +1,34 @@
+# $defs/decision — a DECISION RECORD: a task whose work is a HUMAN'S CALL. It IS-A task (allOf:
+# task, hence a chapter): the scalar self-value is its title, the body is the chapter's, the
+# planning fields are the task's — and it adds the decision's own fields. When an investigation
+# or a refinement meets a question the agent must not answer alone, the agent births one UNDER
+# THE SECTION where the question arose (the session, the ticket being refined), assigned to the
+# user, carrying the `question`, the `options` with their consequences, and in the body the
+# information and links a decision needs. It LINKS the record into the board where the problem
+# occurred: a body pointer from the task that depends on it — which by the link law makes the
+# record that task's subtask and BLOCKER, a card on its lanes in its own state. The user decides
+# by writing `decision` (and `decided`) and moving the record to done; the blocked task resumes.
+#
+# Its lifecycle is the task's (a tag application into a workflow): born `ready` — the question
+# is prepared, it waits for the user; `done` — decided. Below the workflow's active state it
+# never raises the task it blocks (the parent-follows law): a question waiting is not work
+# happening. Attach with  !!<*::yamlover:$defs:decision>.  Format: x-yamlover-decision.
+# Docs: docs/documents/chapter/decision.
+allOf:
+  - *:: yamlover: $defs: task
+type: variant
+members:
+  question:                        # THE thing to decide, in one sentence — marklower
+    type: string
+    format: text/marklower
+  options:                         # the choices, each with its consequences — one line each
+    type: array
+    others:
+      type: string
+      format: text/marklower
+  decision:                        # the answer, once the user has taken it — marklower
+    type: string
+    format: text/marklower
+  decided:                         # when it was taken
+    type: string
+    format: date-time

package/dist/builtin-taxonomy/$defs/edit

@@ -0,0 +1,60 @@
+# $defs/edit — ONE SURGICAL EDIT of the tree: the element of a `POST /api/edit` batch
+# ($defs/edit-batch) and of `POST /api/edit-text`. An edit names a node by its colon path and
+# says what to do there; its payload is VALID INLINE YAMLOVER SOURCE (the caller escapes its own
+# prose) and is parsed before any splice, so a malformed edit fails with the file untouched.
+# The server splices the AUTHORED TEXT of the backing file (never a re-serialization — comments,
+# spelling and order survive), grouped by file, one reindex per touched file. Semantics:
+# tools/server/src/server/engine-api.ts applyEdits / editChapterSource; docs/server/wire.
+#
+# THE INVARIANTS an implementation holds (docs/server/editor, concrete-rules.ts, drop-policy.ts):
+#   - a payload never carries member STORAGE — a directory member is born by `concrete`/`name`,
+#     never by pasting its body into the parent; an existing node never changes concrete through
+#     an edit (a conversion is a move, `POST /api/mv`);
+#   - content inside a file document speaks that file's language; a JSON-family file takes
+#     scalar `emplace` only;
+#   - a `remove` of a member archives its storage to the parent's `.yo/.trash/` after the batch
+#     commits — deletion never destroys;
+#   - THE POSITION LAW (docs/language/partial): an `insert` before a pinned position is refused —
+#     it would renumber what the author pinned;
+#   - the `.yo/` subtree is engine-managed and read-only (`settings.yo` excepted);
+#   - the field is spelled `yamlover:` on the wire (the yo migration keeps the old spelling).
+type: object
+members:
+  path:
+    type: string
+    description: the colon path of the node edited (`:a:b:0`) — a key or an absolute position per segment; for `insert`, the parent (append) or a positional slot (`:a:3`, insert before it)
+  op:
+    type: string
+    description: unlist removes only an authored reference placement and preserves member storage; emplace | replace | insert | remove — `emplace` sets the entry, creating it when absent (a scalar self-value, a keyed field, a whole node); `replace` only when it exists; `insert` splices a new entry at a position (keyed with `key`); `remove` drops the entry
+  yamlover:
+    type: string
+    format: text/yamlover
+    description: the node's value as valid inline yamlover source — the payload of emplace, replace and insert
+  meta:
+    type: string
+    description: the `!!<…>` schema pointer to set on the entry; `null` drops it; omitted leaves it alone
+  concrete:
+    type: string
+    description: insert only — the storage a NEW document is born in — yamlover (inline, the default) | file/yamlover | dir/index.yo | dir/.yo | dir (a bare folder)
+  name:
+    type: string
+    description: insert only — the file or directory name when `concrete` births a document; the server uniquifies it
+  key:
+    type: string
+    description: insert only — create a KEYED entry (`key: value`) at the position; keeps authored order, where a fresh keyed emplace splices at the top of the block
+  at:
+    type: integer
+    description: scalar emplace only — the self-value line's authored position (the number of entries that precede it)
+  flat:
+    type: boolean
+    description: insert only — the payload's first row is a FLAT continuation of the key (docs/language/flattening), spliced as one line when its shape allows
+  safety:
+    type: object
+    description: optional wire-2 extension; omitted preserves legacy unguarded writes
+    members:
+      revision:
+        type: string
+        description: SHA-256 project revision from X-Yamlover-Revision on an editing read
+      operationId:
+        type: string
+        description: milliseconds-since-epoch:UUID; keep identical across retries; expires after 30 days

package/dist/builtin-taxonomy/$defs/edit-answer

@@ -0,0 +1,21 @@
+# $defs/edit-answer — what `POST /api/edit` answers. 200 with `ok` when the batch folded; `path`
+# names what was BORN (the last document created) or APPENDED (the parent's new last child), so
+# the caller can navigate to it; 400 with `error` — the message of the first edit that could not
+# fold — and no file touched. `POST /api/edit-text` answers `{source}` instead (the text after
+# the batch). The `{error}` form is every route's refusal (docs/server/wire, the routes).
+type: object
+members:
+  ok:
+    type: boolean
+  path:
+    type: string
+    description: the created or appended node's colon path — present only when the batch created or appended something
+  error:
+    type: string
+    description: refusal or recovery conflict; 409 means stale revision or recovery required, 410 means expired identity, 428 means missing revision inside safety
+  revision:
+    type: string
+    description: post-commit project revision, present for guarded writes
+  operationId:
+    type: string
+    description: the original request identity, unchanged on replay

package/dist/builtin-taxonomy/$defs/edit-batch

@@ -0,0 +1,31 @@
+# $defs/edit-batch — the body of `POST /api/edit`: a BATCH of $defs/edit, applied in order, grouped
+# by backing file, the later edits addressed against the state the earlier ones leave (nothing is
+# written until the whole batch folds — a batch that fails half-way leaves every file untouched).
+# One reindex per touched file, one `diff` event each ($defs/event); a batch that births a document
+# reindexes the tree. A bare single edit — the $defs/edit fields at the top level, no `edits` — is
+# the same request with a batch of one. The answer is $defs/edit-answer. Spec: docs/server/wire.
+type: object
+members:
+  edits:
+    type: array
+    others: *:: yamlover: $defs: edit
+  safety:
+    type: object
+    description: optional wire-2 extension; omitted preserves legacy unguarded writes
+    members:
+      revision:
+        type: string
+        description: SHA-256 project revision from X-Yamlover-Revision on an editing read
+      operationId:
+        type: string
+        description: milliseconds-since-epoch:UUID; keep identical across retries; expires after 30 days
+  renames:
+    type: array
+    description: ordered key renames after edits, committed in the same recovery boundary
+    others:
+      type: object
+      members:
+        path:
+          type: string
+        key:
+          description: the new key string, or null to make an inline entry keyless

package/dist/builtin-taxonomy/$defs/envelope

@@ -0,0 +1,169 @@
+# $defs/envelope — THE CONTENT ENVELOPE: the answer of `GET /api/content/{path}?depth=&range=`
+# (and of `POST /api/preview`), a `text/yamlover` document whose top-level keys are the HEADER
+# (what the store knows about the node), `source` (the node's authored text, cut at the depth
+# and the window), `side` (the SIDECAR — what the text cannot say, keyed by fragment) and
+# `relations` (the upstream panel). Built by tools/server/src/content-envelope.ts, read by
+# tools/server/src/client/content.ts; the laws are the comments of the builder and the prose of
+# docs/server/wire. Every key here is a promise of the wire (wire-version.ts): a client ignores
+# keys it does not know; a key renamed, retyped or dropped bumps the wire.
+type: object
+members:
+  wire:
+    type: integer
+    description: the wire version this envelope speaks — the first key, so a saved envelope says what it pins
+  path:
+    type: string
+    description: the requested node's colon path (`:a:b:0`) — as asked; through a link (engine-tasks paths-over-link-edges) the WALKED path, the slot's
+  canonical:
+    type: string
+    description: where the node lives, when `path` walked through a link (`:host:11` → `:elsewhere:card.yo`); absent when the two coincide
+  documentPath:
+    type: string
+    description: the document (the nearest yamlover entity — a file, an index.yo, a .yo body) the node lives in
+  type:
+    type: string
+    description: the TYPE name — a scalar leaf's scalar type (null | boolean | integer | number | string), `binary`, or a container's corner of the type cube (docs/meta/facets) — map | seq | kseq (keyed + ordinal) | vmap | vseq (a self-value too) | omni
+  valueType:
+    type: string
+    description: the self-value's scalar type — null | boolean | integer | number | string | binary; absent without a value facet
+  hasKeyed:
+    type: boolean
+  hasOrdinal:
+    type: boolean
+  format:
+    type: string
+    description: the node's format when it has one (a mime, an x-yamlover-* document format)
+  concrete:
+    type: string
+    description: the storage the node lives in — yamlover | file/yamlover | dir/index.yo | dir/.yo | dir | …
+  title:
+    type: string
+  description:
+    type: string
+  size:
+    type: integer
+    description: the byte size — blob nodes only; the bytes themselves live behind `/api/blob`
+  parseError:
+    type: string
+    description: a DEGRADED node's parse error — the page below it is the fallback
+  special:
+    type: string
+    description: '`overlay` when the node lives inside a `.yo/` subtree (settings.yo excepted); `graft` when it lives inside the bundled `yamlover` self-import (IMPORTS.md §4) — both are engine-owned: read-only on the page, no row in the TOC'
+  depth:
+    anyOf:                         # an integer, or the token `.inf` for unlimited
+      - type: integer
+      - type: string
+    description: the document-boundary budget the answer was cut at — an integer, or `.inf` for unlimited (the default for a text document; 1 for a directory or a binary)
+  childCount:
+    type: integer
+    description: WINDOWED answers only — the node's rendered entry count
+  range:
+    type: string
+    description: WINDOWED answers only — the resolved absolute half-open window, `A-B` over rendered entry indices
+  large:
+    type: boolean
+    description: the node has more than LARGE_THRESHOLD (1000) rendered entries — a bare GET auto-windows `0-500` and browsing is read-only
+  length:
+    type: integer
+    description: SPARSE or OPEN nodes only (docs/language/partial) — the last position + 1, which is not the count when pins left gaps
+  open:
+    type: boolean
+    description: the node's last entry is a keyless postponed slot (`- *.`) — its tail is unknown
+  source:
+    type: string
+    format: text/yamlover
+    description: >-
+      the node's authored text — the merged IR subtree serialized WITH comments, members beyond the depth respelled as their pointer (`- *: name` / `name: *: name`), a window's first entry pinned at its position and a cut tail one open `- *.`; the empty text for an empty document; blobs have no text
+  side:
+    type: object
+    description: the SIDECAR — one bucket per fragment; a fragment is the continuation the client computes over the parsed source (`""` the node itself, `/key`, `/3` a rendered index, `/~` the null key, nested by `/`), so sidecar keys and client keys can never disagree
+    others:
+      type: object
+      members:
+        format:
+          type: string
+          description: the engine-derived format of the node at this fragment (extension folds, resolved tags)
+        fileText:
+          type: boolean
+          description: a whole-file text scalar — the raw IS the value; the decoder restores it
+        position:
+          type: integer
+          description: the original member position when omitted hidden entries or sparse positions differ from the visible source rank; hiding never frees an occupied position
+        anchorKey:
+          type: string
+          description: a body-positioned MEMBER (a file or directory) serialized keyless here — its storage name
+        member:
+          type: boolean
+          description: a keyed-remainder member — its key IS its storage name
+        other:
+          type: boolean
+          description: a filesystem member not placed by an existing directory body; thumbnail metadata alone does not place it. Chapter pages show unconsumed members in the Other pane while retaining them in editor IR.
+        consumed:
+          type: boolean
+          description: a keyed-remainder member that a `*` pointer deeper in the document (inside a section, at any nesting) already places — the page and the TOC draw it there, never a second time at the foot; decided by the store, so the depth window cannot hide the placing pointer
+        stub:                        # every member's link stub, cut or not — and a postponed branch's facets when the engine knows the node behind it
+          type: object
+          members:
+            $yamloverLink: *:: yamlover: $defs: link
+        deco:
+          type: object
+          description: a CUT member's node decorations — the comment-map bucket (anchors, tags, raw, tail) its inlined form would have carried
+          others: true
+        refPath:
+          type: string
+          description: a realized reference entry — its resolved target's path
+        refText:
+          type: string
+          description: …and the scope-correct canonical pointer spelling, framed at the holder's document
+        target:                      # …and the target's link stub
+          type: object
+          members:
+            $yamloverLink: *:: yamlover: $defs: link
+        via:
+          type: array
+          description: EDGE PROVENANCE (docs/language/redundant) — the authorings the engine read for this edge — `pull` (a `*` pointer entry), `push` (a `&` bookmark on the target), or both
+          others:
+            type: string
+        postponed:
+          type: boolean
+          description: a POSTPONED branch (docs/language/partial) — the slot is known, the value not loaded; also the window's open tail
+        notloaded:
+          type: boolean
+          description: a pointer into a GAP — the target position is not loaded; fetch it, never a dead link
+        bookmarked:
+          type: array
+          description: the `&` bookmarks PUSHED into this node, which the projection appends after its own entries — they exist nowhere in the authored text
+          others:
+            type: object
+            members:
+              label:
+                type: string
+              path:
+                type: string
+              text:
+                type: string
+              stub:
+                type: object
+                members:
+                  $yamloverLink: *:: yamlover: $defs: link
+              via:
+                type: array
+                others:
+                  type: string
+  relations:
+    type: object
+    description: 'the upstream relations panel, in the query language (wire 2): `..` is the spine parent, every other key is the minimal query that finds the holder from this node (`: ...: ?#: pet: $`, `:: ...: ?#: -: $`); each value is the holder''s link marker — its description (a duplicate key gets ` (2)`, ` (3)`, …)'
+    others:
+      type: object
+      members:
+        $yamloverLink:
+          type: object
+        $yamloverRef:
+          type: object
+          members:
+            text:
+              type: string
+              description: the pointer's canonical text WITHOUT the `*` sigil (the IR's `Pointer.raw`); the face spells the deref token, once
+            path:
+              type: string
+              description: the target path it links to — null for an unrealized (dangling or external) reference

package/dist/builtin-taxonomy/$defs/event

@@ -0,0 +1,85 @@
+# $defs/event — ONE FRAME of `GET /api/events`, the server's `text/event-stream`: `data: <json>`
+# per frame, comment lines `: connected` (on connect) and `: ping` (every 30 s) between them.
+# Two kinds. A DIFF is what one reindex changed — after every write route, and after the
+# watcher sees an external edit — as ROOT-RELATIVE FILE PATHS spelled as colon paths (the
+# storage that changed, `:dir:index.yo`, `:a:.yo:body.yo`; not node paths — the client maps a
+# file onto the branch it backs and refetches it). A TASK frame is the progress of one
+# long-running job (indexing, hashing, thumbnails, reconciling), throttled to one every 150 ms
+# per task, unthrottled on a state change.
+#
+# THE ORDER LAW: frames arrive in the order the server applied the changes; one write route
+# yields one diff per touched file (a batch that births a document yields one tree-wide diff).
+# THE RESYNC LAW (2026-09-07): there is still no replay — a client that missed frames must refetch
+# — but it can now tell WHETHER it missed any. A HELLO frame opens every connection, naming the
+# server `instance` and the number of change frames it has broadcast (`seq`); each diff carries the
+# `seq` it is. A reconnect (the `open` after the first) whose greeting names the same instance and
+# the same count missed nothing and may keep everything it holds; a different instance (a restart —
+# a fresh process counts from zero), a higher count, or no greeting at all means everything loaded
+# is stale: drop the document store, refetch the tree. `GET /api/tasks` is the snapshot of tasks in
+# flight for a fresh page. Source: tools/server/src/server/engine-api.ts broadcast, tasks.ts;
+# docs/server/wire.
+type: object
+members:
+  type:
+    type: string
+    description: hello | diff | task
+  instance:
+    type: string
+    description: hello — this server process's identity; a change of it means a restart, so nothing loaded may be trusted
+  seq:
+    type: integer
+    description: hello — change frames broadcast so far; diff — which one this frame is. A reconnect compares them (THE RESYNC LAW above)
+  added:
+    type: array
+    description: diff — files the reindex found new
+    others:
+      type: string
+  changed:
+    type: array
+    description: diff — files whose content changed
+    others:
+      type: string
+  removed:
+    type: array
+    description: diff — files gone
+    others:
+      type: string
+  moved:
+    type: array
+    description: diff — moves the reindex inferred (a removed file whose content reappeared elsewhere)
+    others:
+      type: object
+      members:
+        from:
+          type: string
+        to:
+          type: string
+  task:
+    type: object
+    description: task — the job's state
+    members:
+      id:
+        type: string
+      label:
+        type: string
+      state:
+        type: string
+        description: running | done | error
+      progress:
+        type: object
+        members:
+          done:
+            type: integer
+          total:
+            type: integer
+            description: absent — indeterminate (an activity bar, not a percent)
+          message:
+            type: string
+            description: human-readable detail — the current path, "writing index…"
+      startedAt:
+        type: integer
+        description: epoch milliseconds
+      finishedAt:
+        type: integer
+      error:
+        type: string

package/dist/builtin-taxonomy/$defs/fragment

@@ -1,10 +1,11 @@
 # $defs/fragment — a user-marked REGION inside a document (the locate/highlight data only; no
-# description or color). Stored under the host node's `yamlover-fragments` mapping, keyed by a
-# slug. `type` selects the locator: a text quote {type:text, exact, prefix, suffix}, an image /
-# pdf / djvu rect {type:rect|pdf|djvu, x,y,w,h (pdf/djvu add page)}, or a map box
-# {type:map, n,s,e,w (geographic edges)}. Image-like fragments also carry an `image` — a PNG crop
-# of the region (a sidecar blob, referenced by a `*` pointer). A fragment may itself be tagged via
-# its own `yamlover-annotations`. Attach with the tag  !!<*::yamlover/$defs/fragment>.
+# color). Stored under the host node's `.yo: fragments:` mapping (the legacy `yo:` spelling is
+# read forever), keyed by a slug. `type` selects the locator: a text quote {type:text, exact,
+# prefix, suffix}, an image / pdf / djvu rect {type:rect|pdf|djvu, x,y,w,h (pdf/djvu add page)},
+# or a map box {type:map, n,s,e,w (geographic edges)}. Image-like fragments also carry an
+# `image` — a PNG crop of the region (a sidecar blob, referenced by a `*` pointer). A fragment
+# is tagged by MEMBERSHIP BOOKMARKS (`&…:-` own-line, docs/annotations/applications).
+# Attach with the tag  !!<*::yamlover/$defs/fragment>.
 type: object
 format: x-yamlover-fragment
 members:
@@ -39,6 +40,3 @@ members:
     description: A PNG crop of the region (image-like fragments only); a sidecar blob by pointer
   created:
     type: string
-  yamlover-annotations:
-    type: array
-    others: *:: yamlover: $defs: annotation

package/dist/builtin-taxonomy/$defs/link

@@ -0,0 +1,58 @@
+# $defs/link — a LINK STUB: the navigable summary of a node the wire hands over INSTEAD of the
+# node itself — a depth-cut member, a postponed branch's facets, a resolved reference's target,
+# a TOC row. One shape everywhere (engine-api.ts linkMarker), always wrapped as the value of a
+# `$yamloverLink` key (`stub: {$yamloverLink: {...}}`) so a consumer can tell a stub from data. The client draws an icon, a title and a count from it and fetches the
+# node when the reader opens it. Spec: docs/server/wire (the content envelope).
+type: object
+members:
+  kind:
+    type: string
+    description: the DISPLAY kind — scalar | binary | object | array | mix | omni
+  type:
+    type: string
+    description: the TYPE name — a scalar leaf's scalar type (null | boolean | integer | number | string), `binary`, or a container's corner of the type cube (docs/meta/facets) — map | seq | kseq (keyed + ordinal) | vmap | vseq (a self-value too) | omni
+  valueType:
+    type: string
+    description: the self-value's scalar type — null | boolean | integer | number | string | binary; absent when the node has no value facet
+  hasKeyed:
+    type: boolean
+  hasOrdinal:
+    type: boolean
+  path:
+    type: string
+    description: the node's colon path
+  format:
+    type: string
+    description: the node's format (a mime, an x-yamlover-* document format) when it has one
+  yo:
+    type: boolean
+    description: '`!!yo` — exempt from the enclosing schema'
+  concrete:
+    type: string
+    description: the storage the node lives in — yamlover | file/yamlover | dir/index.yo | dir/.yo | dir | …
+  hasChildren:
+    type: boolean
+    description: for a chapter or a task, whether it has a subchapter; else whether it owns visible members
+  title:
+    type: string
+  size:
+    type: integer
+    description: the byte size (binary nodes)
+  value:
+    description: the scalar self-value, for the link label (scalar and omni nodes); a long whole-file text is truncated
+  valueTruncated:
+    type: boolean
+  valueLength:
+    type: integer
+  count:
+    type: integer
+    description: the owned members — items and fields, reverse members excluded (container nodes)
+  color:
+    type: string
+    description: a tag's color (onto nodes)
+  preview:
+    type: string
+    description: the path of a fragment's PNG crop (fragment nodes)
+  flow:
+    type: string
+    description: 'a GLIMPSE of the node — its first element in one line of flow yamlover, nested first elements, `…` for the rest, long strings cut (every link marker built with the document in hand; flow-preview.ts)'

package/dist/builtin-taxonomy/$defs/task

@@ -1,23 +1,34 @@
-# $defs/task — a unit of work (a ticket), or a study card. A task IS-A chapter: it EXTENDS
-# the chapter schema (`allOf: [*chapter]`), inheriting the FULLY-OMNI shape — the scalar
-# SELF-VALUE is the title (no `title:` key), `description` stays keyed — and the positional
-# body, except its subchapter recursion means SUBTASKS (a task tree). On top of that it adds
-# a few OPTIONAL structured fields for planning and automation.
-# It carries NO `state` field: a task's lifecycle position is a TAG APPLICATION
-# (`yamlover-annotations`) into a workflow taxonomy ($defs/workflow), so the whole tag / board
-# machinery is reused. Every planning field is optional — defaults-never-constraints: an
-# untouched task is just a titled note. Attach with  !!<*yamlover:$defs:task>.  Spec: ../TICKETS.md.
+# $defs/task — a unit of work (a ticket), a study card, or a BOARD of such. A task IS-A chapter:
+# it EXTENDS the chapter schema (`allOf: [*chapter]`), inheriting the FULLY-OMNI shape — the
+# scalar SELF-VALUE is the title (no `title:` key), `description` stays keyed — and the
+# positional body, and adds a few OPTIONAL planning fields. Defaults-never-constraints: an
+# untouched task is just a titled note.
 #
-# `allOf: [*chapter]` extends: a task is a chapter plus more. Because task ⊆ chapter, the OWN
-# `others:` below — run before the inherited one — narrows the body union to (task | chunk),
-# intersecting chapter's (chapter | chunk): subtasks, not subchapters.
+# SUBTASKS are the task's keyless body members that are tasks BY THEIR OWN DECLARATION: an inline
+# container tagged `!!<*yamlover:$defs:task>`, a DIRECTORY task's `- *: slug.yo` file/dir member
+# whose own document carries the task tag (or a keyed-only member the body never names — the
+# chapter member law). An UNTAGGED container in a task body is a plain SUBCHAPTER, exactly as in
+# a chapter — the body union is the inherited chapter one (`chapter | table | bullets | numbered
+# | chunk`), never narrowed: a task is a section that can be tagged, not a body that turns
+# every section into a ticket (rule changed 2026-08-29; before, the own `others:` narrowed the
+# body to `task | chunk`). A pointer body element to a task ELSEWHERE (`- *..: slug.yo`,
+# `- *:: …`) makes that task a subtask of this one too — a BLOCKER: the link is the DAG edge,
+# the linked task's storage stays where it is (docs/documents/chapter/task). A task with subtasks IS a board: its lanes are the workflow states
+# its subtasks carry, in workflow order; `workflow:` only adds empty lanes for states no subtask
+# has yet; the UI's saved layout lives under the hidden `.yo: lanes:` overlay (machine-owned,
+# POST /api/board, written on demand — never by opening a page).
+#
+# It carries NO `state` field: a task's lifecycle position is a TAG APPLICATION (a membership
+# bookmark, `&::yamlover:ontos:workflow:dev:ready:-`) into a $defs/workflow, so the whole tag /
+# board machinery is reused. The retired `!!<*yamlover:$defs:board>` tag still READS as this
+# schema (engine/yed alias). Attach with  !!<*yamlover:$defs:task>.  Spec: ../TICKETS.md,
+# docs/documents/chapter/task.
 allOf:
   - *:: yamlover: $defs: chapter
 type: variant
-others:                            # the body — SUBTASKS (the recursion) and chunks, interleaved
-  anyOf:
-    - *:: yamlover: $defs: task      # a subtask — the task tree
-    - *:: yamlover: $defs: chunk     # a content block
+# NO own `others:` — the body is the chapter's (allOf): subchapters, tagged blocks, chunks. A
+# subtask enters ONLY by its explicit tag (a tagged element is exempt from the sweep — its tag
+# decides, docs/documents/chapter/schema); the sweep never makes a task out of a section.
 members:
   priority:                        # free ordinal: low | normal | high | urgent (advisory)
     type: string
@@ -26,8 +37,6 @@ members:
     format: date-time
   assignee:                        # a name, or a pointer to a person / agent node
     type: string
-  depends:                         # "blocked-by" edges → other tasks (ref; the dependency DAG)
-    type: array
-    others: *:: yamlover: $defs: task
   estimate:                        # free: "2h", "3pt"
     type: string
+  workflow: *:: yamlover: $defs: onto    # optional ref → the workflow whose states add EMPTY lanes

package/dist/builtin-taxonomy/$defs/workflow

@@ -15,4 +15,7 @@ value:                                          # the workflow's description (it
   format: text/marklower
 members:
   initial: *:: yamlover: $defs: onto             # ref → the start state
+  active: *:: yamlover: $defs: onto              # ref → the state that says WORK IS HAPPENING: a parent whose
+                                                 #   subtask reached it (or any later state) is raised to it
+                                                 #   (docs/documents/chapter/task, the parent-follows law)
 others: *:: yamlover: $defs: onto                # every other key is a STATE (a plain tag)

package/dist/builtin-taxonomy/ontos/.yo/body.yo

@@ -28,15 +28,21 @@ fifth tag: !!<*::yamlover:$defs:onto>
 workflow: Lifecycles — task/ticket state machines
   dev: !!<*yamlover:$defs:workflow> Software task lifecycle
     initial: *::yamlover:ontos:workflow:dev:backlog
+    active: *::yamlover:ontos:workflow:dev:in-progress
     backlog: Captured, not yet refined
       color: "#9399b2"
       next: *::yamlover:ontos:workflow:dev:ready
     ready: Refined, ready to pick up
       color: "#89b4fa"
       next: *::yamlover:ontos:workflow:dev:in-progress
-    in-progress: Being worked 
+    in-progress: Being worked
       color: "#fab387"
       next:
+      - *::yamlover:ontos:workflow:dev:review
+      - *::yamlover:ontos:workflow:dev:cancelled
+    review: Under review — tests, checks, a second look
+      color: "#f9e2af"
+      next:
       - *::yamlover:ontos:workflow:dev:done
       - *::yamlover:ontos:workflow:dev:cancelled
     done: Completed

package/dist/client/assets/{decoded-DYF3m3qY.js → decoded-Bj1qJCo_.js}

@@ -1 +1 @@
-import{r as f,b as d,j as o}from"./index-DDCohDX6.js";import{StaticImageChunk as h,PanZoomImage as x}from"./imagemap-BHOOud3m.js";function E({node:t,label:a,decode:s,chunk:e}){const[r,i]=f.useState([]),[g,u]=f.useState(null);return f.useEffect(()=>{let n=!1;const c=[];return i([]),u(null),(async()=>{const l=await fetch(d(t.path)).then(m=>m.arrayBuffer()),p=await s(l);if(!n){for(const m of p)c.push(URL.createObjectURL(m));n||i(c)}})().catch(l=>!n&&u(String(l.message||l))),()=>{n=!0,c.forEach(URL.revokeObjectURL)}},[t.path]),g?o.jsxs("div",{className:"error",children:[a,": ",g]}):r.length?o.jsx(o.Fragment,{children:r.map((n,c)=>e?o.jsx(h,{src:n,path:t.path,onNavigate:e.onNavigate},c):o.jsx(x,{src:n,className:"filemap fileimagemap",fill:r.length===1},c))}):o.jsxs("div",{className:"loading",children:["decoding ",a,"…"]})}async function w(t,a,s){const e=document.createElement("canvas");e.width=a,e.height=s;const r=e.getContext("2d");if(!r)throw new Error("no 2d context");const i=r.createImageData(a,s);return i.data.set(t),r.putImageData(i,0,0),b(e)}function b(t){return new Promise((a,s)=>t.toBlob(e=>e?a(e):s(new Error("canvas export failed")),"image/png"))}export{E as D,b as c,w as r};
+import{r as f,b as d,j as o}from"./index-0ALNONIF.js";import{StaticImageChunk as h,PanZoomImage as x}from"./imagemap-rdhcPlWy.js";function E({node:t,label:a,decode:s,chunk:e}){const[r,i]=f.useState([]),[g,u]=f.useState(null);return f.useEffect(()=>{let n=!1;const c=[];return i([]),u(null),(async()=>{const l=await fetch(d(t.path)).then(m=>m.arrayBuffer()),p=await s(l);if(!n){for(const m of p)c.push(URL.createObjectURL(m));n||i(c)}})().catch(l=>!n&&u(String(l.message||l))),()=>{n=!0,c.forEach(URL.revokeObjectURL)}},[t.path]),g?o.jsxs("div",{className:"error",children:[a,": ",g]}):r.length?o.jsx(o.Fragment,{children:r.map((n,c)=>e?o.jsx(h,{src:n,path:t.path,onNavigate:e.onNavigate},c):o.jsx(x,{src:n,className:"filemap fileimagemap",fill:r.length===1},c))}):o.jsxs("div",{className:"loading",children:["decoding ",a,"…"]})}async function w(t,a,s){const e=document.createElement("canvas");e.width=a,e.height=s;const r=e.getContext("2d");if(!r)throw new Error("no 2d context");const i=r.createImageData(a,s);return i.data.set(t),r.putImageData(i,0,0),b(e)}function b(t){return new Promise((a,s)=>t.toBlob(e=>e?a(e):s(new Error("canvas export failed")),"image/png"))}export{E as D,b as c,w as r};

package/dist/client/assets/{djvu--bwAI3Ad.js → djvu-lnurzbzN.js}

@@ -1 +1 @@
-import{r as u,u as te,a as ne,e as oe,c as re,D as W,b as se,j as d,f as ae}from"./index-DDCohDX6.js";import{u as ce,a as ie}from"./paged-CKzW-eq6.js";const le=""+new URL("djvu-Ci0lFKxE.js",import.meta.url).href;let X=null;function ue(){return window.DjVu?Promise.resolve(window.DjVu):(X??=new Promise((s,c)=>{const i=document.createElement("script");i.src=le,i.onload=()=>window.DjVu?s(window.DjVu):c(new Error("DjVu failed to load")),i.onerror=()=>c(new Error("could not load djvu.js")),document.head.appendChild(i)}),X)}let v=null,Y=null,_=null;const m=new Map,S=new Map,de=6,Q=1500;async function he(s,c){const i=await ue();return v??=new i.Worker,c!==Y&&(Y=c,m.clear(),S.clear(),_=(async()=>(await v.createDocument(s),Number(await v.doc.getPagesQuantity().run())||0))()),_}async function ge(s,c){const i=Math.max(1,Math.round(s.height*c/s.width)),w=await createImageBitmap(s,{resizeWidth:c,resizeHeight:i,resizeQuality:"medium"}),g=document.createElement("canvas");g.width=c,g.height=i;const x=g.getContext("2d");return x.drawImage(w,0,0),w.close(),x.getImageData(0,0,c,i)}function fe(s){const c=m.get(s);if(c)return m.delete(s),m.set(s,c),Promise.resolve(c);const i=S.get(s);if(i)return i;const w=(async()=>{const[g,x,y,A]=await v.run(v.doc.getPage(s).getImageData(),v.doc.getPage(s).getNormalizedTextZones(),v.doc.getPage(s).getWidth(),v.doc.getPage(s).getHeight()),b=Number(y)||g.width,N=Number(A)||g.height,j={image:b>Q?await ge(g,Q):g,zones:Array.isArray(x)?x:[],w:b,h:N};for(S.delete(s),m.set(s,j);m.size>de;)m.delete(m.keys().next().value);return j})();return S.set(s,w),w}const p=s=>Number(s)||0;function pe({image:s}){const c=u.useRef(null);return u.useLayoutEffect(()=>{const i=c.current;i&&(i.width=s.width,i.height=s.height,i.getContext("2d")?.putImageData(s,0,0))},[s]),d.jsx("canvas",{className:"djvu-page",ref:c})}function xe({node:s}){const c=u.useRef(null),[i,w]=u.useState(0),[g,x]=u.useState(1),[y,A]=u.useState(0),[b,N]=u.useState(null),[f,j]=u.useState(null),[E,B]=u.useState(()=>new Set),[D,P]=u.useState(()=>new Map),T=u.useRef(new Map),V=te(s.path),{openCreate:H,openEdit:Z,palette:q,preview:R}=ne(V,s.path),O=V.annotations.filter(e=>e.selector?.type==="djvu").map(e=>({page:p(e.selector.page)||1,x:p(e.selector.x),y:p(e.selector.y),w:p(e.selector.w),h:p(e.selector.h),title:e.description,color:re(e),ann:oe(e)?e:void 0})),U=R?.color??W;if(R?.selector.type==="djvu"){const e=R.selector;O.push({page:p(e.page)||1,x:p(e.x),y:p(e.y),w:p(e.w),h:p(e.h),color:R.color})}const C=u.useRef(new Map),z=ce(c,()=>{const e=[];for(let n=1;n<=i;n++){const t=C.current.get(n);t&&e.push(t)}return e},i>0&&y>0);ie(c);const F=u.useRef(z);F.current=z,u.useLayoutEffect(()=>{z.restoreAnchor()},[g]),u.useEffect(()=>{const e=c.current;e&&!e.closest(".chunk-body")&&e.focus({preventScroll:!0})},[]),u.useLayoutEffect(()=>{const e=c.current;if(!e)return;const n=new ResizeObserver(([t])=>A(t.contentRect.width));return n.observe(e),()=>n.disconnect()},[]);const k=Math.min(y,1e3)*g;u.useEffect(()=>{const e=c.current;if(!e)return;let n=!1,t=0;const o=a=>{(a.ctrlKey||a.altKey||a.metaKey)&&(a.preventDefault(),n||(F.current.captureAnchor(),n=!0),clearTimeout(t),t=window.setTimeout(()=>n=!1,250),x(h=>Math.min(5,Math.max(.4,h*(a.deltaY<0?1.1:1/1.1)))))};return e.addEventListener("wheel",o,{passive:!1}),()=>{e.removeEventListener("wheel",o),clearTimeout(t)}},[]),u.useEffect(()=>{let e=!1;return w(0),N(null),B(new Set),P(new Map),C.current.clear(),T.current.clear(),(async()=>{const n=await fetch(se(s.path)).then(o=>o.arrayBuffer()),t=await he(n,s.path);e||w(t)})().catch(n=>!e&&N(String(n.message||n))),()=>{e=!0}},[s.path]),u.useEffect(()=>{if(!i)return;const e=new IntersectionObserver(n=>{B(t=>{const o=new Set(t);for(const a of n){const h=Number(a.target.dataset.page);a.isIntersecting?o.add(h):o.delete(h)}return o.size===t.size&&[...o].every(a=>t.has(a))?t:o})},{root:c.current,rootMargin:"2000px 0px"});for(const n of C.current.values())e.observe(n);return()=>e.disconnect()},[i,y>0]),u.useEffect(()=>{let e=!0;return E.forEach(n=>{D.has(n)||fe(n).then(t=>{T.current.set(n,{w:t.w,h:t.h}),e&&P(o=>new Map(o).set(n,t))}).catch(()=>{})}),P(n=>{let t=!1;const o=new Map(n);for(const a of o.keys())E.has(a)||(o.delete(a),t=!0);return t?o:n}),()=>{e=!1}},[E]);const G=()=>{const e=window.getSelection();if(!e||e.isCollapsed||!e.anchorNode)return;const t=(e.anchorNode.nodeType===1?e.anchorNode:e.anchorNode.parentElement)?.closest(".djvu-page-wrap");if(!t||!c.current?.contains(t))return;const o=Number(t.dataset.page),a=t.getBoundingClientRect(),h=a.width/(D.get(o)?.w||1);if(!h)return;const l=e.getRangeAt(0).getBoundingClientRect();l.width<2||l.height<2||H({type:"djvu",page:o,x:Math.round((l.left-a.left)/h),y:Math.round((l.top-a.top)/h),w:Math.round(l.width/h),h:Math.round(l.height/h)},{x:l.left,y:l.bottom+6})},I=(e,n)=>n.getBoundingClientRect().width/(D.get(e)?.w||1),J=(e,n)=>{const t=n.currentTarget.getBoundingClientRect(),o=I(e,n.currentTarget);j({page:e,x0:(n.clientX-t.left)/o,y0:(n.clientY-t.top)/o,x1:(n.clientX-t.left)/o,y1:(n.clientY-t.top)/o})},$=(e,n)=>{const t=n.currentTarget.getBoundingClientRect(),o=I(e,n.currentTarget);j(a=>a&&{...a,x1:(n.clientX-t.left)/o,y1:(n.clientY-t.top)/o})},ee=(e,n)=>{const t=f;if(j(null),!t||t.page!==e)return;const o=I(e,n.currentTarget),a=Math.min(t.x0,t.x1),h=Math.min(t.y0,t.y1),l=Math.abs(t.x1-t.x0),r=Math.abs(t.y1-t.y0);if(l*o<3||r*o<3)return;const M=n.currentTarget.getBoundingClientRect();H({type:"djvu",page:e,x:Math.round(a),y:Math.round(h),w:Math.round(l),h:Math.round(r)},{x:M.left+a*o,y:M.top+(h+r)*o+6})};return b?d.jsxs("div",{className:"error",children:["djvu: ",b]}):d.jsxs(d.Fragment,{children:[d.jsxs("div",{className:"filedjvu yo-zoomable",ref:c,tabIndex:0,onMouseUp:G,children:[i===0&&d.jsx("div",{className:"loading",children:"opening djvu…"}),y>0&&Array.from({length:i},(e,n)=>{const t=n+1,o=E.has(t)?D.get(t):void 0,a=T.current.get(t),h=k*(a?a.h/a.w:Math.SQRT2),l=o?k/o.w:0;return d.jsx("div",{className:"djvu-page-wrap","data-page":t,ref:r=>{r?C.current.set(t,r):C.current.delete(t)},style:{width:k,height:o?void 0:h},children:o?d.jsxs(d.Fragment,{children:[d.jsx(pe,{image:o.image}),o.zones.length>0?d.jsx("div",{className:"djvu-textlayer",children:o.zones.map((r,M)=>d.jsx("span",{style:{left:r.x*l,top:r.y*l,width:r.width*l,height:r.height*l,fontSize:r.height*l},children:r.text},M))}):d.jsx("div",{className:"djvu-marquee",onMouseDown:r=>J(t,r),onMouseMove:r=>$(t,r),onMouseUp:r=>ee(t,r),children:f?.page===t&&d.jsx("div",{className:"djvu-region",style:{left:Math.min(f.x0,f.x1)*l,top:Math.min(f.y0,f.y1)*l,width:Math.abs(f.x1-f.x0)*l,height:Math.abs(f.y1-f.y0)*l,borderColor:U,background:U+"2e"}})}),O.filter(r=>r.page===t).map((r,M)=>{const K=r.color||W;return d.jsx("div",{id:r.ann?.fragmentSlug?ae(s.path,r.ann.fragmentSlug):void 0,className:"djvu-region"+(r.ann?" editable":""),title:r.ann?r.title||"click to recolor or delete":r.title,onClick:r.ann?L=>{L.stopPropagation(),Z(r.ann,{x:L.clientX,y:L.clientY})}:void 0,style:{left:r.x*l,top:r.y*l,width:r.w*l,height:r.h*l,borderColor:K,background:K+"2e"}},M)})]}):d.jsx("div",{className:"djvu-placeholder",children:E.has(t)?"decoding…":""})},n)})]}),q]})}export{xe as DjvuView};
+import{r as u,u as te,a as ne,e as oe,c as re,D as W,b as se,j as d,f as ae}from"./index-0ALNONIF.js";import{u as ce,a as ie}from"./paged-Cjy3svw2.js";const le=""+new URL("djvu-Ci0lFKxE.js",import.meta.url).href;let X=null;function ue(){return window.DjVu?Promise.resolve(window.DjVu):(X??=new Promise((s,c)=>{const i=document.createElement("script");i.src=le,i.onload=()=>window.DjVu?s(window.DjVu):c(new Error("DjVu failed to load")),i.onerror=()=>c(new Error("could not load djvu.js")),document.head.appendChild(i)}),X)}let v=null,Y=null,_=null;const m=new Map,S=new Map,de=6,Q=1500;async function he(s,c){const i=await ue();return v??=new i.Worker,c!==Y&&(Y=c,m.clear(),S.clear(),_=(async()=>(await v.createDocument(s),Number(await v.doc.getPagesQuantity().run())||0))()),_}async function ge(s,c){const i=Math.max(1,Math.round(s.height*c/s.width)),w=await createImageBitmap(s,{resizeWidth:c,resizeHeight:i,resizeQuality:"medium"}),g=document.createElement("canvas");g.width=c,g.height=i;const x=g.getContext("2d");return x.drawImage(w,0,0),w.close(),x.getImageData(0,0,c,i)}function fe(s){const c=m.get(s);if(c)return m.delete(s),m.set(s,c),Promise.resolve(c);const i=S.get(s);if(i)return i;const w=(async()=>{const[g,x,y,A]=await v.run(v.doc.getPage(s).getImageData(),v.doc.getPage(s).getNormalizedTextZones(),v.doc.getPage(s).getWidth(),v.doc.getPage(s).getHeight()),b=Number(y)||g.width,N=Number(A)||g.height,j={image:b>Q?await ge(g,Q):g,zones:Array.isArray(x)?x:[],w:b,h:N};for(S.delete(s),m.set(s,j);m.size>de;)m.delete(m.keys().next().value);return j})();return S.set(s,w),w}const p=s=>Number(s)||0;function pe({image:s}){const c=u.useRef(null);return u.useLayoutEffect(()=>{const i=c.current;i&&(i.width=s.width,i.height=s.height,i.getContext("2d")?.putImageData(s,0,0))},[s]),d.jsx("canvas",{className:"djvu-page",ref:c})}function xe({node:s}){const c=u.useRef(null),[i,w]=u.useState(0),[g,x]=u.useState(1),[y,A]=u.useState(0),[b,N]=u.useState(null),[f,j]=u.useState(null),[E,B]=u.useState(()=>new Set),[D,P]=u.useState(()=>new Map),T=u.useRef(new Map),V=te(s.path),{openCreate:H,openEdit:Z,palette:q,preview:R}=ne(V,s.path),O=V.annotations.filter(e=>e.selector?.type==="djvu").map(e=>({page:p(e.selector.page)||1,x:p(e.selector.x),y:p(e.selector.y),w:p(e.selector.w),h:p(e.selector.h),title:e.description,color:re(e),ann:oe(e)?e:void 0})),U=R?.color??W;if(R?.selector.type==="djvu"){const e=R.selector;O.push({page:p(e.page)||1,x:p(e.x),y:p(e.y),w:p(e.w),h:p(e.h),color:R.color})}const C=u.useRef(new Map),z=ce(c,()=>{const e=[];for(let n=1;n<=i;n++){const t=C.current.get(n);t&&e.push(t)}return e},i>0&&y>0);ie(c);const F=u.useRef(z);F.current=z,u.useLayoutEffect(()=>{z.restoreAnchor()},[g]),u.useEffect(()=>{const e=c.current;e&&!e.closest(".chunk-body")&&e.focus({preventScroll:!0})},[]),u.useLayoutEffect(()=>{const e=c.current;if(!e)return;const n=new ResizeObserver(([t])=>A(t.contentRect.width));return n.observe(e),()=>n.disconnect()},[]);const k=Math.min(y,1e3)*g;u.useEffect(()=>{const e=c.current;if(!e)return;let n=!1,t=0;const o=a=>{(a.ctrlKey||a.altKey||a.metaKey)&&(a.preventDefault(),n||(F.current.captureAnchor(),n=!0),clearTimeout(t),t=window.setTimeout(()=>n=!1,250),x(h=>Math.min(5,Math.max(.4,h*(a.deltaY<0?1.1:1/1.1)))))};return e.addEventListener("wheel",o,{passive:!1}),()=>{e.removeEventListener("wheel",o),clearTimeout(t)}},[]),u.useEffect(()=>{let e=!1;return w(0),N(null),B(new Set),P(new Map),C.current.clear(),T.current.clear(),(async()=>{const n=await fetch(se(s.path)).then(o=>o.arrayBuffer()),t=await he(n,s.path);e||w(t)})().catch(n=>!e&&N(String(n.message||n))),()=>{e=!0}},[s.path]),u.useEffect(()=>{if(!i)return;const e=new IntersectionObserver(n=>{B(t=>{const o=new Set(t);for(const a of n){const h=Number(a.target.dataset.page);a.isIntersecting?o.add(h):o.delete(h)}return o.size===t.size&&[...o].every(a=>t.has(a))?t:o})},{root:c.current,rootMargin:"2000px 0px"});for(const n of C.current.values())e.observe(n);return()=>e.disconnect()},[i,y>0]),u.useEffect(()=>{let e=!0;return E.forEach(n=>{D.has(n)||fe(n).then(t=>{T.current.set(n,{w:t.w,h:t.h}),e&&P(o=>new Map(o).set(n,t))}).catch(()=>{})}),P(n=>{let t=!1;const o=new Map(n);for(const a of o.keys())E.has(a)||(o.delete(a),t=!0);return t?o:n}),()=>{e=!1}},[E]);const G=()=>{const e=window.getSelection();if(!e||e.isCollapsed||!e.anchorNode)return;const t=(e.anchorNode.nodeType===1?e.anchorNode:e.anchorNode.parentElement)?.closest(".djvu-page-wrap");if(!t||!c.current?.contains(t))return;const o=Number(t.dataset.page),a=t.getBoundingClientRect(),h=a.width/(D.get(o)?.w||1);if(!h)return;const l=e.getRangeAt(0).getBoundingClientRect();l.width<2||l.height<2||H({type:"djvu",page:o,x:Math.round((l.left-a.left)/h),y:Math.round((l.top-a.top)/h),w:Math.round(l.width/h),h:Math.round(l.height/h)},{x:l.left,y:l.bottom+6})},I=(e,n)=>n.getBoundingClientRect().width/(D.get(e)?.w||1),J=(e,n)=>{const t=n.currentTarget.getBoundingClientRect(),o=I(e,n.currentTarget);j({page:e,x0:(n.clientX-t.left)/o,y0:(n.clientY-t.top)/o,x1:(n.clientX-t.left)/o,y1:(n.clientY-t.top)/o})},$=(e,n)=>{const t=n.currentTarget.getBoundingClientRect(),o=I(e,n.currentTarget);j(a=>a&&{...a,x1:(n.clientX-t.left)/o,y1:(n.clientY-t.top)/o})},ee=(e,n)=>{const t=f;if(j(null),!t||t.page!==e)return;const o=I(e,n.currentTarget),a=Math.min(t.x0,t.x1),h=Math.min(t.y0,t.y1),l=Math.abs(t.x1-t.x0),r=Math.abs(t.y1-t.y0);if(l*o<3||r*o<3)return;const M=n.currentTarget.getBoundingClientRect();H({type:"djvu",page:e,x:Math.round(a),y:Math.round(h),w:Math.round(l),h:Math.round(r)},{x:M.left+a*o,y:M.top+(h+r)*o+6})};return b?d.jsxs("div",{className:"error",children:["djvu: ",b]}):d.jsxs(d.Fragment,{children:[d.jsxs("div",{className:"filedjvu yo-zoomable",ref:c,tabIndex:0,onMouseUp:G,children:[i===0&&d.jsx("div",{className:"loading",children:"opening djvu…"}),y>0&&Array.from({length:i},(e,n)=>{const t=n+1,o=E.has(t)?D.get(t):void 0,a=T.current.get(t),h=k*(a?a.h/a.w:Math.SQRT2),l=o?k/o.w:0;return d.jsx("div",{className:"djvu-page-wrap","data-page":t,ref:r=>{r?C.current.set(t,r):C.current.delete(t)},style:{width:k,height:o?void 0:h},children:o?d.jsxs(d.Fragment,{children:[d.jsx(pe,{image:o.image}),o.zones.length>0?d.jsx("div",{className:"djvu-textlayer",children:o.zones.map((r,M)=>d.jsx("span",{style:{left:r.x*l,top:r.y*l,width:r.width*l,height:r.height*l,fontSize:r.height*l},children:r.text},M))}):d.jsx("div",{className:"djvu-marquee",onMouseDown:r=>J(t,r),onMouseMove:r=>$(t,r),onMouseUp:r=>ee(t,r),children:f?.page===t&&d.jsx("div",{className:"djvu-region",style:{left:Math.min(f.x0,f.x1)*l,top:Math.min(f.y0,f.y1)*l,width:Math.abs(f.x1-f.x0)*l,height:Math.abs(f.y1-f.y0)*l,borderColor:U,background:U+"2e"}})}),O.filter(r=>r.page===t).map((r,M)=>{const K=r.color||W;return d.jsx("div",{id:r.ann?.fragmentSlug?ae(s.path,r.ann.fragmentSlug):void 0,className:"djvu-region"+(r.ann?" editable":""),title:r.ann?r.title||"click to recolor or delete":r.title,onClick:r.ann?L=>{L.stopPropagation(),Z(r.ann,{x:L.clientX,y:L.clientY})}:void 0,style:{left:r.x*l,top:r.y*l,width:r.w*l,height:r.h*l,borderColor:K,background:K+"2e"}},M)})]}):d.jsx("div",{className:"djvu-placeholder",children:E.has(t)?"decoding…":""})},n)})]}),q]})}export{xe as DjvuView};