cursedbelt 2.8.0 → 3.0.1

package/dist/client/router/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/router/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,SAAS,EACT,yBAAyB,EACzB,cAAc,EACd,iBAAiB,EACjB,QAAQ,EACR,MAAM,EACN,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,YAAY,EACZ,KAAK,aAAa,EAClB,wBAAwB,EACxB,cAAc,EACd,SAAS,GACV,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,iBAAiB,EACjB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,OAAO,EACZ,qBAAqB,EACrB,0BAA0B,EAC1B,UAAU,EACV,WAAW,EACX,KAAK,UAAU,EACf,KAAK,cAAc,GACpB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,cAAc,EACd,KAAK,WAAW,GACjB,MAAM,YAAY,CAAC"}

package/dist/client/router/index.js

@@ -1,11 +0,0 @@
-/**
- * The client half of the Dual-Layer Router (03 §3.1, §4, §5).
- *
- * Framework-agnostic on purpose: the navigation state machine and the locator
- * resolver are testable without a renderer, and the React binding
- * (`cursedbelt/react`) is a thin subscription on top.
- */
-export { CC_SCHEME, DEEP_LINK_ENTITY_PREFIXES, entityPrefixOf, fillRouteTemplate, GO_ROUTE, goHref, parseLocator, registerDeepLinkPrefixes, resolveLocator, toLocator, } from './locator';
-export { buildClientRoutes, defaultViewModulePath, generateClientRoutesModule, matchRoute, routeParams, } from './routeTable';
-export { createCcRouter, } from './ccRouter';
-//# sourceMappingURL=index.js.map

package/dist/client/router/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/client/router/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,SAAS,EACT,yBAAyB,EACzB,cAAc,EACd,iBAAiB,EACjB,QAAQ,EACR,MAAM,EAIN,YAAY,EAEZ,wBAAwB,EACxB,cAAc,EACd,SAAS,GACV,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,iBAAiB,EAIjB,qBAAqB,EACrB,0BAA0B,EAC1B,UAAU,EACV,WAAW,GAGZ,MAAM,cAAc,CAAC;AAEtB,OAAO,EAKL,cAAc,GAEf,MAAM,YAAY,CAAC"}

package/dist/client/router/locator.d.ts

