@sprig-and-prose/sprig 0.9.1 → 0.10.0

package/scripts/switch-deps.js

@@ -1,44 +0,0 @@
-#!/usr/bin/env node
-
-import { readFileSync, writeFileSync } from 'fs';
-import { fileURLToPath } from 'url';
-import { dirname, join } from 'path';
-import { execSync } from 'child_process';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-const packageJsonPath = join(__dirname, '..', 'package.json');
-
-const mode = process.argv[2]; // 'local' or 'published'
-
-if (!mode || !['local', 'published'].includes(mode)) {
-  console.error('Usage: node scripts/switch-deps.js [local|published]');
-  process.exit(1);
-}
-
-const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
-
-if (mode === 'local') {
-  // Switch to local file: protocol
-  packageJson.dependencies['@sprig-and-prose/sprig-universe'] = 'file:../sprig-universe';
-  packageJson.dependencies['@sprig-and-prose/sprig-ui-csr'] = 'file:../sprig-ui-csr';
-  console.log('✓ Switched to local dependencies');
-} else {
-  // Fetch latest published versions from npm
-  console.log('Fetching latest published versions...');
-  try {
-    const universeVersion = execSync('npm view @sprig-and-prose/sprig-universe version', { encoding: 'utf-8' }).trim();
-    const uiVersion = execSync('npm view @sprig-and-prose/sprig-ui-csr version', { encoding: 'utf-8' }).trim();
-    
-    packageJson.dependencies['@sprig-and-prose/sprig-universe'] = `^${universeVersion}`;
-    packageJson.dependencies['@sprig-and-prose/sprig-ui-csr'] = `^${uiVersion}`;
-    console.log(`✓ Switched to published dependencies (universe: ^${universeVersion}, ui-csr: ^${uiVersion})`);
-  } catch (error) {
-    console.error('Error fetching latest versions from npm:', error.message);
-    process.exit(1);
-  }
-}
-
-writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2) + '\n');
-console.log('✓ Updated package.json');
-

package/src/scene-compiler.ts

