@auto-engineer/component-implementor-react 1.110.0 → 1.110.2

package/src/generate-story-deterministic.ts

@@ -1,267 +0,0 @@
-// ═══════════════════════════════════════════════════════════════════
-// Deterministic story generator — no LLM call, pure template logic
-// ═══════════════════════════════════════════════════════════════════
-
-export interface DeterministicStoryProp {
-  name: string;
-  type: string;
-  required: boolean;
-  default?: string;
-  description: string;
-  category: 'data' | 'callback' | 'slot' | 'visual' | 'state' | 'config';
-}
-
-export interface StoryVariant {
-  name: string;
-  description: string;
-  args: Record<string, unknown>;
-  needsPlayFunction?: boolean;
-  playDescription?: string;
-}
-
-export interface DeterministicStoryInput {
-  componentName: string;
-  componentImportPath: string;
-  props?: DeterministicStoryProp[];
-  storyVariants?: StoryVariant[];
-}
-
-/**
- * Generates a Storybook CSF3 story file deterministically (no LLM call).
- *
- * Uses structured prop data and optional story variants to emit a complete
- * `.stories.tsx` file string. When no variants are provided, a Default
- * story is synthesized from the props with sensible placeholder values.
- */
-export function generateStoryDeterministic(input: DeterministicStoryInput): string {
-  const { componentName, componentImportPath, props, storyVariants } = input;
-
-  const lines: string[] = [];
-
-  // ── Imports ──────────────────────────────────────────────────────
-  lines.push(`import type { Meta, StoryObj } from '@storybook/react-vite';`);
-  lines.push(`import { ${componentName} } from '${componentImportPath}';`);
-  lines.push('');
-
-  // ── Meta ─────────────────────────────────────────────────────────
-  lines.push(`const meta: Meta<typeof ${componentName}> = {`);
-  lines.push(`  title: 'UI Components/${componentName}',`);
-  lines.push(`  component: ${componentName},`);
-  lines.push(`};`);
-  lines.push(`export default meta;`);
-  lines.push('');
-
-  // ── Story type alias ─────────────────────────────────────────────
-  lines.push(`type Story = StoryObj<typeof ${componentName}>;`);
-
-  // ── Stories ──────────────────────────────────────────────────────
-  if (storyVariants && storyVariants.length > 0) {
-    for (const variant of storyVariants) {
-      lines.push('');
-      lines.push(`export const ${variant.name}: Story = {`);
-      const argsBlock = serializeArgs(variant.args);
-      if (argsBlock) {
-        lines.push(`  args: {`);
-        lines.push(argsBlock);
-        lines.push(`  },`);
-      }
-      lines.push(`};`);
-    }
-  } else {
-    // Derive a Default story from props
-    const defaultArgs = deriveDefaultArgs(props ?? []);
-    lines.push('');
-    lines.push(`export const Default: Story = {`);
-    const argsBlock = serializeArgs(defaultArgs);
-    if (argsBlock) {
-      lines.push(`  args: {`);
-      lines.push(argsBlock);
-      lines.push(`  },`);
-    }
-    lines.push(`};`);
-  }
-
-  lines.push('');
-  return lines.join('\n');
-}
-
-// ═══════════════════════════════════════════════════════════════════
-// Internals
-// ═══════════════════════════════════════════════════════════════════
-
-/**
- * Derives sensible default arg values from structured prop definitions.
- *
- * - `callback` props are omitted (Storybook auto-detects them via argTypes).
- * - `slot` props are omitted (ReactNode cannot be serialized to args).
- * - `data` props get placeholder values based on their TypeScript type.
- * - `visual` props use the declared default if present, otherwise a placeholder.
- * - `state` props default to `false`.
- * - `config` props use the declared default if present, otherwise a placeholder.
- */
-function deriveDefaultArgs(props: DeterministicStoryProp[]): Record<string, unknown> {
-  const args: Record<string, unknown> = {};
-
-  for (const prop of props) {
-    // Skip categories that cannot or should not be serialized in args
-    if (prop.category === 'callback' || prop.category === 'slot') {
-      continue;
-    }
-
-    if (prop.category === 'state') {
-      args[prop.name] = false;
-      continue;
-    }
-
-    // If a default is declared, try to use it
-    if (prop.default !== undefined) {
-      const parsed = parseDefaultValue(prop.default);
-      if (parsed !== undefined) {
-        args[prop.name] = parsed;
-        continue;
-      }
-    }
-
-    // Otherwise generate a placeholder based on the TypeScript type string
-    args[prop.name] = placeholderForType(prop.type);
-  }
-
-  return args;
-}
-
-/**
- * Attempts to parse a default value string into a JS primitive.
- * Returns `undefined` when the string cannot be meaningfully parsed
- * (e.g. an arrow function or complex expression).
- */
-function parseDefaultValue(raw: string): unknown {
-  const trimmed = raw.trim();
-  if (trimmed === 'true') return true;
-  if (trimmed === 'false') return false;
-  if (trimmed === 'null') return null;
-  if (trimmed === 'undefined') return undefined;
-
-  // Quoted string
-  const stringMatch = trimmed.match(/^['"](.*)['"]$/);
-  if (stringMatch) return stringMatch[1];
-
-  // Numeric
-  const num = Number(trimmed);
-  if (!Number.isNaN(num) && trimmed !== '') return num;
-
-  // Array or object literal — attempt JSON parse
-  if (trimmed.startsWith('[') || trimmed.startsWith('{')) {
-    try {
-      return JSON.parse(trimmed);
-    } catch {
-      return undefined;
-    }
-  }
-
-  // Anything else (functions, expressions) → skip
-  return undefined;
-}
-
-/**
- * Returns a sensible placeholder value for a given TypeScript type string.
- */
-function placeholderForType(typeStr: string): unknown {
-  const t = typeStr.trim();
-
-  if (t === 'string') return 'Example';
-  if (t === 'number') return 42;
-  if (t === 'boolean') return true;
-
-  // Union of string literals — pick the first literal
-  const literalUnion = t.match(/^['"]([^'"]+)['"]/);
-  if (literalUnion) return literalUnion[1];
-
-  // Array types
-  if (t.endsWith('[]') || t.startsWith('Array<')) return [];
-
-  // Generic object / Record
-  if (t === 'object' || t.startsWith('Record<') || t.startsWith('{')) return {};
-
-  // Fallback
-  return undefined;
-}
-
-/**
- * Serializes an args record into indented TypeScript object body lines.
- * Returns an empty string when the args record is empty (caller should
- * omit the `args` block entirely).
- *
- * Each value is formatted as a valid TypeScript literal:
- * - strings → quoted
- * - numbers / booleans → as-is
- * - arrays / plain objects → JSON.stringify
- * - undefined, null, functions → skipped
- */
-function serializeArgs(args: Record<string, unknown>): string {
-  const entries: string[] = [];
-
-  for (const [key, value] of Object.entries(args)) {
-    const formatted = formatArgValue(value);
-    if (formatted === null) continue;
-    entries.push(`    ${key}: ${formatted},`);
-  }
-
-  return entries.join('\n');
-}
-
-function formatArgValue(value: unknown): string | null {
-  if (value === undefined) return null;
-  if (value === null) return null;
-  if (typeof value === 'function') return null;
-
-  if (typeof value === 'string') {
-    // Callback strings like "() => {}" — emit as raw JS, not quoted
-    if (/^\s*\(/.test(value) || /^\s*function\s*\(/.test(value)) {
-      return value;
-    }
-    return JSON.stringify(value);
-  }
-  if (typeof value === 'number') return String(value);
-  if (typeof value === 'boolean') return String(value);
-
-  // Arrays and plain objects — deep-fix stringified JSON values first
-  if (Array.isArray(value) || typeof value === 'object') {
-    const fixed = deepParseStringifiedJson(value);
-    return JSON.stringify(fixed);
-  }
-
-  return null;
-}
-
-/**
- * Recursively walks a value and parses any string that looks like
- * stringified JSON back into an actual object/array. This fixes
- * FEA output where nested objects are accidentally double-stringified.
- */
-function deepParseStringifiedJson(value: unknown): unknown {
-  if (typeof value === 'string') {
-    const trimmed = value.trim();
-    if ((trimmed.startsWith('{') && trimmed.endsWith('}')) || (trimmed.startsWith('[') && trimmed.endsWith(']'))) {
-      try {
-        return deepParseStringifiedJson(JSON.parse(trimmed));
-      } catch {
-        return value;
-      }
-    }
-    return value;
-  }
-
-  if (Array.isArray(value)) {
-    return value.map(deepParseStringifiedJson);
-  }
-
-  if (value !== null && typeof value === 'object') {
-    const result: Record<string, unknown> = {};
-    for (const [k, v] of Object.entries(value)) {
-      result[k] = deepParseStringifiedJson(v);
-    }
-    return result;
-  }
-
-  return value;
-}