@@ -1,78 +0,0 @@
-import type { EffectiveManifest } from '../../verify/types';
-export declare const CC_SCHEME = "cc://";
-export interface ParsedLocator {
-    engine: string;
-    entityId: string;
-    /** Explicit instance qualifier from `cc://knowledge@chat-main/note_1`. */
-    instanceId?: string;
-}
-/** Why a locator did not resolve. Mirrors `CCRouteFallback`'s `reason`. */
-export type LocatorFailure = 'unknown-route' | 'entity-missing' | 'unauthorized';
-export type LocatorResolution = {
-    ok: true;
-    path: string;
-    instanceId: string;
-    view: string;
-    ambiguous: boolean;
-} | {
-    ok: false;
-    reason: LocatorFailure;
-};
-/**
- * Parse `cc://<engine>[@<instanceId>]/<entity-id>`.
- *
- * Returns null rather than throwing: an unparseable locator is user-supplied
- * data (it can arrive from an external deep link), so it belongs in the
- * fallback path, not in an exception.
- */
-export declare function parseLocator(locator: string): ParsedLocator | null;
-/** `note_102` → `note`. The prefix is the entity type ids are minted with (01 §2). */
-export declare const entityPrefixOf: (entityId: string) => string;
-/** Substitute a route template's single param: `/chat/:conversationId` → `/chat/conv_9482`. */
-export declare function fillRouteTemplate(template: string, entityId: string): string;
-export interface LocatorContext {
-    manifest: EffectiveManifest;
-    /** The AUTHENTICATED tenant. Mandatory (J3-2) — never defaulted, never optional. */
-    tenantId: string;
-    /**
-     * Tenant of the target entity, when the caller already knows it (a wire
-     * payload carries it). Omitted means "not yet known" and the target view's
-     * own fetch performs the check under the caller's claims.
-     */
-    entityTenantId?: string;
-}
-/**
- * Resolve a locator to a concrete client path.
- *
- * `ambiguous: true` means several instances declared the same
- * `deepLinkEntity`; declaration order wins and the caller emits WARNING
- * `ambiguous-deep-link`. An explicit `cc://knowledge@chat-main/...` qualifier
- * silences it.
- */
-export declare function resolveLocator(locator: string, tenantId: string, context: LocatorContext): LocatorResolution;
-/**
- * Which id prefixes each deep-link token owns.
- *
- * This is an explicit table rather than a string heuristic on the token's local
- * name, because the minted prefixes are deliberately short forms — `bookmark`
- * ids are `bm_…`, `worklog` ids are `wl_…`, `article` ids are `art_…`
- * (cwip `ID_PREFIXES`). Deriving the prefix from the token name would resolve
- * `bm_1` to nothing and, worse, could resolve a near-miss to the WRONG route.
- * A missing entry here yields `unknown-route` and the fallback UI, which is the
- * correct failure: visible, and never a silent mis-navigation.
- */
-export declare const DEEP_LINK_ENTITY_PREFIXES: Readonly<Record<string, readonly string[]>>;
-/**
- * Register a deep-link token's id prefixes. Promotion (02 §3.3) calls this when
- * a staging module's token becomes a core one.
- */
-export declare const registerDeepLinkPrefixes: (tokenId: string, prefixes: readonly string[]) => void;
-/** Build a locator — the only sanctioned way to mint one. */
-export declare const toLocator: (engine: string, entityId: string, instanceId?: string) => string;
-/**
- * The external deep-link entry path. `/go/:locator` decodes and forwards, so an
- * external tool can link into an app without knowing its route customizations.
- */
-export declare const GO_ROUTE = "/go/:locator";
-export declare const goHref: (locator: string) => string;
-//# sourceMappingURL=locator.d.ts.map

package/dist/client/router/locator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"locator.d.ts","sourceRoot":"","sources":["../../../src/client/router/locator.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,eAAO,MAAM,SAAS,UAAU,CAAC;AAEjC,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,2EAA2E;AAC3E,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG,gBAAgB,GAAG,cAAc,CAAC;AAEjF,MAAM,MAAM,iBAAiB,GACzB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,GAChF;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,CAAC;AAE1C;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAclE;AAED,sFAAsF;AACtF,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM,KAAG,MAGjD,CAAC;AAEF,+FAA+F;AAC/F,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAK5E;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,oFAAoF;IACpF,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,iBAAiB,CAqC5G;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CASjF,CAAC;AAKF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,GAAI,SAAS,MAAM,EAAE,UAAU,SAAS,MAAM,EAAE,KAAG,IAEvF,CAAC;AAOF,6DAA6D;AAC7D,eAAO,MAAM,SAAS,GAAI,QAAQ,MAAM,EAAE,UAAU,MAAM,EAAE,aAAa,MAAM,KAAG,MACR,CAAC;AAE3E;;;GAGG;AACH,eAAO,MAAM,QAAQ,iBAAiB,CAAC;AAEvC,eAAO,MAAM,MAAM,GAAI,SAAS,MAAM,KAAG,MAA8C,CAAC"}

package/dist/client/router/locator.js