@@ -1,192 +0,0 @@
-import { readFileSync, writeFileSync, mkdirSync, renameSync, unlinkSync } from "node:fs";
-import { join, basename } from "node:path";
-import { execSync } from "node:child_process";
-import fg from "fast-glob";
-// Import directly from compile_scene to avoid scene-engine dependency
-// @ts-expect-error - sprig-scenes doesn't have full TypeScript types
-import { compileSceneFromText } from "@sprig-and-prose/sprig-scenes/compiler/compile_scene";
-
-export interface SceneCompileResult {
-  success: boolean;
-  scenes: string[];
-  diagnostics: Array<{ severity: string; message: string; source?: unknown; scene?: string }>;
-}
-
-/** Base name for output files derived from scene prose path (e.g. 05-group.scene.prose → 05-group). */
-function sceneFileBaseName(sceneFile: string): string {
-  return basename(sceneFile).replace(/\.scene\.prose$/i, "") || "scene";
-}
-
-/**
- * Write compile errors to <base>.error.txt in outputDir.
- * One line per error, then "  at <scene-name>" if scene name was parsed from source, else "  in <filename>".
- */
-function writeSceneErrors(
-  outputDir: string,
-  sceneFile: string,
-  errors: string[],
-  sourceText: string,
-): void {
-  const base = sceneFileBaseName(sceneFile);
-  const sceneNameMatch = sourceText.match(/\bscene\s+([A-Za-z_][A-Za-z0-9_]*)\s*\{/);
-  const locationLine = sceneNameMatch
-    ? "  at " + sceneNameMatch[1] + "\n"
-    : "  in " + base + "\n";
-  const errorPath = join(outputDir, `${base}.error.txt`);
-  const errorBlock = errors.join("\n").trim() + (errors.length ? "\n" : "");
-  const content = errorBlock + locationLine;
-  writeFileSync(errorPath, content, "utf-8");
-}
-
-/**
- * Generate manifestId: git:<sha> if available, else time:<iso>
- */
-function generateManifestId(): string {
-  try {
-    const sha = execSync("git rev-parse HEAD", { encoding: "utf-8", stdio: ["ignore", "pipe", "ignore"] }).trim();
-    if (sha) {
-      return `git:${sha}`;
-    }
-  } catch {
-    // Git not available or not in a git repo
-  }
-  return `time:${new Date().toISOString()}`;
-}
-
-export interface CompileScenesOptions {
-  /** Explicit scene file paths (skips globbing) */
-  sceneFiles?: string[];
-  /** If false, parse and validate only; do not write manifests or error files */
-  emitManifests?: boolean;
-}
-
-/**
- * Compile all scene files in the universe
- * @param universeRoot - Universe root directory (or search root for scene-only mode)
- * @param outputDir - Output directory for scene manifests
- * @param options - Optional: sceneFiles (explicit list), emitManifests (default true in universe mode)
- * @returns Compile result with success status and list of compiled scenes
- */
-export async function compileScenes(
-  universeRoot: string,
-  outputDir: string,
-  options?: CompileScenesOptions,
-): Promise<SceneCompileResult> {
-  const diagnostics: Array<{ severity: string; message: string; source?: unknown; scene?: string }> = [];
-  const compiledScenes: string[] = [];
-  const emitManifests = options?.emitManifests !== false;
-
-  try {
-    // Use explicit scene files or discover via glob
-    let sceneFiles: string[];
-    if (options?.sceneFiles && options.sceneFiles.length > 0) {
-      sceneFiles = options.sceneFiles;
-    } else {
-      sceneFiles = await fg("**/*.scene.prose", {
-        cwd: universeRoot,
-        absolute: true,
-        ignore: ["node_modules/**", ".git/**"],
-      });
-    }
-
-    if (sceneFiles.length === 0) {
-      // No scenes to compile is not an error
-      return {
-        success: true,
-        scenes: [],
-        diagnostics: [],
-      };
-    }
-
-    if (emitManifests) {
-      // Ensure output directory exists
-      try {
-        mkdirSync(outputDir, { recursive: true });
-      } catch (error) {
-        // Directory might already exist, ignore
-      }
-    }
-
-    const generatedAt = new Date().toISOString();
-    const manifestId = emitManifests ? generateManifestId() : "";
-
-    // Compile each scene
-    for (const sceneFile of sceneFiles) {
-      let sourceText = "";
-      try {
-        sourceText = readFileSync(sceneFile, "utf-8");
-        const manifest = compileSceneFromText(sourceText);
-
-        if (!manifest || !manifest.sceneName) {
-          const message = "Failed to compile scene: no sceneName found";
-          diagnostics.push({
-            severity: "error",
-            message,
-            source: sceneFile,
-          });
-          if (emitManifests) {
-            writeSceneErrors(outputDir, sceneFile, [message], sourceText);
-          }
-          continue;
-        }
-
-        compiledScenes.push(manifest.sceneName);
-
-        if (emitManifests) {
-          // Inject metadata
-          const manifestWithMeta = {
-            ...manifest,
-            meta: {
-              generatedAt,
-              manifestId,
-            },
-          };
-
-          // Write to output directory
-          const outputPath = join(outputDir, `${manifest.sceneName}.scene.json`);
-          const tempPath = `${outputPath}.tmp`;
-          const json = JSON.stringify(manifestWithMeta, null, 2);
-          writeFileSync(tempPath, json, "utf-8");
-          renameSync(tempPath, outputPath);
-
-          // Remove any prior .error.txt for this scene (same source file base name)
-          const errorPath = join(outputDir, `${sceneFileBaseName(sceneFile)}.error.txt`);
-          try {
-            unlinkSync(errorPath);
-          } catch {
-            // ignore if missing
-          }
-        }
-      } catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        diagnostics.push({
-          severity: "error",
-          message: `Scene compile failed: ${message}`,
-          source: sceneFile,
-        });
-        if (emitManifests) {
-          writeSceneErrors(outputDir, sceneFile, [message], sourceText);
-        }
-      }
-    }
-
-    const hasErrors = diagnostics.some((d) => d.severity === "error");
-    return {
-      success: !hasErrors,
-      scenes: compiledScenes,
-      diagnostics,
-    };
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    return {
-      success: false,
-      scenes: [],
-      diagnostics: [
-        {
-          severity: "error",
-          message: `Scene discovery error: ${message}`,
-        },
-      ],
-    };
-  }
-}

