@sigrun/shared 0.4.1 → 0.5.0

package/dist/views.js

@@ -0,0 +1,54 @@
+/**
+ * §5 wire types (Tasks 9a–9d) — THE channel contract.
+ *
+ * Every HTTP/SSE payload shape both clients (webui, tui) consume is
+ * declared or re-exported here, and both import it directly (the tui
+ * imports from `@sigrun/shared`, never from server source). It is the
+ * intended basis for a generated OpenAPI schema later, so the purity
+ * rules are enforced by `test/views-purity.test.ts`:
+ *
+ * - imports and re-exports are `import type`/`export type` from SIBLING
+ *   shared modules only, and type-only — they erase at compile time and
+ *   contribute no runtime (the only runtime exports here are local pure
+ *   constants);
+ * - no external package imports, no server/framework types, no route
+ *   logic (the server's `src/server/views.ts` owns the RUNTIME
+ *   serializer and re-exports this module);
+ * - no `node:` imports (the webui compiles DOM-only against this file).
+ *
+ * Spec §5: the server serves pi-durable's NATIVE views, not a bespoke
+ * endpoint list — so the conversation wire payload IS the view shape
+ * (`{ conversation, entries, docs }`; JSON-safe by construction) PLUS
+ * the sigrun-side `steer` field. The upstream view's inner shapes are
+ * re-declared STRUCTURALLY below (`ViewConversation`, `ViewEntry`,
+ * `ViewMessage`, `WireBlock`): deliberately loose where channels only
+ * read a subset, and structurally compatible with the upstream types so
+ * the server's serializer (which spreads an upstream
+ * `ConversationView`) typechecks against this declaration — the
+ * captured-schema fixture (`src/server/schema-fixture.ts`,
+ * `view-schema.json`) pins the UPSTREAM shape, and
+ * `test/schema-drift.test.ts` trips on upstream drift.
+ *
+ * `serializeConversationView` (src/server/views.ts) is the single
+ * chokepoint every §5 endpoint that returns a conversation goes through
+ * — including each SSE watch frame (T9d) — so the fixture continues to
+ * describe the wire.
+ */
+/** The `Content-Type` of the JSONL export/import wire (Task 5b/5c). */
+export const JSONL_CONTENT_TYPE = "application/x-ndjson";
+/**
+ * The settings search's filter (UI-blocks U4 Task 4 round-2): the ONE
+ * implementation both channels run — the webui panel and the TUI view
+ * previously carried byte-identical copies, which drifted apart once
+ * (the TUI's lacked the key match). Case-insensitive over label + help
+ * + key; an empty query filters to nothing (the picker carries the
+ * full list).
+ */
+export function filterSettingsIndex(index, query) {
+    const q = query.trim().toLowerCase();
+    if (q === "")
+        return [];
+    return index.filter((entry) => entry.label.toLowerCase().includes(q) ||
+        (entry.help ?? "").toLowerCase().includes(q) ||
+        (entry.key ?? "").toLowerCase().includes(q));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@sigrun/shared",
-	"version": "0.4.1",
+	"version": "0.5.0",
 	"description": "sigrun shared leaf package \u2014 theme tokens, turn/conversation shaping, and the channel wire types (pure leaf, zero dependencies)",
 	"type": "module",
 	"exports": {
@@ -66,7 +66,8 @@
 		}
 	},
 	"scripts": {
-		"build": "tsc -p tsconfig.build.json"
+		"build": "tsc -p tsconfig.build.json",
+		"prepublishOnly": "npm run build"
 	},
 	"devDependencies": {
 		"typescript": "^7.0.2"