@astrale-os/sdk 0.4.19 → 0.5.0-beta.2

package/dist/query/node.js

@@ -0,0 +1,164 @@
+import { Property, Query, } from '@astrale-os/kernel-core/graph/query';
+const selections = new WeakMap();
+export const queryContext = Object.freeze({
+    node(definition, path) {
+        const source = Query.from({ kind: 'node', paths: [path] });
+        return selection(definition, source.filter({ satisfies: definition.schemaRef }), false);
+    },
+    nodes(definition) {
+        return selection(definition, Query.from({ kind: 'node', definitions: [definition.schemaRef] }), true);
+    },
+});
+export function compileNodeQuery(input) {
+    if (!isRuntimeSelection(input))
+        return input;
+    const ast = input.compile();
+    selections.set(ast, input);
+    return ast;
+}
+export function queryContextIsMany(input) {
+    return isRuntimeSelection(input) ? input.many : undefined;
+}
+export function projectNodeQuery(ast, result, bind) {
+    const selected = selections.get(ast);
+    if (selected === undefined)
+        return Object.freeze({ matched: false });
+    if (bind === undefined) {
+        throw new TypeError('Node Query projection requires a Domain value binder.');
+    }
+    if (!isValueNodeResult(result))
+        throw new TypeError('Node Query returned a non-node value projection.');
+    return Object.freeze({ matched: true, value: selected.project(result, bind) });
+}
+function selection(definition, builder, many, current = definitionClosure(definition), bindDefinition = definition) {
+    const runtime = {
+        current,
+        ...(bindDefinition === undefined ? {} : { bindDefinition }),
+        builder,
+        many,
+        compile() {
+            if (!('node' in builder))
+                throw new TypeError('Node Query selection lost its node binding.');
+            return builder.select({ kind: 'nodes', projection: { kind: 'value' } });
+        },
+        project(result, bind) {
+            const values = result.nodes.map((item) => bindDefinition === undefined ? bind(item.value) : bind(bindDefinition, item.value));
+            return many ? Object.freeze(values) : (values[0] ?? null);
+        },
+    };
+    const value = {
+        ...runtime,
+        __many: many,
+        where(input) {
+            if (input === null ||
+                typeof input !== 'object' ||
+                input.property === null ||
+                typeof input.property !== 'object' ||
+                !('key' in input.property)) {
+                throw new TypeError('Node Query where requires one rich Property.');
+            }
+            const hasEquals = Object.hasOwn(input, 'equals');
+            const hasPresent = input.present === true;
+            if (hasEquals === hasPresent) {
+                throw new TypeError('Node Query where requires exactly one of equals or present.');
+            }
+            const predicate = hasEquals
+                ? Property(input.property.key).equals(input.equals)
+                : Property(input.property.key).isPresent();
+            return selection(definition, builder.filter({ predicate }), many, current, bindDefinition);
+        },
+        when(candidate, refine) {
+            const current = value;
+            return candidate === undefined || candidate === null || candidate === false
+                ? current
+                : refine(current, candidate);
+        },
+        linked(relation, options) {
+            if (options === null || typeof options !== 'object' || options.to === undefined) {
+                throw new TypeError('Node Query linked requires an accepted rich to definition.');
+            }
+            const from = options?.from ?? inferSide(current, relation);
+            if (!overlaps(endpointsOf(relation)[from].accepts, current)) {
+                throw new TypeError(`Relation ${relation.key} does not accept the current selection at its ${from} endpoint.`);
+            }
+            const expanded = builder
+                .expand({
+                via: [relation.schemaRef],
+                direction: from === 'source' ? 'outgoing' : 'incoming',
+            })
+                .filter({ satisfies: options.to.schemaRef });
+            const opposite = endpointsOf(relation)[from === 'source' ? 'target' : 'source'];
+            if (!overlaps(opposite.accepts, definitionClosure(options.to))) {
+                throw new TypeError(`Relation ${relation.key} does not accept ${options.to.key} at its opposite endpoint.`);
+            }
+            const next = Object.freeze({
+                ...selection(options.to, expanded, many || !isSingular(relation, from), definitionClosure(options.to), options.to),
+            });
+            return next;
+        },
+    };
+    return Object.freeze(value);
+}
+function inferSide(current, relation) {
+    const source = overlaps(endpointsOf(relation).source.accepts, current);
+    const target = overlaps(endpointsOf(relation).target.accepts, current);
+    if (source === target) {
+        throw new TypeError(source
+            ? `Relation ${relation.key} accepts the current selection at both endpoints; declare from.`
+            : `Relation ${relation.key} does not accept the current selection.`);
+    }
+    return source ? 'source' : 'target';
+}
+function overlaps(left, right) {
+    return left.some((candidate) => right.some((current) => sameRef(candidate, current)));
+}
+function definitionClosure(definition) {
+    const refs = [];
+    const seen = new Set();
+    const visit = (candidate) => {
+        const ref = candidate.schemaRef;
+        const identity = `${ref.origin}\0${ref.kind}\0${ref.name}`;
+        if (seen.has(identity))
+            return;
+        seen.add(identity);
+        refs.push(ref);
+        const parents = candidate.kind === 'class' ? candidate.implements : candidate.extends;
+        for (const parent of parents ?? [])
+            visit(parent);
+    };
+    visit(definition);
+    return Object.freeze(refs);
+}
+function sameRef(left, right) {
+    return left.origin === right.origin && left.kind === right.kind && left.name === right.name;
+}
+function isSingular(relation, side) {
+    const count = endpointsOf(relation)[side].count;
+    return count === '1' || count === '0..1';
+}
+function endpointsOf(relation) {
+    const declaration = relation.definition;
+    if (declaration.family !== 'edge') {
+        throw new TypeError(`Relation ${relation.key} has no Edge endpoints.`);
+    }
+    return declaration.orientation === 'directed'
+        ? {
+            source: { ...declaration.endpoints.source, count: declaration.endpoints.source.outgoing },
+            target: { ...declaration.endpoints.target, count: declaration.endpoints.target.incoming },
+        }
+        : {
+            source: { ...declaration.endpoints[0], count: declaration.endpoints[0].incident },
+            target: { ...declaration.endpoints[1], count: declaration.endpoints[1].incident },
+        };
+}
+function isRuntimeSelection(input) {
+    return (input !== null &&
+        typeof input === 'object' &&
+        typeof input.compile === 'function');
+}
+function isValueNodeResult(input) {
+    return (input !== null &&
+        typeof input === 'object' &&
+        input.kind === 'nodes');
+}
+//# sourceMappingURL=node.js.map

