@eide/uniformgen 0.1.0

package/dist/commands/scaffold.js

@@ -0,0 +1,366 @@
+/**
+ * Scaffold Command
+ *
+ * Generates component stubs for EIDE entity models using @eide/foir-renderer.
+ * Creates type-safe components that integrate with the EntityRenderer.
+ */
+import chalk from 'chalk';
+import ora from 'ora';
+import { mkdir, writeFile, access } from 'fs/promises';
+import { join } from 'path';
+import { loadConfig } from '../config/load-config.js';
+import { getSettings } from '../config/settings.js';
+import { fetchEntityModels } from '../fetcher/fetch-schemas.js';
+/**
+ * Convert kebab-case to PascalCase
+ */
+function toPascalCase(str) {
+    return str
+        .split('-')
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join('');
+}
+/**
+ * Generate entity component (page, product, collection, etc.)
+ */
+function generateEntityComponent(model) {
+    const componentName = toPascalCase(model.key);
+    const propsName = `${componentName}Props`;
+    return `/**
+ * ${model.name} Component
+ *
+ * Entity component for rendering ${model.key} content.
+ * ${model.description || ''}
+ *
+ * @generated by uniformgen scaffold - customize as needed
+ */
+
+import type { EntityComponentProps } from '@eide/foir-renderer';
+import type { ${componentName}Data } from '../types/models/${model.key}';
+
+export type ${propsName} = EntityComponentProps<${componentName}Data>;
+
+export function ${componentName}({
+  data,
+  zones,
+  metadata,
+  breadcrumbs,
+  breakpoint,
+}: ${propsName}) {
+  return (
+    <article className="${model.key}" data-breakpoint={breakpoint}>
+      {/* Breadcrumbs */}
+      {breadcrumbs && breadcrumbs.length > 0 && (
+        <nav className="${model.key}__breadcrumbs" aria-label="Breadcrumb">
+          <ol>
+            {breadcrumbs.map((crumb, index) => (
+              <li key={crumb.url}>
+                {index < breadcrumbs.length - 1 ? (
+                  <a href={crumb.url}>{crumb.label}</a>
+                ) : (
+                  <span aria-current="page">{crumb.label}</span>
+                )}
+              </li>
+            ))}
+          </ol>
+        </nav>
+      )}
+
+      {/* Main content zone */}
+      {zones.default && (
+        <section className="${model.key}__content">
+          {zones.default}
+        </section>
+      )}
+
+      {/* Sidebar zone (if exists) */}
+      {zones.sidebar && (
+        <aside className="${model.key}__sidebar">
+          {zones.sidebar}
+        </aside>
+      )}
+
+      {/* Additional zones */}
+      {Object.entries(zones)
+        .filter(([key]) => !['default', 'sidebar'].includes(key))
+        .map(([key, content]) => (
+          <section key={key} className={\`${model.key}__\${key}\`}>
+            {content}
+          </section>
+        ))}
+    </article>
+  );
+}
+`;
+}
+/**
+ * Generate inline component (hero-banner, product-card, etc.)
+ */
+function generateInlineComponent(model) {
+    const componentName = toPascalCase(model.key);
+    const propsName = `${componentName}Props`;
+    const fields = model.fields || [];
+    // Generate typed data interface
+    const dataFields = fields
+        .map((f) => {
+        const type = getFieldTypeString(f.type);
+        const optional = f.required ? '' : '?';
+        return `  ${f.key}${optional}: ${type};`;
+    })
+        .join('\n');
+    const dataType = fields.length > 0
+        ? `interface ${componentName}Data {\n${dataFields}\n}`
+        : `type ${componentName}Data = Record<string, unknown>`;
+    return `/**
+ * ${model.name} Component
+ *
+ * Inline component for rendering ${model.key} fields.
+ * ${model.description || ''}
+ *
+ * @generated by uniformgen scaffold - customize as needed
+ */
+
+import type { InlineComponentProps } from '@eide/foir-renderer';
+
+${dataType}
+
+export type ${propsName} = InlineComponentProps<${componentName}Data>;
+
+export function ${componentName}({
+  data,
+  field,
+  layout,
+  breakpoint,
+  children,
+}: ${propsName}) {
+  return (
+    <div
+      className="${model.key}"
+      data-field={field?.key}
+      data-breakpoint={breakpoint}
+    >
+${fields.map((f) => generateFieldRenderer(f, model.key)).join('\n')}
+
+      {/* Nested children (composites containing composites) */}
+      {children}
+    </div>
+  );
+}
+`;
+}
+/**
+ * Get TypeScript type string for a field type
+ */
+function getFieldTypeString(type) {
+    switch (type) {
+        case 'text':
+            return 'string';
+        case 'richtext':
+            return 'string | { html: string; text?: string }';
+        case 'number':
+            return 'number';
+        case 'boolean':
+            return 'boolean';
+        case 'date':
+            return 'string | Date';
+        case 'image':
+            return '{ url: string; alt?: string; width?: number; height?: number }';
+        case 'video':
+            return '{ url: string; poster?: string }';
+        case 'select':
+            return 'string';
+        case 'list':
+            return 'unknown[]';
+        case 'json':
+            return 'Record<string, unknown>';
+        default:
+            // Custom field type (entity reference or composite)
+            return 'unknown';
+    }
+}
+/**
+ * Generate JSX for rendering a field
+ */
+function generateFieldRenderer(field, parentKey) {
+    const className = `${parentKey}__${field.key}`;
+    const dataAccess = `data.${field.key}`;
+    switch (field.type) {
+        case 'text':
+            return `      {${dataAccess} && (
+        <div className="${className}">{${dataAccess}}</div>
+      )}`;
+        case 'richtext':
+            return `      {${dataAccess} && (
+        <div
+          className="${className}"
+          dangerouslySetInnerHTML={{
+            __html: typeof ${dataAccess} === 'string' ? ${dataAccess} : ${dataAccess}.html || ''
+          }}
+        />
+      )}`;
+        case 'image':
+            return `      {${dataAccess}?.url && (
+        <img
+          className="${className}"
+          src={${dataAccess}.url}
+          alt={${dataAccess}.alt || ''}
+          width={${dataAccess}.width}
+          height={${dataAccess}.height}
+        />
+      )}`;
+        case 'video':
+            return `      {${dataAccess}?.url && (
+        <video
+          className="${className}"
+          src={${dataAccess}.url}
+          poster={${dataAccess}.poster}
+          controls
+        />
+      )}`;
+        case 'boolean':
+            return `      {/* ${field.label || field.key}: ${dataAccess} */}`;
+        case 'number':
+            return `      {${dataAccess} !== undefined && (
+        <span className="${className}">{${dataAccess}}</span>
+      )}`;
+        default:
+            return `      {/* TODO: Render ${field.key} (${field.type}) */}`;
+    }
+}
+/**
+ * Generate component registry file
+ */
+function generateRegistry(models) {
+    const entityModels = models.filter((m) => m.modes.records && m.modes.publicApi);
+    const inlineModels = models.filter((m) => m.modes.inline);
+    const imports = [
+        ...entityModels.map((m) => `import { ${toPascalCase(m.key)} } from './${m.key}';`),
+        ...inlineModels.map((m) => `import { ${toPascalCase(m.key)} } from './${m.key}';`),
+    ].join('\n');
+    const components = [
+        ...entityModels.map((m) => `  '${m.key}': ${toPascalCase(m.key)},`),
+        ...inlineModels.map((m) => `  '${m.key}': ${toPascalCase(m.key)},`),
+    ].join('\n');
+    return `/**
+ * Component Registry
+ *
+ * Maps entity model keys to React components for use with EntityRenderer.
+ *
+ * @generated by uniformgen scaffold - customize as needed
+ */
+
+import { createRegistry } from '@eide/foir-renderer';
+${imports}
+
+export const registry = createRegistry({
+  components: {
+${components}
+  },
+  layout: {
+    defaultMode: 'auto',
+  },
+});
+
+export default registry;
+`;
+}
+/**
+ * Generate components index file
+ */
+function generateComponentsIndex(models) {
+    const exports = models
+        .map((m) => `export { ${toPascalCase(m.key)} } from './${m.key}';`)
+        .join('\n');
+    return `/**
+ * Generated EIDE Components
+ *
+ * @generated by uniformgen scaffold - customize as needed
+ */
+
+${exports}
+export { registry } from './registry';
+`;
+}
+/**
+ * Main scaffold function
+ */
+export async function scaffold(options) {
+    const spinner = ora();
+    try {
+        // Load configuration
+        spinner.start('Loading configuration...');
+        const config = await loadConfig(options.config, process.cwd());
+        // Override config with CLI options
+        if (options.apiUrl)
+            config.apiUrl = options.apiUrl;
+        // Get framework from settings or options
+        const settings = await getSettings();
+        const framework = options.framework || config.framework || settings.framework || 'react';
+        spinner.succeed('Configuration loaded');
+        // Fetch entity models
+        spinner.start(`Fetching entity models from ${config.apiUrl}...`);
+        let entityModels = await fetchEntityModels(config.apiUrl, config.accessToken, config.tenantId, config.projectId, { includeInline: true });
+        // Filter to specific models if --models provided
+        if (options.models) {
+            const modelKeys = options.models.split(',').map((k) => k.trim());
+            entityModels = entityModels.filter((m) => modelKeys.includes(m.key));
+        }
+        spinner.succeed(`Fetched ${entityModels.length} entity models`);
+        // Create output directory
+        const componentsDir = options.componentsDir || join(process.cwd(), 'src/components/foir');
+        await mkdir(componentsDir, { recursive: true });
+        // Generate component files
+        spinner.start(`Generating ${entityModels.length} component stubs...`);
+        const files = [];
+        for (const model of entityModels) {
+            const filePath = join(componentsDir, `${model.key}.tsx`);
+            // Check if file exists and skip unless --overwrite
+            if (!options.overwrite) {
+                try {
+                    await access(filePath);
+                    console.log(chalk.yellow(`  Skipping ${model.key}.tsx (exists, use --overwrite to replace)`));
+                    continue;
+                }
+                catch {
+                    // File doesn't exist, proceed
+                }
+            }
+            // Generate appropriate component type
+            const content = model.modes.records && model.modes.publicApi
+                ? generateEntityComponent(model)
+                : generateInlineComponent(model);
+            files.push({ path: filePath, content });
+        }
+        // Generate registry
+        files.push({
+            path: join(componentsDir, 'registry.ts'),
+            content: generateRegistry(entityModels),
+        });
+        // Generate index
+        files.push({
+            path: join(componentsDir, 'index.ts'),
+            content: generateComponentsIndex(entityModels),
+        });
+        // Write files
+        for (const file of files) {
+            await writeFile(file.path, file.content, 'utf-8');
+        }
+        spinner.succeed(`Generated ${files.length} files`);
+        console.log(chalk.green('\n✓ Component scaffolding complete!'));
+        console.log(chalk.gray(`  Output: ${componentsDir}`));
+        console.log(chalk.gray(`  Framework: ${framework}`));
+        console.log('');
+        console.log(chalk.cyan('Next steps:'));
+        console.log(chalk.gray('  1. Customize the generated components'));
+        console.log(chalk.gray('  2. Import and use the registry with EntityRenderer:'));
+        console.log('');
+        console.log(chalk.gray(`     import { EntityRenderer } from '@eide/foir-renderer';`));
+        console.log(chalk.gray(`     import { registry } from '${componentsDir.replace(process.cwd(), '.')}';`));
+        console.log('');
+        console.log(chalk.gray('     <EntityRenderer data={resolvedRoute} registry={registry} />'));
+    }
+    catch (error) {
+        spinner.fail('Scaffolding failed');
+        throw error;
+    }
+}

package/dist/commands/seed.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Seed Command
+ *
+ * Seeds content data to a Foir project from local JSON/YAML files.
+ * Useful for bootstrapping starter content in templates.
+ */
+export interface SeedOptions {
+    apiUrl: string;
+    seedDir: string;
+    pattern?: string;
+    publish?: boolean;
+    dryRun?: boolean;
+    upsert?: boolean;
+    config?: string;
+}
+/**
+ * Main seed function
+ */
+export declare function seed(options: SeedOptions): Promise<void>;
+//# sourceMappingURL=seed.d.ts.map

package/dist/commands/seed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../../src/commands/seed.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAyND;;GAEG;AACH,wBAAsB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAuP9D"}