@principal-ai/subsystems-react 0.32.0 → 0.34.0

package/dist/subsystem/SymbolInspectionCard.d.ts

@@ -0,0 +1,31 @@
+/**
+ * SymbolInspectionCard — the declaration of a symbol referenced by a
+ * declaration panel, resolved through graphify. Rendered as a popover from the
+ * declaration panel.
+ *
+ * The useful payload is the declaration itself (`inspection.declaration`,
+ * rebuilt from graph edges), with `source` as the fallback. `resolution` and
+ * `candidates` explain a miss. The "Add to references" affordance is
+ * intentionally hidden until it's wired up (`onAddToModel` is accepted but not
+ * rendered yet).
+ */
+import { type CSSProperties } from 'react';
+import type { SubsystemOpenFileOptions } from './declarationRef';
+import type { DeclarationSymbolRef, SymbolInspection } from './symbolRefs';
+export interface SymbolInspectionCardProps {
+    /** The symbol that was clicked. */
+    symbolRef: DeclarationSymbolRef;
+    /** Graphify result; absent when the lookup failed. */
+    inspection?: SymbolInspection | null;
+    error?: string;
+    onClose?: () => void;
+    /** Add the symbol to the model's references (for an agent to maintain).
+     *  Accepted but not rendered yet — wired in a later slice. */
+    onAddToModel?: (ref: DeclarationSymbolRef, info?: SymbolInspection) => void;
+    /** Open the definition file at its line. */
+    onOpenFile?: (file: string, opts?: SubsystemOpenFileOptions) => void;
+    style?: CSSProperties;
+}
+/** Popover showing the declaration of one referenced symbol. */
+export declare function SymbolInspectionCard({ symbolRef, inspection, error, onClose, onOpenFile, style, }: SymbolInspectionCardProps): import("react").JSX.Element;
+//# sourceMappingURL=SymbolInspectionCard.d.ts.map

package/dist/subsystem/SymbolInspectionCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SymbolInspectionCard.d.ts","sourceRoot":"","sources":["../../src/subsystem/SymbolInspectionCard.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAgC,KAAK,aAAa,EAAkB,MAAM,OAAO,CAAC;AAKzF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAUjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAE3E,MAAM,WAAW,yBAAyB;IACxC,mCAAmC;IACnC,SAAS,EAAE,oBAAoB,CAAC;IAChC,sDAAsD;IACtD,UAAU,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB;kEAC8D;IAC9D,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,oBAAoB,EAAE,IAAI,CAAC,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC5E,4CAA4C;IAC5C,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,wBAAwB,KAAK,IAAI,CAAC;IACrE,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AA+MD,gEAAgE;AAChE,wBAAgB,oBAAoB,CAAC,EACnC,SAAS,EACT,UAAU,EACV,KAAK,EACL,OAAO,EACP,UAAU,EACV,KAAK,GACN,EAAE,yBAAyB,+BA+K3B"}

package/dist/subsystem/SymbolInspectionCard.js

