@cosmicdrift/kumiko-framework 0.388.0 → 0.390.0

package/dist/engine/feature-ast/extractors/jobs-routes.js

@@ -1,145 +0,0 @@
-import { SyntaxKind } from "ts-morph";
-import { sourceLocationFromNode } from "../source-location.js";
-import { fail, findFunctionLiteral, isPlainObject, ok, readBooleanProperty, readDataLiteralNode, readNameLiteral, readPropertyKey, } from "./shared.js";
-export function isHttpRouteMethod(value) {
-    return (value === "GET" ||
-        value === "POST" ||
-        value === "PUT" ||
-        value === "PATCH" ||
-        value === "DELETE" ||
-        value === "HEAD" ||
-        value === "OPTIONS");
-}
-export function extractJob(call, sourceFile) {
-    const args = call.getArguments();
-    const first = args[0];
-    if (!first) {
-        return fail("job", sourceLocationFromNode(call, sourceFile), "expected at least one argument");
-    }
-    const obj = first.asKind(SyntaxKind.ObjectLiteralExpression);
-    if (obj && args.length === 1) {
-        const nameInit = obj
-            .getProperty("name")
-            ?.asKind(SyntaxKind.PropertyAssignment)
-            ?.getInitializer()
-            ?.asKind(SyntaxKind.StringLiteral);
-        if (!nameInit) {
-            return fail("job", sourceLocationFromNode(call, sourceFile), "object form requires a string-literal `name` property");
-        }
-        const handlerInit = obj
-            .getProperty("handler")
-            ?.asKind(SyntaxKind.PropertyAssignment)
-            ?.getInitializer();
-        if (!handlerInit) {
-            return fail("job", sourceLocationFromNode(call, sourceFile), "object form requires a `handler` property");
-        }
-        const fn = findFunctionLiteral(handlerInit);
-        if (!fn) {
-            return fail("job", sourceLocationFromNode(call, sourceFile), "handler must be an inline arrow function or function expression");
-        }
-        const optionsBag = {};
-        for (const prop of obj.getProperties()) {
-            const propAssign = prop.asKind(SyntaxKind.PropertyAssignment);
-            if (!propAssign)
-                continue;
-            const key = readPropertyKey(propAssign);
-            if (key === "name" || key === "handler")
-                continue;
-            const init = propAssign.getInitializer();
-            if (!init)
-                continue;
-            const value = readDataLiteralNode(init);
-            if (value === undefined) {
-                return fail("job", sourceLocationFromNode(call, sourceFile), `option "${key}" could not be read as a plain value`);
-            }
-            optionsBag[key] = value;
-        }
-        return ok({
-            kind: "job",
-            source: sourceLocationFromNode(call, sourceFile),
-            jobName: nameInit.getLiteralValue(),
-            options: optionsBag,
-            handlerBody: sourceLocationFromNode(fn, sourceFile),
-        });
-    }
-    const jobName = readNameLiteral(first);
-    if (jobName === undefined) {
-        return fail("job", sourceLocationFromNode(call, sourceFile), "first argument must be a string literal job name, or an identifier resolving to one (or use the object form)");
-    }
-    const optionsArg = args[1];
-    if (!optionsArg) {
-        return fail("job", sourceLocationFromNode(call, sourceFile), "expected an options object as second argument");
-    }
-    const options = readDataLiteralNode(optionsArg);
-    if (!isPlainObject(options)) {
-        return fail("job", sourceLocationFromNode(call, sourceFile), "options could not be read as a plain object");
-    }
-    const handlerArg = args[2];
-    if (!handlerArg) {
-        return fail("job", sourceLocationFromNode(call, sourceFile), "expected a handler function as third argument");
-    }
-    const fn = findFunctionLiteral(handlerArg);
-    if (!fn) {
-        return fail("job", sourceLocationFromNode(call, sourceFile), "third argument must be an inline arrow function or function expression");
-    }
-    return ok({
-        kind: "job",
-        source: sourceLocationFromNode(call, sourceFile),
-        jobName,
-        options: options,
-        handlerBody: sourceLocationFromNode(fn, sourceFile),
-    });
-}
-export function extractHttpRoute(call, sourceFile) {
-    const arg = call.getArguments()[0]?.asKind(SyntaxKind.ObjectLiteralExpression);
-    if (!arg) {
-        return fail("httpRoute", sourceLocationFromNode(call, sourceFile), "argument must be an inline HttpRouteDefinition object");
-    }
-    const methodLiteral = arg
-        .getProperty("method")
-        ?.asKind(SyntaxKind.PropertyAssignment)
-        ?.getInitializer()
-        ?.asKind(SyntaxKind.StringLiteral);
-    if (!methodLiteral) {
-        return fail("httpRoute", sourceLocationFromNode(call, sourceFile), "method must be a string literal");
-    }
-    const methodValue = methodLiteral.getLiteralValue();
-    if (!isHttpRouteMethod(methodValue)) {
-        return fail("httpRoute", sourceLocationFromNode(call, sourceFile), `method must be one of GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS (got "${methodValue}")`);
-    }
-    const pathLiteral = arg
-        .getProperty("path")
-        ?.asKind(SyntaxKind.PropertyAssignment)
-        ?.getInitializer()
-        ?.asKind(SyntaxKind.StringLiteral);
-    if (!pathLiteral) {
-        return fail("httpRoute", sourceLocationFromNode(call, sourceFile), "path must be a string literal");
-    }
-    const handlerInit = arg
-        .getProperty("handler")
-        ?.asKind(SyntaxKind.PropertyAssignment)
-        ?.getInitializer();
-    if (!handlerInit) {
-        return fail("httpRoute", sourceLocationFromNode(call, sourceFile), "missing `handler` property");
-    }
-    const fn = findFunctionLiteral(handlerInit);
-    if (!fn) {
-        return fail("httpRoute", sourceLocationFromNode(call, sourceFile), "handler must be an inline arrow function or function expression");
-    }
-    // Missing `anonymous` reads as false (the safe side — mounted
-    // behind the session auth chain, not public) so a source file that predates
-    // the required field still parses instead of erroring here.
-    const anonymousValue = readBooleanProperty(arg, "anonymous");
-    if (anonymousValue === undefined && arg.getProperty("anonymous") !== undefined) {
-        return fail("httpRoute", sourceLocationFromNode(call, sourceFile), "anonymous must be a boolean literal — a non-literal value would be rewritten to a literal on round-trip");
-    }
-    const anonymous = anonymousValue === true;
-    return ok({
-        kind: "httpRoute",
-        source: sourceLocationFromNode(call, sourceFile),
-        method: methodValue,
-        path: pathLiteral.getLiteralValue(),
-        handlerBody: sourceLocationFromNode(fn, sourceFile),
-        anonymous,
-    });
-}