package/dist/query/node.js.map

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

package/dist/query/result/contract.d.ts

@@ -0,0 +1,23 @@
+import type { Node, NodeId } from '@astrale-os/kernel-core/graph/node';
+import type { QueryEdgeItemFor, QueryEdgeProjection, QueryResult } from '@astrale-os/kernel-core/graph/query';
+type EdgeValueItem = QueryEdgeItemFor<{
+    readonly edge: 'value';
+    readonly source: 'value';
+    readonly target: 'value';
+}>;
+/** Pure strict projections from canonical Kernel Query results. */
+export interface QueryResultProjection {
+    nodeValues(result: QueryResult, context: string): readonly Node[];
+    completeNodeValues(results: readonly QueryResult[], context: string): readonly Node[];
+    nodeIds(result: QueryResult, context: string): readonly NodeId[];
+    completeNodeIds(results: readonly QueryResult[], context: string): readonly NodeId[];
+    exactlyOneNode(result: QueryResult, context: string): Node;
+    optionalNode(result: QueryResult, context: string): Node | undefined;
+    edgeItems(result: QueryResult, context: string): readonly QueryEdgeItemFor<QueryEdgeProjection>[];
+    optionalEdgeTarget(result: QueryResult, context: string): Node | undefined;
+    exactlyOneEdgeTarget(result: QueryResult, context: string): Node;
+    exactlyOneEdgeSource(result: QueryResult, context: string): Node;
+}
+export type QueryEdgeValueItem = EdgeValueItem;
+export {};
+//# sourceMappingURL=contract.d.ts.map

package/dist/query/result/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../src/query/result/contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAA;AACtE,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,EACZ,MAAM,qCAAqC,CAAA;AAE5C,KAAK,aAAa,GAAG,gBAAgB,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CACzB,CAAC,CAAA;AAEF,mEAAmE;AACnE,MAAM,WAAW,qBAAqB;IACpC,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,IAAI,EAAE,CAAA;IACjE,kBAAkB,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,IAAI,EAAE,CAAA;IACrF,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAA;IAChE,eAAe,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAA;IACpF,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1D,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;IACpE,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,gBAAgB,CAAC,mBAAmB,CAAC,EAAE,CAAA;IACjG,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;IAC1E,oBAAoB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAChE,oBAAoB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CACjE;AAED,MAAM,MAAM,kBAAkB,GAAG,aAAa,CAAA"}