@@ -0,0 +1,247 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * SymbolInspectionCard — the declaration of a symbol referenced by a
+ * declaration panel, resolved through graphify. Rendered as a popover from the
+ * declaration panel.
+ *
+ * The useful payload is the declaration itself (`inspection.declaration`,
+ * rebuilt from graph edges), with `source` as the fallback. `resolution` and
+ * `candidates` explain a miss. The "Add to references" affordance is
+ * intentionally hidden until it's wired up (`onAddToModel` is accepted but not
+ * rendered yet).
+ */
+import { useEffect, useMemo, useState } from 'react';
+import { ExternalLink } from 'lucide-react';
+import { useTheme } from '@principal-ade/industry-theme';
+import { resolvePierreSyntaxThemeName } from '../pierre/pierreSyntaxTheme';
+import { sourceLangForPath } from '../pierre/sourceLang';
+import { parseSourceLocation } from './declarationRef';
+import { generateDeclarationString } from './formatDeclaration';
+import { tokenizeComponent } from './tokenizeComponent';
+import { tokenizeFormatted } from './tokenizeFormatted';
+/**
+ * A repo path that wraps at `/` only. Each segment is unbreakable, so the
+ * browser can't fall back to breaking at a hyphen (`event-` / `processing`);
+ * the `<wbr>` after each slash supplies the break opportunity instead.
+ */
+function WrappablePath({ path }) {
+    const nodes = [];
+    path.split('/').forEach((seg, i) => {
+        if (i > 0) {
+            nodes.push('/');
+            nodes.push(_jsx("wbr", {}, `b${i}`));
+        }
+        nodes.push(_jsx("span", { style: { whiteSpace: 'nowrap' }, children: seg }, `s${i}`));
+    });
+    return _jsx(_Fragment, { children: nodes });
+}
+/** Label stacked above the value, so long values get the full width. */
+function StackedRow({ label, children }) {
+    const { theme } = useTheme();
+    const muted = theme.colors.textMuted ?? theme.colors.textSecondary;
+    return (_jsxs("div", { style: { display: 'flex', flexDirection: 'column', gap: 2 }, children: [_jsx("span", { style: {
+                    color: muted,
+                    fontFamily: theme.fonts.body,
+                    fontSize: theme.fontSizes[0],
+                    textTransform: 'uppercase',
+                    letterSpacing: 0.4,
+                }, children: label }), _jsx("span", { style: { minWidth: 0, overflowWrap: 'anywhere' }, children: children })] }));
+}
+/** Map a graphify declaration kind to the construct the renderer expects. */
+function constructForDeclaration(info) {
+    const d = info.declaration;
+    switch (d?.kind) {
+        case 'class':
+            return 'class';
+        case 'function':
+            return 'function';
+        case 'method':
+            return 'method';
+        case 'store':
+            return 'store';
+        case 'external':
+            return 'external';
+        case 'custom_entity':
+            return 'custom_entity';
+        case 'type':
+            if (d.enumMembers?.length)
+                return 'enum';
+            if (d.rhs || d.aliasOf || d.unionOf?.length || d.signature)
+                return 'type_alias';
+            return 'interface';
+        default:
+            return 'interface';
+    }
+}
+/**
+ * A valid TS identifier used while generating/formatting the declaration, then
+ * swapped for the real symbol name on display. Graphify labels aren't always
+ * valid identifiers (`capture-session`), which would make Prettier's parser
+ * throw and skip formatting.
+ */
+const SYMBOL_PLACEHOLDER = '__SYMBOL__';
+/** Build a renderable component from the inspection's structured declaration. */
+function componentForInspection(info) {
+    if (!info.declaration)
+        return null;
+    return {
+        alias: info.symbol,
+        name: SYMBOL_PLACEHOLDER,
+        construct: constructForDeclaration(info),
+        file: info.node?.sourceFile ?? '',
+        purl: info.purl ?? '',
+        declaration: info.declaration,
+    };
+}
+/** Put the real symbol name back into a generated/formatted declaration. */
+function withSymbolName(text, symbol) {
+    return text.split(SYMBOL_PLACEHOLDER).join(symbol);
+}
+/** Typography for the declaration text — the section supplies the framing. */
+function declBlockStyle(theme) {
+    return {
+        fontFamily: theme.fonts.monospace,
+        fontSize: theme.fontSizes[1],
+        lineHeight: 1.6,
+        whiteSpace: 'pre-wrap',
+        overflowWrap: 'anywhere',
+    };
+}
+/**
+ * Token stream → per-line colored spans, substituting a placeholder name. Each
+ * line is its own block: token text carries no newline (the `newline` token is
+ * a marker), so without a block per line everything collapses onto one row.
+ */
+function renderTokenLines(tokens, theme, symbol) {
+    const lines = [[]];
+    let li = 0;
+    for (const tok of tokens) {
+        if (tok.kind === 'newline') {
+            lines.push([]);
+            li++;
+            continue;
+        }
+        const text = symbol ? tok.text.split(SYMBOL_PLACEHOLDER).join(symbol) : tok.text;
+        lines[li].push(_jsx("span", { style: { color: tok.color ?? theme.colors.text }, children: text }, `${li}-${lines[li].length}`));
+    }
+    return lines
+        .filter((spans) => spans.length > 0)
+        .map((spans, i) => (_jsx("div", { style: { minHeight: '1em' }, children: spans }, i)));
+}
+/**
+ * The declaration, syntax-colored via the same Shiki/Pierre pipeline as the
+ * main panel. Falls back to the plain generated string until tokens arrive.
+ */
+function DeclarationPreview({ info }) {
+    const { theme, mode } = useTheme();
+    const [tokens, setTokens] = useState(null);
+    const component = useMemo(() => componentForInspection(info), [info]);
+    const fallbackText = useMemo(() => (component ? withSymbolName(generateDeclarationString(component), info.symbol) : ''), [component, info.symbol]);
+    useEffect(() => {
+        if (!component)
+            return;
+        let cancelled = false;
+        tokenizeComponent(component, 40, resolvePierreSyntaxThemeName(mode))
+            .then((t) => {
+            if (!cancelled)
+                setTokens(t);
+        })
+            .catch(() => {
+            if (!cancelled)
+                setTokens(null);
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [component, mode]);
+    return (_jsx("div", { style: declBlockStyle(theme), children: tokens ? renderTokenLines(tokens, theme, info.symbol) : fallbackText }));
+}
+/** Raw source declaration text, syntax-colored with the file's grammar. */
+function TokenizedSource({ code, lang }) {
+    const { theme, mode } = useTheme();
+    const [tokens, setTokens] = useState(null);
+    useEffect(() => {
+        let cancelled = false;
+        tokenizeFormatted(code, resolvePierreSyntaxThemeName(mode), lang)
+            .then((t) => {
+            if (!cancelled)
+                setTokens(t);
+        })
+            .catch(() => {
+            if (!cancelled)
+                setTokens(null);
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [code, lang, mode]);
+    return (_jsx("div", { style: declBlockStyle(theme), children: tokens ? renderTokenLines(tokens, theme) : code }));
+}
+/** Popover showing the declaration of one referenced symbol. */
+export function SymbolInspectionCard({ symbolRef, inspection, error, onClose, onOpenFile, style, }) {
+    const { theme } = useTheme();
+    const muted = theme.colors.textMuted ?? theme.colors.textSecondary;
+    const mono = theme.fonts.monospace;
+    const small = theme.fontSizes[0];
+    const body = theme.fontSizes[1];
+    const info = inspection ?? undefined;
+    const node = info?.node;
+    const line = parseSourceLocation(node?.sourceLocation);
+    // Structured declaration when graphify reconstructed it; otherwise the raw
+    // source declaration when only the location is known.
+    const component = info ? componentForInspection(info) : null;
+    const sourceText = info?.source?.text ?? null;
+    // The declaration block already carries the symbol's name, so only fall back
+    // to a header title when there's nothing to show (loading / miss).
+    const hasBody = !!component || !!sourceText;
+    // What to say when there's no declaration: ambiguous is "pick one", not a
+    // dead end — so it must not read as "no declaration available".
+    const statusText = !info
+        ? 'Nothing in graphify for this symbol.'
+        : info.candidates && info.candidates.length > 0
+            ? `Multiple definitions match (${info.candidates.length}).`
+            : `No declaration available from graphify${info.reason ? ` — ${info.reason}` : '.'}`;
+    const openFile = () => {
+        if (!onOpenFile || !node?.sourceFile)
+            return;
+        onOpenFile(node.sourceFile, line != null ? { startLine: line } : undefined);
+    };
+    return (_jsxs("div", { "data-symbol-inspection": true, style: {
+            position: 'absolute',
+            zIndex: 40,
+            width: 360,
+            maxWidth: 'calc(100vw - 24px)',
+            boxSizing: 'border-box',
+            background: theme.colors.backgroundSecondary,
+            border: `1px solid ${theme.colors.border}`,
+            borderRadius: 8,
+            overflow: 'hidden',
+            boxShadow: '0 8px 24px rgba(0, 0, 0, 0.28)',
+            fontFamily: mono,
+            fontSize: body,
+            color: theme.colors.text,
+            ...style,
+        }, onClick: (e) => e.stopPropagation(), children: [_jsx("button", { type: "button", "aria-label": "Close", onClick: onClose, style: {
+                    position: 'absolute',
+                    top: 6,
+                    right: 8,
+                    zIndex: 1,
+                    border: 'none',
+                    background: 'transparent',
+                    color: muted,
+                    cursor: 'pointer',
+                    fontSize: 15,
+                    lineHeight: 1,
+                    padding: '2px 4px',
+                }, children: "\u00D7" }), _jsxs("div", { style: {
+                    padding: '12px 32px 12px 12px',
+                    borderBottom: `1px solid ${theme.colors.border}`,
+                }, children: [error && (_jsx("span", { style: { color: '#e5534b', fontFamily: theme.fonts.body, fontSize: small }, children: error })), !error && component && info && (_jsx(DeclarationPreview, { info: info }, info.symbol)), !error && !component && sourceText && (_jsx(TokenizedSource, { code: sourceText, lang: sourceLangForPath(info?.source?.file ?? info?.node?.sourceFile ?? '') }, info?.symbol)), !error && !hasBody && (_jsx("span", { style: { color: theme.colors.accent ?? theme.colors.secondary, fontWeight: 600 }, children: symbolRef.name }))] }), !error && (_jsxs("div", { style: { padding: '10px 12px', display: 'flex', flexDirection: 'column', gap: 8 }, children: [node?.sourceFile && (_jsx(StackedRow, { label: "Source", children: onOpenFile ? (_jsxs("span", { role: "button", tabIndex: 0, onClick: openFile, style: {
+                                cursor: 'pointer',
+                                color: theme.colors.accent ?? theme.colors.secondary,
+                            }, children: [_jsx(WrappablePath, { path: node.sourceFile }), line != null ? `:${line}` : '', ' ', _jsx(ExternalLink, { size: 11, style: { display: 'inline', verticalAlign: 'text-bottom' } })] })) : (_jsxs("span", { children: [_jsx(WrappablePath, { path: node.sourceFile }), line != null ? `:${line}` : ''] })) })), !hasBody && (_jsx("span", { style: { color: muted, fontFamily: theme.fonts.body, fontSize: small }, children: statusText })), info?.candidates && info.candidates.length > 0 && (_jsx(StackedRow, { label: "Candidates", children: _jsx("div", { style: { display: 'flex', flexDirection: 'column', gap: 2 }, children: info.candidates.slice(0, 6).map((c) => (_jsxs("span", { style: { fontFamily: mono, fontSize: small }, children: [_jsx("span", { style: { color: theme.colors.text }, children: c.label }), c.sourceFile && (_jsxs(_Fragment, { children: [' ', _jsx("span", { role: onOpenFile ? 'button' : undefined, tabIndex: onOpenFile ? 0 : undefined, onClick: onOpenFile ? () => onOpenFile(c.sourceFile, undefined) : undefined, style: {
+                                                    color: theme.colors.accent ?? theme.colors.secondary,
+                                                    cursor: onOpenFile ? 'pointer' : 'default',
+                                                }, children: _jsx(WrappablePath, { path: c.sourceFile }) })] }))] }, c.nodeId))) }) }))] }))] }));
+}
+//# sourceMappingURL=SymbolInspectionCard.js.map

package/dist/subsystem/SymbolInspectionCard.js.map

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

package/dist/subsystem/prettierProvider.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Optional host-provided Prettier.
+ *
+ * Some host bundlers mangle Prettier's already-minified plugin code. Cottontail
+ * (Electrobun) re-bundles it and renames a local parameter to a name that
+ * collides with an outer function used inside a closure (`e3 is not a
+ * function`), which breaks `prettier.format` for every input in the renderer.
+ *
+ * A host can load a correctly-bundled Prettier outside its own bundler and
+ * register it here; `tokenizeComponent` prefers it over the bundled dynamic
+ * import. When nothing is registered the built-in import path is unchanged.
+ */
+export type PrettierBundle = {
+    prettier: typeof import('prettier/standalone');
+    plugins: {
+        typescript: typeof import('prettier/plugins/typescript');
+        estree: typeof import('prettier/plugins/estree');
+    };
+};
+/** Register (or clear with `null`) a host-provided Prettier bundle. */
+export declare function setPrettierProvider(bundle: PrettierBundle | null): void;
+/** The currently registered bundle, if any. */
+export declare function getPrettierProvider(): PrettierBundle | null;
+//# sourceMappingURL=prettierProvider.d.ts.map

package/dist/subsystem/prettierProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prettierProvider.d.ts","sourceRoot":"","sources":["../../src/subsystem/prettierProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,cAAc,qBAAqB,CAAC,CAAC;IAC/C,OAAO,EAAE;QACP,UAAU,EAAE,cAAc,6BAA6B,CAAC,CAAC;QACzD,MAAM,EAAE,cAAc,yBAAyB,CAAC,CAAC;KAClD,CAAC;CACH,CAAC;AAIF,uEAAuE;AACvE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,GAAG,IAAI,CAEvE;AAED,+CAA+C;AAC/C,wBAAgB,mBAAmB,IAAI,cAAc,GAAG,IAAI,CAE3D"}

package/dist/subsystem/prettierProvider.js

@@ -0,0 +1,22 @@
+/**
+ * Optional host-provided Prettier.
+ *
+ * Some host bundlers mangle Prettier's already-minified plugin code. Cottontail
+ * (Electrobun) re-bundles it and renames a local parameter to a name that
+ * collides with an outer function used inside a closure (`e3 is not a
+ * function`), which breaks `prettier.format` for every input in the renderer.
+ *
+ * A host can load a correctly-bundled Prettier outside its own bundler and
+ * register it here; `tokenizeComponent` prefers it over the bundled dynamic
+ * import. When nothing is registered the built-in import path is unchanged.
+ */
+let provider = null;
+/** Register (or clear with `null`) a host-provided Prettier bundle. */
+export function setPrettierProvider(bundle) {
+    provider = bundle;
+}
+/** The currently registered bundle, if any. */
+export function getPrettierProvider() {
+    return provider;
+}
+//# sourceMappingURL=prettierProvider.js.map

package/dist/subsystem/prettierProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prettierProvider.js","sourceRoot":"","sources":["../../src/subsystem/prettierProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAUH,IAAI,QAAQ,GAA0B,IAAI,CAAC;AAE3C,uEAAuE;AACvE,MAAM,UAAU,mBAAmB,CAAC,MAA6B;IAC/D,QAAQ,GAAG,MAAM,CAAC;AACpB,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,mBAAmB;IACjC,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/subsystem/symbolRefs.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Referenced symbols inside a component's declaration.
+ *
+ * A declaration mentions other symbols — parameter/return types, property
+ * types, `extends`/`implements`, and related callables (`callers`/`callees`,
+ * `references`/`usedBy`). This module flattens the structured declaration into
+ * a deduped, lookup-friendly list so the panel can offer a graphify inspection
+ * per name, and defines the payload graphify returns for one.
+ *
+ * Slice 1 is display-only: the inspection payload is produced by the host (or,
+ * in stories, by a fixture). Nothing here reads the graph.
+ */
+import type { GraphifyComponentDetail } from '../graphify';
+/** One symbol a declaration references, normalized for lookup. */
+export interface DeclarationSymbolRef {
+    /** Referenced name as written (e.g. `SessionRecord`), no call/`()` decoration. */
+    name: string;
+    /** Graphify node id when the backing reference carried one. */
+    nodeId?: string;
+    /** Reference context (`parameter_type`, `return_type`, `field`, `caller`, …). */
+    context?: string;
+    /** `L<line>` of the reference site, when known. */
+    sourceLocation?: string;
+}
+/**
+ * How a symbol resolved against the cached graphify graph. Name-first, so it
+ * mirrors the type-ref resolver (`graphify/resolve.ts`) rather than component
+ * anchoring — there is no claimed file to fall back to.
+ */
+export type SymbolInspectionResolution = 
+/** Exactly one definition node for the name. */
+'resolved'
+/** Referenced, but no definition in this corpus (external / ambient type). */
+ | 'unresolved'
+/** Multiple same-label definitions. */
+ | 'ambiguous'
+/** The name isn't in the graph at all. */
+ | 'missing';
+export interface SymbolInspectionNode {
+    nodeId: string;
+    label: string;
+    /** Repo-root-relative source path. */
+    sourceFile?: string;
+    /** `L<line>` of the definition. */
+    sourceLocation?: string;
+    fileType?: string;
+    community?: string;
+}
+export interface SymbolInspectionCandidate {
+    nodeId: string;
+    label: string;
+    sourceFile?: string;
+}
+/**
+ * The actual source declaration, read from the checkout at the node's anchor.
+ * Used when graphify resolved a location but couldn't reconstruct the shape.
+ */
+export interface SymbolInspectionSource {
+    file: string;
+    startLine?: number;
+    /** Declaration text as read from source. */
+    text: string;
+}
+/**
+ * What graphify has on one symbol. The useful payload is `declaration` — the
+ * symbol's declaration shape, rebuilt from graph edges — with `source` as the
+ * fallback when graphify knows where the symbol is but not what it is.
+ * `resolution` and `candidates` explain a miss; the rest of the graph's
+ * inference bookkeeping is deliberately not part of this payload.
+ */
+export interface SymbolInspection {
+    symbol: string;
+    purl?: string;
+    resolution: SymbolInspectionResolution;
+    node?: SymbolInspectionNode;
+    /** The symbol's declaration, when graphify could reconstruct it. */
+    declaration?: GraphifyComponentDetail;
+    /** The declaration as read from source, when only the location is known. */
+    source?: SymbolInspectionSource;
+    candidates?: SymbolInspectionCandidate[];
+    /** Human-readable reason when there's neither a declaration nor source. */
+    reason?: string;
+}
+/**
+ * True when there's no declaration to show — either graphify couldn't resolve
+ * the symbol or couldn't reconstruct its shape. The case where offering
+ * "add to model + agent" is worthwhile.
+ */
+export declare function isLimitedInspection(info: SymbolInspection | null | undefined): boolean;
+/**
+ * Flatten a declaration into the set of symbols it references, deduped by name.
+ * Entries backed by a `nodeId` win over bare-name entries.
+ */
+export declare function extractDeclarationSymbolRefs(declaration: GraphifyComponentDetail | undefined): DeclarationSymbolRef[];
+//# sourceMappingURL=symbolRefs.d.ts.map

package/dist/subsystem/symbolRefs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbolRefs.d.ts","sourceRoot":"","sources":["../../src/subsystem/symbolRefs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAyB,MAAM,aAAa,CAAC;AAElF,kEAAkE;AAClE,MAAM,WAAW,oBAAoB;IACnC,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAMD;;;;GAIG;AACH,MAAM,MAAM,0BAA0B;AACpC,gDAAgD;AAC9C,UAAU;AACZ,8EAA8E;GAC5E,YAAY;AACd,uCAAuC;GACrC,WAAW;AACb,0CAA0C;GACxC,SAAS,CAAC;AAEd,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,0BAA0B,CAAC;IACvC,IAAI,CAAC,EAAE,oBAAoB,CAAC;IAC5B,oEAAoE;IACpE,WAAW,CAAC,EAAE,uBAAuB,CAAC;IACtC,4EAA4E;IAC5E,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC,UAAU,CAAC,EAAE,yBAAyB,EAAE,CAAC;IACzC,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,GACxC,OAAO,CAET;AAwDD;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,uBAAuB,GAAG,SAAS,GAC/C,oBAAoB,EAAE,CAyFxB"}

package/dist/subsystem/symbolRefs.js

@@ -0,0 +1,167 @@
+/**
+ * Referenced symbols inside a component's declaration.
+ *
+ * A declaration mentions other symbols — parameter/return types, property
+ * types, `extends`/`implements`, and related callables (`callers`/`callees`,
+ * `references`/`usedBy`). This module flattens the structured declaration into
+ * a deduped, lookup-friendly list so the panel can offer a graphify inspection
+ * per name, and defines the payload graphify returns for one.
+ *
+ * Slice 1 is display-only: the inspection payload is produced by the host (or,
+ * in stories, by a fixture). Nothing here reads the graph.
+ */
+/**
+ * True when there's no declaration to show — either graphify couldn't resolve
+ * the symbol or couldn't reconstruct its shape. The case where offering
+ * "add to model + agent" is worthwhile.
+ */
+export function isLimitedInspection(info) {
+    return !info?.declaration;
+}
+// ---------------------------------------------------------------------------
+// Extraction
+// ---------------------------------------------------------------------------
+/** Names that carry no lookup value — primitives and non-identifiers. */
+const PRIMITIVES = new Set([
+    'string',
+    'number',
+    'boolean',
+    'bigint',
+    'symbol',
+    'void',
+    'null',
+    'undefined',
+    'never',
+    'any',
+    'unknown',
+    'object',
+    'true',
+    'false',
+    'self',
+    'None',
+    'True',
+    'False',
+    'bool',
+    'int',
+    'float',
+    'str',
+    'bytes',
+    'list',
+    'dict',
+    'tuple',
+    'set',
+]);
+/** A bare (optionally dotted) identifier we can look up by name. */
+function isSimpleSymbolName(type) {
+    if (!type)
+        return false;
+    const t = type.trim();
+    if (!/^[A-Za-z_$][\w$]*(\.[A-Za-z_$][\w$]*)*$/.test(t))
+        return false;
+    return !PRIMITIVES.has(t);
+}
+/**
+ * Normalize a callable/related label (`normalize()`, `.get`, `capture-session`)
+ * to a name. Labels are freer than type expressions — kebab-case is common.
+ */
+function normalizeRelatedName(raw) {
+    if (!raw)
+        return null;
+    const t = raw.trim().replace(/^\./, '').replace(/\(\)$/, '');
+    if (!/^[A-Za-z_$][\w$.-]*$/.test(t))
+        return null;
+    return PRIMITIVES.has(t) ? null : t;
+}
+/**
+ * Flatten a declaration into the set of symbols it references, deduped by name.
+ * Entries backed by a `nodeId` win over bare-name entries.
+ */
+export function extractDeclarationSymbolRefs(declaration) {
+    if (!declaration)
+        return [];
+    const byName = new Map();
+    const add = (name, opts = {}) => {
+        if (!name)
+            return;
+        const existing = byName.get(name);
+        const nodeId = opts.ref?.nodeId;
+        const next = {
+            name,
+            nodeId: nodeId ?? existing?.nodeId,
+            context: opts.ref?.context ?? opts.context ?? existing?.context,
+            sourceLocation: opts.ref?.source_location ?? opts.sourceLocation ?? existing?.sourceLocation,
+        };
+        // Prefer the richer entry when we already have one with a nodeId.
+        if (existing?.nodeId && !nodeId)
+            return;
+        byName.set(name, next);
+    };
+    const addType = (type, ref, context) => {
+        if (!isSimpleSymbolName(type))
+            return;
+        add(type.trim(), { ref, context });
+    };
+    const addCall = (call, context) => {
+        if (!call)
+            return;
+        add(normalizeRelatedName(call.name), {
+            context,
+            sourceLocation: call.source_location,
+        });
+    };
+    switch (declaration.kind) {
+        case 'function':
+            for (const p of declaration.parameters ?? [])
+                addType(p.type, p.ref, 'parameter_type');
+            addType(declaration.returnType, declaration.returnTypeRef, 'return_type');
+            for (const c of declaration.callers ?? [])
+                addCall(c, 'caller');
+            for (const c of declaration.callees ?? [])
+                addCall(c, 'callee');
+            break;
+        case 'method':
+            for (const p of declaration.parameters ?? [])
+                addType(p.type, p.ref, 'parameter_type');
+            addType(declaration.returnType, undefined, 'return_type');
+            break;
+        case 'class':
+            for (const m of declaration.methods ?? []) {
+                for (const p of m.parameters ?? [])
+                    addType(p.type, p.ref, 'parameter_type');
+                addType(m.returnType, m.returnTypeRef, 'return_type');
+            }
+            for (const p of declaration.properties ?? []) {
+                addType(p.type, p.typeRef, 'field');
+            }
+            for (const name of declaration.extends ?? [])
+                addType(name, undefined, 'extends');
+            for (const name of declaration.implements ?? [])
+                addType(name, undefined, 'implements');
+            for (const r of declaration.references ?? []) {
+                add(normalizeRelatedName(r.name), { ref: r, context: r.context ?? 'references' });
+            }
+            break;
+        case 'type':
+            for (const p of declaration.properties ?? []) {
+                addType(p.type, p.typeRef, 'field');
+            }
+            for (const r of declaration.usedBy ?? []) {
+                add(normalizeRelatedName(r.name), { ref: r, context: r.context ?? 'usedBy' });
+            }
+            for (const name of declaration.implementors ?? [])
+                addType(name, undefined, 'implementor');
+            addType(declaration.aliasOf, undefined, 'alias');
+            for (const alt of declaration.unionOf ?? [])
+                addType(alt, undefined, 'union');
+            break;
+        case 'store':
+            for (const p of declaration.properties ?? []) {
+                addType(p.type, p.typeRef, 'field');
+            }
+            break;
+        default:
+            break;
+    }
+    return [...byName.values()];
+}
+//# sourceMappingURL=symbolRefs.js.map

package/dist/subsystem/symbolRefs.js.map

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

package/dist/subsystem/tokenizeComponent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tokenizeComponent.d.ts","sourceRoot":"","sources":["../../src/subsystem/tokenizeComponent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAKzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AA2BtE;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,kBAAkB,EAC7B,UAAU,SAAK,EACf,SAAS,GAAE,qBAAqC,GAC/C,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAgD/B"}
+{"version":3,"file":"tokenizeComponent.d.ts","sourceRoot":"","sources":["../../src/subsystem/tokenizeComponent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAKzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAgCtE;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,kBAAkB,EAC7B,UAAU,SAAK,EACf,SAAS,GAAE,qBAAqC,GAC/C,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAgD/B"}