yamlover 0.3.10 → 0.3.12

package/dist/agent-docs/AGENTS.md

@@ -0,0 +1,267 @@
+# Working with this yamlover project (guide for AI agents)
+
+This project stores structured knowledge as **yamlover** files. You (an AI coding agent) and a
+human are editing the **same directory** at the same time: the human browses the tree in the
+yamlover web UI (`npx yamlover .`) while you read and edit the files on disk. This document
+tells you how to manipulate these files **correctly** so you don't corrupt the data or break the
+human's live view.
+
+> This file is self-contained. You do **not** need any other spec to follow it. If the project
+> also contains files like `YAMLOVER.md`, `SEPARATOR.md`, `QUERY.md`, or `ANNOTATIONS.md`, those
+> are the authoritative, deeper specs — consult them for edge cases.
+
+---
+
+## 1. What yamlover is
+
+yamlover is a **strict superset of YAML**. Every valid YAML document is valid yamlover. On top
+of YAML it adds a small **pointer layer** so that data forms a graph, not just a tree:
+
+- **`*` pointers** — a value that *refers to* another node (a shared edge, not a copy).
+- **`&` path anchors** — declare that "this node also lives over there" (the push side of `*`).
+- **`!!` tags** — type/schema markers, including inline schema references `!!<…>`.
+
+There is a sibling brace surface called **json5p** (`.json5p` files) — the same pointer layer
+expressed in JSON5 syntax. Most projects use `.yamlover`; treat `.json5p` as the JSON-flavored
+twin (pointers are written as quoted strings, e.g. `*": pets[1]"`).
+
+**Important:** because `*` and `&` mean something different than in stock YAML (a `*` is a path
+pointer, **not** a YAML alias), these files require the yamlover parser. Do not "fix" them with
+a generic YAML formatter — you will destroy the pointers and anchors.
+
+---
+
+## 2. The one-ordered-container model
+
+Plain YAML forces a node to be **either** a sequence (all `- item`) **or** a mapping (all
+`key: value`). yamlover unifies them: there is **one ordered container**. Every entry has an
+integer **position** (`[0]`, `[1]`, …) and **may also** carry a string key. Keyless (positional)
+and keyed entries coexist in one node — this is the default ("omni"):
+
+```yamlover
+playlist:
+  - Intro                  # [0]            keyless / positional
+  - Verse                  # [1]            keyless
+  title: Greatest Hits     # [2], key=title keyed — AND still positioned
+  - Chorus                 # [3]            keyless
+  encore: *: pets[0]       # [4], key=encore a keyed pointer, still in order
+```
+
+A node can even carry a **scalar value AND fields at once**:
+
+```yamlover
+rating: 5                  # the node's own scalar value …
+  - solid                  # [0]  positional field
+  scale: 10                # [2]  keyed field
+```
+
+(You may see optional `!!mix` / `!!var` tags marking these shapes. They are **no-op readability
+markers** — mixing and scalar-plus-fields are the default. Don't add or remove them to change
+meaning; they don't carry any.)
+
+---
+
+## 3. Paths use COLONS, not slashes
+
+A path is `key: value` chained. The separator is the **colon**: `a: b: c` means "key a → key b →
+key c". Canonical style writes `: ` (colon + space) after each step; a colon without the space
+also parses.
+
+`/` is an **ordinary character** now — MIME-type keys (`text/html`), date keys (`01/02/2026`)
+and URL-ish keys ride bare in a path. (Legacy files may still use `/` as a separator during a
+migration window; **new content you author should use `:`**.)
+
+### The scope ladder — more colons, wider scope
+
+```
+current: object: path                         # bare       — current scope (siblings)
+: document: rooted: path                      # :          — this document's root
+:: project: rooted: path                      # ::         — this project's root
+::: yamlover.inthemoon.net: $defs: tag        # :::        — the world (an external project)
+```
+
+- `*pets[1]` — bare: a **sibling** named `pets`, position 1.
+- `*: pets[0]` — `:` document root.
+- `*:: tags: genre` — `::` this project's root.
+- `*::: host.example: $defs: tag` — `:::` a world/external reference.
+
+`[n]` addresses by **position** (integer key); a bare word addresses by **string key**. They
+chain: `*: pets[1]: name` = root → position 1 → key `name`.
+
+---
+
+## 4. Pointers `*` (the pull side)
+
+A `*` value dereferences a path to another node and creates a **shared edge** (not a copy):
+
+```yamlover
+humans:
+  - name: Alice
+    manager: *: pets[1]      # Alice.manager IS the node at root → pets → position 1
+feline: *pets[1]             # bare → a sibling
+topDog: *: pets[0]           # : → document root
+```
+
+Pointers are **lazy** and **cycle-safe** — pointing two nodes at each other is fine. Editing the
+target changes everything that points at it.
+
+---
+
+## 5. Path anchors `&` (the push side)
+
+`&: path` on a node declares "this node **also lives** at that path" — it grafts a **real key**
+(there is no separate anchor namespace), so any plain pointer can then reach it:
+
+```yamlover
+boss: &: chief             # this node is ALSO reachable as the document-root key `chief`
+  name: Rex
+team:
+  lead: *: chief           # same node as `boss` — a shared edge, not a copy
+```
+
+Reverse relations are spelled as anchors. `&: parent: child` means "parent holds me as child":
+
+```yamlover
+adam:
+  cain:
+    &: eve: cain           # "eve holds me as cain" — the reverse of eve's cain-edge
+```
+
+`&: container[]` (trailing `[]`, no index) means **positional membership**: "that container also
+holds me", appended after the container's own entries:
+
+```yamlover
+fan:
+  name: Bob
+  &: favorites[]           # Bob appends himself to `favorites`
+```
+
+Anchor paths must be **unambiguous** (no wildcards, no trailing `[n]` position claim) — they
+create real keys, so they must resolve to exactly one place.
+
+> You may encounter the older `~key: *path` back-edge syntax in legacy files. It still parses but
+> is deprecated; author new reverse edges as `&` anchors.
+
+---
+
+## 6. Tags `!!` and `$defs` schemas
+
+- `!!type` — a YAML-style tag. Common no-op markers: `!!mix`, `!!var` (see §2). `!!set` marks a
+  container whose membership is by identity (duplicates collapse).
+- **Inline schema reference** `!!<…>` binds a node to a reusable schema definition:
+  ```yamlover
+  mychapter: !!<*:: yamlover: $defs: chapter>
+  ```
+  Reusable schemas live at the project root under **`$defs`** (e.g. `$defs: chapter`,
+  `$defs: tag`, `$defs: annotation`, `$defs: fragment`). They are referenced project-scoped
+  (`*:: $defs: name`) or via the self-import (`*:: yamlover: $defs: name` — synonyms inside this
+  project). Schemas are **metadata** (typing/format/presentation), not data storage.
+
+---
+
+## 7. Concretes: how a node is stored on disk
+
+A node can be materialized two ways:
+
+1. **Single-file concrete** — a whole document in one `.yamlover` (or `.json5p`) file.
+2. **Directory concrete** — a directory **is** the node; its files/subdirs are its entries, and
+   two optional overlay files inside a hidden `.yamlover/` subdir add data and schema:
+   - `.yamlover/body.yamlover` — **instance** overlay: scalar values, ordering, pointers,
+     extra keyed/keyless entries layered onto the directory's contents.
+   - `.yamlover/meta.yamlover` — **schema** overlay: typing, format, validation.
+
+So to add a pointer or a value "to a folder", you edit (or create) that folder's
+`.yamlover/body.yamlover`. Plain files inside the directory are its members; a `.yamlover/`
+subdir does not appear as a member — it's the overlay.
+
+---
+
+## 8. Annotations & fragments (tags applied to content)
+
+The human marks up documents in the UI. These live **on the target node**, not in side files:
+
+- **`yamlover-fragments`** — a mapping of slug → selector (a text span, image/PDF rectangle, or
+  map box) identifying a region within the node.
+- **`yamlover-annotations`** — a sequence; each element applies a tag to the node (or a
+  fragment). An element is either a bare **tag pointer** or an object with a `tag:` field plus
+  parameters:
+  ```yamlover
+  yamlover-annotations:
+    - *:: tags: genre: brevity            # parameterless
+    - {description: A math block, tag: *:: tags: topic: math}   # parametrized
+  ```
+
+Prefer letting the human create these through the UI. If you must touch them by hand, keep the
+exact key names (`yamlover-fragments`, `yamlover-annotations`) and the tag-pointer form, and do
+not renumber or reorder fragment slugs.
+
+---
+
+## 9. Escaping (critical when editing keys)
+
+A literal metacharacter inside a key is **backslash-escaped** (this is per-character, not
+quote-based):
+
+```yamlover
+weird:
+  cat\:dog: 1              # the literal key "cat:dog" (\: suppresses the separator)
+  cat/dog: 2              # `/` is ordinary now — no escape needed
+ref:  *weird: cat\:dog    # the second portion is the literal key "cat:dog"
+dots: *\.\.               # the literal key ".." (NOT the parent scope)
+```
+
+- Metachars that need escaping in a key include: `:` `[` `]` `*` `&` `~` `#` `\` `?` `!`
+  `(` `)` `<` `>` `=` `|`.
+- The literal keys `..` and `...` are written `\.\.` and `\.\.\.` (bare `..` means "parent").
+- **A key containing a space MUST be quoted**: `: tags: 'дорожный знак'`. Use the host surface's
+  string quoting (`'…'` / `"…"`).
+
+---
+
+## 10. Co-editing workflow & safety rules
+
+The yamlover server **watches the filesystem**. Every time you save a file, it reindexes and
+pushes the change to the human's browser over a live event stream — so your edits appear in their
+UI within a moment, and theirs appear to you on disk. Work with that, not against it:
+
+- **Make small, valid saves.** A half-written file will reindex as broken. Prefer complete edits.
+- **NEVER touch `.yamlover/index.db`** (nor its `-wal` / `-shm` companions). It is the server's
+  generated SQLite index — it regenerates itself from the source files. Editing or deleting it
+  does nothing useful and can confuse a running server. It is the *only* thing in `.yamlover/`
+  you must not edit; `body.yamlover` / `meta.yamlover` overlays (§7) are normal editable data.
+- **Renames and moves break inbound pointers.** Other files may point at a node by its path
+  (`*: some: node`). If you move or rename it with a plain `mv`, those pointers dangle. The
+  running server exposes a **mediated move** (`POST /api/mv`) that surgically rewrites inbound
+  references at their source. Prefer it for moves/renames; if you must move by hand, search the
+  project for pointers to the old path (`*` followed by the path) and update them too.
+- **Don't reformat with a generic YAML/JSON tool.** It will mangle `*`, `&`, `!!<…>`, the
+  colon paths, and the mixed keyed/keyless ordering. Edit the text directly and preserve style.
+- **Settings live in `.yamlover/settings.yamlover`** at the project root (e.g. where new tags and
+  annotations are written). Treat it as configuration; change it only when asked.
+- **When unsure of a path, query it.** The server answers `GET /api/query?...` using the path
+  grammar above, and serves the tree at `GET /api/tree` / a node at `GET /api/json?path=:a:b`.
+  Use these to confirm a path resolves before you author a pointer to it.
+
+---
+
+## 11. Quick reference
+
+```yamlover
+# pointers (pull) — colon paths, the scope ladder
+sibling:   *pets[1]                 # current scope, by position
+rooted:    *: humans[0]: name       # document root → position 0 → key name
+projscope: *:: tags: genre          # this project's root
+world:     *::: host.example: $defs: tag
+
+# anchors (push) — "I also live there"; real keys; unambiguous only
+here:  &: chief                     # also at document-root key `chief`
+rev:   &: parent: child             # parent holds me as `child`
+mem:   &: favorites[]               # appended member of `favorites`
+
+# tags / schema
+node:  !!<*:: $defs: chapter>       # bind a reusable schema
+
+# escaping
+lit:   *weird: cat\:dog             # literal colon in a key
+space: : tags: 'two words'          # spacey key must be quoted
+```

package/dist/agent-docs/CLAUDE.md

@@ -0,0 +1,7 @@
+# Project guidance for AI agents
+
+This is a **yamlover** project. The authoring rules, the pointer/anchor syntax, and the rules for
+safely co-editing the tree while the yamlover web UI is running are in **`AGENTS.md`** — read it
+before editing any `.yamlover` / `.json5p` file.
+
+@AGENTS.md

package/dist/builtin-taxonomy/$defs/.yamlover/meta.yamlover

@@ -0,0 +1,25 @@
+properties:
+    chapter:
+        type: string
+        format: yamlover/meta
+    chunk:
+        type: string
+        format: yamlover/meta
+    tag:
+        type: string
+        format: yamlover/meta
+    annotation:
+        type: string
+        format: yamlover/meta
+    fragment:
+        type: string
+        format: yamlover/meta
+    task:
+        type: string
+        format: yamlover/meta
+    workflow:
+        type: string
+        format: yamlover/meta
+    board:
+        type: string
+        format: yamlover/meta

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

@@ -0,0 +1,18 @@
+# $defs/annotation — 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 (`- *::tags:…`): the host simply HAS this tag.
+#   • parametrized  — an object carrying `tag: *::tags:…` plus parameters (e.g. `description`).
+# The applied tag drives the display color (its `color`, else a name-derived hue). The region, if
+# any, is the host fragment's selector — an annotation carries no selector of its own. This
+# replaces the old separate-file annotation (a `target` pointer + `selector` + reverse tag
+# membership). The tag pointer IS the data (a forward ref edge into the tag); the schema tag
+# !!<*::yamlover/$defs/annotation> is optional, for the parametrized object form.
+type: variant
+format: x-yamlover-annotation
+value: *:: yamlover: $defs: tag          # the parameterless case: the self-value IS a tag (by ref)
+properties:
+  tag: *:: yamlover: $defs: tag          # the parametrized case: the applied tag, by pointer
+  description:
+    type: string
+    format: text/marklower
+additionalProperties: true               # any other field is a free-form parameter

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

@@ -0,0 +1,15 @@
+# $defs/board — marks a DIRECTORY of tasks as an agile/kanban board. Attach it to the directory's
+# `.yamlover/body.yamlover` overlay; the `workflow:` ref names which $defs/workflow supplies the
+# columns (its states, in order). The board renderer then groups the directory's task members into
+# those columns by each task's current state annotation, and a drag between columns rewrites that
+# annotation (re-tags the state). format `x-yamlover-board`. Attach with  !!<*yamlover:$defs:board>.
+# Spec: ../TICKETS.md §3.
+type: object
+format: x-yamlover-board
+properties:
+  workflow: *:: yamlover: $defs: tag    # ref → the workflow that SEEDS the default lanes
+  columns:                              # optional saved lanes (the explorer board view's config):
+    type: array                         #   a sequence of lanes, each a list of tag refs; multiple
+    items:                              #   tags in a lane split it vertically. Edited via the lane
+      type: array                       #   headers, persisted by POST /api/board.
+      items: *:: yamlover: $defs: tag

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

@@ -0,0 +1,19 @@
+# $defs/chapter — a document node: a title, a body of chunks, and recursive subchapters.
+#
+# This replaces the old split (title from the schema concrete, chunks from the instance):
+# it is a normal schema with `title`, `chunks`, and `children` fields. Attach it to a
+# yamlover node with the tag  !!<*yamlover/$defs/chapter>.
+type: object
+properties:
+  title:
+    type: string
+    format: text/marklower
+  description:                     # optional subtitle / heading annotation
+    type: string
+    format: text/marklower
+  chunks:                          # the body — a sequence of chunks, read top to bottom
+    type: array
+    items: *:: yamlover: $defs: chunk
+  children:                        # subchapters — the recursion
+    type: array
+    items: *:: yamlover: $defs: chapter

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

@@ -0,0 +1,6 @@
+# $defs/chunk — one renderable content block.
+#
+# A chunk is a typed value; its (type, format) selects the renderer. The default is
+# markdown prose; a chunk overrides type/format to be a diagram, image, LaTeX, CSV, etc.
+type: string
+format: text/marklower

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

@@ -0,0 +1,20 @@
+# $defs/config — the project configuration schema for `<root>/.yamlover/settings.yamlover`
+# (settings.ts, IMPORTS.md). Settings are DEFAULTS, never constraints; reading is location-
+# independent. The format `x-yamlover-config` lets the server render the (hidden but accessible)
+# config file with the SETTINGS EDITOR — opened by the gear button, in the main pane. Locations are
+# PROJECT-SCOPE pointers (`*:: name`) naming the object at the project root. Attach with
+#  !!<*yamlover:$defs:config>.
+type: object
+format: x-yamlover-config
+properties:
+  uri:                                  # this project's identity (IMPORTS.md §1) — an authority,
+    type: string                        #   authored as `::: host`; identity, not transport
+  exports:                              # the paths exported to importers (IMPORTS.md §2):
+    type: array                         #   a list of pointer/query texts
+    items:
+      type: string
+  annotations: *:: yamlover: $defs: tag   # where new annotations are created (`*:: annotations`)
+  tags: *:: yamlover: $defs: tag          # where new tags are created (`*:: tags`)
+  sidecars:                             # where derived sidecar blobs go: per-directory | project
+    type: string
+  annotation-tag: *:: yamlover: $defs: tag  # the last-used annotation tag (the picker default)

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

@@ -0,0 +1,44 @@
+# $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>.
+type: object
+format: x-yamlover-fragment
+properties:
+  type:
+    type: string
+    description: The locator kind — text | rect | pdf | djvu | map
+  exact:
+    type: string
+  prefix:
+    type: string
+  suffix:
+    type: string
+  page:
+    type: integer
+  x:
+    type: number
+  y:
+    type: number
+  w:
+    type: number                     # rect/pdf/djvu width — OR the map's west edge
+  h:
+    type: number
+  n:
+    type: number                     # map north edge
+  s:
+    type: number                     # map south edge
+  e:
+    type: number                     # map east edge
+  image:
+    type: binary
+    format: image/png
+    description: A PNG crop of the region (image-like fragments only); a sidecar blob by pointer
+  created:
+    type: string
+  yamlover-annotations:
+    type: array
+    items: *:: yamlover: $defs: annotation

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

@@ -0,0 +1,17 @@
+# $defs/tag — a node in a tag taxonomy. A tag's description is its BODY (the node's own scalar
+# value — author `name: !!omni The description` when the tag also has fields, or a plain
+# `name: The description` for a leaf); an optional explicit `color` ("#rrggbb" — a "pure color
+# tag"; absent ⇒ the UI derives a stable hue from the name); every OTHER key is a sub-tag, so
+# the taxonomy recurses to any depth (`additionalProperties` → tag). The format `x-yamlover-tag`
+# makes the server render each one as a tag (a badge wired to its super/sub-tags). Attach to the
+# taxonomy root with the tag  !!<*yamlover/$defs/tag>  — it propagates down.
+type: variant
+format: x-yamlover-tag
+value:
+  type: string
+  format: text/marklower
+properties:
+  color:
+    type: string
+    description: An explicit display color ("#rrggbb"); absent ⇒ derived from the tag's name
+additionalProperties: *:: yamlover: $defs: tag

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

@@ -0,0 +1,33 @@
+# $defs/task — a unit of work (a ticket), or a study card. A task IS a chapter (it has a
+# `title`, an optional `description`, a body of `chunks`, and recursive `children` — which here
+# mean SUBTASKS, a task tree) PLUS 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.
+type: object
+properties:
+  title:
+    type: string
+    format: text/marklower
+  description:                     # optional subtitle / brief
+    type: string
+    format: text/marklower
+  chunks:                          # the body — a sequence of chunks, read top to bottom
+    type: array
+    items: *:: yamlover: $defs: chunk
+  children:                        # SUBTASKS — the task tree (the recursion)
+    type: array
+    items: *:: yamlover: $defs: task
+  priority:                        # free ordinal: low | normal | high | urgent (advisory)
+    type: string
+  due:
+    type: string
+    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
+    items: *:: yamlover: $defs: task
+  estimate:                        # free: "2h", "3pt"
+    type: string

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

@@ -0,0 +1,18 @@
+# $defs/workflow — a state machine, expressed as a TAG whose CONTAINED sub-tags are its STATES
+# (each an ordinary $defs/tag: a description body, an optional `color`). Transitions are REF
+# edges, not containment: a state's `next:` holds pointer(s) to its successor state(s) elsewhere
+# in the SAME workflow — a cross-link in the or-graph, so a successor is NOT nested under its
+# predecessor (the contain-vs-ref distinction; a pointer-valued entry is a ref member, never a
+# contained sub-tag). The workflow's `initial:` ref points at the start state; a TERMINAL state
+# is DERIVED (it has no outgoing `next`). Transitions are ADVISORY — the engine permits any state
+# change; the board UI merely offers `next` states as the obvious moves. The format
+# `x-yamlover-workflow` lets the board renderer recognize this node and order its columns. Attach
+# with  !!<*yamlover:$defs:workflow>.  Spec: ../TICKETS.md §2.
+type: variant
+format: x-yamlover-workflow
+value:                                          # the workflow's description (its body)
+  type: string
+  format: text/marklower
+properties:
+  initial: *:: yamlover: $defs: tag             # ref → the start state
+additionalProperties: *:: yamlover: $defs: tag  # every other key is a STATE (a plain tag)

package/dist/builtin-taxonomy/tags/.yamlover/body.yamlover

@@ -0,0 +1,46 @@
+# Tag taxonomy: the built-in PALETTE (colors — pure color tags, each with an explicit
+# color) plus named tags created from the annotation picker (settings.yamlover:
+# tags.location). The palette ships with the yamlover project (::: yamlover.inthemoon.net);
+# the engine grafts {$defs, tags} as the `yamlover` self-import key into every served
+# root, so *//yamlover/tags/colors/<name> resolves from any project. Spec: ../$defs/tag.
+!!<*yamlover: $defs: tag>
+!!var Tags
+colors: Pure color tags — the annotation palette; each carries an explicit color
+  yellow:
+    color: "#f9e2af"
+  green:
+    color: "#a6e3a1"
+  sky:
+    color: "#89dceb"
+  mauve:
+    color: "#cba6f7"
+  pink:
+    color: "#f5c2e7"
+  peach:
+    color: "#fab387"
+first tag: !!<*::yamlover:$defs:tag>
+second tag: !!<*::yamlover:$defs:tag>
+third tag: !!<*::yamlover:$defs:tag>
+forth tag: !!<*::yamlover:$defs:tag>
+fifth tag: !!<*::yamlover:$defs:tag>
+# Workflows — state machines (TICKETS.md §2). Each `next:` is a REF edge to a successor STATE in
+# the SAME workflow (a cross-link, not a contained sub-tag); a terminal state has no `next`.
+workflow: Lifecycles — task/ticket state machines
+  dev: !!<*yamlover:$defs:workflow> Software task lifecycle
+    initial: *::yamlover:tags:workflow:dev:backlog
+    backlog: Captured, not yet refined
+      color: "#9399b2"
+      next: *::yamlover:tags:workflow:dev:ready
+    ready: Refined, ready to pick up
+      color: "#89b4fa"
+      next: *::yamlover:tags:workflow:dev:in-progress
+    in-progress: Being worked 
+      color: "#fab387"
+      next:
+      - *::yamlover:tags:workflow:dev:done
+      - *::yamlover:tags:workflow:dev:cancelled
+    done: Completed
+      color: "#a6e3a1"
+    cancelled: Dropped
+      color: "#f38ba8"
+верхушка: !!<*::yamlover:$defs:tag>

package/dist/client/assets/{decoded-M-9MjrR3.js → decoded-DVR13gJ5.js}

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

package/dist/client/assets/{djvu-M6ksPMNz.js → djvu-CZbDJKwH.js}

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