@@ -1,119 +0,0 @@
-export const CC_SCHEME = 'cc://';
-/**
- * Parse `cc://<engine>[@<instanceId>]/<entity-id>`.
- *
- * Returns null rather than throwing: an unparseable locator is user-supplied
- * data (it can arrive from an external deep link), so it belongs in the
- * fallback path, not in an exception.
- */
-export function parseLocator(locator) {
-    if (!locator.startsWith(CC_SCHEME))
-        return null;
-    const rest = locator.slice(CC_SCHEME.length);
-    const slash = rest.indexOf('/');
-    if (slash <= 0)
-        return null;
-    const authority = rest.slice(0, slash);
-    const entityId = rest.slice(slash + 1);
-    if (entityId.length === 0)
-        return null;
-    const at = authority.indexOf('@');
-    return at === -1
-        ? { engine: authority, entityId }
-        : { engine: authority.slice(0, at), instanceId: authority.slice(at + 1), entityId };
-}
-/** `note_102` → `note`. The prefix is the entity type ids are minted with (01 §2). */
-export const entityPrefixOf = (entityId) => {
-    const underscore = entityId.indexOf('_');
-    return underscore === -1 ? entityId : entityId.slice(0, underscore);
-};
-/** Substitute a route template's single param: `/chat/:conversationId` → `/chat/conv_9482`. */
-export function fillRouteTemplate(template, entityId) {
-    return template
-        .split('/')
-        .map((segment) => (segment.startsWith(':') ? encodeURIComponent(entityId) : segment))
-        .join('/');
-}
-/**
- * Resolve a locator to a concrete client path.
- *
- * `ambiguous: true` means several instances declared the same
- * `deepLinkEntity`; declaration order wins and the caller emits WARNING
- * `ambiguous-deep-link`. An explicit `cc://knowledge@chat-main/...` qualifier
- * silences it.
- */
-export function resolveLocator(locator, tenantId, context) {
-    if (context.tenantId !== tenantId)
-        // A caller passing a tenant that disagrees with its own context is either a
-        // bug or an escalation attempt; either way it must not resolve.
-        return { ok: false, reason: 'unauthorized' };
-    const parsed = parseLocator(locator);
-    if (!parsed)
-        return { ok: false, reason: 'unknown-route' };
-    if (context.entityTenantId !== undefined && context.entityTenantId !== tenantId)
-        return { ok: false, reason: 'unauthorized' };
-    const prefix = entityPrefixOf(parsed.entityId);
-    // Candidates: instances of the named engine that declare a route whose
-    // `deepLinkEntity` token matches this entity's type, in declaration order.
-    const candidates = context.manifest.instances
-        .filter((instance) => instance.engine === parsed.engine)
-        .filter((instance) => parsed.instanceId === undefined || instance.id === parsed.instanceId)
-        .flatMap((instance) => instance.routes
-        .filter((route) => route.deepLinkEntity !== undefined && matchesEntity(route.deepLinkEntity, prefix))
-        .map((route) => ({ instance, route })));
-    if (candidates.length === 0)
-        return { ok: false, reason: 'unknown-route' };
-    const [winner] = candidates;
-    if (!winner)
-        return { ok: false, reason: 'unknown-route' };
-    return {
-        ok: true,
-        path: fillRouteTemplate(winner.route.path, parsed.entityId),
-        instanceId: winner.instance.id,
-        view: winner.route.view,
-        ambiguous: candidates.length > 1 && parsed.instanceId === undefined,
-    };
-}
-/**
- * Which id prefixes each deep-link token owns.
- *
- * This is an explicit table rather than a string heuristic on the token's local
- * name, because the minted prefixes are deliberately short forms — `bookmark`
- * ids are `bm_…`, `worklog` ids are `wl_…`, `article` ids are `art_…`
- * (cwip `ID_PREFIXES`). Deriving the prefix from the token name would resolve
- * `bm_1` to nothing and, worse, could resolve a near-miss to the WRONG route.
- * A missing entry here yields `unknown-route` and the fallback UI, which is the
- * correct failure: visible, and never a silent mis-navigation.
- */
-export const DEEP_LINK_ENTITY_PREFIXES = {
-    'knowledge:note-ref': ['note'],
-    'knowledge:conversation-ref': ['conv'],
-    'knowledge:records': ['list', 'lrow'],
-    'media:video-ref': ['vid'],
-    'media:items': ['itm', 'file'],
-    'media:videos': ['vid'],
-    'media:photos': ['pho'],
-    'asset:file-ref': ['file'],
-};
-/** Extra token → prefix mappings, contributed by promoted staging modules. */
-const extraPrefixes = new Map();
-/**
- * Register a deep-link token's id prefixes. Promotion (02 §3.3) calls this when
- * a staging module's token becomes a core one.
- */
-export const registerDeepLinkPrefixes = (tokenId, prefixes) => {
-    extraPrefixes.set(tokenId, prefixes);
-};
-function matchesEntity(deepLinkEntity, prefix) {
-    const owned = extraPrefixes.get(deepLinkEntity) ?? DEEP_LINK_ENTITY_PREFIXES[deepLinkEntity];
-    return owned?.includes(prefix) === true;
-}
-/** Build a locator — the only sanctioned way to mint one. */
-export const toLocator = (engine, entityId, instanceId) => `${CC_SCHEME}${engine}${instanceId ? `@${instanceId}` : ''}/${entityId}`;
-/**
- * The external deep-link entry path. `/go/:locator` decodes and forwards, so an
- * external tool can link into an app without knowing its route customizations.
- */
-export const GO_ROUTE = '/go/:locator';
-export const goHref = (locator) => `/go/${encodeURIComponent(locator)}`;
-//# sourceMappingURL=locator.js.map

