view-contracts 0.3.4 → 0.4.0

package/README.md

@@ -111,19 +111,21 @@ The generated output is deterministic.
 ### Supported
 
 - React generation (`generated/react/` — screens, `runtime.ts`, `theme.css`, …)
+- SwiftUI generation (`generated/swiftui/` — full DSL element coverage, theme variant dictionary, `SampleData.json` from mock YAML SSoT)
 - Design tokens + theme variants (`views/design/tokens.yaml`, `theme.yaml`)
 - Live DSL preview (`dev:preview`) with `views/preview/*.mock.yaml` sample data
 - Extension registry (`extensions.yaml`) with plain HTML/CSS implementations
 - In-memory View IR compilation
 - Standalone app scaffold (`.vite/` per example project)
+- Table DSL with configurable `separator` / `separatorColor` / `border` / `borderColor`
+- Dynamic variant resolution via `IrConcat` (runtime theme dictionary in SwiftUI)
 
 ### Planned
 
-- SwiftUI renderer
 - Jetpack Compose renderer
 - PDF renderer
 
-The contract model is designed for multi-target generation, but the first production target is React.
+The contract model is designed for multi-target generation. React and SwiftUI are production-ready targets.
 
 ---
 
@@ -238,6 +240,11 @@ examples/admin-dashboard/
 │   └── preview/        # *.mock.yaml — preview sample ViewModels only
 ├── src/                # app wiring, extension components (HTML/CSS), handlers
 ├── generated/          # build output (standalone — no @view-contracts imports)
+│   ├── react/          # React generated code
+│   └── swiftui/        # SwiftUI generated code + SampleData.json
+├── ios-preview/        # SwiftUI preview app (XcodeGen project)
+│   ├── Sources/        # ContentView, ViewModels (Codable, loads SampleData.json)
+│   └── project.yml     # XcodeGen definition
 ├── contracts/          # OpenAPI + micro-contracts config
 ├── extensions.yaml     # extension registry (Grid, Table, …)
 ├── dev.ports.ts        # fixed dev server ports
@@ -270,7 +277,7 @@ packages/
 
 renderers/
 ├── react/              # lowering, element map, runtime, templates
-├── swiftui/            # (planned)
+├── swiftui/            # lowering, theme dictionary, modifier cascade
 └── compose/            # (planned)
 
 docs/

package/cli-contract.yaml

@@ -3,7 +3,7 @@ cli_contracts: 0.1.0
 
 info:
   title: view-contracts CLI
-  version: 0.3.3
+  version: 0.3.5
   description: >-
     Contract-first UI design toolchain. Compiles restricted view-contract TSX
     to language-neutral View IR and renders platform targets (React, SwiftUI, Compose).
@@ -162,3 +162,43 @@ command_sets:
             description: Lint passed.
           '1':
             description: Lint failed.
