glirastes 0.4.0 → 0.5.0

package/dist/codegen/tools/sources/ui-tools.js

@@ -0,0 +1,207 @@
+import ts from 'typescript';
+import { TOOL_NAME_PATTERN } from '../../../runtime/local-tool-bindings.js';
+import { canonicalJson, compareCodeUnits, jsonSchemaDigest, sha256Digest } from '../canonical.js';
+import { OPAQUE_SCHEMA_DIGEST } from '../contract-tiers.js';
+import { toolFinding } from '../findings.js';
+/** Action id the navigation bridge listens to; `ui.navigate` and every `ui.filter.<view>` use it. */
+export const NAVIGATE_ACTION_BINDING = 'glirastes.navigate';
+export const NAVIGATE_STABLE_KEY = 'UI navigate';
+export const NAVIGATE_DEFINITION_ID = 'ui.navigate';
+export function filterStableKey(path) {
+    return `UI filter ${path}`;
+}
+export function actionStableKey(actionId) {
+    return `UI action ${actionId}`;
+}
+/** What every generated UI tool returns (`uiActionToolToTool`). */
+export const UI_TOOL_OUTPUT_SCHEMA = {
+    type: 'object',
+    properties: {
+        success: { type: 'boolean' },
+        message: { type: 'string' },
+        error: { type: 'string' },
+        uiAction: { type: 'object' },
+    },
+    required: ['success'],
+};
+function words(segment) {
+    return segment.split(/[^A-Za-z0-9]+/).filter(Boolean);
+}
+function camel(parts) {
+    return parts.map((part, index) => (index === 0
+        ? part.charAt(0).toLowerCase() + part.slice(1)
+        : part.charAt(0).toUpperCase() + part.slice(1))).join('');
+}
+/** `/tasks` → `tasks`, `/` → `home`, `/tasks/:id` → `tasksItem`: the `<view>` of `ui.filter.<view>`. */
+export function viewName(path) {
+    const segments = path.split('/').filter(Boolean);
+    const statics = segments.filter((segment) => !segment.startsWith(':') && !segment.startsWith('*'));
+    let name = camel(statics.flatMap(words)) || 'home';
+    if (segments.at(-1)?.startsWith(':'))
+        name = `${name}Item`;
+    return /^[0-9]/.test(name) ? `v${name}` : name;
+}
+/** The inventory and `tool-contracts.json` cap a definition id at 200 characters. */
+const MAX_DEFINITION_ID_LENGTH = 200;
+const RESERVED_FIRST_SEGMENTS = new Set(['navigate', 'filter', 'action']);
+/**
+ * `tasks.highlight` → `ui.tasks.highlight`. A single segment or one that
+ * would shadow `ui.navigate`/`ui.filter.*` moves under `ui.action.`;
+ * undefined when the id cannot form a tool name.
+ */
+export function uiDefinitionIdForAction(actionId) {
+    const segments = actionId.split('.').map((segment) => camel(words(segment)));
+    if (segments.some((segment) => segment.length === 0))
+        return undefined;
+    const named = segments.map((segment) => (/^[0-9]/.test(segment) ? `a${segment}` : segment));
+    const parts = named.length === 1 || RESERVED_FIRST_SEGMENTS.has(named[0]) ? ['action', ...named] : named;
+    const id = `ui.${parts.join('.')}`;
+    return id.length <= MAX_DEFINITION_ID_LENGTH && TOOL_NAME_PATTERN.test(id) ? id : undefined;
+}
+/**
+ * `base` plus an 8-character digest of the stable key, cut so the id stays
+ * within the cap; a cut that ends on a dot drops it so the id stays a tool name.
+ */
+function suffixedDefinitionId(base, stableKey, attempt) {
+    const suffix = sha256Digest(attempt === 0 ? stableKey : `${stableKey}#${attempt}`)
+        .slice(7, 15).replace(/[^A-Za-z0-9]/g, 'x');
+    return `${base.slice(0, MAX_DEFINITION_ID_LENGTH - suffix.length).replace(/\.+$/, '')}${suffix}`;
+}
+/**
+ * Same base name for two stable keys: the later key gets a digest suffix,
+ * independent of order. A base over the cap is cut and suffixed the same way,
+ * and no id is handed out twice.
+ */
+export function uniqueDefinitionIds(entries) {
+    const ids = new Map();
+    const taken = new Set();
+    for (const entry of [...entries].sort((left, right) => compareCodeUnits(left.stableKey, right.stableKey))) {
+        let id = entry.base;
+        for (let attempt = 0; id.length > MAX_DEFINITION_ID_LENGTH || taken.has(id); attempt += 1) {
+            id = suffixedDefinitionId(entry.base, entry.stableKey, attempt);
+        }
+        taken.add(id);
+        ids.set(entry.stableKey, id);
+    }
+    return ids;
+}
+export function parseAppSource(file) {
+    const kind = /\.tsx$/.test(file.path) ? ts.ScriptKind.TSX
+        : /\.(?:[cm]?ts|vue)$/.test(file.path) ? ts.ScriptKind.TS
+            : ts.ScriptKind.JSX;
+    return ts.createSourceFile(file.path, file.source, ts.ScriptTarget.Latest, true, kind);
+}
+/** Value imports of the given names from the given modules; type-only imports never count. */
+export function importBindings(source, specs) {
+    const named = new Map();
+    const namespaces = new Map();
+    for (const statement of source.statements) {
+        if (!ts.isImportDeclaration(statement) || !ts.isStringLiteral(statement.moduleSpecifier))
+            continue;
+        const clause = statement.importClause;
+        if (!clause || clause.isTypeOnly)
+            continue;
+        const spec = specs.find((candidate) => candidate.module === statement.moduleSpecifier.text);
+        if (!spec)
+            continue;
+        const bindings = clause.namedBindings;
+        if (bindings && ts.isNamespaceImport(bindings))
+            namespaces.set(bindings.name.text, new Set(spec.names));
+        if (bindings && ts.isNamedImports(bindings)) {
+            for (const element of bindings.elements) {
+                const imported = (element.propertyName ?? element.name).text;
+                if (!element.isTypeOnly && spec.names.includes(imported))
+                    named.set(element.name.text, imported);
+            }
+        }
+    }
+    return { named, namespaces };
+}
+/** The exported name `node` refers to through `bindings`: `alias` or `namespace.name`. */
+export function importedName(node, bindings) {
+    if (ts.isIdentifier(node))
+        return bindings.named.get(node.text);
+    if (ts.isPropertyAccessExpression(node) && ts.isIdentifier(node.expression)) {
+        return bindings.namespaces.get(node.expression.text)?.has(node.name.text) ? node.name.text : undefined;
+    }
+    return undefined;
+}
+/**
+ * Calls of named or namespace imports from the given modules, read from
+ * syntax only: a same-named local function, a comment or an import that is
+ * never called does not count.
+ */
+export function importedCalls(source, specs) {
+    const bindings = importBindings(source, specs);
+    if (bindings.named.size === 0 && bindings.namespaces.size === 0)
+        return [];
+    const calls = [];
+    const visit = (node) => {
+        if (ts.isCallExpression(node)) {
+            const name = importedName(node.expression, bindings);
+            if (name !== undefined)
+                calls.push({ name, call: node });
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(source);
+    return calls;
+}
+const BRIDGE_IMPORTS = [
+    { module: 'glirastes/react', names: ['useGlirastesNavigationBridge'] },
+    { module: 'glirastes/browser', names: ['registerNavigationBridge'] },
+];
+/** True when app code calls the navigation bridge that executes `ui.navigate` and `ui.filter.*`. */
+export function hasNavigationBridge(files) {
+    return files.some((file) => (file.source.includes('NavigationBridge') && importedCalls(parseAppSource(file), BRIDGE_IMPORTS).length > 0));
+}
+export function mentionsNavigationBridge(source) {
+    return source.includes('NavigationBridge');
+}
+/** An `ObservedTool` for a generated UI tool; its contract is JSON Schema read from code. */
+export function uiObservation(input) {
+    const output = UI_TOOL_OUTPUT_SCHEMA;
+    const contract = input.input
+        ? {
+            source: 'ui-bridge',
+            loadBearing: true,
+            input: input.input,
+            output,
+            params: input.params ?? { path: [], query: [], body: [] },
+            interfaceDigest: sha256Digest(canonicalJson({ stableKey: input.stableKey, input: input.input, uiAction: input.uiAction })),
+            runtime: { input: { kind: 'json', schema: input.input }, output: { kind: 'json', schema: output } },
+            uiAction: input.uiAction,
+        }
+        : undefined;
+    return {
+        execution: {
+            definitionId: input.definitionId,
+            stableKey: input.stableKey,
+            executionKind: 'ui',
+            actionBindingRef: input.actionBindingRef,
+            sourceFingerprint: sha256Digest(canonicalJson({ stableKey: input.stableKey, facts: input.facts })),
+            inputSchemaDigest: input.input ? jsonSchemaDigest(input.input) : OPAQUE_SCHEMA_DIGEST,
+            outputSchemaDigest: jsonSchemaDigest(output),
+        },
+        ...(contract ? { contract, interface: { digest: contract.interfaceDigest, params: contract.params } } : {}),
+        ...(input.files ? { files: [...input.files] } : {}),
+        evidence: {
+            authEvidence: false,
+            externalCall: false,
+            ...(input.jsDoc ? { jsDoc: input.jsDoc } : {}),
+            ...(input.uiMutation ? { uiMutation: true } : {}),
+        },
+        findings: input.findings,
+        ...(input.prose ? { prose: input.prose } : {}),
+    };
+}
+/** One incomplete UI enumeration stops the refresh, like an unreadable route file. */
+export function incompleteUiSource(kind, reason) {
+    return {
+        observations: [],
+        findings: [toolFinding('E-INVENTORY-011', 'error', kind, reason)],
+        complete: false,
+        excluded: [],
+    };
+}
+//# sourceMappingURL=ui-tools.js.map

package/dist/codegen/tools/sources/ui-tools.js.map

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

package/dist/codegen/tools/sources/url-filters.d.ts

@@ -0,0 +1,41 @@
+import type { JsonSchemaLike, ToolSource } from '../types.js';
+import { type PageTreeOptions } from './page-tree.js';
+import { type RouterKind } from './route-config.js';
+export interface UrlFilterSourceOptions extends PageTreeOptions {
+    /** Where `defineQueryFilters` and the navigation bridge are searched; `src` when the app has one. */
+    srcDir?: string;
+    /** Which page list the filters attach to: the Next.js page tree (default) or react-router routes. */
+    pages?: 'next' | RouterKind;
+}
+export type FilterDomain = {
+    kind: 'enum';
+    values: string[];
+} | {
+    kind: 'number-enum';
+    values: number[];
+} | {
+    kind: 'string';
+} | {
+    kind: 'integer';
+} | {
+    kind: 'number';
+} | {
+    kind: 'boolean';
+};
+export interface FilterKey {
+    key: string;
+    domain: FilterDomain;
+    /** `comma`: one value joined with commas (nuqs `parseAsArrayOf`); `repeat`: the key repeats. */
+    array?: 'comma' | 'repeat';
+}
+/** Two readings of one key: the closed one wins; incompatible ones become open text. */
+export declare function mergeDomains(left: FilterDomain, right: FilterDomain): FilterDomain | undefined;
+export declare function isFilterKeyName(key: string): boolean;
+export declare function filterKeySchema(key: FilterKey): JsonSchemaLike;
+/**
+ * The `url-filters` source: one `ui.filter.<view>` tool per page or
+ * `defineQueryFilters` view whose URL filters the code reads (nuqs parsers,
+ * typed `searchParams`, `useSearchParams().get`), executed by the navigation
+ * bridge as a URL push.
+ */
+export declare function createUrlFilterSource(options?: UrlFilterSourceOptions): ToolSource;