package/dist/engine/feature-ast/extractors/projections-screens.d.ts

@@ -1,10 +0,0 @@
-import type { CallExpression, Node, SourceFile } from "ts-morph";
-import type { MultiStreamProjectionPattern, ProjectionPattern, ScreenPattern } from "../patterns.ts";
-import type { SourceLocation } from "../source-location.ts";
-import { type ExtractOutput } from "./shared.ts";
-export declare function readApplyBodies(defObj: ReturnType<Node["asKind"]>, sourceFile: SourceFile): Record<string, SourceLocation> | undefined;
-export declare function extractProjection(call: CallExpression, sourceFile: SourceFile): ExtractOutput<ProjectionPattern>;
-export declare function extractMultiStreamProjection(call: CallExpression, sourceFile: SourceFile): ExtractOutput<MultiStreamProjectionPattern>;
-export declare function collectScreenOpaqueProps(node: Node, path: string, sourceFile: SourceFile, out: Record<string, SourceLocation>): void;
-export declare function readScreenStatic(node: Node): unknown;
-export declare function extractScreen(call: CallExpression, sourceFile: SourceFile): ExtractOutput<ScreenPattern>;

package/dist/engine/feature-ast/extractors/projections-screens.js

@@ -1,195 +0,0 @@
-import { SyntaxKind } from "ts-morph";
-import { SCREEN_OPAQUE_MARKER } from "../patterns.js";
-import { sourceLocationFromNode } from "../source-location.js";
-import { fail, findFunctionLiteral, isPlainObject, isRawRefSentinel, ok, readDataLiteralNode, readNameOrRefOrList, readPropertyKey, } from "./shared.js";
-export function readApplyBodies(defObj, sourceFile) {
-    if (!defObj)
-        return undefined;
-    const obj = defObj.asKind?.(SyntaxKind.ObjectLiteralExpression);
-    if (!obj)
-        return undefined;
-    const applyObj = obj
-        .getProperty("apply")
-        ?.asKind(SyntaxKind.PropertyAssignment)
-        ?.getInitializer()
-        ?.asKind(SyntaxKind.ObjectLiteralExpression);
-    if (!applyObj)
-        return undefined;
-    const out = {};
-    for (const prop of applyObj.getProperties()) {
-        const propAssign = prop.asKind(SyntaxKind.PropertyAssignment);
-        if (!propAssign)
-            return undefined;
-        const init = propAssign.getInitializer();
-        if (!init)
-            return undefined;
-        const fn = findFunctionLiteral(init);
-        if (!fn)
-            return undefined;
-        out[readPropertyKey(propAssign)] = sourceLocationFromNode(fn, sourceFile);
-    }
-    return out;
-}
-export function extractProjection(call, sourceFile) {
-    const arg = call.getArguments()[0]?.asKind(SyntaxKind.ObjectLiteralExpression);
-    if (!arg) {
-        return fail("projection", sourceLocationFromNode(call, sourceFile), "argument must be an inline ProjectionDefinition object");
-    }
-    const nameLit = arg
-        .getProperty("name")
-        ?.asKind(SyntaxKind.PropertyAssignment)
-        ?.getInitializer()
-        ?.asKind(SyntaxKind.StringLiteral);
-    if (!nameLit) {
-        return fail("projection", sourceLocationFromNode(call, sourceFile), "name must be a string literal");
-    }
-    const sourceInit = arg
-        .getProperty("source")
-        ?.asKind(SyntaxKind.PropertyAssignment)
-        ?.getInitializer();
-    if (!sourceInit) {
-        return fail("projection", sourceLocationFromNode(call, sourceFile), "missing `source` property");
-    }
-    const sourceEntity = readNameOrRefOrList(sourceInit);
-    if (!sourceEntity) {
-        return fail("projection", sourceLocationFromNode(call, sourceFile), "source must be a string literal or array of string literals");
-    }
-    const applyBodies = readApplyBodies(arg, sourceFile);
-    if (!applyBodies) {
-        return fail("projection", sourceLocationFromNode(call, sourceFile), "apply must be an inline object map of event-type → function");
-    }
-    return ok({
-        kind: "projection",
-        source: sourceLocationFromNode(call, sourceFile),
-        name: nameLit.getLiteralValue(),
-        sourceEntity,
-        applyBodies,
-    });
-}
-export function extractMultiStreamProjection(call, sourceFile) {
-    const arg = call.getArguments()[0]?.asKind(SyntaxKind.ObjectLiteralExpression);
-    if (!arg) {
-        return fail("multiStreamProjection", sourceLocationFromNode(call, sourceFile), "argument must be an inline MultiStreamProjectionDefinition object");
-    }
-    const nameLit = arg
-        .getProperty("name")
-        ?.asKind(SyntaxKind.PropertyAssignment)
-        ?.getInitializer()
-        ?.asKind(SyntaxKind.StringLiteral);
-    if (!nameLit) {
-        return fail("multiStreamProjection", sourceLocationFromNode(call, sourceFile), "name must be a string literal");
-    }
-    const applyBodies = readApplyBodies(arg, sourceFile);
-    if (!applyBodies) {
-        return fail("multiStreamProjection", sourceLocationFromNode(call, sourceFile), "apply must be an inline object map of event-type → function");
-    }
-    const errorModeInit = arg
-        .getProperty("errorMode")
-        ?.asKind(SyntaxKind.PropertyAssignment)
-        ?.getInitializer();
-    const errorMode = errorModeInit ? readDataLiteralNode(errorModeInit) : undefined;
-    const runInLit = arg
-        .getProperty("runIn")
-        ?.asKind(SyntaxKind.PropertyAssignment)
-        ?.getInitializer()
-        ?.asKind(SyntaxKind.StringLiteral);
-    const runIn = runInLit ? runInLit.getLiteralValue() : undefined;
-    const deliveryLit = arg
-        .getProperty("delivery")
-        ?.asKind(SyntaxKind.PropertyAssignment)
-        ?.getInitializer()
-        ?.asKind(SyntaxKind.StringLiteral);
-    const delivery = deliveryLit
-        ? deliveryLit.getLiteralValue()
-        : undefined;
-    return ok({
-        kind: "multiStreamProjection",
-        source: sourceLocationFromNode(call, sourceFile),
-        name: nameLit.getLiteralValue(),
-        applyBodies,
-        ...(isPlainObject(errorMode) && { errorMode: errorMode }),
-        ...(runIn !== undefined && { runIn }),
-        ...(delivery !== undefined && { delivery }),
-    });
-}
-export function collectScreenOpaqueProps(node, path, sourceFile, out) {
-    const fn = findFunctionLiteral(node);
-    if (fn) {
-        out[path] = sourceLocationFromNode(fn, sourceFile);
-    }
-    else if (node.isKind(SyntaxKind.ObjectLiteralExpression)) {
-        for (const prop of node.getProperties()) {
-            const propAssign = prop.asKind(SyntaxKind.PropertyAssignment);
-            if (!propAssign)
-                continue;
-            const init = propAssign.getInitializer();
-            if (!init)
-                continue;
-            const key = readPropertyKey(propAssign);
-            const childPath = path ? `${path}.${key}` : key;
-            collectScreenOpaqueProps(init, childPath, sourceFile, out);
-        }
-    }
-    else if (node.isKind(SyntaxKind.ArrayLiteralExpression)) {
-        node.getElements().forEach((el, idx) => {
-            collectScreenOpaqueProps(el, `${path}.${idx}`, sourceFile, out);
-        });
-    }
-}
-export function readScreenStatic(node) {
-    if (findFunctionLiteral(node))
-        return SCREEN_OPAQUE_MARKER;
-    const obj = node.asKind(SyntaxKind.ObjectLiteralExpression);
-    if (obj) {
-        const out = {};
-        for (const prop of obj.getProperties()) {
-            const propAssign = prop.asKind(SyntaxKind.PropertyAssignment);
-            if (!propAssign)
-                continue;
-            const init = propAssign.getInitializer();
-            if (!init)
-                continue;
-            out[readPropertyKey(propAssign)] = readScreenStatic(init);
-        }
-        return out;
-    }
-    const arr = node.asKind(SyntaxKind.ArrayLiteralExpression);
-    if (arr) {
-        return arr.getElements().map(readScreenStatic);
-    }
-    const value = readDataLiteralNode(node);
-    if (value === undefined)
-        return SCREEN_OPAQUE_MARKER;
-    return value;
-}
-export function extractScreen(call, sourceFile) {
-    const arg = call.getArguments()[0];
-    if (!arg) {
-        return fail("screen", sourceLocationFromNode(call, sourceFile), "expected a ScreenDefinition object as first argument");
-    }
-    const obj = arg.asKind(SyntaxKind.ObjectLiteralExpression);
-    if (!obj) {
-        const raw = readDataLiteralNode(arg);
-        if (!isRawRefSentinel(raw)) {
-            return fail("screen", sourceLocationFromNode(call, sourceFile), "argument must be an inline object literal");
-        }
-        return ok({
-            kind: "screen",
-            source: sourceLocationFromNode(call, sourceFile),
-            definition: raw,
-            opaqueProps: {},
-        });
-    }
-    const opaqueProps = {};
-    collectScreenOpaqueProps(obj, "", sourceFile, opaqueProps);
-    const definition = readScreenStatic(obj);
-    if (!isPlainObject(definition)) {
-        return fail("screen", sourceLocationFromNode(call, sourceFile), "definition could not be read structurally");
-    }
-    return ok({
-        kind: "screen",
-        source: sourceLocationFromNode(call, sourceFile),
-        definition: definition,
-        opaqueProps: opaqueProps,
-    });
-}

