openuispec 0.1.14 → 0.1.15

package/README.md

@@ -155,6 +155,21 @@ brand:
 
 Validate with: `openuispec validate`
 
+## Output directories
+
+By default, drift stores state in `generated/<target>/<project>/`. To point targets to your actual code directories, add `output_dir` to `openuispec.yaml`:
+
+```yaml
+generation:
+  targets: [ios, android, web]
+  output_dir:
+    web: "../web-ui/"
+    android: "../kmp-ui/"
+    ios: "../kmp-ui/iosApp/"
+```
+
+Paths are relative to `openuispec.yaml`. The `.openuispec-state.json` file is stored inside each output directory.
+
 ## Spec at a glance
 
 | Section | What it defines |

package/cli/init.ts

@@ -106,6 +106,10 @@ i18n:
 
 generation:
   targets: [${targetList}]
+  # output_dir:                          # Optional: map targets to code directories
+  #   ios: "../ios-app/"                  # relative to this file
+  #   android: "../android-app/"
+  #   web: "../web-ui/"
   output_format:
 ${outputLines}
 
@@ -250,10 +254,23 @@ openuispec drift --snapshot --target ${targets[0]}  # Snapshot current state
 openuispec drift --all          # Include stubs in drift check
 \`\`\`
 
-## Targets
+## Targets and output directories
 
 This project generates native code for: **${targetList}**
 
+By default, drift stores state in \`generated/<target>/<project>/\`. To point targets to your actual code directories, add \`output_dir\` to \`openuispec.yaml\`:
+
+\`\`\`yaml
+generation:
+  targets: [ios, android, web]
+  output_dir:
+    web: "../web-ui/"
+    android: "../kmp-ui/"
+    ios: "../kmp-ui/iosApp/"
+\`\`\`
+
+Paths are relative to \`openuispec.yaml\`.
+
 ## Learn more
 
 All docs and examples are in the installed \`openuispec\` package — check \`node_modules/openuispec/\` or run \`npm root -g\` for the global install path.
@@ -377,6 +394,18 @@ Workflow: read the schema → read an example from \`examples/taskflow/\` → cr
 - Actions: typed objects (navigate, api_call, set_state, confirm, sequence, feedback, etc.)
 - Adaptive layout: size classes (compact, regular, expanded) with per-section overrides
 
+## Output directories
+Drift tracks spec changes per target. By default state is stored in \`generated/<target>/<project>/\`.
+To map targets to actual code directories, set \`generation.output_dir\` in \`openuispec.yaml\`:
+\`\`\`yaml
+generation:
+  output_dir:
+    web: "../web-ui/"
+    android: "../kmp-ui/"
+    ios: "../kmp-ui/iosApp/"
+\`\`\`
+Paths are relative to \`openuispec.yaml\`. The \`.openuispec-state.json\` file is stored inside each output directory.
+
 ## CLI commands
 - \`openuispec init\` — scaffold a new spec project
 - \`openuispec validate [group...]\` — validate spec files against schemas

package/drift/index.ts

@@ -159,27 +159,60 @@ function readProjectName(projectDir: string): string {
   return doc.project?.name ?? basename(projectDir);
 }
 
+/** Read per-target output_dir map from the manifest. */
+function readOutputDirs(projectDir: string): Record<string, string> {
+  try {
+    const doc = YAML.parse(readFileSync(join(projectDir, "openuispec.yaml"), "utf-8"));
+    return doc.generation?.output_dir ?? {};
+  } catch {
+    return {};
+  }
+}
+
 /** Resolve the generated output directory for a target. */
-function resolveOutputDir(cwd: string, projectName: string, target: string): string {
-  return resolve(cwd, "generated", target, projectName);
+function resolveOutputDir(projectDir: string, projectName: string, target: string): string {
+  const outputDirs = readOutputDirs(projectDir);
+  if (outputDirs[target]) {
+    return resolve(projectDir, outputDirs[target]);
+  }
+  // Default: generated/<target>/<project_name> relative to cwd
+  return resolve(projectDir, "..", "generated", target, projectName);
 }
 
-function stateFilePath(cwd: string, projectName: string, target: string): string {
-  return join(resolveOutputDir(cwd, projectName, target), STATE_FILE);
+function stateFilePath(projectDir: string, projectName: string, target: string): string {
+  return join(resolveOutputDir(projectDir, projectName, target), STATE_FILE);
 }
 
-function discoverTargets(cwd: string, projectName: string): string[] {
-  const generatedDir = resolve(cwd, "generated");
-  if (!existsSync(generatedDir)) return [];
-  try {
-    return readdirSync(generatedDir)
-      .filter((entry) =>
-        existsSync(stateFilePath(cwd, projectName, entry))
-      )
-      .sort();
-  } catch {
-    return [];
+function discoverTargets(projectDir: string, projectName: string): string[] {
+  const outputDirs = readOutputDirs(projectDir);
+  const targets: string[] = [];
+
+  // Check configured output_dir entries
+  for (const [target, dir] of Object.entries(outputDirs)) {
+    const resolved = resolve(projectDir, dir);
+    if (existsSync(join(resolved, STATE_FILE))) {
+      targets.push(target);
+    }
+  }
+
+  // Also check default generated/ directory
+  const generatedDir = resolve(projectDir, "..", "generated");
+  if (existsSync(generatedDir)) {
+    try {
+      for (const entry of readdirSync(generatedDir)) {
+        if (!targets.includes(entry)) {
+          const defaultPath = join(generatedDir, entry, projectName, STATE_FILE);
+          if (existsSync(defaultPath)) {
+            targets.push(entry);
+          }
+        }
+      }
+    } catch {
+      // ignore
+    }
   }
+
+  return targets.sort();
 }
 
 /**
@@ -197,7 +230,7 @@ function normalizeEntry(value: string | FileEntry): FileEntry {
 
 function snapshot(cwd: string, projectDir: string, target: string): void {
   const projectName = readProjectName(projectDir);
-  const outDir = resolveOutputDir(cwd, projectName, target);
+  const outDir = resolveOutputDir(projectDir, projectName, target);
   if (!existsSync(outDir)) {
     console.error(
       `Error: Output directory not found: ${relative(cwd, outDir)}\n` +
@@ -226,7 +259,7 @@ function snapshot(cwd: string, projectDir: string, target: string): void {
     files: entries,
   };
 
-  const outPath = stateFilePath(cwd, projectName, target);
+  const outPath = stateFilePath(projectDir, projectName, target);
   writeFileSync(outPath, JSON.stringify(state, null, 2) + "\n");
   console.log(`Snapshot saved: ${relative(cwd, outPath)}`);
   console.log(`  ${Object.keys(entries).length} files hashed`);
@@ -301,7 +334,7 @@ function check(
   includeAll: boolean
 ): void {
   const projectName = readProjectName(projectDir);
-  const statePath = stateFilePath(cwd, projectName, target);
+  const statePath = stateFilePath(projectDir, projectName, target);
   if (!existsSync(statePath)) {
     console.error(
       `No snapshot found for target "${target}".\n` +
@@ -331,7 +364,7 @@ function checkAll(
   includeAll: boolean
 ): void {
   const projectName = readProjectName(projectDir);
-  const targets = discoverTargets(cwd, projectName);
+  const targets = discoverTargets(projectDir, projectName);
   if (targets.length === 0) {
     console.error(
       "No snapshots found. Run: openuispec drift --snapshot --target <target>"
@@ -342,7 +375,7 @@ function checkAll(
   let anyDrift = false;
 
   for (const target of targets) {
-    const statePath = stateFilePath(cwd, projectName, target);
+    const statePath = stateFilePath(projectDir, projectName, target);
     const state: StateFile = JSON.parse(readFileSync(statePath, "utf-8"));
     const result = computeDrift(projectDir, state, includeAll);
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openuispec",
-  "version": "0.1.14",
+  "version": "0.1.15",
   "license": "MIT",
   "type": "module",
   "description": "A semantic UI specification format for AI-native, platform-native app development",

package/schema/openuispec.schema.json

@@ -104,6 +104,13 @@
             "type": "string"
           }
         },
+        "output_dir": {
+          "type": "object",
+          "description": "Per-target output directory (relative to openuispec.yaml). Defaults to generated/<target>/<project_name> if not set.",
+          "additionalProperties": {
+            "type": "string"
+          }
+        },
         "output_format": {
           "type": "object",
           "description": "Per-target generation config",