package/dist/query/result/contract.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contract.js.map

package/dist/query/result/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../../src/query/result/contract.ts"],"names":[],"mappings":""}

package/dist/query/result/index.d.ts

@@ -0,0 +1,3 @@
+export { queryResult } from './projection.js';
+export type { QueryResultProjection } from './contract.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/query/result/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/query/result/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7C,YAAY,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA"}

package/dist/query/result/index.js

@@ -0,0 +1,2 @@
+export { queryResult } from './projection.js';
+//# sourceMappingURL=index.js.map

package/dist/query/result/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/query/result/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/query/result/projection.d.ts

@@ -0,0 +1,3 @@
+import type { QueryResultProjection } from './contract.js';
+export declare const queryResult: QueryResultProjection;
+//# sourceMappingURL=projection.d.ts.map

package/dist/query/result/projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../../src/query/result/projection.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAgG1D,eAAO,MAAM,WAAW,EAAE,qBAWxB,CAAA"}

package/dist/query/result/projection.js

@@ -0,0 +1,100 @@
+function nodeValues(result, context) {
+    if (result.kind === 'graph')
+        return graphNodes(result, context);
+    if (result.kind !== 'nodes')
+        throw new TypeError(`Expected a Node ${context} query result.`);
+    return Object.freeze(result.nodes.map((projection) => {
+        if (projection.kind !== 'value') {
+            throw new TypeError(`Expected ${context} query to project Node values.`);
+        }
+        return projection.value;
+    }));
+}
+function graphNodes(result, context) {
+    if (result.selection.kind !== 'node') {
+        throw new TypeError(`Expected a Node ${context} query result.`);
+    }
+    const byId = new Map(result.graph.nodes.map((node) => [node.id, node]));
+    return Object.freeze(result.selection.ids.map((id) => {
+        const node = byId.get(id);
+        if (node === undefined)
+            throw new TypeError(`${context} graph omits selected Node ${id}.`);
+        return node;
+    }));
+}
+function completeNodeValues(results, context) {
+    return Object.freeze(results.flatMap((result) => nodeValues(result, context)));
+}
+function nodeIds(result, context) {
+    if (result.kind === 'graph') {
+        if (result.selection.kind !== 'node') {
+            throw new TypeError(`Expected a Node ${context} query result.`);
+        }
+        return result.selection.ids;
+    }
+    if (result.kind !== 'nodes')
+        throw new TypeError(`Expected a Node ${context} query result.`);
+    return Object.freeze(result.nodes.map((projection) => projection.value.id));
+}
+function completeNodeIds(results, context) {
+    return Object.freeze(results.flatMap((result) => nodeIds(result, context)));
+}
+function exactlyOneNode(result, context) {
+    const values = nodeValues(result, context);
+    if (values.length !== 1)
+        throw new TypeError(`${context} must resolve exactly one Node.`);
+    return values[0];
+}
+function optionalNode(result, context) {
+    const values = nodeValues(result, context);
+    if (values.length > 1)
+        throw new TypeError(`${context} must resolve at most one Node.`);
+    return values[0];
+}
+function edgeItems(result, context) {
+    if (result.kind !== 'edges')
+        throw new TypeError(`Expected an Edge ${context} query result.`);
+    return result.edges;
+}
+function optionalEdgeTarget(result, context) {
+    const items = edgeItems(result, context);
+    if (items.length > 1)
+        throw new TypeError(`${context} must resolve at most one Edge.`);
+    const target = items[0]?.target;
+    if (target === undefined)
+        return undefined;
+    if (target.kind !== 'value')
+        throw new TypeError(`${context} must project its target value.`);
+    return target.value;
+}
+function exactlyOneEdgeTarget(result, context) {
+    const items = edgeItems(result, context);
+    if (items.length !== 1)
+        throw new TypeError(`${context} must resolve exactly one Edge.`);
+    const target = items[0].target;
+    if (target.kind !== 'value')
+        throw new TypeError(`${context} must project its target value.`);
+    return target.value;
+}
+function exactlyOneEdgeSource(result, context) {
+    const items = edgeItems(result, context);
+    if (items.length !== 1)
+        throw new TypeError(`${context} must resolve exactly one Edge.`);
+    const source = items[0].source;
+    if (source.kind !== 'value')
+        throw new TypeError(`${context} must project its source value.`);
+    return source.value;
+}
+export const queryResult = Object.freeze({
+    nodeValues,
+    completeNodeValues,
+    nodeIds,
+    completeNodeIds,
+    exactlyOneNode,
+    optionalNode,
+    edgeItems,
+    optionalEdgeTarget,
+    exactlyOneEdgeTarget,
+    exactlyOneEdgeSource,
+});
+//# sourceMappingURL=projection.js.map

