glirastes 0.3.2 → 0.5.0

package/dist/codegen/tools/sources/route-config.js

@@ -0,0 +1,427 @@
+import { dirname, join } from 'node:path';
+import ts from 'typescript';
+import { compareCodeUnits } from '../canonical.js';
+import { toolFinding } from '../findings.js';
+import { createAppProgram } from '../program.js';
+import { scanAppSources } from './app-files.js';
+import { pageStableKey, pathExclusion } from './page-tree.js';
+import { importBindings, importedName } from './ui-tools.js';
+import { observeNavigation } from './next-pages.js';
+const JSX_ROUTES = ['Route', 'Routes', 'createRoutesFromElements', 'createRoutesFromChildren'];
+const REACT_ROUTER = {
+    kind: 'react-router',
+    specs: ['react-router', 'react-router-dom'].map((module) => ({
+        module, names: ['createBrowserRouter', 'createHashRouter', 'createMemoryRouter', 'useRoutes', ...JSX_ROUTES],
+    })),
+    calls: ['createBrowserRouter', 'createHashRouter', 'createMemoryRouter', 'useRoutes'],
+    routesIn: 'argument',
+    components: ['Component', 'element'],
+    lazy: ['lazy'],
+    marker: /['"]react-router(?:-dom)?['"]/,
+    unresolved: 'wrapped element, inline component or unresolvable lazy module',
+};
+const VUE_ROUTER = {
+    kind: 'vue-router',
+    specs: [{ module: 'vue-router', names: ['createRouter'] }],
+    calls: ['createRouter'],
+    routesIn: 'routes-property',
+    components: ['component', 'components'],
+    lazy: [],
+    marker: /['"]vue-router['"]/,
+    unresolved: 'inline component, named views without a default view or an unresolvable import',
+};
+const DIALECTS = { 'react-router': REACT_ROUTER, 'vue-router': VUE_ROUTER };
+const MAX_ROUTES = 5_000;
+const MAX_DEPTH = 32;
+function unwrap(node) {
+    let current = node;
+    while (ts.isParenthesizedExpression(current) || ts.isAsExpression(current) || ts.isSatisfiesExpression(current)) {
+        current = current.expression;
+    }
+    return current;
+}
+function propertyName(name) {
+    return ts.isIdentifier(name) || ts.isStringLiteral(name) ? name.text : undefined;
+}
+/** An array literal, directly or through a `const` binding. */
+function arrayOf(app, node) {
+    const value = unwrap(node);
+    if (ts.isArrayLiteralExpression(value))
+        return value;
+    if (!ts.isIdentifier(value))
+        return undefined;
+    return constArrayOf(app, app.checker.getSymbolAtLocation(value));
+}
+function constArrayOf(app, found) {
+    let symbol = found;
+    if (symbol && symbol.flags & ts.SymbolFlags.Alias)
+        symbol = app.checker.getAliasedSymbol(symbol);
+    const declaration = symbol?.declarations?.find(ts.isVariableDeclaration);
+    const list = declaration?.parent;
+    if (!declaration?.initializer || !list || !ts.isVariableDeclarationList(list) || !(list.flags & ts.NodeFlags.Const))
+        return undefined;
+    const initializer = unwrap(declaration.initializer);
+    return ts.isArrayLiteralExpression(initializer) ? initializer : undefined;
+}
+/** The `.vue` module an import specifier points to: through the program, else relative to the importing file. */
+function vueModuleOf(app, specifier) {
+    if (!ts.isStringLiteralLike(specifier) || !specifier.text.endsWith('.vue'))
+        return undefined;
+    const resolved = app.checker.getSymbolAtLocation(specifier)?.declarations?.find(ts.isSourceFile);
+    if (resolved)
+        return app.appRelative(resolved.fileName);
+    if (!specifier.text.startsWith('.'))
+        return undefined;
+    return app.appRelative(join(dirname(specifier.getSourceFile().fileName), specifier.text));
+}
+/** A single-file component: a default import of a `.vue` module, or `() => import('./X.vue')`. */
+function vueComponentOf(app, node) {
+    const value = unwrap(node);
+    if (ts.isIdentifier(value)) {
+        const declaration = app.checker.getSymbolAtLocation(value)?.declarations?.[0];
+        if (!declaration || !ts.isImportClause(declaration) || !ts.isImportDeclaration(declaration.parent))
+            return undefined;
+        const file = vueModuleOf(app, declaration.parent.moduleSpecifier);
+        return file ? { file, component: 'default' } : undefined;
+    }
+    let found;
+    const visit = (child) => {
+        if (found)
+            return;
+        if (ts.isCallExpression(child) && child.expression.kind === ts.SyntaxKind.ImportKeyword && child.arguments[0]) {
+            const file = vueModuleOf(app, child.arguments[0]);
+            if (file)
+                found = { file, component: 'default' };
+            return;
+        }
+        ts.forEachChild(child, visit);
+    };
+    visit(value);
+    return found;
+}
+/** `components: { default: TasksView, sidebar: … }`: the default view renders the page. */
+function namedViewsOf(app, node) {
+    const value = unwrap(node);
+    if (!ts.isObjectLiteralExpression(value))
+        return undefined;
+    for (const property of value.properties) {
+        if (ts.isPropertyAssignment(property) && propertyName(property.name) === 'default')
+            return componentOf(app, property.initializer);
+    }
+    return undefined;
+}
+/** The module and export name a component reference points to. */
+function componentOf(app, node) {
+    const vue = vueComponentOf(app, node);
+    if (vue)
+        return vue;
+    let target = unwrap(node);
+    if (ts.isJsxSelfClosingElement(target) || ts.isJsxElement(target)) {
+        const tag = ts.isJsxElement(target) ? target.openingElement.tagName : target.tagName;
+        target = tag;
+    }
+    if (!ts.isIdentifier(target))
+        return undefined;
+    let symbol = app.checker.getSymbolAtLocation(target);
+    if (symbol && symbol.flags & ts.SymbolFlags.Alias)
+        symbol = app.checker.getAliasedSymbol(symbol);
+    const declaration = symbol?.declarations?.[0];
+    const file = declaration ? app.appRelative(declaration.getSourceFile().fileName) : undefined;
+    if (!declaration || !file || !symbol)
+        return undefined;
+    const isDefault = ts.canHaveModifiers(declaration)
+        && (ts.getModifiers(declaration) ?? []).some((modifier) => modifier.kind === ts.SyntaxKind.DefaultKeyword);
+    return { file, component: isDefault ? 'default' : symbol.name };
+}
+/** `lazy: () => import('./TasksPage')`: the module, rendering its `Component` or default export. */
+function lazyComponentOf(app, node) {
+    let found;
+    const visit = (child) => {
+        if (found)
+            return;
+        if (ts.isCallExpression(child) && child.expression.kind === ts.SyntaxKind.ImportKeyword && child.arguments[0]) {
+            const moduleSymbol = app.checker.getSymbolAtLocation(child.arguments[0]);
+            const sourceFile = moduleSymbol?.declarations?.find(ts.isSourceFile);
+            const file = sourceFile ? app.appRelative(sourceFile.fileName) : undefined;
+            if (moduleSymbol && file) {
+                const names = new Set(app.checker.getExportsOfModule(moduleSymbol).map((symbol) => symbol.name));
+                const component = names.has('Component') ? 'Component' : names.has('default') ? 'default' : undefined;
+                if (component)
+                    found = { file, component };
+            }
+            return;
+        }
+        ts.forEachChild(child, visit);
+    };
+    visit(node);
+    return found;
+}
+function joinRoute(parent, own) {
+    const segments = (own.startsWith('/') ? own : `${parent}/${own}`).split('/').filter(Boolean);
+    return `/${segments.join('/')}`;
+}
+function shape(path) {
+    const params = [];
+    for (const segment of path.split('/').filter(Boolean)) {
+        if (segment === '*' || segment.startsWith('*'))
+            return { params, reason: 'catch-all-page' };
+        // vue-router: `:pathMatch(.*)*` matches every remaining path; other custom regexes and repeatables are not read.
+        if (/^:\w+\(\.\*\)\*$/.test(segment))
+            return { params, reason: 'catch-all-page' };
+        if (segment.startsWith(':') && (segment.includes('(') || /[*+]$/.test(segment)))
+            return { params, reason: 'unsupported-path' };
+        if (segment.endsWith('?'))
+            return { params, reason: 'optional-segment-page' };
+        if (segment.startsWith(':'))
+            params.push(segment.slice(1));
+    }
+    return { params };
+}
+function readRoutes(app, dialect, file, array, parent, depth, into) {
+    if (depth > MAX_DEPTH)
+        return `${file} nests routes deeper than ${MAX_DEPTH} levels.`;
+    for (const element of array.elements) {
+        const route = unwrap(element);
+        if (!ts.isObjectLiteralExpression(route))
+            return `${file} has a route that is not an object literal.`;
+        let path;
+        let index = false;
+        let component;
+        let children;
+        let rendersElsewhere = false;
+        let declaresRender = false;
+        for (const property of route.properties) {
+            if (ts.isSpreadAssignment(property))
+                return `${file} spreads a route object, so its routes cannot be enumerated.`;
+            if (!ts.isPropertyAssignment(property) && !ts.isShorthandPropertyAssignment(property))
+                continue;
+            const name = propertyName(property.name);
+            const value = ts.isPropertyAssignment(property) ? property.initializer : property.name;
+            if (name === 'path') {
+                const literal = unwrap(value);
+                if (!ts.isStringLiteral(literal) && !ts.isNoSubstitutionTemplateLiteral(literal)) {
+                    return `${file} has a route path that is not a string literal.`;
+                }
+                path = literal.text;
+            }
+            else if (name === 'index' && dialect.kind === 'react-router') {
+                index = value.kind === ts.SyntaxKind.TrueKeyword;
+            }
+            else if (name === 'children') {
+                children = arrayOf(app, value);
+                if (!children)
+                    return `${file} has route children that are not an array literal.`;
+            }
+            else if (name === 'alias' && dialect.kind === 'vue-router') {
+                return `${file} has a route alias; the generator reads one path per route.`;
+            }
+            else if (name === 'redirect' && dialect.kind === 'vue-router') {
+                // A redirect navigates elsewhere; its component, if any, never renders.
+                rendersElsewhere = true;
+            }
+            else if (name === 'components' && dialect.components.includes(name)) {
+                declaresRender = true;
+                component = namedViewsOf(app, value) ?? component;
+            }
+            else if (name && dialect.components.includes(name)) {
+                declaresRender = true;
+                component = componentOf(app, value) ?? component;
+                const element = unwrap(value);
+                if ((ts.isJsxSelfClosingElement(element) || ts.isJsxElement(element))
+                    && /^Navigate$/.test(ts.isJsxElement(element) ? element.openingElement.tagName.getText() : element.tagName.getText())) {
+                    rendersElsewhere = true;
+                }
+            }
+            else if (name && dialect.lazy.includes(name)) {
+                declaresRender = true;
+                component = lazyComponentOf(app, value) ?? component;
+            }
+        }
+        if (path !== undefined && !index && !component && !children && declaresRender && !rendersElsewhere) {
+            return `${file} has a route "${path}" whose component cannot be resolved (${dialect.unresolved}).`;
+        }
+        if (dialect.kind === 'vue-router' && rendersElsewhere)
+            component = undefined;
+        // vue-router: an empty child path renders at its parent's path, like a react-router index route.
+        if (dialect.kind === 'vue-router' && path === '' && depth > 0) {
+            path = undefined;
+            index = component !== undefined;
+        }
+        const full = path !== undefined ? joinRoute(parent, path) : parent;
+        if ((path !== undefined || index) && (component || index)) {
+            const { params, reason } = shape(full);
+            into.push({
+                path: full,
+                params,
+                file: component?.file ?? file,
+                ...(component ? { component: component.component } : {}),
+                ...(reason ? { reason } : {}),
+                index: index && path === undefined,
+            });
+            if (into.length > MAX_ROUTES)
+                return 'The app has too many routes to enumerate.';
+        }
+        if (children) {
+            const failure = readRoutes(app, dialect, file, children, full, depth + 1, into);
+            if (failure)
+                return failure;
+        }
+    }
+    return undefined;
+}
+/** The route array a router call receives. */
+function routesOf(app, dialect, call) {
+    const argument = call.arguments[0] ? unwrap(call.arguments[0]) : undefined;
+    if (!argument)
+        return undefined;
+    if (dialect.routesIn === 'argument')
+        return arrayOf(app, argument);
+    if (!ts.isObjectLiteralExpression(argument))
+        return undefined;
+    for (const property of argument.properties) {
+        if (ts.isPropertyAssignment(property) && propertyName(property.name) === 'routes')
+            return arrayOf(app, property.initializer);
+        if (ts.isShorthandPropertyAssignment(property) && property.name.text === 'routes') {
+            return constArrayOf(app, app.checker.getShorthandAssignmentValueSymbol(property));
+        }
+    }
+    return undefined;
+}
+function readFile(app, dialect, source) {
+    const file = app.appRelative(source.fileName) ?? source.fileName;
+    const bindings = importBindings(source, dialect.specs);
+    if (bindings.named.size === 0 && bindings.namespaces.size === 0)
+        return { pages: [] };
+    const pages = [];
+    let failure;
+    const visit = (node) => {
+        if (failure)
+            return;
+        if ((ts.isJsxSelfClosingElement(node) || ts.isJsxOpeningElement(node))
+            && JSX_ROUTES.includes(importedName(node.tagName, bindings) ?? '')) {
+            failure = `${file} declares JSX routes; the generator reads route object arrays only.`;
+            return;
+        }
+        if (ts.isCallExpression(node)) {
+            const name = importedName(node.expression, bindings);
+            if (name && JSX_ROUTES.includes(name)) {
+                failure = `${file} builds routes from elements; the generator reads route object arrays only.`;
+                return;
+            }
+            if (name && dialect.calls.includes(name)) {
+                const array = routesOf(app, dialect, node);
+                if (!array) {
+                    failure = `${file} passes ${name} routes that are not an array literal.`;
+                    return;
+                }
+                failure = readRoutes(app, dialect, file, array, '', 0, pages);
+                return;
+            }
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(source);
+    return failure ? { failure } : { pages };
+}
+/**
+ * Pages of a react-router or vue-router app: the route object arrays given
+ * to `createBrowserRouter`, `createHashRouter`, `createMemoryRouter` or
+ * `useRoutes`, or the `routes` of vue-router's `createRouter`. JSX routes,
+ * spread or computed routes and aliases make the enumeration incomplete
+ * instead of silently missing pages.
+ */
+export async function enumerateRouteConfigPages(root, options, policyExcludes, router = 'react-router') {
+    const dialect = DIALECTS[router];
+    const scan = await scanAppSources(root, {
+        ...(options.srcDir ? { srcDir: options.srcDir } : {}),
+        matches: (source) => dialect.marker.test(source),
+    });
+    if (!scan.complete)
+        return { complete: false, reason: scan.reason };
+    if (scan.files.length === 0)
+        return { complete: true, pages: [], excluded: [], findings: [] };
+    const app = createAppProgram({ root, rootNames: scan.files.map((file) => file.absolute) });
+    const read = [];
+    for (const file of scan.files) {
+        const source = app.sourceFile(file.absolute);
+        if (!source)
+            return { complete: false, reason: `${file.path} cannot be read.` };
+        const result = readFile(app, dialect, source);
+        if ('failure' in result)
+            return { complete: false, reason: result.failure };
+        read.push(...result.pages);
+    }
+    const pages = new Map();
+    const excluded = new Map();
+    const findings = [];
+    for (const page of read) {
+        const stableKey = pageStableKey(page.path);
+        const exclusion = page.reason ? { reason: page.reason, origin: 'default' } : pathExclusion(page.path, policyExcludes);
+        if (exclusion) {
+            excluded.set(stableKey, { stableKey, ...exclusion });
+            continue;
+        }
+        const existing = pages.get(page.path);
+        if (existing && !page.index) {
+            findings.push(toolFinding('page-path-duplicated', 'warning', stableKey, `Two routes render ${page.path}; navigation uses the one in ${existing.file}.`));
+            continue;
+        }
+        pages.set(page.path, {
+            path: page.path, params: page.params, file: page.file, ...(page.component ? { component: page.component } : {}),
+        });
+    }
+    return {
+        complete: true,
+        pages: [...pages.values()].sort((left, right) => compareCodeUnits(left.path, right.path)),
+        excluded: [...excluded.values()].sort((left, right) => compareCodeUnits(left.stableKey, right.stableKey)),
+        findings,
+    };
+}
+/** The declaration of a page component in its module: a named export or `default`. */
+export function componentDeclaration(source, component) {
+    const named = (name) => {
+        for (const statement of source.statements) {
+            if ((ts.isFunctionDeclaration(statement) || ts.isClassDeclaration(statement)) && statement.name?.text === name)
+                return statement;
+            if (ts.isVariableStatement(statement)) {
+                const declaration = statement.declarationList.declarations.find((candidate) => (ts.isIdentifier(candidate.name) && candidate.name.text === name));
+                if (declaration)
+                    return declaration;
+            }
+        }
+        return undefined;
+    };
+    if (component !== 'default')
+        return named(component);
+    for (const statement of source.statements) {
+        if ((ts.isFunctionDeclaration(statement) || ts.isClassDeclaration(statement))
+            && (ts.getModifiers(statement) ?? []).some((modifier) => modifier.kind === ts.SyntaxKind.DefaultKeyword))
+            return statement;
+        if (ts.isExportAssignment(statement) && !statement.isExportEquals) {
+            const value = unwrap(statement.expression);
+            return ts.isIdentifier(value) ? named(value.text) ?? value : value;
+        }
+    }
+    return undefined;
+}
+/**
+ * The `react-router` source: one `ui.navigate` tool whose destinations are
+ * the app's route objects, executed by the navigation bridge.
+ */
+export function createReactRouterSource(options = {}) {
+    return {
+        kind: 'react-router',
+        observe: async (ctx) => observeNavigation('react-router', await enumerateRouteConfigPages(ctx.root, options, ctx.policy.exclude ?? []), ctx.root, ctx.config.locale, options.srcDir),
+    };
+}
+/**
+ * The `vue-router` source: one `ui.navigate` tool whose destinations are the
+ * routes of `createRouter`, executed by `registerNavigationBridge`.
+ */
+export function createVueRouterSource(options = {}) {
+    return {
+        kind: 'vue-router',
+        observe: async (ctx) => observeNavigation('vue-router', await enumerateRouteConfigPages(ctx.root, options, ctx.policy.exclude ?? [], 'vue-router'), ctx.root, ctx.config.locale, options.srcDir),
+    };
+}
+//# sourceMappingURL=route-config.js.map

package/dist/codegen/tools/sources/route-config.js.map

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

package/dist/codegen/tools/sources/ui-controls.d.ts

@@ -0,0 +1,41 @@
+import ts from 'typescript';
+import type { ToolPolicyFile } from '../../../contracts/tool-policy.js';
+import type { AppProgram } from '../program.js';
+import type { JsonSchemaLike, ToolFinding } from '../types.js';
+import type { AppSourceFile } from './app-files.js';
+/**
+ * Stateful UI controls without a client action (concept
+ * `2026-10-28-ui-state-controls-concept.md`, option A). A control never
+ * becomes a tool here: the finding proposes the `useAiClientAction` the app
+ * adds where the state lives, and the `react-actions` source derives the tool
+ * from that registration on the next refresh.
+ */
+/** Text that makes a file worth parsing for controls. */
+export declare const CONTROL_TEXT: RegExp;
+/** What a registered client action looks like to the control analysis. */
+export interface ControlRegistration {
+    actionId: string;
+    stableKey: string;
+    handler: ts.Expression | undefined;
+    schema: JsonSchemaLike | undefined;
+}
+export interface UiControlInput {
+    app: AppProgram;
+    /** Files in the program that may declare or reach a control. */
+    files: ReadonlyArray<AppSourceFile>;
+    /** Every scanned app file, for the files that use a setter. */
+    allFiles: ReadonlyArray<AppSourceFile>;
+    registrations: ReadonlyArray<ControlRegistration>;
+    policy: ToolPolicyFile;
+    /** The function a handler or setter expression stands for. */
+    functionOf(expression: ts.Expression | undefined): ts.SignatureDeclaration | undefined;
+    /** Whether a function writes through `fetch` or `axios` (then the route is the tool). */
+    writes(fn: ts.SignatureDeclaration | undefined): boolean;
+}
+export interface UiControlAnalysis {
+    /** `ui-control-unbound` per control no client action reaches. */
+    findings: ToolFinding[];
+    /** `ui-control-contract-mismatch` by the stable key of the client action. */
+    byStableKey: Map<string, ToolFinding[]>;
+}
+export declare function analyzeUiControls(input: UiControlInput): UiControlAnalysis;