package/dist/client/router/locator.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"locator.js","sourceRoot":"","sources":["../../../src/client/router/locator.ts"],"names":[],"mappings":"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"}

package/dist/client/router/routeTable.d.ts

@@ -1,75 +0,0 @@
-/**
- * The client layer of the Dual-Layer Router (03 §3.1).
- *
- * One declaration in `app-config.json` compiles into BOTH layers. This module
- * owns the client half: `instances[].routes` becomes a lazy route table, plus
- * redirect entries for each alias.
- *
- * Collisions do **not** silently first-declare-wins. Two instances claiming
- * `/chat/:id` is V1 `route-collision`, because the alternative — one of them
- * quietly never rendering — is a bug that presents as "the feature is broken"
- * with nothing in the logs.
- */
-import type { EngineId } from '../../config/appConfig';
-import type { EffectiveManifest } from '../../verify/types';
-export interface CCRoute {
-    path: string;
-    instanceId: string;
-    engine: EngineId;
-    view: string;
-    /** The lazy chunk. A feature that is off contributes no chunk at all (V5). */
-    load: () => Promise<{
-        default: unknown;
-    }>;
-    /** Param names this path declares, in order. */
-    params: readonly string[];
-    /** True for an alias entry that redirects to its canonical path. */
-    redirectTo?: string;
-}
-/** Extract `:param` names from a path template, in order. */
-export declare const routeParams: (path: string) => string[];
-/**
- * How a view id resolves to its lazy chunk. Injected because the import graph is
- * generated per app — cursedbelt cannot statically know an app's view modules,
- * and a dynamic `import(variable)` would defeat the bundler's code splitting.
- */
-export type ViewLoader = (engine: EngineId, view: string, instanceId: string) => () => Promise<{
-    default: unknown;
-}>;
-export interface BuildRoutesOptions {
-    manifest: EffectiveManifest;
-    lazyView: ViewLoader;
-}
-export interface BuiltRoutes {
-    routes: readonly CCRoute[];
-    /** Paths declared more than once — V1 `route-collision` (never silently resolved). */
-    collisions: readonly {
-        path: string;
-        instanceIds: readonly string[];
-    }[];
-}
-export declare function buildClientRoutes(options: BuildRoutesOptions): BuiltRoutes;
-/**
- * Match a concrete path against the table. Static segments beat params at the
- * same depth, so `/chat/new` wins over `/chat/:conversationId` — otherwise a
- * literal sub-route is unreachable the moment a param route exists above it.
- */
-export declare function matchRoute(routes: readonly CCRoute[], path: string): {
-    route: CCRoute;
-    params: Record<string, string>;
-} | null;
-/**
- * Emit `client-routes.gen.ts`.
- *
- * The table is generated at COMPILE time (03 §1) rather than assembled at boot,
- * so the bundler sees literal `import()` specifiers and can actually split the
- * chunks. A runtime-assembled table with dynamic specifiers would silently
- * collapse every view into the main bundle — which is how a "lazy" editor ends
- * up costing every user its ffmpeg payload.
- */
-export declare function generateClientRoutesModule(manifest: EffectiveManifest, viewModulePath: ViewModulePath): string;
-/** Where an engine's view module lives in the generated app. */
-export type ViewModulePath = (engine: EngineId, view: string) => string;
-/** The default layout: `./engines/<engine>/views/<view>`. */
-export declare const defaultViewModulePath: ViewModulePath;
-//# sourceMappingURL=routeTable.d.ts.map