package/dist/query/result/projection.js.map

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

package/dist/query/selection.d.ts

@@ -0,0 +1,4 @@
+import type { QueryResult, QuerySelectionFor } from '@astrale-os/kernel-core/graph/query';
+/** Merge one exhausted SDK page chain into the exact Core selected identity sequence. */
+export declare function completeQuerySelection<Result extends QueryResult>(pages: readonly [Result, ...Result[]]): QuerySelectionFor<Result>;
+//# sourceMappingURL=selection.d.ts.map

package/dist/query/selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../src/query/selection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EAEX,iBAAiB,EAClB,MAAM,qCAAqC,CAAA;AAI5C,yFAAyF;AACzF,wBAAgB,sBAAsB,CAAC,MAAM,SAAS,WAAW,EAC/D,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,GACpC,iBAAiB,CAAC,MAAM,CAAC,CAgB3B"}

package/dist/query/selection.js

@@ -0,0 +1,25 @@
+import { QueryResult as QueryResultValue } from '@astrale-os/kernel-core/graph/query';
+/** Merge one exhausted SDK page chain into the exact Core selected identity sequence. */
+export function completeQuerySelection(pages) {
+    const first = QueryResultValue.selection(pages[0]);
+    if (first.kind === 'node') {
+        const ids = pages.flatMap((page) => {
+            const selection = QueryResultValue.selection(page);
+            if (selection.kind !== 'node')
+                changed(first, selection);
+            return selection.ids;
+        });
+        return Object.freeze({ kind: 'node', ids: Object.freeze(ids) });
+    }
+    const keys = pages.flatMap((page) => {
+        const selection = QueryResultValue.selection(page);
+        if (selection.kind !== 'edge')
+            changed(first, selection);
+        return selection.keys;
+    });
+    return Object.freeze({ kind: 'edge', keys: Object.freeze(keys) });
+}
+function changed(first, next) {
+    throw new TypeError(`Paginated Query selection changed from ${first.kind} to ${next.kind}.`);
+}
+//# sourceMappingURL=selection.js.map

package/dist/query/selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.js","sourceRoot":"","sources":["../../src/query/selection.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,IAAI,gBAAgB,EAAE,MAAM,qCAAqC,CAAA;AAErF,yFAAyF;AACzF,MAAM,UAAU,sBAAsB,CACpC,KAAqC;IAErC,MAAM,KAAK,GAAG,gBAAgB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IAClD,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;YACjC,MAAM,SAAS,GAAG,gBAAgB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;YAClD,IAAI,SAAS,CAAC,IAAI,KAAK,MAAM;gBAAE,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;YACxD,OAAO,SAAS,CAAC,GAAG,CAAA;QACtB,CAAC,CAAC,CAAA;QACF,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAA8B,CAAA;IAC9F,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAClC,MAAM,SAAS,GAAG,gBAAgB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;QAClD,IAAI,SAAS,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;QACxD,OAAO,SAAS,CAAC,IAAI,CAAA;IACvB,CAAC,CAAC,CAAA;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAA8B,CAAA;AAChG,CAAC;AAED,SAAS,OAAO,CAAC,KAAqB,EAAE,IAAoB;IAC1D,MAAM,IAAI,SAAS,CAAC,0CAA0C,KAAK,CAAC,IAAI,OAAO,IAAI,CAAC,IAAI,GAAG,CAAC,CAAA;AAC9F,CAAC"}

package/dist/react/compile.d.ts

@@ -0,0 +1,9 @@
+import type { GeneratedFrontendFile } from '../view/index.js';
+import type { ReactFrontendArtifact } from './definition.js';
+/** Generate the browser-only Shell/React boot source consumed by the Vite recipe. */
+export declare function compileReactEntrypoint(artifact: ReactFrontendArtifact): readonly GeneratedFrontendFile[];
+export declare const reactEntrypoint: Readonly<{
+    root: "./views/app";
+    entry: "index.html";
+}>;
+//# sourceMappingURL=compile.d.ts.map

