@plurnk/plurnk-service 1.3.12 → 1.4.0

package/dist/schemes/_entry-crud.js

@@ -1,26 +1,27 @@
-// Shared CRUD primitives for entry-bearing schemes (Known, Unknown, Skill).
-// Per SPEC §crud — uniform read/write/delete that the engine drives for
+// Shared CRUD primitives for entry-bearing schemes.
+// Per SPEC {§crud} — uniform read/write/delete that the engine drives for
 // cross-scheme orchestration of COPY/MOVE/SEND[410].
 import { contentHash } from "../core/content-hash.js";
 import Owner from "../core/Owner.js";
+import { renderAddress } from "../core/plurnk-uri.js";
+import Results from "../core/results.js";
 export default class EntryCrud {
-    // {§entry-identity-no-null} — the identity scheme a manifest persists under. Explicit
-    // null is ILLEGAL: a NULL identity component voids the entries UNIQUE index (run59/#545).
+    // {§entry-identity-no-null} — the non-null identity scheme persisted by a manifest.
     static identityScheme(manifest) {
-        if (manifest.storedScheme === null)
-            throw new Error(manifest.name + ": storedScheme null is illegal — a NULL identity component voids the entries identity index ({§entry-identity-no-null})");
         return manifest.storedScheme ?? manifest.name;
     }
     static async readEntry(pathname, ctx, scheme, ownerId) {
         const { db, workspaceId } = ctx;
         const owner_id = ownerId ?? await Owner.commonsId(db, workspaceId);
         const entry = await db.crud_find_workspace_entry.get({ workspace_id: workspaceId, owner_id, scheme, pathname });
-        if (entry === undefined)
-            return { status: 404, entry: null };
+        if (entry === undefined) {
+            const target = renderAddress(scheme, pathname);
+            return Results.failure(`scheme:${scheme}`, "entry-not-found", 404, `No entry exists at ${target}.`, { entry: null }, { target });
+        }
         const channelRows = await db.crud_read_channels.all({ entry_id: entry.id });
         const channels = {};
         for (const row of channelRows) {
-            channels[row.name] = { content: row.content, mimetype: row.mimetype };
+            channels[row.name] = { content: row.content, mimetype: row.mimetype, state: row.state };
         }
         const tagRows = await db.crud_read_tags.all({ entry_id: entry.id });
         const tags = tagRows.map((r) => r.tag);
@@ -35,7 +36,15 @@ export default class EntryCrud {
         let entryId;
         let created;
         if (existing === undefined) {
-            const row = await db.crud_insert_workspace_entry.get({ workspace_id: workspaceId, owner_id, scheme, pathname });
+            const row = entry.attributes === undefined
+                ? await db.crud_insert_workspace_entry.get({ workspace_id: workspaceId, owner_id, scheme, pathname })
+                : await db.crud_insert_workspace_entry_with_attributes.get({
+                    workspace_id: workspaceId,
+                    owner_id,
+                    scheme,
+                    pathname,
+                    attributes: JSON.stringify(entry.attributes),
+                });
             if (row === undefined)
                 throw new Error("writeEntry: insert returned no row");
             entryId = row.id;
@@ -44,6 +53,12 @@ export default class EntryCrud {
         else {
             entryId = existing.id;
             created = false;
+            if (entry.attributes !== undefined) {
+                await db.crud_set_entry_attributes.run({
+                    entry_id: entryId,
+                    attributes: JSON.stringify(entry.attributes),
+                });
+            }
             await db.crud_delete_channels.run({ entry_id: entryId });
             await db.crud_delete_tags.run({ entry_id: entryId });
         }
@@ -54,7 +69,7 @@ export default class EntryCrud {
         for (const [channelName, channelData] of Object.entries(entry.channels)) {
             await db.crud_write_channel.run({
                 entry_id: entryId, name: channelName, content: channelData.content, mimetype: channelData.mimetype,
-                tokens: tokenize(channelData.content), // the model-agnostic ruler stamp (§tokenomics-agnostic-ruler, §tokenomics-tokens-stored-at-write)
+                tokens: tokenize(channelData.content), // the model-agnostic ruler stamp ({§tokenomics-agnostic-ruler}, {§tokenomics-tokens-stored-at-write})
                 content_hash: contentHash(channelData.content),
                 state: channelData.state ?? "static",
             });
@@ -68,11 +83,42 @@ export default class EntryCrud {
         const { db, workspaceId } = ctx;
         const owner_id = ownerId ?? await Owner.commonsId(db, workspaceId);
         const existing = await db.crud_find_workspace_entry.get({ workspace_id: workspaceId, owner_id, scheme, pathname });
-        if (existing === undefined)
-            return { status: 404 };
+        if (existing === undefined) {
+            const target = renderAddress(scheme, pathname);
+            return Results.failure(`scheme:${scheme}`, "entry-not-found", 404, `No entry exists at ${target}.`, {}, { target });
+        }
         await db.crud_delete_entry.run({ entry_id: existing.id });
         // CASCADE on entry_channels, entry_tags per FK constraints.
         return { status: 200 };
     }
+    static async deleteChannel(pathname, channel, ctx, scheme, ownerId) {
+        const { db, workspaceId } = ctx;
+        const owner_id = ownerId ?? await Owner.commonsId(db, workspaceId);
+        const existing = await db.crud_find_workspace_entry.get({
+            workspace_id: workspaceId,
+            owner_id,
+            scheme,
+            pathname,
+        });
+        if (existing === undefined) {
+            const target = renderAddress(scheme, pathname);
+            return Results.failure(`scheme:${scheme}`, "entry-not-found", 404, `No entry exists at ${target}.`, {}, { target });
+        }
+        const deleted = await db.crud_delete_channel.get({
+            entry_id: existing.id,
+            name: channel,
+        });
+        if (deleted === undefined) {
+            const target = renderAddress(scheme, pathname);
+            return Results.failure(`scheme:${scheme}`, "channel-not-found", 404, `No channel named #${channel} exists at ${target}.`, {}, {
+                target,
+                channel,
+            });
+        }
+        const remaining = await db.crud_read_channels.all({ entry_id: existing.id });
+        if (remaining.length === 0)
+            await db.crud_delete_entry.run({ entry_id: existing.id });
+        return { status: 200 };
+    }
 }
 //# sourceMappingURL=_entry-crud.js.map

package/dist/schemes/_entry-crud.js.map

@@ -1 +1 @@
-{"version":3,"file":"_entry-crud.js","sourceRoot":"","sources":["../../src/schemes/_entry-crud.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"_entry-crud.js","sourceRoot":"","sources":["../../src/schemes/_entry-crud.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,0EAA0E;AAC1E,qDAAqD;AAErD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAGtD,OAAO,KAAK,MAAM,kBAAkB,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,OAAkC,MAAM,oBAAoB,CAAC;AAgCpE,MAAM,CAAC,OAAO,OAAO,SAAS;IAC1B,oFAAoF;IACpF,MAAM,CAAC,cAAc,CAAC,QAAiD;QACnE,OAAO,QAAQ,CAAC,YAAY,IAAI,QAAQ,CAAC,IAAI,CAAC;IAClD,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,QAAgB,EAAE,GAAwB,EAAE,MAAc,EAAE,OAAgB;QAC/F,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,GAAG,GAAG,CAAC;QAChC,MAAM,QAAQ,GAAG,OAAO,IAAI,MAAM,KAAK,CAAC,SAAS,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;QACnE,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,yBAAyB,CAAC,GAAG,CAAiB,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;QAChI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACtB,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAC/C,OAAO,OAAO,CAAC,OAAO,CAClB,UAAU,MAAM,EAAE,EAClB,iBAAiB,EACjB,GAAG,EACH,sBAAsB,MAAM,GAAG,EAC/B,EAAE,KAAK,EAAE,IAAI,EAAE,EACf,EAAE,MAAM,EAAE,CACM,CAAC;QACzB,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,kBAAkB,CAAC,GAAG,CAKhD,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3B,MAAM,QAAQ,GAAgC,EAAE,CAAC;QACjD,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;YAC5B,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC;QAC5F,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,cAAc,CAAC,GAAG,CAAkB,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QACrF,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAEvC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC;IACtD,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,QAAgB,EAAE,KAAgB,EAAE,GAAwB,EAAE,MAAc,EAAE,OAAgB;QAClH,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,GAAG,CAAC;QAC1C,IAAI,QAAQ,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;QACzG,MAAM,QAAQ,GAAG,OAAO,IAAI,MAAM,KAAK,CAAC,SAAS,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;QACnE,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,yBAAyB,CAAC,GAAG,CAAiB,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;QAEnI,IAAI,OAAe,CAAC;QACpB,IAAI,OAAgB,CAAC;QACrB,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,KAAK,SAAS;gBACtC,CAAC,CAAC,MAAM,EAAE,CAAC,2BAA2B,CAAC,GAAG,CAAiB,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;gBACrH,CAAC,CAAC,MAAM,EAAE,CAAC,2CAA2C,CAAC,GAAG,CAAiB;oBACvE,YAAY,EAAE,WAAW;oBACzB,QAAQ;oBACR,MAAM;oBACN,QAAQ;oBACR,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC;iBAC/C,CAAC,CAAC;YACP,IAAI,GAAG,KAAK,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;YAC7E,OAAO,GAAG,GAAG,CAAC,EAAE,CAAC;YACjB,OAAO,GAAG,IAAI,CAAC;QACnB,CAAC;aAAM,CAAC;YACJ,OAAO,GAAG,QAAQ,CAAC,EAAE,CAAC;YACtB,OAAO,GAAG,KAAK,CAAC;YAChB,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;gBACjC,MAAM,EAAE,CAAC,yBAAyB,CAAC,GAAG,CAAC;oBACnC,QAAQ,EAAE,OAAO;oBACjB,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC;iBAC/C,CAAC,CAAC;YACP,CAAC;YACD,MAAM,EAAE,CAAC,oBAAoB,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;YACzD,MAAM,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QACzD,CAAC;QAED,0FAA0F;QAC1F,8FAA8F;QAC9F,8FAA8F;QAC9F,oFAAoF;QACpF,KAAK,MAAM,CAAC,WAAW,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;YACtE,MAAM,EAAE,CAAC,kBAAkB,CAAC,GAAG,CAAC;gBAC5B,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC,QAAQ;gBAClG,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,sGAAsG;gBAC7I,YAAY,EAAE,WAAW,CAAC,WAAW,CAAC,OAAO,CAAC;gBAC9C,KAAK,EAAE,WAAW,CAAC,KAAK,IAAI,QAAQ;aACvC,CAAC,CAAC;QACP,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YAC3B,MAAM,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IAC7D,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,QAAgB,EAAE,GAAwB,EAAE,MAAc,EAAE,OAAgB;QACjG,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,GAAG,GAAG,CAAC;QAChC,MAAM,QAAQ,GAAG,OAAO,IAAI,MAAM,KAAK,CAAC,SAAS,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;QACnE,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,yBAAyB,CAAC,GAAG,CAAiB,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnI,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAC/C,OAAO,OAAO,CAAC,OAAO,CAClB,UAAU,MAAM,EAAE,EAClB,iBAAiB,EACjB,GAAG,EACH,sBAAsB,MAAM,GAAG,EAC/B,EAAE,EACF,EAAE,MAAM,EAAE,CACQ,CAAC;QAC3B,CAAC;QACD,MAAM,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;QAC1D,4DAA4D;QAC5D,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IAC3B,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,aAAa,CACtB,QAAgB,EAChB,OAAe,EACf,GAAwB,EACxB,MAAc,EACd,OAAgB;QAEhB,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,GAAG,GAAG,CAAC;QAChC,MAAM,QAAQ,GAAG,OAAO,IAAI,MAAM,KAAK,CAAC,SAAS,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;QACnE,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,yBAAyB,CAAC,GAAG,CAAiB;YACpE,YAAY,EAAE,WAAW;YACzB,QAAQ;YACR,MAAM;YACN,QAAQ;SACX,CAAC,CAAC;QACH,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAC/C,OAAO,OAAO,CAAC,OAAO,CAClB,UAAU,MAAM,EAAE,EAClB,iBAAiB,EACjB,GAAG,EACH,sBAAsB,MAAM,GAAG,EAC/B,EAAE,EACF,EAAE,MAAM,EAAE,CACQ,CAAC;QAC3B,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,mBAAmB,CAAC,GAAG,CAAmB;YAC/D,QAAQ,EAAE,QAAQ,CAAC,EAAE;YACrB,IAAI,EAAE,OAAO;SAChB,CAAC,CAAC;QACH,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAC/C,OAAO,OAAO,CAAC,OAAO,CAClB,UAAU,MAAM,EAAE,EAClB,mBAAmB,EACnB,GAAG,EACH,qBAAqB,OAAO,cAAc,MAAM,GAAG,EACnD,EAAE,EACF;gBACI,MAAM;gBACN,OAAO;aACV,CACiB,CAAC;QAC3B,CAAC;QACD,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC,kBAAkB,CAAC,GAAG,CAAmB,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/F,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;QACtF,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IAC3B,CAAC;CACJ"}

package/dist/schemes/_entry-crud.sql

@@ -1,5 +1,5 @@
--- Entry CRUD primitives (SPEC §crud). Used by entry-bearing schemes
--- (known/unknown/skill) and the engine for cross-scheme COPY/MOVE/SEND[410].
+-- Entry CRUD primitives (SPEC {§crud}). Used by entry-bearing schemes and
+-- the engine for cross-scheme COPY/MOVE/SEND[410].
 
 -- PREP: crud_find_workspace_entry
 -- {§entry-identity-no-null} — every identity component is NOT NULL (bare/absolute paths
@@ -8,7 +8,7 @@ SELECT id FROM entries
 WHERE workspace_id = $workspace_id AND owner_id = $owner_id AND scheme = $scheme AND pathname = $pathname;
 
 -- PREP: crud_read_channels
-SELECT name, content, mimetype FROM entry_channels WHERE entry_id = $entry_id;
+SELECT name, content, mimetype, state FROM entry_channels WHERE entry_id = $entry_id;
 
 -- PREP: crud_read_tags
 SELECT tag FROM entry_tags WHERE entry_id = $entry_id ORDER BY tag;
@@ -18,8 +18,20 @@ INSERT INTO entries (workspace_id, owner_id, scheme, pathname)
 VALUES ($workspace_id, $owner_id, $scheme, $pathname)
 RETURNING id;
 
+-- PREP: crud_insert_workspace_entry_with_attributes
+-- Core-private metadata is present at identity creation, before any channel
+-- makes the entry visible to a reader.
+INSERT INTO entries (workspace_id, owner_id, scheme, pathname, attributes)
+VALUES ($workspace_id, $owner_id, $scheme, $pathname, $attributes)
+RETURNING id;
+
+-- PREP: crud_set_entry_attributes
+-- Core-private entry metadata. Omission at the EntryCrud seam preserves the
+-- existing value; an explicit bag replaces it before channels become visible.
+UPDATE entries SET attributes = $attributes WHERE id = $entry_id;
+
 -- PREP: crud_register_workspace_member
--- Idempotent bare-membership insert (SPEC §membership D4 — git ls-files membership).
+-- Idempotent bare-membership insert (SPEC {§membership} D4 — git ls-files membership).
 -- A git-tracked file is a workspace member by virtue of being tracked; the row
 -- is the membership marker the File read-gate checks and FIND globs by path.
 -- Channel-less by design — disk stays the truth (D3). ON CONFLICT no-ops so
@@ -31,10 +43,10 @@ DO NOTHING
 RETURNING id;
 
 -- PREP: crud_get_member_sig
--- SPEC §membership-change-gated-sync — the member's last-synced disk signature
+-- SPEC {§membership-change-gated-sync} — the member's last-synced disk signature
 -- (mtime:size), read before materializing so an unchanged file short-circuits
 -- before any content read. File members store scheme='file' ({§entry-identity-no-null}).
-SELECT id, synced_sig, membership_origin FROM entries
+SELECT id, synced_sig, membership_origin, attributes FROM entries
 WHERE workspace_id = $workspace_id AND owner_id = $owner_id AND scheme = $scheme AND pathname = $pathname;
 
 -- PREP: crud_set_synced_sig
@@ -53,7 +65,7 @@ RETURNING name;
 DELETE FROM entry_tags WHERE entry_id = $entry_id;
 
 -- PREP: crud_write_channel
--- #312 — content_hash stamped at every static write: the join key into token_counts.
+-- {§tokenomics-content-hash-identity}: every static write stamps stable content identity.
 INSERT INTO entry_channels (entry_id, name, content, mimetype, tokens, content_hash, state)
 VALUES ($entry_id, $name, $content, $mimetype, $tokens, $content_hash, $state);
 
@@ -75,7 +87,7 @@ SELECT id, pathname FROM entries
 WHERE workspace_id = $workspace_id AND scheme = 'file' AND membership_origin IN ('git', 'constraint');
 
 -- PREP: crud_insert_workspace_constraint
--- SPEC §membership constraint overlay — the client supersede. Idempotent per
+-- SPEC {§membership} constraint overlay — the client supersede. Idempotent per
 -- (workspace, effect, glob); effect ∈ {add, ignore, read-only}.
 INSERT OR IGNORE INTO workspace_constraints (workspace_id, effect, glob)
 VALUES ($workspace_id, $effect, $glob);

package/dist/schemes/_entry-find.d.ts

@@ -1,30 +1,35 @@
-import type { FindStatement } from "@plurnk/plurnk-grammar";
+import type { FindStatement } from "@plurnk/plurnk-contracts";
 import type { PlurnkSchemeContext, SchemeManifest } from "../core/scheme-types.ts";
 import { type CatalogEntry } from "./_entry-manifest.ts";
-export interface MatchSpan {
-    lineStart: number;
-    lineEnd: number;
-    rowStart: number;
-    rowEnd: number;
-}
+import { type SchemeResultBase } from "../core/results.ts";
+import type { MatchEvidence } from "@plurnk/plurnk-schemes";
 export interface Match {
     pathname: string;
-    span: MatchSpan | null;
-    path?: string;
+    matches: MatchEvidence[];
 }
-export type MatchItem = CatalogEntry & {
-    matchSpan?: MatchSpan;
-    matchPath?: string;
+export type CatalogScope = {
+    path: string;
+    items: number;
+    tokens: number;
+    channels?: never;
+    matches?: undefined;
+};
+export type CatalogMatch = CatalogEntry & {
+    matches?: MatchEvidence[];
+    items?: never;
+    tokens?: never;
 };
-export interface FindResult {
-    status: number;
+export type MatchItem = CatalogMatch | CatalogScope;
+export declare const renderFindContent: (results: readonly MatchItem[]) => string;
+export interface FindResult extends SchemeResultBase {
     content: string | null;
     mimetype: string | null;
     results: MatchItem[];
     itemsTokenTotal: number;
     pathnames: string[];
     matches: Match[];
-    overflow?: number;
+    omittedItems?: number;
+    maximumItems?: number;
 }
 export default class EntryFind {
     #private;

package/dist/schemes/_entry-find.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_entry-find.d.ts","sourceRoot":"","sources":["../../src/schemes/_entry-find.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAKnF,OAAsB,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAWxE,MAAM,WAAW,SAAS;IAAG,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;CAAE;AAGpG,MAAM,WAAW,KAAK;IAAG,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CAAE;AAEnF,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG;IAAE,SAAS,CAAC,EAAE,SAAS,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAErF,MAAM,WAAW,UAAU;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,KAAK,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,CAAC,OAAO,OAAO,SAAS;;IAwN1B,OAAa,oBAAoB,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,EAAE,mBAAmB,EAAE,QAAQ,EAAE,cAAc,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAmD7J;CACJ"}
+{"version":3,"file":"_entry-find.d.ts","sourceRoot":"","sources":["../../src/schemes/_entry-find.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAMnF,OAAsB,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGxE,OAAgB,EAAuB,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACzF,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,wBAAwB,CAAC;AAIzE,MAAM,WAAW,KAAK;IAAG,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,aAAa,EAAE,CAAC;CAAE;AAGtE,MAAM,MAAM,YAAY,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,KAAK,CAAC;IACjB,OAAO,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AACF,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG;IAAE,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IAAC,MAAM,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AACvG,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,YAAY,CAAC;AAKpD,eAAO,MAAM,iBAAiB,YAAa,SAAS,SAAS,EAAE,KAAG,MACI,CAAC;AAEvE,MAAM,WAAW,UAAW,SAAQ,gBAAgB;IAChD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,KAAK,EAAE,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,CAAC,OAAO,OAAO,SAAS;;IAkW1B,OAAa,oBAAoB,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,EAAE,mBAAmB,EAAE,QAAQ,EAAE,cAAc,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAsI7J;CACJ"}