package/dist/client/router/routeTable.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"routeTable.d.ts","sourceRoot":"","sources":["../../../src/client/router/routeTable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAG5D,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,QAAQ,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,IAAI,EAAE,MAAM,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC1C,gDAAgD;IAChD,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,6DAA6D;AAC7D,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,KAAG,MAAM,EAIV,CAAC;AAExC;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,MAAM,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAErH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,QAAQ,EAAE,UAAU,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC;IAC3B,sFAAsF;IACtF,UAAU,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;CACzE;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CA+C1E;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,SAAS,OAAO,EAAE,EAC1B,IAAI,EAAE,MAAM,GACX;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,IAAI,CA4B3D;AAMD;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,iBAAiB,EAAE,cAAc,EAAE,cAAc,GAAG,MAAM,CA8C9G;AAED,gEAAgE;AAChE,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AAExE,6DAA6D;AAC7D,eAAO,MAAM,qBAAqB,EAAE,cAAsE,CAAC"}

package/dist/client/router/routeTable.js

@@ -1,140 +0,0 @@
-import { GO_ROUTE } from './locator';
-/** Extract `:param` names from a path template, in order. */
-export const routeParams = (path) => path
-    .split('/')
-    .filter((segment) => segment.startsWith(':'))
-    .map((segment) => segment.slice(1));
-export function buildClientRoutes(options) {
-    const { manifest, lazyView } = options;
-    const routes = [];
-    const byPath = new Map();
-    const claim = (path, instanceId) => {
-        const existing = byPath.get(path);
-        if (existing)
-            existing.push(instanceId);
-        else
-            byPath.set(path, [instanceId]);
-    };
-    for (const instance of manifest.instances) {
-        for (const route of instance.routes) {
-            claim(route.path, instance.id);
-            routes.push({
-                path: route.path,
-                instanceId: instance.id,
-                engine: instance.engine,
-                view: route.view,
-                load: lazyView(instance.engine, route.view, instance.id),
-                params: routeParams(route.path),
-            });
-            for (const alias of route.aliases) {
-                claim(alias, instance.id);
-                routes.push({
-                    path: alias,
-                    instanceId: instance.id,
-                    engine: instance.engine,
-                    view: route.view,
-                    load: lazyView(instance.engine, route.view, instance.id),
-                    params: routeParams(alias),
-                    redirectTo: route.path,
-                });
-            }
-        }
-    }
-    const collisions = [...byPath.entries()]
-        .filter(([, ids]) => ids.length > 1)
-        .map(([path, instanceIds]) => ({ path, instanceIds: [...new Set(instanceIds)] }))
-        // A single instance declaring the same alias twice is a duplicate, not a
-        // cross-instance collision; both are reported, but only the latter is the
-        // V1 error class.
-        .filter((entry) => entry.instanceIds.length > 1);
-    return { routes, collisions };
-}
-/**
- * Match a concrete path against the table. Static segments beat params at the
- * same depth, so `/chat/new` wins over `/chat/:conversationId` — otherwise a
- * literal sub-route is unreachable the moment a param route exists above it.
- */
-export function matchRoute(routes, path) {
-    const target = splitPath(path);
-    let best = null;
-    for (const route of routes) {
-        const template = splitPath(route.path);
-        if (template.length !== target.length)
-            continue;
-        const params = {};
-        let staticSegments = 0;
-        let matched = true;
-        for (let i = 0; i < template.length; i += 1) {
-            const segment = template[i];
-            const value = target[i];
-            if (segment.startsWith(':'))
-                params[segment.slice(1)] = decodeURIComponent(value);
-            else if (segment === value)
-                staticSegments += 1;
-            else {
-                matched = false;
-                break;
-            }
-        }
-        if (matched && (best === null || staticSegments > best.staticSegments))
-            best = { route, params, staticSegments };
-    }
-    return best ? { route: best.route, params: best.params } : null;
-}
-const splitPath = (path) => path.split('/').filter((segment) => segment.length > 0);
-/* ------------------------------------------------- the generated module */
-/**
- * Emit `client-routes.gen.ts`.
- *
- * The table is generated at COMPILE time (03 §1) rather than assembled at boot,
- * so the bundler sees literal `import()` specifiers and can actually split the
- * chunks. A runtime-assembled table with dynamic specifiers would silently
- * collapse every view into the main bundle — which is how a "lazy" editor ends
- * up costing every user its ffmpeg payload.
- */
-export function generateClientRoutesModule(manifest, viewModulePath) {
-    const entries = [];
-    for (const instance of manifest.instances) {
-        for (const route of instance.routes) {
-            const specifier = viewModulePath(instance.engine, route.view);
-            const emit = (path, redirectTo) => {
-                entries.push([
-                    '  {',
-                    `    path: ${JSON.stringify(path)},`,
-                    `    instanceId: ${JSON.stringify(instance.id)},`,
-                    `    engine: ${JSON.stringify(instance.engine)},`,
-                    `    view: ${JSON.stringify(route.view)},`,
-                    `    params: ${JSON.stringify(routeParams(path))},`,
-                    redirectTo === undefined ? null : `    redirectTo: ${JSON.stringify(redirectTo)},`,
-                    `    load: () => import(${JSON.stringify(specifier)}),`,
-                    '  },',
-                ]
-                    .filter((line) => line !== null)
-                    .join('\n'));
-            };
-            emit(route.path);
-            for (const alias of route.aliases)
-                emit(alias, route.path);
-        }
-    }
-    return `/**
- * GENERATED by cursedbelt from app-config.json — do not edit.
- *
- * One route declaration compiles into both layers (03 §3). This is the client
- * half; the server half is the fixed per-engine mixin block.
- *
- * bundleKey: ${manifest.bundleKey}
- */
-import type { CCRoute } from 'cursedbelt/client';
-
-export const CLIENT_ROUTES: readonly CCRoute[] = [
-${entries.join('\n')}
-];
-
-/** External deep-link entry point (03 §4). */
-export const GO_ROUTE = ${JSON.stringify(GO_ROUTE)};
-`;
-}
-/** The default layout: `./engines/<engine>/views/<view>`. */
-export const defaultViewModulePath = (engine, view) => `./engines/${engine}/views/${view}`;
-//# sourceMappingURL=routeTable.js.map

