@plurnk/plurnk-schemes 0.3.0 → 0.4.0

package/README.md

@@ -15,14 +15,14 @@ Framework + contract for `@plurnk/plurnk-schemes-*` URI handler packages. Consum
 - Result families: `SchemeResult` / `EntryResult` / `ProposalResult` / `PassthroughResult` / `SchemeResultBase` / `TelemetryEvent`.
 - Capability ctx: `SchemeCtx` + `EntryCaps` / `ChannelCaps` / `VisibilityCaps` / `TagCaps` / `NotifyCaps` / `SubscriptionCaps` / `CrossSchemeCaps`, plus `EntryData` / `ChannelState` / `SubscriptionHandle` / `ProposalAware`.
 
-### Helpers
-
-- `resolveForLoop(handlers, flags)` — active-scheme resolution under loop flags.
-- `isBinaryMimetype` / `isLineNavigableMimetype` / `isJsonMimetype` / `normalizeAutoTextMimetype` / `TEXT_PRIMITIVE_MIMETYPE` — mimetype classification.
-- `sliceLines` / `sliceLinesRaw` / `sliceJsonItems` / `applyLineMarkerEdit` / `applyJsonItemEdit` — `<L>` slicing + structural EDIT.
-- `resolveEntryMimetype(pathname, default, mimetypes)` — path-extension mimetype resolver.
-- `matchAgainstContent(body, content, mimetype, mimetypes, baseLine?)` — body-matcher dispatch adapter over `Mimetypes.query` (glob/regex/jsonpath/xpath).
-- Result builders/guards: `schemeError` / `logCoordinate` / `isEntryResult` / `isProposalResult` / `isPassthroughResult` / `isErrorStatus`.
+### Helpers (`export default class`, static methods)
+
+- `SchemeResolver.forLoop(handlers, flags)` — active-scheme resolution under loop flags.
+- `MimetypeClassifier.isBinary` / `.isLineNavigable` / `.isJson` / `.normalizeAutoText` (+ `TEXT_PRIMITIVE_MIMETYPE` named export) — mimetype classification.
+- `Slicer.lines` / `.linesRaw` / `.jsonItems` / `.lineMarkerEdit` / `.jsonItemEdit` — `<L>` slicing + structural EDIT.
+- `PathMimetype.resolve(pathname, default, mimetypes)` — path-extension mimetype resolver.
+- `Matcher.matchAgainstContent(body, content, mimetype, mimetypes, baseLine?)` — body-matcher dispatch over `Mimetypes.query` (glob/regex/jsonpath/xpath).
+- `Results.error` / `.logCoordinate` / `.isEntry` / `.isProposal` / `.isPassthrough` / `.isErrorStatus` — result builders + guards.
 
 The **capability ctx** (`SchemeCtx`) is the DB-free authoring surface for siblings — interfaces only; plurnk-service injects the db-backed impl (see SPEC §3.bis). The db-backed implementations themselves (CRUD primitives, entry-op handlers, channel writes, subscription registry) stay in plurnk-service.
 

package/SPEC.md

@@ -81,33 +81,42 @@ Result-type definitions (`EditResult`, `ReadResult`, etc.) live in plurnk-servic
 - Result families: `SchemeResult` (`EntryResult` | `ProposalResult` | `PassthroughResult`), `SchemeResultBase`, `TelemetryEvent`. Keyed on scheme-shape, not op. `error` is a grammar `TelemetryEvent`, present iff `status >= 400`. Guards `isEntryResult` / `isProposalResult` / `isPassthroughResult` / `isErrorStatus`; builders `schemeError(scheme, kind, message?, position?)`, `logCoordinate(coordinate, op?)`.
 - Capability ctx (PR-2, see §3.bis): `SchemeCtx` + `EntryCaps` / `ChannelCaps` / `VisibilityCaps` / `TagCaps` / `NotifyCaps` / `SubscriptionCaps` / `CrossSchemeCaps`, plus `EntryData`, `ChannelState`, `SubscriptionHandle`, `ProposalAware`.
 
-### Active-scheme resolution
+Behavior ships as `export default class` (one class per file, static methods) — the ecosystem class paradigm. Type-only modules, the barrel, and the frozen `DEFAULT_LOOP_FLAGS` constant are the only non-class files.
 
