view-contracts 0.3.3 → 0.3.5

package/renderers/react/syncGeneratedRuntime.ts

@@ -1,4 +1,4 @@
-import { readFile, writeFile, mkdir, stat, rm } from 'node:fs/promises';
+import { readFile, writeFile, mkdir, stat, rm, unlink } from 'node:fs/promises';
 import { resolve } from 'node:path';
 import type { ViewContractsConfig } from '../../src/config.js';
 import { projectRoot } from '../../src/config.js';
@@ -14,64 +14,52 @@ async function pathExists(target: string): Promise<boolean> {
   }
 }
 
-async function removeStaleSchemaDir(componentsDir: string): Promise<void> {
-  const schemaDest = resolve(componentsDir, 'schema');
-  if (await pathExists(schemaDest)) {
-    await rm(schemaDest, { recursive: true, force: true });
+/** Remove legacy generated layout under generated/react/. */
+export async function removeLegacyReactRuntimeLayout(reactDir: string): Promise<void> {
+  const generatedRoot = resolve(reactDir, '..');
+  for (const dir of [resolve(reactDir, 'runtime'), resolve(generatedRoot, 'components'), resolve(generatedRoot, 'runtime')]) {
+    if (await pathExists(dir)) {
+      await rm(dir, { recursive: true, force: true });
+    }
+  }
+  for (const name of ['extensions.tsx', 'extensions.ts', 'contracts.ts'] as const) {
+    const stale = resolve(reactDir, name);
+    if (await pathExists(stale)) {
+      await unlink(stale);
+    }
   }
 }
 
-async function copyStyleBundle(componentsDir: string): Promise<void> {
-  const runtimeSrc = reactRuntimeDir();
-  await writeFile(resolve(componentsDir, 'style.ts'), await readFile(resolve(runtimeSrc, 'style.ts'), 'utf-8'), 'utf-8');
-  await writeFile(resolve(componentsDir, 'types.ts'), await readFile(resolve(runtimeSrc, 'types.ts'), 'utf-8'), 'utf-8');
+function stripDispatchImport(dispatchSource: string): string {
+  return dispatchSource.replace(/^import type \{ DispatchableAction \} from [^;]+;\n/gm, '');
 }
 
-/** Copy package runtime (style, types, dispatch) into generated/ — standalone output, no renderers/ imports. */
-export async function syncGeneratedRuntime(
+/** Emit generated/react/runtime.ts — fixed system runtime only (dispatch + style helpers). */
+export async function writeGeneratedRuntimeBundle(
   configPath: string,
   config: ViewContractsConfig,
   templatesDir?: string,
-): Promise<{ componentsDir: string; runtimeDir: string }> {
+): Promise<{ runtimePath: string }> {
   const root = projectRoot(configPath);
+  const reactDir = config.generated.reactDir;
   const templates = reactTemplatesDir(templatesDir ?? (config.rendererTemplatesDir ? resolve(root, config.rendererTemplatesDir) : undefined));
-  const componentsDir = resolve(config.generated.reactDir, '../components');
-  const runtimeDir = resolve(config.generated.reactDir, '../runtime');
+  const runtimeSrc = reactRuntimeDir();
 
-  await mkdir(componentsDir, { recursive: true });
-  await mkdir(runtimeDir, { recursive: true });
+  await mkdir(reactDir, { recursive: true });
+  await removeLegacyReactRuntimeLayout(reactDir);
 
-  await removeStaleSchemaDir(componentsDir);
-  await copyStyleBundle(componentsDir);
-  await writeFile(
-    resolve(componentsDir, 'style-helpers.ts'),
-    await renderTemplate(templates, 'style-helpers.ts.hbs', {}),
-    'utf-8',
-  );
-  await writeFile(
-    resolve(componentsDir, 'index.ts'),
-    await renderTemplate(templates, 'components-index.ts.hbs', {}),
-    'utf-8',
-  );
-  await writeFile(
-    resolve(runtimeDir, 'types.ts'),
-    await renderTemplate(templates, 'runtime-types.ts.hbs', {}),
-    'utf-8',
-  );
-  await writeFile(
-    resolve(runtimeDir, 'dispatch.ts'),
-    await renderTemplate(templates, 'dispatch.ts.hbs', {}),
-    'utf-8',
-  );
+  const typesBody = await readFile(resolve(runtimeSrc, 'types.ts'), 'utf-8');
+  const styleBody = await readFile(resolve(runtimeSrc, 'style.ts'), 'utf-8');
+  const dispatchRaw = await renderTemplate(templates, 'dispatch.ts.hbs', {});
+  const dispatchBody = stripDispatchImport(dispatchRaw);
 
-  return { componentsDir, runtimeDir };
-}
+  const content = await renderTemplate(templates, 'runtime.ts.hbs', {
+    typesBody: typesBody.trim(),
+    styleBody: styleBody.trim(),
+    dispatchBody: dispatchBody.trim(),
+  });
 
-/** Rewrite preview virtual imports to generated/components-relative paths. */
-export function rewriteExtensionImportsForGenerated(body: string): string {
-  return body
-    .replace(/from 'view-contracts:runtime\/dispatch'/g, "from '../runtime/dispatch.js'")
-    .replace(/from "view-contracts:runtime\/dispatch"/g, 'from "../runtime/dispatch.js"')
-    .replace(/from 'view-contracts:runtime\/types'/g, "from './types.js'")
-    .replace(/from "view-contracts:runtime\/types"/g, 'from "./types.js"');
+  const runtimePath = resolve(reactDir, 'runtime.ts');
+  await writeFile(runtimePath, content, 'utf-8');
+  return { runtimePath };
 }

package/renderers/react/templates/components-index.ts.hbs

@@ -1,5 +1,5 @@
 /** Auto-generated component barrel — DO NOT EDIT */
 export * from './extensions.js';
 export type { TableColumn } from './extensions.js';
-export { commonStyle, mapAlign, mapJustify, isHidden, toneClass } from './style.js';
-export type { Action, Option, LoweredStyleInput } from './types.js';
+export { extensionClassName, resolveExtensionVariant, isHidden, toneClass } from './style.js';
+export type { Action, Option } from './types.js';

package/renderers/react/templates/runtime.ts.hbs

@@ -0,0 +1,10 @@
+/** Auto-generated React runtime bundle — DO NOT EDIT */
+
+// --- types ---
+{{{typesBody}}}
+
+// --- style helpers ---
+{{{styleBody}}}
+
+// --- action dispatch ---
+{{{dispatchBody}}}

package/renderers/react/templates/style-helpers.ts.hbs

@@ -1,2 +1,2 @@
-/** Auto-generated style helpers for lowered JSX — DO NOT EDIT */
-export { commonStyle, extensionClassName, mapAlign, mapJustify, resolveExtensionVariant } from './style.js';
+/** Auto-generated style helpers for extensions — DO NOT EDIT */
+export { extensionClassName, resolveExtensionVariant } from './style.js';

package/renderers/swiftui/README.md

@@ -1,8 +1,15 @@
 # SwiftUI renderer scaffold
 
+**Not implemented yet** beyond theme / screen stubs. View IR lowering and modifier emission are future work.
+
+SwiftUI `ViewModifier` chains are **compositional** (not CSS-style override). view-contracts may later introduce a separate **modifier pipeline** concept (wrapper-style transforms, analogous to nested HTML layout shells) — that is **out of scope for the current phase**. When styling is implemented, defaults + variant + instance props will be **folded at compile time** into resolved values, not chained for cascade-like override. See [docs/ARCHITECTURE.md](../../docs/ARCHITECTURE.md) § Native renderers.
+
 - Maps: `elements.yaml`, `properties.yaml` (hand-maintained under this directory)
 - Routes: `routes.yaml`
 - Templates: `templates/`
+- Theme codegen spec: [../NATIVE_THEME_EMIT.md](../NATIVE_THEME_EMIT.md)
 
 Implement SwiftUI code generation by reading View IR + renderer maps.
+Theme is emitted at build time via `src/design/emit/swiftui.ts` and `templates/theme/*.hbs` — same Token IR + Theme IR as React `theme.css`, not runtime JSON.
+
 Extend vocabulary via `spec/ui-dsl.schema.json` (from `ui-dsl-*.csv`), then update renderer maps.

package/renderers/swiftui/templates/Screen.swift.hbs

@@ -1,8 +1,6 @@
-// {{screenName}} — SwiftUI scaffold (Phase 5)
-// Theme IR: {{themeJsonPath}}
-// Token IR: {{tokensJsonPath}}
-//
-// TODO(Phase B): Load theme.json and emit PrimaryButtonStyle(), vcTextMuted(), etc.
+// {{screenName}} — SwiftUI scaffold
+// View IR lowering: renderers/swiftui/lowerToSwiftUI.ts (planned)
+// Theme: renderers/NATIVE_THEME_EMIT.md
 
 import SwiftUI
 

package/renderers/swiftui/templates/VcTheme.swift.hbs

@@ -1,21 +1,13 @@
-// VcTheme — SwiftUI theme scaffold (Phase 5)
-// Load Token IR + Theme IR from bundle resources:
-//   {{tokensJsonPath}}
-//   {{themeJsonPath}}
+// VcTheme — SwiftUI theme (scaffold placeholder)
 //
-// TODO(Phase B): Map Theme IR variants to ButtonStyle / ViewModifier implementations.
+// Theme is emitted at build time from Token IR + Theme IR via Handlebars templates.
+// See renderers/NATIVE_THEME_EMIT.md — not loaded from JSON at runtime.
+//
+// Implementation: src/design/emit/swiftui.ts + renderers/swiftui/templates/theme/*.hbs
+// Output target: generated/swiftui/Theme/
 
-import Foundation
+import SwiftUI
 
 enum VcTheme {
-    static let tokensResource = "{{tokensJsonPath}}"
-    static let themeResource = "{{themeJsonPath}}"
-
-    /// Placeholder — decode theme.json into Swift types in Phase B.
-    static func loadThemeJson() -> Data? {
-        guard let url = Bundle.main.url(forResource: themeResource, withExtension: nil) else {
-            return nil
-        }
-        return try? Data(contentsOf: url)
-    }
+    // Populated by emitSwiftUITheme() when swiftui target is enabled.
 }