@lovo/matter-cli 0.4.1 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @lovo/matter-cli
 
+## 0.5.0
+
+### Minor Changes
+
+- 0299ddb: Rename ambiguous CLI flags and the config key to spelled-out names (BREAKING, pre-1.0):
+
+  - `list`/`add`/`update`: `--ref` → `--reference`
+  - `poster`: `--from` → `--source`, `--out` → `--output`, `--type` → `--format`, `--export` → `--export-name`, `--time` → `--capture-delay`
+  - `matter.config.json`: removed the `tsx` boolean key (it was validated but never read by any command)
+
+  Kept: `--registry`, `--quality`, `--width`, `--height`, `--force`, and the config keys `componentsDir`, `registryUrl`, `aliases`.
+
+  Migration: update any scripts that pass the old flags. You can delete the `tsx` key from your `matter.config.json` if present — it is no longer used (unknown keys are ignored). Re-running `matter-cli init` regenerates a config without it.
+
 ## 0.4.1
 
 ## 0.4.0

package/README.md

@@ -25,12 +25,11 @@ Writes `matter.config.json` to your project root with sensible defaults:
 {
   "componentsDir": "src/components/matter",
   "registryUrl": "https://raw.githubusercontent.com/lovo-hq/matter/${ref}/registry",
-  "aliases": { "@/": "src/" },
-  "tsx": true
+  "aliases": { "@/": "src/" }
 }
 ```
 
-The `${ref}` placeholder is auto-substituted with the CLI's published version tag (e.g., `v0.1.0`), so you get a stable snapshot. Override with `--ref <tag|branch|sha>` if you want to track `main` or a specific commit.
+The `${ref}` placeholder is auto-substituted with the CLI's published version tag (e.g., `v0.1.0`), so you get a stable snapshot. Override with `--reference <tag|branch|sha>` if you want to track `main` or a specific commit.
 
 ### List available components
 
@@ -58,9 +57,74 @@ npx matter-cli update linear-gradient
 npx matter-cli update --force
 ```
 
+### Render a static fallback image
+
+Render a Matter component tree to an image for use as a `<ShaderScene fallback>` — eliminates the visible blank canvas during WebGPU initialization.
+
+```bash
+npx matter-cli poster --source <file> --output <path> [options]
+```
+
+| Flag               | Default    | Description                                                                                          |
+| ------------------ | ---------- | ---------------------------------------------------------------------------------------------------- |
+| `--source <file>`           | (required) | Path to a `.tsx`/`.ts` file whose chosen export renders the full tree (must include `<ShaderScene>`) |
+| `--output <path>`           | (required) | Where to write the image. Extension optional — `--format` decides. Parent directories auto-created.    |
+| `--format <format>`         | `jpg`      | Output format: `png` or `jpg`. Default is `jpg` — best size/quality for most shaders.                |
+| `--quality <n>`             | `80`       | JPEG quality 1–100. Ignored for PNG.                                                                 |
+| `--export-name <name>`      | `default`  | Named export to render.                                                                              |
+| `--capture-delay <seconds>` | `0`        | Wait this long after the first non-blank frame before snapshotting.                                  |
+| `--width <px>`              | `1280`     | Render width.                                                                                        |
+| `--height <px>`             | `720`      | Render height.                                                                                       |
+
+#### Which format should I pick?
+
+The default (JPEG q80) handles most shaders well. PNG wins on shaders with large flat-color regions where its lossless palette compression beats JPEG's DCT. As a rule of thumb:
+
+| Use PNG (`--format png`) for…     | Use the default JPEG for…                  |
+| --------------------------------- | ------------------------------------------ |
+| `LinearGradient` with hard stops  | `Aurora` and similar gradient-heavy scenes |
+| `SimplexNoise` with contour bands | `MeshGradient` (smooth color flow)         |
+| Anything with < ~20 unique colors | `FilmGrain` (high-entropy noise)           |
+
+If unsure, run both — the difference can be 3–7× either direction.
+
+**Requires Playwright** as a peer dependency:
+
+```bash
+pnpm add -D playwright
+pnpm exec playwright install chromium
+```
+
+**Examples:**
+
+```bash
+# Default — writes ./public/hero.jpg (JPEG q80)
+npx matter-cli poster --from ./src/components/matter/hero.tsx --out ./public/hero
+
+# Posterized shader — PNG compresses smaller
+npx matter-cli poster --from ./gradient.tsx --out ./public/gradient --type png
+
+# Higher quality JPEG
+npx matter-cli poster --from ./aurora.tsx --out ./public/aurora --quality 92
+```
+
+Wire it up:
+
+```tsx
+<ShaderScene fallback={<img src="/hero.jpg" alt="" />}>
+  <LinearGradient ... />
+</ShaderScene>
+```
+
+**Limitations:**
+
+- The component you point at must render the entire tree (including `<ShaderScene>`); the CLI doesn't wrap.
+- Components that depend on app-context hooks (`useTheme`, `useRouter`, etc.) won't render in the headless harness. Extract a presentational child.
+- WebP and AVIF are not supported (would require an extra dependency for marginal savings over JPEG).
+
 ## v1 components
 
-`linear-gradient`, `mesh-gradient`, `aurora`, `dot-field`, `noise-field`, `waves`.
+`linear-gradient`, `mesh-gradient`, `aurora`, `dot-field`, `simplex-noise`, `waves`.
 
 Each component depends on `@lovo/matter` and `@lovo/matter-react`, which you install separately:
 