package/src/scene-discovery.ts

@@ -1,51 +0,0 @@
-import { statSync, existsSync } from "node:fs";
-import { resolve, dirname, join } from "node:path";
-import fg from "fast-glob";
-
-export interface SceneDiscovery {
-  sceneFiles: string[];
-  searchRoot: string;
-}
-
-/**
- * Discover scene files when no universe.prose is found.
- * @param path - Path (file or directory) from user
- * @returns SceneDiscovery with sceneFiles and searchRoot, or null if no scenes found
- */
-export function discoverSceneFiles(path: string): SceneDiscovery | null {
-  const resolved = resolve(path);
-
-  if (!existsSync(resolved)) {
-    return null;
-  }
-
-  const stat = statSync(resolved);
-
-  if (stat.isFile()) {
-    if (/\.scene\.prose$/i.test(resolved)) {
-      return {
-        sceneFiles: [resolved],
-        searchRoot: dirname(resolved),
-      };
-    }
-    // Other file: search in same directory
-    const searchRoot = dirname(resolved);
-    const sceneFiles = fg.sync("**/*.scene.prose", {
-      cwd: searchRoot,
-      absolute: true,
-      ignore: ["node_modules/**", ".git/**"],
-    });
-    return sceneFiles.length > 0 ? { sceneFiles, searchRoot } : null;
-  }
-
-  if (stat.isDirectory()) {
-    const sceneFiles = fg.sync("**/*.scene.prose", {
-      cwd: resolved,
-      absolute: true,
-      ignore: ["node_modules/**", ".git/**"],
-    });
-    return sceneFiles.length > 0 ? { sceneFiles, searchRoot: resolved } : null;
-  }
-
-  return null;
-}

package/tests/compile-scene-only.test.js