+
+      preview:
+        summary: Start DSL preview HTTP server.
+        description: >-
+          Compiles views/*.view.tsx on demand and serves a React preview over HTTP.
+          No Vite setup required in the consumer project.
+        usage:
+          - view-contracts preview
+          - view-contracts preview -c view-contracts.config.yaml
+          - view-contracts preview --port 3000 --screen AdminDashboard
+        options:
+          - name: config
+            aliases: [c]
+            description: Path to view-contracts.config.yaml (discovered upward from cwd when omitted).
+            value_name: path
+            schema:
+              type: string
+          - name: port
+            aliases: [p]
+            description: HTTP listen port.
+            value_name: number
+            schema:
+              type: integer
+            default: 5173
+          - name: host
+            description: HTTP listen host.
+            value_name: address
+            schema:
+              type: string
+            default: 127.0.0.1
+          - name: screen
+            description: Screen name from view-bindings.yaml (default first react target).
+            value_name: name
+            schema:
+              type: string
+        exits:
+          '0':
+            description: Server stopped normally.
+          '1':
+            description: Startup or compile failed.

package/dist/preview-style-helpers.js

@@ -0,0 +1,2 @@
+function o(t){return t.replace(/([a-z])([A-Z])/g,"$1-$2").toLowerCase()}var a=new Set(["default","muted"]);function i(t,n){let e=t??n;return!e||a.has(e)?"default":e}function f(t,n){let e=`vc-${o(t)}`,s=i(n?.variant,n?.tone),r=[e,`${e}--${s}`];return n?.extra&&r.push(n.extra),r.filter(Boolean).join(" ")}export{f as extensionClassName,i as resolveExtensionVariant};
+//# sourceMappingURL=preview-style-helpers.js.map

package/dist/preview-style-helpers.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../renderers/react/runtime/style.ts"],
+  "sourcesContent": ["/** Map flex alignment shorthand to CSS align-items / align-self values. */\nexport function mapAlign(value?: string): string | undefined {\n  if (!value) return undefined;\n  if (value === 'start') return 'flex-start';\n  if (value === 'end') return 'flex-end';\n  return value;\n}\n\n/** Map flex justification shorthand to CSS justify-content values. */\nexport function mapJustify(value?: string): string | undefined {\n  if (!value) return undefined;\n  if (value === 'start') return 'flex-start';\n  if (value === 'end') return 'flex-end';\n  if (value === 'between' || value === 'spaceBetween') return 'space-between';\n  if (value === 'around' || value === 'spaceAround') return 'space-around';\n  if (value === 'spaceEvenly') return 'space-evenly';\n  return value;\n}\n\n/** Preview vocabulary helper \u2014 production lowered JSX uses visibility guards instead. */\nexport function isHidden(props: { visible?: boolean; hidden?: boolean }): boolean {\n  return props.hidden === true || props.visible === false;\n}\n\n/** Sample/extension helper for preview tone class names. */\nexport function toneClass(tone: string | undefined): string {\n  return tone ? `ui-tone-${tone}` : 'ui-tone-default';\n}\n\nfunction componentToKebab(name: string): string {\n  return name.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase();\n}\n\nconst DEFAULT_VARIANT_ALIASES = new Set(['default', 'muted']);\n\n/** Resolve theme variant name from variant or legacy tone prop. */\nexport function resolveExtensionVariant(variant?: string, tone?: string): string {\n  const raw = variant ?? tone;\n  if (!raw || DEFAULT_VARIANT_ALIASES.has(raw)) return 'default';\n  return raw;\n}\n\n/** Build vc-* base + --variant modifier for themed extension components. */\nexport function extensionClassName(\n  component: string,\n  options?: { variant?: string; tone?: string; extra?: string | false },\n): string {\n  const base = `vc-${componentToKebab(component)}`;\n  const variant = resolveExtensionVariant(options?.variant, options?.tone);\n  const parts = [base, `${base}--${variant}`];\n  if (options?.extra) parts.push(options.extra);\n  return parts.filter(Boolean).join(' ');\n}\n"],
+  "mappings": "AA6BA,SAASA,EAAiBC,EAAsB,CAC9C,OAAOA,EAAK,QAAQ,kBAAmB,OAAO,EAAE,YAAY,CAC9D,CAEA,IAAMC,EAA0B,IAAI,IAAI,CAAC,UAAW,OAAO,CAAC,EAGrD,SAASC,EAAwBC,EAAkBC,EAAuB,CAC/E,IAAMC,EAAMF,GAAWC,EACvB,MAAI,CAACC,GAAOJ,EAAwB,IAAII,CAAG,EAAU,UAC9CA,CACT,CAGO,SAASC,EACdC,EACAC,EACQ,CACR,IAAMC,EAAO,MAAMV,EAAiBQ,CAAS,CAAC,GACxCJ,EAAUD,EAAwBM,GAAS,QAASA,GAAS,IAAI,EACjEE,EAAQ,CAACD,EAAM,GAAGA,CAAI,KAAKN,CAAO,EAAE,EAC1C,OAAIK,GAAS,OAAOE,EAAM,KAAKF,EAAQ,KAAK,EACrCE,EAAM,OAAO,OAAO,EAAE,KAAK,GAAG,CACvC",
+  "names": ["componentToKebab", "name", "DEFAULT_VARIANT_ALIASES", "resolveExtensionVariant", "variant", "tone", "raw", "extensionClassName", "component", "options", "base", "parts"]
+}