@nanisoft/prism-llms 0.4.0 → 0.5.0

package/dist/demo-graph.d.ts

@@ -1,24 +1,33 @@
 /**
- * The demo contract (ticket 16 check invariant 2, ticket 12 §2): each example
- * is one self-contained `.tsx` — default-exported component, importing only
- * from `@nanisoft/prism-ui/*` and `react`, no relative imports. This module is
- * the contract's single enforcement point: the generator reuses the import
- * scan for `## Blocks` / `## Pages` cross-refs, the check reuses the validator.
+ * The demo contract.
+ *
+ * Each example is one self-contained `.tsx`: a default export that imports only
+ * from `@nanisoft/prism-ui/*`, `react` or `lucide-react`, and never from a
+ * relative path. `lucide-react` is allowed because the public Block API surfaces
+ * its `LucideIcon` type (a demo that composes a Block must pass an icon), so the
+ * example a consumer copies has to name the same import.
+ *
+ * This module is the contract's single enforcement point: the generator reuses
+ * the import scan for its composition and cross-references, and the check
+ * reuses the validator.
  */
 export interface DemoViolation {
     readonly file: string;
     readonly reason: string;
 }
 /**
- * Validate one demo's source against the self-contained contract. Returns the
- * violations (empty = compliant): non-allowlisted or relative imports, and a
- * missing default export.
+ * Validate one demo's source. Returns the violations (empty means compliant):
+ * a relative or non-allowlisted import, or a missing default export.
  */
 export declare function validateDemoSource(source: string): DemoViolation[];
+export interface PrismImport {
+    readonly specifier: string;
+    readonly names: readonly string[];
+}
 /**
- * The prism-ui export names a demo imports (for `## Blocks` / `## Pages`
- * cross-refs). Returns catalog names — the pre-alias original — and skips
- * type-only specifiers, which reference supporting types, not items.
+ * The prism-ui bindings a demo imports, with their module specifier. Type-only
+ * specifiers reference supporting types, not runtime items.
  */
+export declare function scanPrismImportsWithSource(source: string): PrismImport[];
+/** The prism-ui value export names a demo imports, sorted and de-duplicated. */
 export declare function scanPrismImports(source: string): string[];
-//# sourceMappingURL=demo-graph.d.ts.map

package/dist/demo-graph.js

@@ -1,16 +1,21 @@
 /**
- * The demo contract (ticket 16 check invariant 2, ticket 12 §2): each example
- * is one self-contained `.tsx` — default-exported component, importing only
- * from `@nanisoft/prism-ui/*` and `react`, no relative imports. This module is
- * the contract's single enforcement point: the generator reuses the import
- * scan for `## Blocks` / `## Pages` cross-refs, the check reuses the validator.
+ * The demo contract.
+ *
+ * Each example is one self-contained `.tsx`: a default export that imports only
+ * from `@nanisoft/prism-ui/*`, `react` or `lucide-react`, and never from a
+ * relative path. `lucide-react` is allowed because the public Block API surfaces
+ * its `LucideIcon` type (a demo that composes a Block must pass an icon), so the
+ * example a consumer copies has to name the same import.
+ *
+ * This module is the contract's single enforcement point: the generator reuses
+ * the import scan for its composition and cross-references, and the check
+ * reuses the validator.
  */
 /** Module specifiers a demo may import. Everything else fails the contract. */
-const ALLOWED_IMPORTS = [/^@nanisoft\/prism-ui(\/[\w.-]+)*$/, /^react$/];
+const ALLOWED_IMPORTS = [/^@nanisoft\/prism-ui(\/[\w.-]+)*$/, /^react$/, /^lucide-react$/];
 /**
- * Validate one demo's source against the self-contained contract. Returns the
- * violations (empty = compliant): non-allowlisted or relative imports, and a
- * missing default export.
+ * Validate one demo's source. Returns the violations (empty means compliant):
+ * a relative or non-allowlisted import, or a missing default export.
  */
 export function validateDemoSource(source) {
     const violations = [];
@@ -23,34 +28,45 @@ export function validateDemoSource(source) {
         violations.push({
             file: '',
             reason: specifier.startsWith('.')
-                ? `relative import '${specifier}' — demos must be self-contained`
-                : `import from '${specifier}' — demos import only from '@nanisoft/prism-ui/*' and 'react'`,
+                ? `relative import '${specifier}': demos must be self-contained`
+                : `import from '${specifier}': demos import only from '@nanisoft/prism-ui/*', 'react' and 'lucide-react'`,
         });
     }
     if (!/export\s+default/.test(source)) {
-        violations.push({ file: '', reason: 'no default export — each demo default-exports its example component' });
+        violations.push({ file: '', reason: 'no default export: each demo default-exports its example' });
     }
     return violations;
 }
 /**
- * The prism-ui export names a demo imports (for `## Blocks` / `## Pages`
- * cross-refs). Returns catalog names — the pre-alias original — and skips
- * type-only specifiers, which reference supporting types, not items.
+ * The prism-ui bindings a demo imports, with their module specifier. Type-only
+ * specifiers reference supporting types, not runtime items.
  */