package/dist/engine/feature-ast/extractors/resolve-import.d.ts

@@ -1,21 +0,0 @@
-import type { SourceFile, VariableDeclaration } from "ts-morph";
-import { Node } from "ts-morph";
-export declare function resolveModuleFile(fromFile: SourceFile, specifier: string, { allowDeclarationFiles }?: {
-    readonly allowDeclarationFiles?: boolean;
-}): SourceFile | undefined;
-export declare function findImportBindingForLocalName(sourceFile: SourceFile, localName: string): {
-    readonly moduleSpecifier: string;
-    readonly importedName: string;
-} | undefined;
-/**
- * `visited` keys on `${filePath}#${name}`, not path alone — aliasing can
- * legally re-export a different name from the same file — and doubles as
- * the cycle guard; `depth` backstops pathological non-cyclic chains.
- */
-export declare function resolveExportedVariable(file: SourceFile, exportedName: string, visited?: Set<string>, depth?: number): VariableDeclaration | undefined;
-/**
- * Any binding of the same name that is not a plain `const NAME = <init>`
- * (parameter, destructuring, loop variable, catch variable) shadows and ends
- * the search — it has no statically readable initializer.
- */
-export declare function findScopedVariableDeclaration(identifier: Node, name: string): VariableDeclaration | undefined;