package/dist/react/compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../src/react/compile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AAC7D,OAAO,KAAK,EAAE,qBAAqB,EAAc,MAAM,iBAAiB,CAAA;AAOxE,qFAAqF;AACrF,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,qBAAqB,GAC9B,SAAS,qBAAqB,EAAE,CAqDlC;AAWD,eAAO,MAAM,eAAe;;;EAA4D,CAAA"}

package/dist/react/compile.js

@@ -0,0 +1,64 @@
+import { isCapturedFrontendArtifact } from '../view/admission.js';
+const ROOT = 'views/app';
+const ENTRY = 'astrale.generated.tsx';
+/** Generate the browser-only Shell/React boot source consumed by the Vite recipe. */
+export function compileReactEntrypoint(artifact) {
+    if (!isCapturedFrontendArtifact(artifact) || artifact.framework !== 'react') {
+        throw new TypeError('React frontend must be created by reactFrontend.');
+    }
+    const routes = artifact.routes;
+    const routeEntries = Object.entries(routes);
+    const schemaImport = importFromRoot(artifact.schemaModule.module);
+    const schemaName = artifact.schemaModule.export;
+    const schemaImportLine = schemaName === 'default'
+        ? `import domainSchema from ${quote(schemaImport)}`
+        : `import { ${schemaName} as domainSchema } from ${quote(schemaImport)}`;
+    const implementations = routeEntries
+        .map(([name, route]) => {
+        const specifier = quote(importFromRoot(route.component.module));
+        const exported = route.component.export === 'default'
+            ? 'loaded.default'
+            : `loaded[${quote(route.component.export)}]`;
+        return `${quote(name)}: { component: () => import(${specifier}).then((loaded) => ({ default: ${exported} })) }`;
+    })
+        .join(',\n    ');
+    const routeNames = routeEntries
+        .filter(([, route]) => route.path !== undefined)
+        .map(([name, route]) => `${quote(route.path)}: ${quote(name)}`)
+        .join(',\n  ');
+    const source = `${schemaImportLine}
+import { mountDomainFrontend } from '@astrale-os/shell-react'
+import type { ReactRouteModule } from '@astrale-os/sdk/react'
+
+const module = {
+  schema: domainSchema,
+  routes: {
+    ${implementations}
+  },
+} satisfies ReactRouteModule<typeof domainSchema>
+
+const routes = {
+  ${routeNames}
+} as const
+
+const view = routes[window.location.pathname as keyof typeof routes] ?? ${quote(artifact.entrypoint)}
+mountDomainFrontend({ root: '#root', module, view })
+`;
+    return Object.freeze([
+        Object.freeze({
+            path: 'index.html',
+            mediaType: 'text/html',
+            content: '<!doctype html><html><head><meta charset="UTF-8"><meta name="viewport" content="width=device-width,initial-scale=1"></head><body><div id="root"></div><script type="module" src="/astrale.generated.tsx"></script></body></html>',
+        }),
+        Object.freeze({ path: ENTRY, mediaType: 'text/tsx', content: source }),
+    ]);
+}
+function importFromRoot(input) {
+    const module = input.startsWith('./') ? input.slice(2) : input;
+    return `../../${module}`;
+}
+function quote(input) {
+    return JSON.stringify(input);
+}
+export const reactEntrypoint = Object.freeze({ root: `./${ROOT}`, entry: 'index.html' });
+//# sourceMappingURL=compile.js.map

package/dist/react/compile.js.map

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

package/dist/react/define.d.ts

@@ -0,0 +1,8 @@
+import type { schema } from '@astrale-os/kernel-dsl/v1';
+import type { ReactFrontendArtifact, ReactFrontendInput, ReactRoute, ReactRouteInput, ReactViewSource } from './definition.js';
+/** Retain a component as a normalized browser module coordinate, never as a Worker import. */
+export declare function reactView(input: ReactViewSource): Readonly<Required<ReactViewSource>>;
+export declare function reactRoute(input: ReactRouteInput): ReactRoute;
+/** Build only serializable metadata; the Worker never imports a browser component module. */
+export declare function reactFrontend<const S extends schema.DomainSchema>(input: ReactFrontendInput<S>): ReactFrontendArtifact<S>;
+//# sourceMappingURL=define.d.ts.map