-export function scanPrismImports(source) {
-    const names = new Set();
-    const importPattern = /(?:^|\n)\s*import\s+(?:type\s+)?\{([^}]*)\}\s+from\s+["']@nanisoft\/prism-ui[^"']*["']/g;
+export function scanPrismImportsWithSource(source) {
+    const found = [];
+    const importPattern = /(?:^|\n)\s*import\s+(type\s+)?\{([^}]*)\}\s+from\s+["'](@nanisoft\/prism-ui[^"']*)["']/g;
     let match;
     while ((match = importPattern.exec(source)) !== null) {
-        for (const raw of (match[1] ?? '').split(',')) {
+        if (match[1])
+            continue;
+        const names = [];
+        for (const raw of (match[2] ?? '').split(',')) {
             const trimmed = raw.trim();
             if (!trimmed || trimmed.startsWith('type '))
                 continue;
             const name = trimmed.split(/\s+as\s+/)[0]?.trim();
             if (name)
-                names.add(name);
+                names.push(name);
         }
+        found.push({ specifier: match[3] ?? '', names });
+    }
+    return found;
+}
+/** The prism-ui value export names a demo imports, sorted and de-duplicated. */
+export function scanPrismImports(source) {
+    const names = new Set();
+    for (const binding of scanPrismImportsWithSource(source)) {
+        for (const name of binding.names)
+            names.add(name);
     }
     return [...names].sort();
 }
-//# sourceMappingURL=demo-graph.js.map

package/dist/extractor.d.ts

@@ -1,17 +1,22 @@
 /**
- * The one props extractor (tickets 12/16): reads prism-ui's built `.d.ts`
- * surface — TSDoc preserved — and returns the Prism-added props. Homed here
- * and exported (`@nanisoft/prism-llms/extractor`) for the site's API tables;
- * one extractor, two consumers. Runs after `^build`, so it reads declarations,
- * never TS source.
+ * The one props extractor.
  *
- * Deliberately compiler-API-free: TypeScript 7 (this repo's compiler) no
- * longer ships the JS compiler API, and ADR-0003 already accepts cosmetic
- * fidelity risk on gnarly unions. This is a small structural scanner for the
- * declaration shape prism-ui emits — `export interface XProps [extends Y]`
- * with JSDoc-carried descriptions. Pass-through re-exports never match, and
- * that absence IS the Extends seam (ADR-0004): no extracted props means the
- * item is "antd X, unchanged".
+ * It reads `@nanisoft/prism-ui`'s emitted declarations, never its TypeScript
+ * source, and it is deliberately compiler-API-free: a small structural scanner
+ * for the declaration shapes this repository emits. Ticket 12 section 2 fixes
+ * the seam at the emitted `.d.ts`, so a compiler bump cannot break the corpus.
+ *
+ * The shapes it understands:
+ * - a named props type (`export type XProps = { ... }` or
+ *   `export interface XProps extends Y { ... }`), referenced by a function;
+ * - an inline props object on the function parameter;
+ * - `ComponentProps<'tag'>`, recorded as an inherited base rather than
+ *   expanded, so a native-backed component reports its element;
+ * - `VariantProps<typeof recipe>`, expanded from the emitted `cva` declaration
+ *   into the recipe's `variant` and `size` rows.
+ *
+ * One extractor, two renderers: the corpus's `## Props` definition list and the
+ * site's API reference table. There is no second extraction.
  */
 export interface ExtractedProp {
     readonly name: string;
@@ -24,14 +29,16 @@ export interface ExtractedProp {
     readonly defaultValue?: string;
 }
 export interface ExtractedInterface {
+    /** The public export name this interface describes. */
     readonly typeName: string;
-    /** The type this interface extends, when declared (e.g. `TitleProps`). */
+    /** The inherited base, when the annotation is not wholly Prism-authored. */
     readonly extendsType?: string;
     readonly props: readonly ExtractedProp[];
 }
+/** Extract every exported `*Props` interface from a declaration, in source order. */
+export declare function extractProps(source: string): ExtractedInterface[];
 /**
- * Extract every exported `*Props` interface from a `.d.ts` source, in source
- * order. Returns an empty array for re-export-only files (pass-throughs).
+ * Extract the props of the named exports from one declaration file's text.
+ * Exports with no declaration are reported with an empty prop list.
  */
-export declare function extractProps(source: string): ExtractedInterface[];
-//# sourceMappingURL=extractor.d.ts.map
+export declare function extractExports(source: string, exportNames: readonly string[]): ExtractedInterface[];