package/dist/client/router/routeTable.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"routeTable.js","sourceRoot":"","sources":["../../../src/client/router/routeTable.ts"],"names":[],"mappings":"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"}

package/dist/client/stream/appStream.d.ts

@@ -1,133 +0,0 @@
-/**
- * The MULTIPLEXED app stream host (D28) — one live connection per app, however
- * many instances it composes.
- *
- * ## Why this exists
- *
- * `createInstanceStreamHost` opens one SSE connection per instance, and that was
- * fine until an app had several. A browser allows **six concurrent connections
- * per origin** over HTTP/1.1 and an SSE connection is long-lived, so the budget
- * is consumed at `instances × open tabs`. Worse than the ceiling is its shape:
- * once it is exhausted, ordinary `fetch`es queue behind the streams, so the app
- * does not report an error — it **hangs**. Measured in the browser gate before
- * this landed: three instances across two tabs passed, four hung, deterministically
- * in both directions. The studio's whole premise is composing instances, so an
- * app a customer builds from six of them exhausted the budget in a SINGLE tab.
- *
- * This host opens `/api/core/stream?instances=a,b,c` once. The server tags each
- * instance-scoped frame with `instance: <id>` (`encodeSseFrame`) and this host
- * routes it to that instance's runtime; an untagged frame is app-wide and goes
- * to every instance. **Connection count is now a constant — one — and no longer
- * a function of the manifest.**
- *
- * ## Two properties that are not obvious
- *
- * **The runtimes are built HERE, not passed in.** That is what makes a full
- * `unmount()` → `start()` cycle work: an `InstanceRuntime` is single-use by
- * design (`onUnmount` is terminal and `onLoad` after it is a recorded lifecycle
- * error), so a host that held one forever could never restart. React's
- * `StrictMode` performs exactly that cycle on every mount in development, which
- * means a host without this property leaves a dev app with no live stream at all
- * — a defect that never shows up in a production bundle and therefore never
- * shows up in a browser gate.
- *
- * **`start()` is ONE memoized promise, not a per-instance race.** `CCAppShell`
- * calls `start()` on every binding and awaits them together; every call resolves
- * the same promise, which runs all the ordered lifecycle hooks and only then
- * opens the socket. Opening on the first binding's start instead would let
- * frames arrive for an instance whose intake is not subscribed yet — a change
- * the ledger silently never records.
- */
-import { type InstanceRuntime, type WireEnvelope, type WireHub } from '../../core/wire/wireHub';
-import type { ContextSyncBroker } from '../contextSyncBroker';
-import { type CcStreamStatus, type CcStreamToken, openCcEventSource } from './ccEventSource';
-import { type CdcFrame, type StreamJobResult } from './instanceStream';
-/** One instance this app hosts — the same two facts `createInstanceRuntime` needs. */
-export interface AppStreamInstanceSpec {
-    id: string;
-    /**
-     * Channels the instance takes intake on at `onReady` — the enabled in-ports
-     * that declare `subscribesAtMount` (03 §6.2).
-     */
-    intakeChannels: readonly string[];
-}
-/**
- * One instance's handle, shaped to satisfy `InstanceHostBinding` so it can be
- * handed straight to `CCAppShell instances={...}`.
- */
-export interface AppStreamBinding {
-    instanceId: string;
-    /** Run every instance's ordered hooks and open the ONE stream. Idempotent. */
-    start(): Promise<void>;
-    /** Re-open the shared stream with the session as it is now. */
-    reconnect(): void;
-    /** Leave the view: abort view-scoped work. Intake, ledger and stream persist. */
-    suspend(): void;
-    /** Remove this instance. The shared stream closes when the LAST one unmounts. */
-    unmount(): void;
-    status(): CcStreamStatus;
-    pullIfDirty<T>(channel: string, renderedRev: number): WireEnvelope<T> | undefined;
-    /** The live runtime, or `null` before `start()` / after `unmount()`. */
-    runtime(): InstanceRuntime | null;
-}
-export interface AppStreamOptions {
-    /** The app's wire hub — the one `EngineDataProvider` reads. */
-    hub: WireHub;
-    /** Every instance in the manifest. Order is preserved in {@link AppStreamHost.bindings}. */
-    instances: readonly AppStreamInstanceSpec[];
-    /**
-     * The multiplexed route. Default `/api/core/stream`; the instance ids are
-     * appended as `?instances=`.
-     */
-    url?: string;
-    /**
-     * The session this stream presents. Pass the session store's `token` GETTER in
-     * any app that can sign in: the stream opens at mount, the session arrives
-     * later, and the server decides which tenant's CDC records you may see once,
-     * at connect. A stream that opened anonymously receives NO tenant-scoped
-     * frames — which is every frame a real write produces (`bridgeCdcToPush`).
-     */
-    token?: CcStreamToken;
-    /**
-     * Maps a CDC record to the wire channels it invalidates. Defaults to
-     * `cdc:<domain>.<table>`.
-     */
-    channelsForCdc?: (frame: CdcFrame) => readonly string[];
-    /**
-     * Re-broadcasts `VAULT_LOCKED` across tabs. Consulted ONCE per frame here,
-     * where N per-instance hosts each published their own copy of the same lock.
-     */
-    sync?: ContextSyncBroker;
-    onStatus?(status: CcStreamStatus, attempt: number): void;
-    /** Job completion notifications. `instanceId` is absent for an app-wide job. */
-    onJob?(job: StreamJobResult, instanceId?: string): void;
-    /** Seam for tests. */
-    openStream?: typeof openCcEventSource;
-}
-export interface AppStreamHost {
-    /** One per instance, in the order given. Pass to `CCAppShell instances={…}`. */
-    readonly bindings: readonly AppStreamBinding[];
-    /** The single URL this app opens — including the `?instances=` list. */
-    readonly url: string;
-    /** Start every instance and open the stream. Idempotent; the same promise. */
-    start(): Promise<void>;
-    /** Re-open on a credential change (sign-in, refresh, sign-out). */
-    reconnect(): void;
-    /** Unmount every instance and close the stream. */
-    unmount(): void;
-    status(): CcStreamStatus;
-    /**
-     * Live SSE connections this host holds: 0 or 1, never `instances.length`.
-     * **This is the assertion D28 is about** — a standing test reads it so a future
-     * refactor cannot quietly reintroduce a connection per instance.
-     */
-    connectionCount(): number;
-}
-/**
- * Build the multiplexed URL. Ids go through `encodeURIComponent` individually
- * rather than the whole list, because the comma is the separator the server
- * splits on and encoding it would make every id a single unknown instance.
- */
-export declare const appStreamUrl: (base: string, instanceIds: readonly string[]) => string;
-export declare function createAppStreamHost(options: AppStreamOptions): AppStreamHost;
-//# sourceMappingURL=appStream.d.ts.map