package/dist/engine/feature-ast/extractors/resolve-import.js

@@ -1,180 +0,0 @@
-import { Node, SyntaxKind, ts } from "ts-morph";
-const MODULE_RESOLUTION_OPTIONS = {
-    moduleResolution: ts.ModuleResolutionKind.Bundler,
-    module: ts.ModuleKind.ESNext,
-    target: ts.ScriptTarget.ESNext,
-};
-const MAX_RESOLUTION_DEPTH = 24;
-const DECLARATION_FILES_OK = { allowDeclarationFiles: true };
-export function resolveModuleFile(fromFile, specifier, { allowDeclarationFiles = false } = {}) {
-    const project = fromFile.getProject();
-    // The project's own host, not ts.sys: it honours an in-memory file system
-    // (Designer) and exists outside Node.
-    const resolved = ts.resolveModuleName(specifier, fromFile.getFilePath(), MODULE_RESOLUTION_OPTIONS, project.getModuleResolutionHost());
-    const resolvedFileName = resolved.resolvedModule?.resolvedFileName;
-    if (!resolvedFileName)
-        return undefined;
-    // A declaration file has no initializers to read. Callers that only need
-    // `export declare const X: "literal"` types opt in (installed packages
-    // resolve to dist/*.d.ts through their publishConfig exports).
-    if (!allowDeclarationFiles && resolvedFileName.endsWith(".d.ts"))
-        return undefined;
-    return fromFile.getProject().addSourceFileAtPathIfExists(resolvedFileName);
-}
-export function findImportBindingForLocalName(sourceFile, localName) {
-    for (const importDecl of sourceFile.getImportDeclarations()) {
-        const named = importDecl
-            .getNamedImports()
-            .find((ni) => (ni.getAliasNode()?.getText() ?? ni.getName()) === localName);
-        if (!named)
-            continue;
-        return {
-            moduleSpecifier: importDecl.getModuleSpecifierValue(),
-            importedName: named.getName(),
-        };
-    }
-    return undefined;
-}
-/**
- * `visited` keys on `${filePath}#${name}`, not path alone — aliasing can
- * legally re-export a different name from the same file — and doubles as
- * the cycle guard; `depth` backstops pathological non-cyclic chains.
- */
-export function resolveExportedVariable(file, exportedName, visited = new Set(), depth = 0) {
-    if (depth > MAX_RESOLUTION_DEPTH)
-        return undefined;
-    const key = `${file.getFilePath()}#${exportedName}`;
-    if (visited.has(key))
-        return undefined;
-    visited.add(key);
-    const directDecl = file.getVariableDeclaration(exportedName);
-    if (directDecl?.getVariableStatement()?.hasExportKeyword())
-        return directDecl;
-    const namedExportMatch = resolveViaNamedExportSpecifier(file, exportedName, visited, depth);
-    if (namedExportMatch)
-        return namedExportMatch;
-    return resolveViaStarExport(file, exportedName, visited, depth);
-}
-function resolveViaNamedExportSpecifier(file, exportedName, visited, depth) {
-    for (const exportDecl of file.getExportDeclarations()) {
-        const specifier = exportDecl
-            .getNamedExports()
-            .find((spec) => (spec.getAliasNode()?.getText() ?? spec.getName()) === exportedName);
-        if (!specifier)
-            continue;
-        const originalName = specifier.getName();
-        if (!exportDecl.hasModuleSpecifier()) {
-            const resolved = resolveLocalExportBinding(file, originalName, visited, depth);
-            if (resolved)
-                return resolved;
-            continue;
-        }
-        const moduleSpecifierValue = exportDecl.getModuleSpecifierValue();
-        if (!moduleSpecifierValue)
-            continue;
-        const target = resolveModuleFile(file, moduleSpecifierValue, DECLARATION_FILES_OK);
-        if (!target)
-            continue;
-        const resolved = resolveExportedVariable(target, originalName, visited, depth + 1);
-        if (resolved)
-            return resolved;
-    }
-    return undefined;
-}
-function resolveLocalExportBinding(file, originalName, visited, depth) {
-    const localDecl = file.getVariableDeclaration(originalName);
-    if (localDecl)
-        return localDecl;
-    const binding = findImportBindingForLocalName(file, originalName);
-    if (!binding)
-        return undefined;
-    const target = resolveModuleFile(file, binding.moduleSpecifier, DECLARATION_FILES_OK);
-    if (!target)
-        return undefined;
-    return resolveExportedVariable(target, binding.importedName, visited, depth + 1);
-}
-function resolveViaStarExport(file, exportedName, visited, depth) {
-    for (const exportDecl of file.getExportDeclarations()) {
-        if (!exportDecl.hasModuleSpecifier())
-            continue;
-        if (exportDecl.getNamedExports().length > 0)
-            continue;
-        if (exportDecl.getNamespaceExport())
-            continue; // `export * as ns from "./m"` is not a re-export target.
-        const moduleSpecifierValue = exportDecl.getModuleSpecifierValue();
-        if (!moduleSpecifierValue)
-            continue;
-        const target = resolveModuleFile(file, moduleSpecifierValue, DECLARATION_FILES_OK);
-        if (!target)
-            continue;
-        const resolved = resolveExportedVariable(target, exportedName, visited, depth + 1);
-        if (resolved)
-            return resolved;
-    }
-    return undefined;
-}
-/**
- * Any binding of the same name that is not a plain `const NAME = <init>`
- * (parameter, destructuring, loop variable, catch variable) shadows and ends
- * the search — it has no statically readable initializer.
- */
-export function findScopedVariableDeclaration(identifier, name) {
-    for (const ancestor of [identifier, ...identifier.getAncestors()]) {
-        if (declaresShadowingBinding(ancestor, name))
-            return undefined;
-        const statements = getDirectStatements(ancestor);
-        if (!statements)
-            continue;
-        for (const stmt of statements) {
-            const varStmt = stmt.asKind(SyntaxKind.VariableStatement);
-            if (!varStmt)
-                continue;
-            for (const decl of varStmt.getDeclarationList().getDeclarations()) {
-                const nameNode = decl.getNameNode();
-                if (Node.isIdentifier(nameNode)) {
-                    if (nameNode.getText() === name)
-                        return decl;
-                }
-                else if (bindingNames(nameNode).includes(name)) {
-                    return undefined;
-                }
-            }
-        }
-    }
-    return undefined;
-}
-function bindingNames(nameNode) {
-    if (Node.isIdentifier(nameNode))
-        return [nameNode.getText()];
-    if (Node.isObjectBindingPattern(nameNode) || Node.isArrayBindingPattern(nameNode)) {
-        return nameNode
-            .getElements()
-            .flatMap((element) => Node.isBindingElement(element) ? bindingNames(element.getNameNode()) : []);
-    }
-    return [];
-}
-function declaresShadowingBinding(node, name) {
-    if (Node.isParametered(node)) {
-        return node.getParameters().some((p) => bindingNames(p.getNameNode()).includes(name));
-    }
-    if (Node.isForOfStatement(node) || Node.isForInStatement(node) || Node.isForStatement(node)) {
-        const initializer = node.getInitializer();
-        return (initializer !== undefined &&
-            Node.isVariableDeclarationList(initializer) &&
-            initializer.getDeclarations().some((decl) => bindingNames(decl.getNameNode()).includes(name)));
-    }
-    if (Node.isCatchClause(node)) {
-        const decl = node.getVariableDeclaration();
-        return decl !== undefined && bindingNames(decl.getNameNode()).includes(name);
-    }
-    return false;
-}
-function getDirectStatements(node) {
-    const block = node.asKind(SyntaxKind.Block);
-    if (block)
-        return block.getStatements();
-    const sourceFile = node.asKind(SyntaxKind.SourceFile);
-    if (sourceFile)
-        return sourceFile.getStatements();
-    return undefined;
-}

