@north-light/crouter 0.3.194 → 0.3.196

package/dist/pages/elements/table.js

@@ -18,8 +18,8 @@
  */
 import { registerElement } from '../register.js';
 import { readSlotConfig, readSlotId } from '../slot-config.js';
-import { artifactData, respond } from '../host.js';
-import { anchorLabel, findComment, setComment } from '../comments.js';
+import { artifactData, respond, savedIds, savedResponse } from '../host.js';
+import { adoptComments, anchorLabel, findComment, setComment } from '../comments.js';
 const COMMENT_BUBBLE = 'M3.25 3.5h9.5A1.75 1.75 0 0 1 14.5 5.25v5A1.75 1.75 0 0 1 12.75 12H7.4l-3.15 2.36A.5.5 0 0 1 3.5 14v-2H3.25A1.75 1.75 0 0 1 1.5 10.25v-5A1.75 1.75 0 0 1 3.25 3.5Z';
 const STYLE = `
   :host {
@@ -421,6 +421,7 @@ class CrtrTableElement extends HTMLElement {
             return;
         }
         this.#rows = config.rows;
+        this.#hydrate();
         this.#renderTable();
     }
     disconnectedCallback() {
@@ -440,8 +441,36 @@ class CrtrTableElement extends HTMLElement {
             return;
         }
         this.#rows = rows.rows;
+        this.#hydrate();
         this.#renderTable();
     }
+    /**
+     * Seed local state from the answer the host is already holding, so a reopened page shows
+     * the rows and columns that were picked. It runs once the rows are known — after a `source`
+     * load, not before — because a saved id is only honoured while it still names something on
+     * screen. The select modes are re-imposed for the same reason.
+     */
+    #hydrate() {
+        if (this.#slotId === undefined)
+            return;
+        const saved = savedResponse(this.#slotId);
+        if (saved === undefined)
+            return;
+        const rows = this.#orderRows(savedIds(saved.selectedRowIds));
+        const columns = this.#orderColumns(savedIds(saved.selectedColumnIds));
+        this.#selectedRowIds = this.#rowSelect === 'none' ? [] : this.#rowSelect === 'single' ? rows.slice(0, 1) : rows;
+        this.#selectedColumnIds =
+            this.#columnSelect === 'none' ? [] : this.#columnSelect === 'single' ? columns.slice(0, 1) : columns;
+        const rowIds = new Set(this.#rows.map((row) => row.id));
+        const columnIds = new Set((this.#config?.columns ?? []).map((column) => column.id));
+        this.#comments = adoptComments(saved.comments).filter((comment) => {
+            if (comment.anchor.kind === 'row')
+                return rowIds.has(comment.anchor.rowId);
+            if (comment.anchor.kind === 'column')
+                return columnIds.has(comment.anchor.columnId);
+            return true;
+        });
+    }
     // ── the response ───────────────────────────────────────────────────────────────────────
     get #rowSelect() {
         return this.#config?.rowSelect ?? 'none';

package/dist/pages/elements/text.js

@@ -24,8 +24,8 @@
  */
 import { registerElement } from '../register.js';
 import { readSlotConfig, readSlotId } from '../slot-config.js';
-import { respond } from '../host.js';
-import { findComment, setComment } from '../comments.js';
+import { respond, savedResponse } from '../host.js';
+import { adoptComments, findComment, setComment } from '../comments.js';
 const WHOLE = { kind: 'whole' };
 const WHOLE_TARGET = 'the whole passage';
 const RANGE_TARGET = 'the selected text';
@@ -622,6 +622,7 @@ class CrtrTextElement extends HTMLElement {
         this.#config = read.config;
         this.#slotId = readSlotId(this);
         this.#text = read.config.initialText;
+        this.#hydrate();
         this.#editing = read.config.editable === true && this.#text.length === 0;
         this.#renderToolbar();
         this.#renderSurface();
@@ -630,6 +631,22 @@ class CrtrTextElement extends HTMLElement {
     disconnectedCallback() {
         document.removeEventListener('pointerdown', this.#onDocumentPointerDown, true);
     }
+    /**
+     * Seed local state from the answer the host is already holding, so a reopened page shows
+     * the edited words and the comments on them rather than the agent's original text. An
+     * uneditable slot keeps its authored text — only comments carry over — because a saved
+     * edit there could not have come from this control.
+     */
+    #hydrate() {
+        if (this.#slotId === undefined)
+            return;
+        const saved = savedResponse(this.#slotId);
+        if (saved === undefined)
+            return;
+        if (this.#config.editable === true && typeof saved.text === 'string')
+            this.#text = saved.text;
+        this.#comments = adoptComments(saved.comments);
+    }
     /** The complete current response — what every change hands `respond()`. */
     #response() {
         return { text: this.#text, edited: this.#text !== this.#config.initialText, comments: this.#comments };

package/dist/pages/host.d.ts

@@ -16,6 +16,12 @@
  *    the host autosave the partial map; it does not resolve the ticket. Only the pager's
  *    submit affordance calls `submit()`, which posts the complete map once.
  *
+ * `respond()` has one counterpart, `savedResponse()`: the host hands back the response it is
+ * currently holding for a slot, so a page reopened after a partial answer re-mounts SHOWING
+ * that answer instead of blank. Every response-bearing element reads it at mount and seeds
+ * its visible state from it — that is what keeps "what submit sends" and "what the screen
+ * shows" the same thing.
+ *
  * The host is optional at the type level (`window.crtr?`) because a page can be opened
  * bare — dropped in a browser, or rendered by a host that installs nothing. Elements read
  * the bridge through the accessors below rather than touching `window.crtr` directly, so
@@ -42,6 +48,12 @@ export interface CrtrHost {
      * partial map. Called on every user change. NOT ticket resolution.
      */
     respond(slotId: string, response: SlotResponse): void;
+    /**
+     * The response the host currently holds for this slot — an autosaved partial answer on a
+     * reopened page, or the published answer on a resolved one. `undefined` when the host has
+     * nothing for the slot. Elements read it at mount; it is the inbound half of `respond`.
+     */
+    savedResponse(slotId: string): SlotResponse | undefined;
     /** Posts the complete response map once. Only the pager's submit affordance calls it. */
     submit(): Promise<void>;
     /** Flushes the pending autosave of the partial map. */
@@ -98,6 +110,20 @@ export declare function host(): CrtrHost | undefined;
  * so an unavailable host only means the answer is not being persisted.
  */
 export declare function respond(slotId: string, response: SlotResponse): HostCall;
+/**
+ * The response the host already holds for this slot, or `undefined` when it holds none — a
+ * bare page, a first open, or a host without the channel. Elements call this once at mount
+ * and seed their visible state from it, so a reopened page shows the answers the host would
+ * submit rather than an empty form beside a full response map.
+ *
+ * `T` is asserted, not verified, exactly like `readSlotConfig`'s config: the host's saved map
+ * was validated against this slot's kind before it was stored. What is not guaranteed is that
+ * a host implements the channel at all, which is what the `undefined` covers — so seed with
+ * the same defensiveness you would give any outside value (`savedIds`, `adoptComments`).
+ */
+export declare function savedResponse<T extends SlotResponse = SlotResponse>(slotId: string): T | undefined;
+/** The string ids of a saved selection field, with anything else in it dropped. */
+export declare function savedIds(value: unknown): string[];
 /**
  * Posts the complete response map once, resolving the ticket. Only the pager's submit
  * affordance calls this.

package/dist/pages/host.js

@@ -16,6 +16,12 @@
  *    the host autosave the partial map; it does not resolve the ticket. Only the pager's
  *    submit affordance calls `submit()`, which posts the complete map once.
  *
+ * `respond()` has one counterpart, `savedResponse()`: the host hands back the response it is
+ * currently holding for a slot, so a page reopened after a partial answer re-mounts SHOWING
+ * that answer instead of blank. Every response-bearing element reads it at mount and seeds
+ * its visible state from it — that is what keeps "what submit sends" and "what the screen
+ * shows" the same thing.
+ *
  * The host is optional at the type level (`window.crtr?`) because a page can be opened
  * bare — dropped in a browser, or rendered by a host that installs nothing. Elements read
  * the bridge through the accessors below rather than touching `window.crtr` directly, so
@@ -52,6 +58,33 @@ export function respond(slotId, response) {
         return { status: 'failed', reason: reasonOf(error) };
     }
 }
+/**
+ * The response the host already holds for this slot, or `undefined` when it holds none — a
+ * bare page, a first open, or a host without the channel. Elements call this once at mount
+ * and seed their visible state from it, so a reopened page shows the answers the host would
+ * submit rather than an empty form beside a full response map.
+ *
+ * `T` is asserted, not verified, exactly like `readSlotConfig`'s config: the host's saved map
+ * was validated against this slot's kind before it was stored. What is not guaranteed is that
+ * a host implements the channel at all, which is what the `undefined` covers — so seed with
+ * the same defensiveness you would give any outside value (`savedIds`, `adoptComments`).
+ */
+export function savedResponse(slotId) {
+    const bridge = host();
+    if (typeof bridge?.savedResponse !== 'function')
+        return undefined;
+    try {
+        const saved = bridge.savedResponse(slotId);
+        return typeof saved === 'object' && saved !== null && !Array.isArray(saved) ? saved : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** The string ids of a saved selection field, with anything else in it dropped. */
+export function savedIds(value) {
+    return Array.isArray(value) ? value.filter((id) => typeof id === 'string') : [];
+}
 /**
  * Posts the complete response map once, resolving the ticket. Only the pager's submit
  * affordance calls this.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@north-light/crouter",
-  "version": "0.3.194",
+  "version": "0.3.196",
   "description": "crtr — agent runtime with memory, plugins, and marketplaces",
   "type": "module",
   "main": "dist/index.js",

package/runtime.lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@north-light/crouter",
-  "version": "0.3.194",
+  "version": "0.3.196",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@north-light/crouter",
-      "version": "0.3.194",
+      "version": "0.3.196",
       "hasInstallScript": true,
       "license": "MIT",
       "dependencies": {