@@ -1,109 +0,0 @@
-import { test } from "node:test";
-import { strict as assert } from "node:assert";
-import { existsSync } from "node:fs";
-import { join, dirname } from "node:path";
-import { fileURLToPath } from "node:url";
-import { spawnSync } from "node:child_process";
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const FIXTURES = join(__dirname, "fixtures");
-const CLI_PATH = join(__dirname, "..", "dist", "cli.js");
-
-function runCompile(args, cwd) {
-  const result = spawnSync("node", [CLI_PATH, "compile", ...args], {
-    encoding: "utf-8",
-    cwd: cwd ?? join(__dirname, ".."),
-  });
-  return {
-    status: result.status,
-    stdout: result.stdout ?? "",
-    stderr: result.stderr ?? "",
-  };
-}
-
-test("sprig compile with no universe in cwd: errors", () => {
-  const cwd = join(FIXTURES, "scene-only-empty");
-  const { status, stderr } = runCompile([], cwd);
-
-  assert.notStrictEqual(status, 0, "Expected non-zero exit");
-  assert.ok(stderr.includes("No universe.prose found."), "Should show expected error");
-});
-
-test("sprig compile <dir> universe in dir, no --out: writes to dir/.sprig", () => {
-  const dir = join(FIXTURES, "universe-unchanged");
-  const { status, stderr } = runCompile([dir]);
-
-  assert.strictEqual(status, 0, `Expected exit 0, got ${status}. stderr: ${stderr}`);
-
-  const sprigDir = join(dir, ".sprig");
-  assert.ok(existsSync(sprigDir), ".sprig should exist");
-  assert.ok(existsSync(join(sprigDir, "manifest.json")), "manifest.json should exist");
-  assert.ok(existsSync(join(sprigDir, "TestScene.scene.json")), "TestScene.scene.json should exist");
-});
-
-test("sprig compile <dir> --out <out> universe found: writes to out", () => {
-  const dir = join(FIXTURES, "universe-unchanged");
-  const outDir = join(dir, "custom-out");
-  const { status, stderr } = runCompile([dir, "--out", outDir]);
-
-  assert.strictEqual(status, 0, `Expected exit 0, got ${status}. stderr: ${stderr}`);
-
-  assert.ok(existsSync(join(outDir, "manifest.json")), "manifest.json should exist in --out");
-  assert.ok(existsSync(join(outDir, "TestScene.scene.json")), "TestScene.scene.json should exist in --out");
-});
-
-test("sprig compile <dir> no universe, no --out: errors with guidance", () => {
-  const dir = join(FIXTURES, "scene-only-valid");
-  const { status, stderr } = runCompile([dir]);
-
-  assert.notStrictEqual(status, 0, "Expected non-zero exit");
-  assert.ok(
-    stderr.includes("No universe.prose found for"),
-    "Should mention no universe for dir",
-  );
-  assert.ok(stderr.includes("Provide --out"), "Should suggest --out");
-});
-
-test("sprig compile <dir> --out <out> no universe, scenes present: emits to out", () => {
-  const dir = join(FIXTURES, "scene-only-valid");
-  const outDir = join(dir, ".sprig-out");
-  const { status, stderr } = runCompile([dir, "--out", outDir]);
-
-  assert.strictEqual(status, 0, `Expected exit 0, got ${status}. stderr: ${stderr}`);
-
-  assert.ok(existsSync(join(outDir, "SimpleScene.scene.json")), "SimpleScene.scene.json should exist");
-  assert.ok(existsSync(join(outDir, "AnotherScene.scene.json")), "AnotherScene.scene.json should exist");
-});
-
-test("sprig compile <dir> --out <out> no universe, no scenes: errors", () => {
-  const dir = join(FIXTURES, "scene-only-empty");
-  const outDir = join(dir, ".sprig-out");
-  const { status, stderr } = runCompile([dir, "--out", outDir]);
-
-  assert.notStrictEqual(status, 0, "Expected non-zero exit");
-  assert.ok(
-    stderr.includes("No universe.prose found and no *.scene.prose files found in:"),
-    "Should show no scenes error",
-  );
-});
-
-test("sprig compile <dir> universe in parent, no --out: writes to in-directory/.sprig", () => {
-  const subdir = join(FIXTURES, "universe-upstream", "subdir");
-  const { status, stderr } = runCompile([subdir]);
-
-  assert.strictEqual(status, 0, `Expected exit 0, got ${status}. stderr: ${stderr}`);
-
-  const sprigDir = join(subdir, ".sprig");
-  assert.ok(existsSync(sprigDir), "Output should be in subdir/.sprig (in-directory)");
-  assert.ok(existsSync(join(sprigDir, "manifest.json")), "manifest.json should exist");
-  assert.ok(existsSync(join(sprigDir, "OneScene.scene.json")), "OneScene.scene.json should exist");
-});
-
-test("scene-only invalid dir with --out: exits non-zero", () => {
-  const dir = join(FIXTURES, "scene-only-invalid");
-  const outDir = join(dir, ".sprig-out");
-  const { status, stderr } = runCompile([dir, "--out", outDir]);
-
-  assert.notStrictEqual(status, 0, "Expected non-zero exit on invalid scene");
-  assert.ok(stderr.includes("BadScene") || stderr.includes("bad.scene.prose"), "Error should mention scene or file");
-});

package/tests/fixtures/scene-only-invalid/.sprig-out/bad.error.txt

@@ -1,2 +0,0 @@
-Field 'id' may only define a single type (e.g. integer, string, array, or an actor). This error appears because two or more types are defined for this field.
-  at BadScene

package/tests/fixtures/scene-only-invalid/bad.scene.prose

@@ -1,10 +0,0 @@
-scene BadScene {
-  actor Actor {
-    shape {
-      id {
-        integer
-        string
-      }
-    }
-  }
-}

package/tests/fixtures/scene-only-valid/.sprig-emit/AnotherScene.scene.json

@@ -1,15 +0,0 @@
-{
-  "sceneName": "AnotherScene",
-  "actors": {
-    "NameActor": {
-      "type": "string",
-      "identity": []
-    }
-  },
-  "portals": {},
-  "derived": {},
-  "meta": {
-    "generatedAt": "2026-02-21T20:00:48.348Z",
-    "manifestId": "git:e97c34ae2cb10839cafef399d1ef329411e3bd22"
-  }
-}