package/dist/engine/feature-ast/extractors/round1.d.ts

@@ -1,10 +0,0 @@
-import type { CallExpression, SourceFile } from "ts-morph";
-import type { DescribePattern, OptionalRequiresPattern, ReadsConfigPattern, RequiresPattern, SystemScopePattern, ToggleablePattern, UiHintsPattern } from "../patterns.ts";
-import { type ExtractOutput } from "./shared.ts";
-export declare function extractRequires(call: CallExpression, sourceFile: SourceFile): ExtractOutput<RequiresPattern>;
-export declare function extractOptionalRequires(call: CallExpression, sourceFile: SourceFile): ExtractOutput<OptionalRequiresPattern>;
-export declare function extractReadsConfig(call: CallExpression, sourceFile: SourceFile): ExtractOutput<ReadsConfigPattern>;
-export declare function extractSystemScope(call: CallExpression, sourceFile: SourceFile): ExtractOutput<SystemScopePattern>;
-export declare function extractUiHints(call: CallExpression, sourceFile: SourceFile): ExtractOutput<UiHintsPattern>;
-export declare function extractDescribe(call: CallExpression, sourceFile: SourceFile): ExtractOutput<DescribePattern>;
-export declare function extractToggleable(call: CallExpression, sourceFile: SourceFile): ExtractOutput<ToggleablePattern>;