package/dist/client/stream/appStream.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"appStream.d.ts","sourceRoot":"","sources":["../../../src/client/stream/appStream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,OAAO,EACb,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAEL,KAAK,QAAQ,EAEb,KAAK,eAAe,EACrB,MAAM,kBAAkB,CAAC;AAE1B,sFAAsF;AACtF,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX;;;OAGG;IACH,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,+DAA+D;IAC/D,SAAS,IAAI,IAAI,CAAC;IAClB,iFAAiF;IACjF,OAAO,IAAI,IAAI,CAAC;IAChB,iFAAiF;IACjF,OAAO,IAAI,IAAI,CAAC;IAChB,MAAM,IAAI,cAAc,CAAC;IACzB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAClF,wEAAwE;IACxE,OAAO,IAAI,eAAe,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,gBAAgB;IAC/B,+DAA+D;IAC/D,GAAG,EAAE,OAAO,CAAC;IACb,4FAA4F;IAC5F,SAAS,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC5C;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,SAAS,MAAM,EAAE,CAAC;IACxD;;;OAGG;IACH,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,QAAQ,CAAC,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACzD,gFAAgF;IAChF,KAAK,CAAC,CAAC,GAAG,EAAE,eAAe,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxD,sBAAsB;IACtB,UAAU,CAAC,EAAE,OAAO,iBAAiB,CAAC;CACvC;AAED,MAAM,WAAW,aAAa;IAC5B,gFAAgF;IAChF,QAAQ,CAAC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC/C,wEAAwE;IACxE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,mEAAmE;IACnE,SAAS,IAAI,IAAI,CAAC;IAClB,mDAAmD;IACnD,OAAO,IAAI,IAAI,CAAC;IAChB,MAAM,IAAI,cAAc,CAAC;IACzB;;;;OAIG;IACH,eAAe,IAAI,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,EAAE,aAAa,SAAS,MAAM,EAAE,KAAG,MAC4B,CAAC;AAEzG,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,aAAa,CA8I5E"}