package/tests/fixtures/scene-only-valid/.sprig-emit/SimpleScene.scene.json

@@ -1,15 +0,0 @@
-{
-  "sceneName": "SimpleScene",
-  "actors": {
-    "IntActor": {
-      "type": "integer",
-      "identity": []
-    }
-  },
-  "portals": {},
-  "derived": {},
-  "meta": {
-    "generatedAt": "2026-02-21T20:00:48.348Z",
-    "manifestId": "git:e97c34ae2cb10839cafef399d1ef329411e3bd22"
-  }
-}

package/tests/fixtures/scene-only-valid/.sprig-out/AnotherScene.scene.json

@@ -1,15 +0,0 @@
-{
-  "sceneName": "AnotherScene",
-  "actors": {
-    "NameActor": {
-      "type": "string",
-      "identity": []
-    }
-  },
-  "portals": {},
-  "derived": {},
-  "meta": {
-    "generatedAt": "2026-02-21T20:23:33.528Z",
-    "manifestId": "git:e97c34ae2cb10839cafef399d1ef329411e3bd22"
-  }
-}

package/tests/fixtures/scene-only-valid/.sprig-out/SimpleScene.scene.json

@@ -1,15 +0,0 @@
-{
-  "sceneName": "SimpleScene",
-  "actors": {
-    "IntActor": {
-      "type": "integer",
-      "identity": []
-    }
-  },
-  "portals": {},
-  "derived": {},
-  "meta": {
-    "generatedAt": "2026-02-21T20:23:33.528Z",
-    "manifestId": "git:e97c34ae2cb10839cafef399d1ef329411e3bd22"
-  }
-}

package/tests/fixtures/scene-only-valid/another.scene.prose

@@ -1,3 +0,0 @@
-scene AnotherScene {
-  actor NameActor { string }
-}

package/tests/fixtures/scene-only-valid/simple.scene.prose

@@ -1,3 +0,0 @@
-scene SimpleScene {
-  actor IntActor { integer }
-}

package/tests/fixtures/universe-unchanged/.sprig/TestScene.scene.json

@@ -1,15 +0,0 @@
-{
-  "sceneName": "TestScene",
-  "actors": {
-    "IntActor": {
-      "type": "integer",
-      "identity": []
-    }
-  },
-  "portals": {},
-  "derived": {},
-  "meta": {
-    "generatedAt": "2026-02-21T20:23:33.122Z",
-    "manifestId": "git:e97c34ae2cb10839cafef399d1ef329411e3bd22"
-  }
-}

package/tests/fixtures/universe-unchanged/custom-out/TestScene.scene.json

@@ -1,15 +0,0 @@
-{
-  "sceneName": "TestScene",
-  "actors": {
-    "IntActor": {
-      "type": "integer",
-      "identity": []
-    }
-  },
-  "portals": {},
-  "derived": {},
-  "meta": {
-    "generatedAt": "2026-02-21T20:23:33.279Z",
-    "manifestId": "git:e97c34ae2cb10839cafef399d1ef329411e3bd22"
-  }
-}

package/tests/fixtures/universe-unchanged/scene.scene.prose

@@ -1,3 +0,0 @@
-scene TestScene {
-  actor IntActor { integer }
-}

package/tests/fixtures/universe-upstream/subdir/.sprig/OneScene.scene.json

@@ -1,15 +0,0 @@
-{
-  "sceneName": "OneScene",
-  "actors": {
-    "IntActor": {
-      "type": "integer",
-      "identity": []
-    }
-  },
-  "portals": {},
-  "derived": {},
-  "meta": {
-    "generatedAt": "2026-02-21T20:23:33.807Z",
-    "manifestId": "git:e97c34ae2cb10839cafef399d1ef329411e3bd22"
-  }
-}

package/tests/fixtures/universe-upstream/subdir/one.scene.prose

@@ -1,3 +0,0 @@
-scene OneScene {
-  actor IntActor { integer }
-}