package/dist/engine/feature-ast/extractors/round1.js

@@ -1,81 +0,0 @@
-import { sourceLocationFromNode } from "../source-location.js";
-import { fail, ok, readBooleanProperty, readStringLiteralArgs, readVarargsOrArrayProp, } from "./shared.js";
-export function extractRequires(call, sourceFile) {
-    const names = readVarargsOrArrayProp(call, "features");
-    if (!names) {
-        return fail("requires", sourceLocationFromNode(call, sourceFile), "expected positional string literals or { features: string[] }");
-    }
-    return ok({
-        kind: "requires",
-        source: sourceLocationFromNode(call, sourceFile),
-        featureNames: names,
-    });
-}
-export function extractOptionalRequires(call, sourceFile) {
-    const names = readVarargsOrArrayProp(call, "features");
-    if (!names) {
-        return fail("optionalRequires", sourceLocationFromNode(call, sourceFile), "expected positional string literals or { features: string[] }");
-    }
-    return ok({
-        kind: "optionalRequires",
-        source: sourceLocationFromNode(call, sourceFile),
-        featureNames: names,
-    });
-}
-export function extractReadsConfig(call, sourceFile) {
-    const keys = readVarargsOrArrayProp(call, "keys");
-    if (!keys) {
-        return fail("readsConfig", sourceLocationFromNode(call, sourceFile), "expected positional string literals or { keys: string[] }");
-    }
-    return ok({
-        kind: "readsConfig",
-        source: sourceLocationFromNode(call, sourceFile),
-        qualifiedKeys: keys,
-    });
-}
-export function extractSystemScope(call, sourceFile) {
-    return ok({
-        kind: "systemScope",
-        source: sourceLocationFromNode(call, sourceFile),
-    });
-}
-export function extractUiHints(call, sourceFile) {
-    return ok({
-        kind: "uiHints",
-        source: sourceLocationFromNode(call, sourceFile),
-    });
-}
-export function extractDescribe(call, sourceFile) {
-    const args = readStringLiteralArgs(call);
-    const text = args?.[0];
-    if (text === undefined || args?.length !== 1) {
-        return fail("describe", sourceLocationFromNode(call, sourceFile), "expected a single string literal");
-    }
-    // Mirrors the define-feature boot guard: whitespace-only describes throw
-    // at boot — the AST path must reject them too, and store the TRIMMED
-    // text so render output matches the runtime/manifest value.
-    const trimmed = text.trim();
-    if (trimmed.length === 0) {
-        return fail("describe", sourceLocationFromNode(call, sourceFile), "must be a non-empty string");
-    }
-    return ok({
-        kind: "describe",
-        source: sourceLocationFromNode(call, sourceFile),
-        text: trimmed,
-    });
-}
-export function extractToggleable(call, sourceFile) {
-    const arg = call.getArguments()[0];
-    if (!arg) {
-        return fail("toggleable", sourceLocationFromNode(call, sourceFile), "expected an object argument with a `default` boolean");
-    }
-    const defaultValue = readBooleanProperty(arg, "default");
-    if (defaultValue === undefined) {
-        return fail("toggleable", sourceLocationFromNode(call, sourceFile), "argument must be `{ default: true | false }`");
-    }
-    return ok({
-        kind: "toggleable",
-        source: sourceLocationFromNode(call, sourceFile),
-        default: defaultValue,
-    });
-}

package/dist/engine/feature-ast/extractors/round2.d.ts

@@ -1,7 +0,0 @@
-import type { CallExpression, SourceFile } from "ts-morph";
-import type { EntityPattern, NavPattern, RelationPattern, WorkspacePattern } from "../patterns.ts";
-import { type ExtractOutput } from "./shared.ts";
-export declare function extractEntity(call: CallExpression, sourceFile: SourceFile): ExtractOutput<EntityPattern>;
-export declare function extractRelation(call: CallExpression, sourceFile: SourceFile): ExtractOutput<RelationPattern>;
-export declare function extractNav(call: CallExpression, sourceFile: SourceFile): ExtractOutput<NavPattern>;
-export declare function extractWorkspace(call: CallExpression, sourceFile: SourceFile): ExtractOutput<WorkspacePattern>;