-- `resolveForLoop(handlers: Map<string, object>, flags: LoopFlags): Set<string>` — applies `manifest.flags` affinity to each handler and returns names of schemes active under the loop's flags.
+### Active-scheme resolution — `SchemeResolver`
 
-### Mimetype classification
+- `SchemeResolver.forLoop(handlers: ReadonlyMap<string, object>, flags: LoopFlags): Set<string>` — applies `manifest.flags` affinity to each handler and returns names of schemes active under the loop's flags.
 
-- `isBinaryMimetype(mimetype)` — enforces 415 boundary on binary entries (text/* is text; application/{json,yaml,toml,xml,javascript,typescript,sql} is text; `+json`/`+xml`/`+yaml` suffix variants are text; everything else with a slash is binary).
-- `isJsonMimetype(mimetype)` — `application/json` plus `+json` variants. Used by `<L>` dispatch.
-- `isLineNavigableMimetype(mimetype)` — render-layer decides whether to prefix lines with `N:\t`.
-- `normalizeAutoTextMimetype(mimetype)` — `text/plain` / null / undefined → `TEXT_PRIMITIVE_MIMETYPE` (`text/markdown`).
-- `TEXT_PRIMITIVE_MIMETYPE` — `"text/markdown"`.
+### Mimetype classification — `MimetypeClassifier`
 
-### `<L>` slicing
+- `MimetypeClassifier.isBinary(mimetype)` — enforces 415 boundary on binary entries (text/* is text; application/{json,yaml,toml,xml,javascript,typescript,sql} is text; `+json`/`+xml`/`+yaml` suffix variants are text; everything else with a slash is binary).
+- `MimetypeClassifier.isJson(mimetype)` — `application/json` plus `+json` variants. Used by `<L>` dispatch.
+- `MimetypeClassifier.isLineNavigable(mimetype)` — render-layer decides whether to prefix lines with `N:\t`.
+- `MimetypeClassifier.normalizeAutoText(mimetype)` — `text/plain` / null / undefined → `TEXT_PRIMITIVE_MIMETYPE` (`text/markdown`).
+- `TEXT_PRIMITIVE_MIMETYPE` — `"text/markdown"` (named export from the same module).
 
-- `sliceLines(content, marker)` — line-navigable slice. Returns `{ status, text?, startLine?, error? }`.
-- `sliceLinesRaw(content, marker)` — same shape; no `N:\t` prefix.
-- `sliceJsonItems(content, marker)` — JSON-source item slice. Returns `{ status, body?, error? }`.
-- `applyLineMarkerEdit(content, marker, body)` — line-navigable EDIT.
-- `applyJsonItemEdit(content, marker, body)` — structural JSON EDIT.
+### `<L>` slicing — `Slicer`
 
-### Path-extension mimetype
+- `Slicer.lines(content, marker)` — line-navigable slice. Returns `{ status, text?, startLine?, error? }`.
+- `Slicer.linesRaw(content, marker)` — same shape; no `N:\t` prefix.
+- `Slicer.jsonItems(content, marker)` — JSON-source item slice. Returns `{ status, body?, error? }`.
+- `Slicer.lineMarkerEdit(content, marker, body)` — line-navigable EDIT.
+- `Slicer.jsonItemEdit(content, marker, body)` — structural JSON EDIT.
 
-- `resolveEntryMimetype(pathname, defaultMimetype, mimetypes)` — pathname extension → `Mimetypes.detect({ ext })`; falls back to `defaultMimetype` when no extension. text/plain auto-normalizes to text/markdown.
+### Path-extension mimetype — `PathMimetype`
 
-### Matcher dispatch
+- `PathMimetype.resolve(pathname, defaultMimetype, mimetypes)` — pathname extension → `Mimetypes.detect({ ext })`; falls back to `defaultMimetype` when no extension. text/plain auto-normalizes to text/markdown.
 
-- `matchAgainstContent(body, content, mimetype, mimetypes, baseLine?)` — body-matcher adapter over `Mimetypes.query`. Maps framework errors:
+### Result families — `Results`
+
+- `Results.isEntry` / `Results.isProposal` / `Results.isPassthrough` — `shape` discriminator guards over `SchemeResult`.
+- `Results.isErrorStatus(status)` — `status >= 400`.
+- `Results.error(scheme, kind, message?, position?)` — build a scheme-sourced `TelemetryEvent` (`source: "scheme:<name>"`).
+- `Results.logCoordinate(coordinate, op?)` — build a `LogCoordinate` position.
+
+### Matcher dispatch — `Matcher`
+
+- `Matcher.matchAgainstContent(body, content, mimetype, mimetypes, baseLine?)` — body-matcher adapter over `Mimetypes.query` (glob/regex/jsonpath/xpath, all served by the framework). Maps framework errors:
   - `UnsupportedDialectError` → status 415
   - `InvalidExpressionError` → status 400
   - `QueryParseFailureError` → status 203 (soft fallback: raw content as text/markdown with `reason`)

package/dist/index.d.ts

@@ -1,13 +1,13 @@
 export type { LoopFlags, SchemeFlagAffinity, SchemeManifest, WriterTier, } from "./types.ts";
 export { DEFAULT_LOOP_FLAGS } from "./types.ts";
-export { resolveForLoop } from "./resolveForLoop.ts";
-export { isBinaryMimetype, isJsonMimetype, isLineNavigableMimetype, normalizeAutoTextMimetype, TEXT_PRIMITIVE_MIMETYPE, } from "./mimetype-binary.ts";
-export { applyJsonItemEdit, applyLineMarkerEdit, sliceJsonItems, sliceLines, sliceLinesRaw, } from "./line-marker.ts";
+export { default as SchemeResolver } from "./resolveForLoop.ts";
+export { default as MimetypeClassifier, TEXT_PRIMITIVE_MIMETYPE } from "./mimetype-binary.ts";
+export { default as Slicer } from "./line-marker.ts";
 export type { EditResult as LineEditResult, JsonSliceResult, SliceResult } from "./line-marker.ts";
-export { resolveEntryMimetype } from "./path-mimetype.ts";
-export { matchAgainstContent } from "./matcher.ts";
+export { default as PathMimetype } from "./path-mimetype.ts";
+export { default as Matcher } from "./matcher.ts";
 export type { MatchResult } from "./matcher.ts";
-export { isEntryResult, isErrorStatus, isPassthroughResult, isProposalResult, logCoordinate, schemeError, } from "./results.ts";
+export { default as Results } from "./results.ts";
 export type { EntryResult, PassthroughResult, ProposalResult, SchemeResult, SchemeResultBase, TelemetryEvent, } from "./results.ts";
 export type { ChannelCaps, ChannelState, CrossSchemeCaps, EntryCaps, EntryData, NotifyCaps, ProposalAware, SchemeCtx, SubscriptionCaps, SubscriptionHandle, TagCaps, VisibilityCaps, } from "./ctx.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACR,SAAS,EACT,kBAAkB,EAClB,cAAc,EACd,UAAU,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EACH,gBAAgB,EAChB,cAAc,EACd,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,GAC1B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACH,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,UAAU,EACV,aAAa,GAChB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,UAAU,IAAI,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEnG,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EACH,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,WAAW,GACd,MAAM,cAAc,CAAC;AACtB,YAAY,EACR,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,cAAc,GACjB,MAAM,cAAc,CAAC;AAItB,YAAY,EACR,WAAW,EACX,YAAY,EACZ,eAAe,EACf,SAAS,EACT,SAAS,EACT,UAAU,EACV,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,kBAAkB,EAClB,OAAO,EACP,cAAc,GACjB,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,YAAY,EACR,SAAS,EACT,kBAAkB,EAClB,cAAc,EACd,UAAU,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGhD,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC9F,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACrD,YAAY,EAAE,UAAU,IAAI,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACnG,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,cAAc,CAAC;AAClD,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,cAAc,CAAC;AAClD,YAAY,EACR,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,cAAc,GACjB,MAAM,cAAc,CAAC;AAItB,YAAY,EACR,WAAW,EACX,YAAY,EACZ,eAAe,EACf,SAAS,EACT,SAAS,EACT,UAAU,EACV,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,kBAAkB,EAClB,OAAO,EACP,cAAc,GACjB,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -1,8 +1,15 @@
+// Public API barrel for @plurnk/plurnk-schemes.
+//
+// Behavior ships as `export default class` (one class per file, static
+// methods) per the ecosystem class paradigm. Type-only modules (types.ts,
+// ctx.ts), the frozen constant (DEFAULT_LOOP_FLAGS), and this barrel are
+// the only non-class files.
 export { DEFAULT_LOOP_FLAGS } from "./types.js";
-export { resolveForLoop } from "./resolveForLoop.js";
-export { isBinaryMimetype, isJsonMimetype, isLineNavigableMimetype, normalizeAutoTextMimetype, TEXT_PRIMITIVE_MIMETYPE, } from "./mimetype-binary.js";
-export { applyJsonItemEdit, applyLineMarkerEdit, sliceJsonItems, sliceLines, sliceLinesRaw, } from "./line-marker.js";
-export { resolveEntryMimetype } from "./path-mimetype.js";
-export { matchAgainstContent } from "./matcher.js";
-export { isEntryResult, isErrorStatus, isPassthroughResult, isProposalResult, logCoordinate, schemeError, } from "./results.js";
+// ── Behavior classes ─────────────────────────────────────────────────────
+export { default as SchemeResolver } from "./resolveForLoop.js";
+export { default as MimetypeClassifier, TEXT_PRIMITIVE_MIMETYPE } from "./mimetype-binary.js";
+export { default as Slicer } from "./line-marker.js";
+export { default as PathMimetype } from "./path-mimetype.js";
+export { default as Matcher } from "./matcher.js";
+export { default as Results } from "./results.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EACH,gBAAgB,EAChB,cAAc,EACd,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,GAC1B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACH,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,UAAU,EACV,aAAa,GAChB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGnD,OAAO,EACH,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,WAAW,GACd,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,EAAE;AACF,uEAAuE;AACvE,0EAA0E;AAC1E,yEAAyE;AACzE,4BAA4B;AAS5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,4EAA4E;AAC5E,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC9F,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/line-marker.d.ts

@@ -5,19 +5,22 @@ export interface SliceResult {
     startLine?: number;
     error?: string;
 }
-export declare const sliceLines: (content: string, marker: LineMarker) => SliceResult;
 export interface JsonSliceResult {
     status: number;
     body?: string;
     error?: string;
 }
-export declare const sliceJsonItems: (content: string, marker: LineMarker) => JsonSliceResult;
-export declare const applyJsonItemEdit: (content: string, marker: LineMarker, body: string) => EditResult;
-export declare const sliceLinesRaw: (content: string, marker: LineMarker) => SliceResult;
 export interface EditResult {
     status: number;
     result?: string;
     error?: string;
 }
-export declare const applyLineMarkerEdit: (content: string, marker: LineMarker, body: string) => EditResult;
+export default class Slicer {
+    #private;
+    static lines(content: string, marker: LineMarker): SliceResult;
+    static jsonItems(content: string, marker: LineMarker): JsonSliceResult;
+    static jsonItemEdit(content: string, marker: LineMarker, body: string): EditResult;
+    static linesRaw(content: string, marker: LineMarker): SliceResult;
+    static lineMarkerEdit(content: string, marker: LineMarker, body: string): EditResult;
+}
 //# sourceMappingURL=line-marker.d.ts.map

package/dist/line-marker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"line-marker.d.ts","sourceRoot":"","sources":["../src/line-marker.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAkCzD,MAAM,WAAW,WAAW;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;AAWlG,eAAO,MAAM,UAAU,GAAI,SAAS,MAAM,EAAE,QAAQ,UAAU,KAAG,WAOhE,CAAC;AAyBF,MAAM,WAAW,eAAe;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;AAElF,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,EAAE,QAAQ,UAAU,KAAG,eAoBpE,CAAC;AA6GF,eAAO,MAAM,iBAAiB,GAAI,SAAS,MAAM,EAAE,QAAQ,UAAU,EAAE,MAAM,MAAM,KAAG,UAerF,CAAC;AAOF,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,EAAE,QAAQ,UAAU,KAAG,WAQnE,CAAC;AAEF,MAAM,WAAW,UAAU;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;AAS/E,eAAO,MAAM,mBAAmB,GAAI,SAAS,MAAM,EAAE,QAAQ,UAAU,EAAE,MAAM,MAAM,KAAG,UAiBvF,CAAC"}
+{"version":3,"file":"line-marker.d.ts","sourceRoot":"","sources":["../src/line-marker.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAQzD,MAAM,WAAW,WAAW;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;AAClG,MAAM,WAAW,eAAe;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;AAClF,MAAM,WAAW,UAAU;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;AAE/E,MAAM,CAAC,OAAO,OAAO,MAAM;;IAoCvB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,WAAW;IA+B9D,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,eAAe;IAgItE,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU;IAsBlF,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,WAAW;IAiBjE,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU;CAkBvF"}