package/dist/react/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../src/react/define.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAA;AAGvD,OAAO,KAAK,EACV,qBAAqB,EACrB,kBAAkB,EAClB,UAAU,EACV,eAAe,EACf,eAAe,EAChB,MAAM,iBAAiB,CAAA;AAKxB,8FAA8F;AAC9F,wBAAgB,SAAS,CAAC,KAAK,EAAE,eAAe,GAAG,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAGrF;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,UAAU,CAO7D;AAED,6FAA6F;AAC7F,wBAAgB,aAAa,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,YAAY,EAC/D,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC3B,qBAAqB,CAAC,CAAC,CAAC,CA6C1B"}

package/dist/react/define.js

@@ -0,0 +1,89 @@
+import { captureFrontendArtifact } from '../view/admission.js';
+import { frontendArtifact, frontendRoute, viteFrontend } from '../view/index.js';
+/** Retain a component as a normalized browser module coordinate, never as a Worker import. */
+export function reactView(input) {
+    exact(record(input, 'React View source'), ['module', 'export']);
+    return Object.freeze({ module: browserModule(input.module), export: exportName(input.export) });
+}
+export function reactRoute(input) {
+    exact(record(input, 'React route'), ['path', 'href', 'document', 'handshake', 'component']);
+    const { component, ...route } = input;
+    return Object.freeze({
+        ...frontendRoute(route),
+        component: reactView(component),
+    });
+}
+/** Build only serializable metadata; the Worker never imports a browser component module. */
+export function reactFrontend(input) {
+    exact(record(input, 'React frontend'), ['schema', 'schemaModule', 'routes', 'entrypoint']);
+    const routeInputs = Object.freeze(Object.fromEntries(Object.entries(input.routes).map(([name, route]) => [
+        name,
+        reactRoute(route),
+    ])));
+    const neutralRouteInputs = Object.fromEntries(Object.entries(routeInputs).map(([name, route]) => [
+        name,
+        Object.freeze({
+            ...(route.path === undefined ? {} : { path: route.path }),
+            ...(route.href === undefined ? {} : { href: route.href }),
+            document: route.document,
+            handshake: route.handshake,
+        }),
+    ]));
+    const artifact = frontendArtifact({
+        schema: input.schema,
+        source: viteFrontend({ root: './views/app' }),
+        routes: neutralRouteInputs,
+        entrypoint: input.entrypoint,
+    });
+    const neutralRoutes = artifact.routes;
+    const routes = Object.fromEntries(Object.entries(neutralRoutes).map(([name, route]) => [
+        name,
+        Object.freeze({
+            ...route,
+            component: reactView(routeInputs[name].component),
+        }),
+    ]));
+    return captureFrontendArtifact(Object.freeze({
+        ...artifact,
+        framework: 'react',
+        schemaModule: reactView(input.schemaModule),
+        routes: Object.freeze(routes),
+    }));
+}
+function browserModule(input) {
+    const relative = typeof input === 'string' && input.startsWith('./') ? input.slice(2) : input;
+    if (typeof input !== 'string' ||
+        input.trim() !== input ||
+        input.length === 0 ||
+        input.startsWith('/') ||
+        input.includes('\\') ||
+        input.includes('?') ||
+        input.includes('#') ||
+        input.includes(':') ||
+        relative.length === 0 ||
+        relative.split('/').some((segment) => segment === '' || segment === '.' || segment === '..') ||
+        !/\.[cm]?[jt]sx?$/u.test(relative)) {
+        throw new TypeError('React View module must be a contained project-relative JS/TS module.');
+    }
+    return `./${relative}`;
+}
+function exportName(input) {
+    const name = input ?? 'default';
+    if (!/^[$A-Z_a-z][$\w]*$/u.test(name)) {
+        throw new TypeError('React View export must be a JavaScript identifier.');
+    }
+    return name;
+}
+function record(input, label) {
+    if (input === null || typeof input !== 'object' || Array.isArray(input)) {
+        throw new TypeError(`${label} must be an object.`);
+    }
+    return input;
+}
+function exact(input, allowed) {
+    const keys = new Set(allowed);
+    const extra = Reflect.ownKeys(input).find((key) => !keys.has(key));
+    if (extra !== undefined)
+        throw new TypeError(`Unsupported React field ${String(extra)}.`);
+}
+//# sourceMappingURL=define.js.map

package/dist/react/define.js.map

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