package/dist/add-T7IRU2NK.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import {
+  runAdd
+} from "./chunk-53DI7V2J.js";
+import "./chunk-FHRQIHCN.js";
+import "./chunk-R7OX6KUP.js";
+import "./chunk-D4HDZEJT.js";
+export {
+  runAdd
+};
+//# sourceMappingURL=add-T7IRU2NK.js.map

package/dist/{chunk-4XUN2PKU.js → chunk-53DI7V2J.js}

@@ -3,10 +3,11 @@ import {
   fetchComponentSource,
   fetchRegistry,
   resolveRef
-} from "./chunk-OJWKSIZ5.js";
+} from "./chunk-FHRQIHCN.js";
 import {
-  readMatterConfig
-} from "./chunk-M6S6HYHE.js";
+  readMatterConfig,
+  resolveRegistryUrl
+} from "./chunk-R7OX6KUP.js";
 
 // src/commands/add.ts
 import { access, mkdir, writeFile } from "fs/promises";
@@ -32,34 +33,33 @@ async function runAdd(components, opts, io = { cwd: process.cwd(), log: console.
   if (components.length === 0) {
     throw new Error("add: at least one component name is required");
   }
-  const cfg = await readMatterConfig(io.cwd);
-  const baseUrl = opts.registry ?? cfg.registryUrl;
+  const matterConfig = await readMatterConfig(io.cwd);
   const ref = resolveRef(opts.ref, opts.cliVersion);
-  const registryUrl = baseUrl.replace("${ref}", ref);
+  const registryUrl = resolveRegistryUrl(matterConfig, { registry: opts.registry, ref });
   const registry = await fetchRegistry(registryUrl);
   const resolved = components.map((slug) => resolveComponent(slug, registry, registryUrl));
   if (opts.force !== true) {
-    for (const r of resolved) {
-      const targetPath = join(io.cwd, cfg.componentsDir, r.entry.file);
+    for (const resolvedComponent of resolved) {
+      const targetPath = join(io.cwd, matterConfig.componentsDir, resolvedComponent.entry.file);
       if (await fileExists(targetPath)) {
         throw new Error(`${targetPath} already exists. Pass --force to overwrite.`);
       }
     }
   }
   const fetched = await Promise.all(
-    resolved.map(async (r) => {
-      const source = await fetchComponentSource(registryUrl, r.entry.file);
-      return { ...r, source };
+    resolved.map(async (resolvedComponent) => {
+      const source = await fetchComponentSource(registryUrl, resolvedComponent.entry.file);
+      return { ...resolvedComponent, source };
     })
   );
   const allDeps = /* @__PURE__ */ new Set();
-  for (const f of fetched) {
-    const targetPath = join(io.cwd, cfg.componentsDir, f.entry.file);
-    const rewritten = rewriteImports(f.source, cfg.aliases);
+  for (const fetchedComponent of fetched) {
+    const targetPath = join(io.cwd, matterConfig.componentsDir, fetchedComponent.entry.file);
+    const rewritten = rewriteImports(fetchedComponent.source, matterConfig.aliases);
     await mkdir(dirname(targetPath), { recursive: true });
     await writeFile(targetPath, rewritten, "utf-8");
     io.log(`Wrote ${targetPath}`);
-    for (const dep of f.entry.dependencies) allDeps.add(dep);
+    for (const dep of fetchedComponent.entry.dependencies) allDeps.add(dep);
   }
   const sortedDeps = [...allDeps].sort();
   io.log("");
@@ -76,17 +76,18 @@ function resolveComponent(slug, registry, registryUrl) {
   }
   return { slug, entry };
 }
-async function fileExists(p) {
+async function fileExists(filePath) {
   try {
-    await access(p);
+    await access(filePath);
     return true;
-  } catch (err) {
-    if (err instanceof Error && "code" in err && err.code === "ENOENT") return false;
-    throw err;
+  } catch (caughtError) {
+    if (caughtError instanceof Error && "code" in caughtError && caughtError.code === "ENOENT")
+      return false;
+    throw caughtError;
   }
 }
 
 export {
   runAdd
 };
-//# sourceMappingURL=chunk-4XUN2PKU.js.map
+//# sourceMappingURL=chunk-53DI7V2J.js.map

package/dist/chunk-53DI7V2J.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/add.ts","../src/transforms/rewriteImports.ts"],"sourcesContent":["import { access, mkdir, writeFile } from 'node:fs/promises';\nimport { dirname, join } from 'node:path';\n\nimport { readMatterConfig, resolveRegistryUrl } from '../config/matterConfig.js';\nimport {\n  fetchComponentSource,\n  fetchRegistry,\n  type Registry,\n  type RegistryEntry,\n} from '../registry/fetchRegistry.js';\nimport { resolveRef } from '../registry/ref.js';\nimport { rewriteImports } from '../transforms/rewriteImports.js';\n\nexport interface AddOptions {\n  registry?: string;\n  ref?: string;\n  force?: boolean;\n  cliVersion: string;\n}\n\nexport interface AddIO {\n  cwd: string;\n  log: (line: string) => void;\n}\n\nexport async function runAdd(\n  components: string[],\n  opts: AddOptions,\n  io: AddIO = { cwd: process.cwd(), log: console.log },\n): Promise<void> {\n  if (components.length === 0) {\n    throw new Error('add: at least one component name is required');\n  }\n\n  const matterConfig = await readMatterConfig(io.cwd);\n  const ref = resolveRef(opts.ref, opts.cliVersion);\n  const registryUrl = resolveRegistryUrl(matterConfig, { registry: opts.registry, ref });\n  const registry = await fetchRegistry(registryUrl);\n\n  const resolved = components.map((slug) => resolveComponent(slug, registry, registryUrl));\n\n  if (opts.force !== true) {\n    for (const resolvedComponent of resolved) {\n      const targetPath = join(io.cwd, matterConfig.componentsDir, resolvedComponent.entry.file);\n\n      if (await fileExists(targetPath)) {\n        throw new Error(`${targetPath} already exists. Pass --force to overwrite.`);\n      }\n    }\n  }\n\n  const fetched = await Promise.all(\n    resolved.map(async (resolvedComponent) => {\n      const source = await fetchComponentSource(registryUrl, resolvedComponent.entry.file);\n\n      return { ...resolvedComponent, source };\n    }),\n  );\n\n  const allDeps = new Set<string>();\n\n  for (const fetchedComponent of fetched) {\n    const targetPath = join(io.cwd, matterConfig.componentsDir, fetchedComponent.entry.file);\n    const rewritten = rewriteImports(fetchedComponent.source, matterConfig.aliases);\n\n    await mkdir(dirname(targetPath), { recursive: true });\n    await writeFile(targetPath, rewritten, 'utf-8');\n    io.log(`Wrote ${targetPath}`);\n    for (const dep of fetchedComponent.entry.dependencies) allDeps.add(dep);\n  }\n\n  const sortedDeps = [...allDeps].sort();\n\n  io.log('');\n  io.log(`This component requires: ${sortedDeps.join(', ')}`);\n  io.log('Install with your package manager, e.g.:');\n  io.log(`npm install ${sortedDeps.join(' ')}`);\n}\n\nfunction resolveComponent(\n  slug: string,\n  registry: Registry,\n  registryUrl: string,\n): { slug: string; entry: RegistryEntry } {\n  const entry = registry.components[slug];\n\n  if (!entry) {\n    throw new Error(\n      `Component \"${slug}\" not found in registry at ${registryUrl}. Run \\`matter-cli list\\` to see available components.`,\n    );\n  }\n\n  return { slug, entry };\n}\n\nasync function fileExists(filePath: string): Promise<boolean> {\n  try {\n    await access(filePath);\n\n    return true;\n  } catch (caughtError) {\n    if (caughtError instanceof Error && 'code' in caughtError && caughtError.code === 'ENOENT')\n      return false;\n    throw caughtError;\n  }\n}\n","export function rewriteImports(source: string, aliases: Record<string, string>): string {\n  const sortedAliases = Object.entries(aliases).sort(([a], [b]) => b.length - a.length);\n\n  if (sortedAliases.length === 0) return source;\n\n  const importRe = /(\\bfrom\\s+|\\bimport\\s*\\(\\s*)(['\"])([^'\"]+)\\2/g;\n\n  return source.replace(importRe, (full, lead: string, quote: string, spec: string) => {\n    for (const [key, value] of sortedAliases) {\n      if (spec.startsWith(key)) {\n        return `${lead}${quote}${value}${spec.slice(key.length)}${quote}`;\n      }\n    }\n\n    return full;\n  });\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-D4HDZEJT.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJS = (cb, mod) => function __require() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+export {
+  __commonJS,
+  __export,
+  __toESM
+};
+//# sourceMappingURL=chunk-D4HDZEJT.js.map

package/dist/chunk-D4HDZEJT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/{chunk-OJWKSIZ5.js → chunk-FHRQIHCN.js}

@@ -3,30 +3,37 @@
 // src/registry/readUrl.ts
 import { readFile } from "fs/promises";
 import { fileURLToPath } from "url";
+async function readFileUrl(filePath) {
+  try {
+    return await readFile(filePath, "utf-8");
+  } catch (caughtError) {
+    if (caughtError instanceof Error && "code" in caughtError && caughtError.code === "ENOENT") {
+      throw new Error(`File not found: ${filePath}`);
+    }
+    throw caughtError;
+  }
+}
+async function readHttpUrl(url) {
+  let response;
+  try {
+    response = await fetch(url);
+  } catch (caughtError) {
+    throw new Error(
+      `Failed to fetch ${url}: ${caughtError instanceof Error ? caughtError.message : String(caughtError)}`
+    );
+  }
+  if (!response.ok) {
+    throw new Error(`Failed to fetch ${url}: ${response.status} ${response.statusText}`);
+  }
+  return response.text();
+}
 async function readUrl(url) {
   const parsed = new URL(url);
   if (parsed.protocol === "file:") {
-    const path = fileURLToPath(parsed);
-    try {
-      return await readFile(path, "utf-8");
-    } catch (err) {
-      if (err instanceof Error && "code" in err && err.code === "ENOENT") {
-        throw new Error(`File not found: ${path}`);
-      }
-      throw err;
-    }
+    return readFileUrl(fileURLToPath(parsed));
   }
   if (parsed.protocol === "http:" || parsed.protocol === "https:") {
-    let res;
-    try {
-      res = await fetch(url);
-    } catch (err) {
-      throw new Error(`Failed to fetch ${url}: ${err instanceof Error ? err.message : String(err)}`);
-    }
-    if (!res.ok) {
-      throw new Error(`Failed to fetch ${url}: ${res.status} ${res.statusText}`);
-    }
-    return await res.text();
+    return readHttpUrl(url);
   }
   throw new Error(
     `Unsupported protocol: ${parsed.protocol} (only file://, http://, https:// are supported)`
@@ -44,9 +51,9 @@ async function fetchRegistry(baseUrl) {
   let parsed;
   try {
     parsed = JSON.parse(json);
-  } catch (err) {
+  } catch (caughtError) {
     throw new Error(
-      `Registry at ${url} is not valid JSON: ${err instanceof Error ? err.message : String(err)}`
+      `Registry at ${url} is not valid JSON: ${caughtError instanceof Error ? caughtError.message : String(caughtError)}`
     );
   }
   if (!looksLikeRegistry(parsed)) {
@@ -54,9 +61,9 @@ async function fetchRegistry(baseUrl) {
   }
   return parsed;
 }
-function looksLikeRegistry(x) {
-  if (typeof x !== "object" || x === null || !("components" in x)) return false;
-  const components = x.components;
+function looksLikeRegistry(value) {
+  if (typeof value !== "object" || value === null || !("components" in value)) return false;
+  const components = value.components;
   return typeof components === "object" && components !== null && !Array.isArray(components);
 }
 async function fetchComponentSource(baseUrl, file) {
@@ -75,4 +82,4 @@ export {
   fetchComponentSource,
   resolveRef
 };
-//# sourceMappingURL=chunk-OJWKSIZ5.js.map
+//# sourceMappingURL=chunk-FHRQIHCN.js.map

package/dist/chunk-FHRQIHCN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/registry/readUrl.ts","../src/registry/fetchRegistry.ts","../src/registry/ref.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { fileURLToPath } from 'node:url';\n\nasync function readFileUrl(filePath: string): Promise<string> {\n  try {\n    return await readFile(filePath, 'utf-8');\n  } catch (caughtError) {\n    if (caughtError instanceof Error && 'code' in caughtError && caughtError.code === 'ENOENT') {\n      throw new Error(`File not found: ${filePath}`);\n    }\n    throw caughtError;\n  }\n}\n\nasync function readHttpUrl(url: string): Promise<string> {\n  let response: Response;\n\n  try {\n    response = await fetch(url);\n  } catch (caughtError) {\n    throw new Error(\n      `Failed to fetch ${url}: ${caughtError instanceof Error ? caughtError.message : String(caughtError)}`,\n    );\n  }\n\n  if (!response.ok) {\n    throw new Error(`Failed to fetch ${url}: ${response.status} ${response.statusText}`);\n  }\n\n  return response.text();\n}\n\nexport async function readUrl(url: string): Promise<string> {\n  const parsed = new URL(url);\n\n  if (parsed.protocol === 'file:') {\n    return readFileUrl(fileURLToPath(parsed));\n  }\n\n  if (parsed.protocol === 'http:' || parsed.protocol === 'https:') {\n    return readHttpUrl(url);\n  }\n\n  throw new Error(\n    `Unsupported protocol: ${parsed.protocol} (only file://, http://, https:// are supported)`,\n  );\n}\n","import { readUrl } from './readUrl.js';\n\nexport interface RegistryEntry {\n  file: string;\n  description?: string;\n  dependencies: string[];\n  uses_primitives?: string[];\n  tier: 1 | 2 | 3;\n}\n\nexport interface Registry {\n  version: string;\n  components: Record<string, RegistryEntry>;\n}\n\nfunction joinUrl(base: string, file: string): string {\n  const trimmed = base.endsWith('/') ? base.slice(0, -1) : base;\n\n  return `${trimmed}/${file}`;\n}\n\nexport async function fetchRegistry(baseUrl: string): Promise<Registry> {\n  const url = joinUrl(baseUrl, 'registry.json');\n  const json = await readUrl(url);\n  let parsed: unknown;\n\n  try {\n    parsed = JSON.parse(json);\n  } catch (caughtError) {\n    throw new Error(\n      `Registry at ${url} is not valid JSON: ${caughtError instanceof Error ? caughtError.message : String(caughtError)}`,\n    );\n  }\n  if (!looksLikeRegistry(parsed)) {\n    throw new Error(`Registry at ${url} is missing a \"components\" object`);\n  }\n\n  return parsed;\n}\n\nfunction looksLikeRegistry(value: unknown): value is Registry {\n  if (typeof value !== 'object' || value === null || !('components' in value)) return false;\n  const components = value.components;\n\n  return typeof components === 'object' && components !== null && !Array.isArray(components);\n}\n\n/**\n * Fetch the raw source of a component file referenced by a registry entry.\n */\nexport async function fetchComponentSource(baseUrl: string, file: string): Promise<string> {\n  return await readUrl(joinUrl(baseUrl, file));\n}\n","export function resolveRef(ref: string | undefined, cliVersion: string): string {\n  if (ref !== undefined && ref !== '') return ref;\n  if (cliVersion === '0.0.0') return 'main';\n\n  return `v${cliVersion}`;\n}\n"],"mappings":";;;AAAA,SAAS,gBAAgB;AACzB,SAAS,qBAAqB;AAE9B,eAAe,YAAY,UAAmC;AAC5D,MAAI;AACF,WAAO,MAAM,SAAS,UAAU,OAAO;AAAA,EACzC,SAAS,aAAa;AACpB,QAAI,uBAAuB,SAAS,UAAU,eAAe,YAAY,SAAS,UAAU;AAC1F,YAAM,IAAI,MAAM,mBAAmB,QAAQ,EAAE;AAAA,IAC/C;AACA,UAAM;AAAA,EACR;AACF;AAEA,eAAe,YAAY,KAA8B;AACvD,MAAI;AAEJ,MAAI;AACF,eAAW,MAAM,MAAM,GAAG;AAAA,EAC5B,SAAS,aAAa;AACpB,UAAM,IAAI;AAAA,MACR,mBAAmB,GAAG,KAAK,uBAAuB,QAAQ,YAAY,UAAU,OAAO,WAAW,CAAC;AAAA,IACrG;AAAA,EACF;AAEA,MAAI,CAAC,SAAS,IAAI;AAChB,UAAM,IAAI,MAAM,mBAAmB,GAAG,KAAK,SAAS,MAAM,IAAI,SAAS,UAAU,EAAE;AAAA,EACrF;AAEA,SAAO,SAAS,KAAK;AACvB;AAEA,eAAsB,QAAQ,KAA8B;AAC1D,QAAM,SAAS,IAAI,IAAI,GAAG;AAE1B,MAAI,OAAO,aAAa,SAAS;AAC/B,WAAO,YAAY,cAAc,MAAM,CAAC;AAAA,EAC1C;AAEA,MAAI,OAAO,aAAa,WAAW,OAAO,aAAa,UAAU;AAC/D,WAAO,YAAY,GAAG;AAAA,EACxB;AAEA,QAAM,IAAI;AAAA,IACR,yBAAyB,OAAO,QAAQ;AAAA,EAC1C;AACF;;;AC/BA,SAAS,QAAQ,MAAc,MAAsB;AACnD,QAAM,UAAU,KAAK,SAAS,GAAG,IAAI,KAAK,MAAM,GAAG,EAAE,IAAI;AAEzD,SAAO,GAAG,OAAO,IAAI,IAAI;AAC3B;AAEA,eAAsB,cAAc,SAAoC;AACtE,QAAM,MAAM,QAAQ,SAAS,eAAe;AAC5C,QAAM,OAAO,MAAM,QAAQ,GAAG;AAC9B,MAAI;AAEJ,MAAI;AACF,aAAS,KAAK,MAAM,IAAI;AAAA,EAC1B,SAAS,aAAa;AACpB,UAAM,IAAI;AAAA,MACR,eAAe,GAAG,uBAAuB,uBAAuB,QAAQ,YAAY,UAAU,OAAO,WAAW,CAAC;AAAA,IACnH;AAAA,EACF;AACA,MAAI,CAAC,kBAAkB,MAAM,GAAG;AAC9B,UAAM,IAAI,MAAM,eAAe,GAAG,mCAAmC;AAAA,EACvE;AAEA,SAAO;AACT;AAEA,SAAS,kBAAkB,OAAmC;AAC5D,MAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,EAAE,gBAAgB,OAAQ,QAAO;AACpF,QAAM,aAAa,MAAM;AAEzB,SAAO,OAAO,eAAe,YAAY,eAAe,QAAQ,CAAC,MAAM,QAAQ,UAAU;AAC3F;AAKA,eAAsB,qBAAqB,SAAiB,MAA+B;AACzF,SAAO,MAAM,QAAQ,QAAQ,SAAS,IAAI,CAAC;AAC7C;;;ACpDO,SAAS,WAAW,KAAyB,YAA4B;AAC9E,MAAI,QAAQ,UAAa,QAAQ,GAAI,QAAO;AAC5C,MAAI,eAAe,QAAS,QAAO;AAEnC,SAAO,IAAI,UAAU;AACvB;","names":[]}

package/dist/chunk-Q7CQW6AH.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+
+// src/poster/projectRoot.ts
+import { access } from "fs/promises";
+import { dirname, resolve } from "path";
+async function findProjectRoot(fromPath) {
+  let dir = dirname(resolve(fromPath));
+  for (; ; ) {
+    try {
+      await access(`${dir}/package.json`);
+      return dir;
+    } catch {
+      const parent = dirname(dir);
+      if (parent === dir) {
+        throw new Error(
+          `Could not find a package.json walking up from ${fromPath}. Poster needs a project root to resolve dependencies against.`
+        );
+      }
+      dir = parent;
+    }
+  }
+}
+
+export {
+  findProjectRoot
+};
+//# sourceMappingURL=chunk-Q7CQW6AH.js.map

package/dist/chunk-Q7CQW6AH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/poster/projectRoot.ts"],"sourcesContent":["import { access } from 'node:fs/promises';\nimport { dirname, resolve } from 'node:path';\n\nexport async function findProjectRoot(fromPath: string): Promise<string> {\n  let dir = dirname(resolve(fromPath));\n\n  // Guard against infinite loops on root (dirname('/') === '/').\n  for (;;) {\n    try {\n      await access(`${dir}/package.json`);\n\n      return dir;\n    } catch {\n      const parent = dirname(dir);\n\n      if (parent === dir) {\n        throw new Error(\n          `Could not find a package.json walking up from ${fromPath}. Poster needs a project root to resolve dependencies against.`,\n        );\n      }\n      dir = parent;\n    }\n  }\n}\n"],"mappings":";;;AAAA,SAAS,cAAc;AACvB,SAAS,SAAS,eAAe;AAEjC,eAAsB,gBAAgB,UAAmC;AACvE,MAAI,MAAM,QAAQ,QAAQ,QAAQ,CAAC;AAGnC,aAAS;AACP,QAAI;AACF,YAAM,OAAO,GAAG,GAAG,eAAe;AAElC,aAAO;AAAA,IACT,QAAQ;AACN,YAAM,SAAS,QAAQ,GAAG;AAE1B,UAAI,WAAW,KAAK;AAClB,cAAM,IAAI;AAAA,UACR,iDAAiD,QAAQ;AAAA,QAC3D;AAAA,MACF;AACA,YAAM;AAAA,IACR;AAAA,EACF;AACF;","names":[]}

package/dist/{chunk-M6S6HYHE.js → chunk-R7OX6KUP.js}

@@ -3,11 +3,44 @@
 // src/config/matterConfig.ts
 import { access, readFile, writeFile } from "fs/promises";
 import { join } from "path";
+
+// src/config/validate.ts
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function validateMatterConfig(parsed, path) {
+  if (!isRecord(parsed)) {
+    throw new Error(`${path}: expected an object`);
+  }
+  const obj = parsed;
+  if (typeof obj.componentsDir !== "string" || obj.componentsDir === "") {
+    throw new Error(`${path}: missing or empty "componentsDir" string`);
+  }
+  if (typeof obj.registryUrl !== "string" || obj.registryUrl === "") {
+    throw new Error(`${path}: missing or empty "registryUrl" string`);
+  }
+  if (!isRecord(obj.aliases)) {
+    throw new Error(`${path}: missing "aliases" object`);
+  }
+  const aliases = {};
+  for (const [aliasKey, aliasValue] of Object.entries(obj.aliases)) {
+    if (typeof aliasValue !== "string") {
+      throw new Error(`${path}: aliases.${aliasKey} must be a string`);
+    }
+    aliases[aliasKey] = aliasValue;
+  }
+  return {
+    componentsDir: obj.componentsDir,
+    registryUrl: obj.registryUrl,
+    aliases
+  };
+}
+
+// src/config/matterConfig.ts
 var DEFAULT_MATTER_CONFIG = {
   componentsDir: "src/components/matter",
   registryUrl: "https://raw.githubusercontent.com/lovo-hq/matter/${ref}/registry",
-  aliases: { "@/": "src/" },
-  tsx: true
+  aliases: { "@/": "src/" }
 };
 var CONFIG_FILENAME = "matter.config.json";
 function configPath(projectRoot) {
@@ -26,70 +59,41 @@ async function readMatterConfig(projectRoot) {
   let raw;
   try {
     raw = await readFile(path, "utf-8");
-  } catch (err) {
-    if (err instanceof Error && "code" in err && err.code === "ENOENT") {
+  } catch (caughtError) {
+    if (caughtError instanceof Error && "code" in caughtError && caughtError.code === "ENOENT") {
       throw new Error(
         `matter.config.json not found in ${projectRoot}. Run \`matter-cli init\` first.`
       );
     }
-    throw err;
+    throw caughtError;
   }
   let parsed;
   try {
     parsed = JSON.parse(raw);
-  } catch (err) {
+  } catch (caughtError) {
     throw new Error(
-      `${path} is not valid JSON: ${err instanceof Error ? err.message : String(err)}`
+      `${path} is not valid JSON: ${caughtError instanceof Error ? caughtError.message : String(caughtError)}`
     );
   }
   return validateMatterConfig(parsed, path);
 }
-async function writeMatterConfig(projectRoot, cfg) {
+function resolveRegistryUrl(matterConfig, opts) {
+  const baseUrl = opts.registry ?? matterConfig.registryUrl;
+  return baseUrl.replace("${ref}", opts.ref);
+}
+async function writeMatterConfig(projectRoot, matterConfig) {
   const path = configPath(projectRoot);
-  const json = `${JSON.stringify(cfg, null, 2)}
+  const json = `${JSON.stringify(matterConfig, null, 2)}
 `;
   await writeFile(path, json, "utf-8");
 }
-function isRecord(x) {
-  return typeof x === "object" && x !== null;
-}
-function validateMatterConfig(parsed, path) {
-  if (!isRecord(parsed)) {
-    throw new Error(`${path}: expected an object`);
-  }
-  const obj = parsed;
-  if (typeof obj.componentsDir !== "string" || obj.componentsDir === "") {
-    throw new Error(`${path}: missing or empty "componentsDir" string`);
-  }
-  if (typeof obj.registryUrl !== "string" || obj.registryUrl === "") {
-    throw new Error(`${path}: missing or empty "registryUrl" string`);
-  }
-  if (!isRecord(obj.aliases)) {
-    throw new Error(`${path}: missing "aliases" object`);
-  }
-  if (typeof obj.tsx !== "boolean") {
-    throw new Error(`${path}: missing "tsx" boolean`);
-  }
-  const aliases = {};
-  for (const [k, v] of Object.entries(obj.aliases)) {
-    if (typeof v !== "string") {
-      throw new Error(`${path}: aliases.${k} must be a string`);
-    }
-    aliases[k] = v;
-  }
-  return {
-    componentsDir: obj.componentsDir,
-    registryUrl: obj.registryUrl,
-    aliases,
-    tsx: obj.tsx
-  };
-}
 
 export {
   DEFAULT_MATTER_CONFIG,
   configPath,
   configExists,
   readMatterConfig,
+  resolveRegistryUrl,
   writeMatterConfig
 };
-//# sourceMappingURL=chunk-M6S6HYHE.js.map
+//# sourceMappingURL=chunk-R7OX6KUP.js.map

package/dist/chunk-R7OX6KUP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config/matterConfig.ts","../src/config/validate.ts"],"sourcesContent":["import { access, readFile, writeFile } from 'node:fs/promises';\nimport { join } from 'node:path';\n\nimport { validateMatterConfig } from './validate.js';\n\nexport interface MatterConfig {\n  componentsDir: string;\n  registryUrl: string;\n  aliases: Record<string, string>;\n}\n\nexport const DEFAULT_MATTER_CONFIG: MatterConfig = {\n  componentsDir: 'src/components/matter',\n  registryUrl: 'https://raw.githubusercontent.com/lovo-hq/matter/${ref}/registry',\n  aliases: { '@/': 'src/' },\n};\n\nconst CONFIG_FILENAME = 'matter.config.json';\n\nexport function configPath(projectRoot: string): string {\n  return join(projectRoot, CONFIG_FILENAME);\n}\n\nexport async function configExists(projectRoot: string): Promise<boolean> {\n  try {\n    await access(configPath(projectRoot));\n\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nexport async function readMatterConfig(projectRoot: string): Promise<MatterConfig> {\n  const path = configPath(projectRoot);\n  let raw: string;\n\n  try {\n    raw = await readFile(path, 'utf-8');\n  } catch (caughtError) {\n    if (caughtError instanceof Error && 'code' in caughtError && caughtError.code === 'ENOENT') {\n      throw new Error(\n        `matter.config.json not found in ${projectRoot}. Run \\`matter-cli init\\` first.`,\n      );\n    }\n    throw caughtError;\n  }\n  let parsed: unknown;\n\n  try {\n    parsed = JSON.parse(raw);\n  } catch (caughtError) {\n    throw new Error(\n      `${path} is not valid JSON: ${caughtError instanceof Error ? caughtError.message : String(caughtError)}`,\n    );\n  }\n\n  return validateMatterConfig(parsed, path);\n}\n\nexport function resolveRegistryUrl(\n  matterConfig: MatterConfig,\n  opts: { registry?: string; ref: string },\n): string {\n  const baseUrl = opts.registry ?? matterConfig.registryUrl;\n\n  return baseUrl.replace('${ref}', opts.ref);\n}\n\nexport async function writeMatterConfig(\n  projectRoot: string,\n  matterConfig: MatterConfig,\n): Promise<void> {\n  const path = configPath(projectRoot);\n  const json = `${JSON.stringify(matterConfig, null, 2)}\\n`;\n\n  await writeFile(path, json, 'utf-8');\n}\n","import type { MatterConfig } from './matterConfig.js';\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null;\n}\n\nexport function validateMatterConfig(parsed: unknown, path: string): MatterConfig {\n  if (!isRecord(parsed)) {\n    throw new Error(`${path}: expected an object`);\n  }\n  const obj = parsed;\n\n  if (typeof obj.componentsDir !== 'string' || obj.componentsDir === '') {\n    throw new Error(`${path}: missing or empty \"componentsDir\" string`);\n  }\n  if (typeof obj.registryUrl !== 'string' || obj.registryUrl === '') {\n    throw new Error(`${path}: missing or empty \"registryUrl\" string`);\n  }\n  if (!isRecord(obj.aliases)) {\n    throw new Error(`${path}: missing \"aliases\" object`);\n  }\n  const aliases: Record<string, string> = {};\n\n  for (const [aliasKey, aliasValue] of Object.entries(obj.aliases)) {\n    if (typeof aliasValue !== 'string') {\n      throw new Error(`${path}: aliases.${aliasKey} must be a string`);\n    }\n    aliases[aliasKey] = aliasValue;\n  }\n\n  return {\n    componentsDir: obj.componentsDir,\n    registryUrl: obj.registryUrl,\n    aliases,\n  };\n}\n"],"mappings":";;;AAAA,SAAS,QAAQ,UAAU,iBAAiB;AAC5C,SAAS,YAAY;;;ACCrB,SAAS,SAAS,OAAkD;AAClE,SAAO,OAAO,UAAU,YAAY,UAAU;AAChD;AAEO,SAAS,qBAAqB,QAAiB,MAA4B;AAChF,MAAI,CAAC,SAAS,MAAM,GAAG;AACrB,UAAM,IAAI,MAAM,GAAG,IAAI,sBAAsB;AAAA,EAC/C;AACA,QAAM,MAAM;AAEZ,MAAI,OAAO,IAAI,kBAAkB,YAAY,IAAI,kBAAkB,IAAI;AACrE,UAAM,IAAI,MAAM,GAAG,IAAI,2CAA2C;AAAA,EACpE;AACA,MAAI,OAAO,IAAI,gBAAgB,YAAY,IAAI,gBAAgB,IAAI;AACjE,UAAM,IAAI,MAAM,GAAG,IAAI,yCAAyC;AAAA,EAClE;AACA,MAAI,CAAC,SAAS,IAAI,OAAO,GAAG;AAC1B,UAAM,IAAI,MAAM,GAAG,IAAI,4BAA4B;AAAA,EACrD;AACA,QAAM,UAAkC,CAAC;AAEzC,aAAW,CAAC,UAAU,UAAU,KAAK,OAAO,QAAQ,IAAI,OAAO,GAAG;AAChE,QAAI,OAAO,eAAe,UAAU;AAClC,YAAM,IAAI,MAAM,GAAG,IAAI,aAAa,QAAQ,mBAAmB;AAAA,IACjE;AACA,YAAQ,QAAQ,IAAI;AAAA,EACtB;AAEA,SAAO;AAAA,IACL,eAAe,IAAI;AAAA,IACnB,aAAa,IAAI;AAAA,IACjB;AAAA,EACF;AACF;;;ADxBO,IAAM,wBAAsC;AAAA,EACjD,eAAe;AAAA,EACf,aAAa;AAAA,EACb,SAAS,EAAE,MAAM,OAAO;AAC1B;AAEA,IAAM,kBAAkB;AAEjB,SAAS,WAAW,aAA6B;AACtD,SAAO,KAAK,aAAa,eAAe;AAC1C;AAEA,eAAsB,aAAa,aAAuC;AACxE,MAAI;AACF,UAAM,OAAO,WAAW,WAAW,CAAC;AAEpC,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,eAAsB,iBAAiB,aAA4C;AACjF,QAAM,OAAO,WAAW,WAAW;AACnC,MAAI;AAEJ,MAAI;AACF,UAAM,MAAM,SAAS,MAAM,OAAO;AAAA,EACpC,SAAS,aAAa;AACpB,QAAI,uBAAuB,SAAS,UAAU,eAAe,YAAY,SAAS,UAAU;AAC1F,YAAM,IAAI;AAAA,QACR,mCAAmC,WAAW;AAAA,MAChD;AAAA,IACF;AACA,UAAM;AAAA,EACR;AACA,MAAI;AAEJ,MAAI;AACF,aAAS,KAAK,MAAM,GAAG;AAAA,EACzB,SAAS,aAAa;AACpB,UAAM,IAAI;AAAA,MACR,GAAG,IAAI,uBAAuB,uBAAuB,QAAQ,YAAY,UAAU,OAAO,WAAW,CAAC;AAAA,IACxG;AAAA,EACF;AAEA,SAAO,qBAAqB,QAAQ,IAAI;AAC1C;AAEO,SAAS,mBACd,cACA,MACQ;AACR,QAAM,UAAU,KAAK,YAAY,aAAa;AAE9C,SAAO,QAAQ,QAAQ,UAAU,KAAK,GAAG;AAC3C;AAEA,eAAsB,kBACpB,aACA,cACe;AACf,QAAM,OAAO,WAAW,WAAW;AACnC,QAAM,OAAO,GAAG,KAAK,UAAU,cAAc,MAAM,CAAC,CAAC;AAAA;AAErD,QAAM,UAAU,MAAM,MAAM,OAAO;AACrC;","names":[]}

package/dist/chunk-RRL35RGP.js

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+
+// src/poster/playwright.ts
+import { access } from "fs/promises";
+import { writeFile } from "fs/promises";
+import { dirname, join } from "path";
+import { pathToFileURL } from "url";
+async function findPlaywrightDir(startDir) {
+  let dir = startDir;
+  for (; ; ) {
+    const candidate = join(dir, "node_modules", "playwright");
+    try {
+      await access(join(candidate, "package.json"));
+      return candidate;
+    } catch {
+    }
+    const parent = dirname(dir);
+    if (parent === dir) return null;
+    dir = parent;
+  }
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function isPlaywrightNamespace(value) {
+  if (!isRecord(value)) return false;
+  const chromium = value.chromium;
+  if (!isRecord(chromium)) return false;
+  return typeof chromium.launch === "function";
+}
+function getDefaultExport(value) {
+  if (!isRecord(value)) return void 0;
+  return value.default;
+}
+async function resolvePlaywright(projectRoot) {
+  const playwrightDir = await findPlaywrightDir(projectRoot);
+  if (playwrightDir === null) {
+    throw new Error(
+      `Install playwright to use this command: pnpm add -D playwright && pnpm exec playwright install chromium`
+    );
+  }
+  for (const entryFilename of ["index.mjs", "index.js"]) {
+    const filePath = join(playwrightDir, entryFilename);
+    try {
+      await access(filePath);
+      const rawModule = await import(pathToFileURL(filePath).href);
+      const playwrightNamespace = isPlaywrightNamespace(rawModule) ? rawModule : getDefaultExport(rawModule);
+      if (!isPlaywrightNamespace(playwrightNamespace)) {
+        throw new Error(`Resolved ${filePath} but it does not expose chromium.launch`);
+      }
+      return playwrightNamespace;
+    } catch (caughtError) {
+      if (entryFilename === "index.js") throw caughtError;
+    }
+  }
+  throw new Error(`Unable to import playwright from ${playwrightDir}`);
+}
+async function launchAndScreenshot(opts) {
+  const playwright = await resolvePlaywright(opts.projectRoot);
+  const browser = await playwright.chromium.launch({ headless: true });
+  try {
+    const browserContext = await browser.newContext({
+      viewport: { width: opts.width, height: opts.height },
+      deviceScaleFactor: 1
+    });
+    const page = await browserContext.newPage();
+    const consoleErrors = [];
+    page.on("pageerror", (pageError) => consoleErrors.push(`pageerror: ${pageError.message}`));
+    page.on("console", (msg) => {
+      if (msg.type() === "error") consoleErrors.push(`console: ${msg.text()}`);
+    });
+    await page.goto(opts.url, { waitUntil: "load" });
+    try {
+      await page.waitForFunction(() => Reflect.get(globalThis, "__matterReady") === true, {
+        timeout: opts.readyTimeoutMs
+      });
+    } catch {
+      if (consoleErrors.length > 0) {
+        throw new Error(
+          `Poster render failed before producing a frame:
+  ${consoleErrors.join("\n  ")}`
+        );
+      }
+      throw new Error(
+        `no canvas content detected within ${opts.readyTimeoutMs / 1e3}s; does your component render a ShaderScene with a visible base layer?`
+      );
+    }
+    if (opts.timeSeconds > 0) {
+      await page.waitForTimeout(opts.timeSeconds * 1e3);
+    }
+    const canvas = page.locator("canvas").first();
+    const imageBuffer = opts.format === "jpeg" ? await canvas.screenshot({ type: "jpeg", quality: opts.quality }) : await canvas.screenshot({ type: "png" });
+    await writeFile(opts.outPath, imageBuffer);
+    return { bytes: imageBuffer.length };
+  } finally {
+    await browser.close();
+  }
+}
+
+export {
+  resolvePlaywright,
+  launchAndScreenshot
+};
+//# sourceMappingURL=chunk-RRL35RGP.js.map