@mondaydotcomorg/z2h-cli 0.1.0 → 0.1.1

package/dist/commands/__tests__/create-workspace.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=create-workspace.test.d.ts.map

package/dist/commands/__tests__/create-workspace.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-workspace.test.d.ts","sourceRoot":"","sources":["../../../src/commands/__tests__/create-workspace.test.ts"],"names":[],"mappings":""}

package/dist/commands/__tests__/create.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=create.test.d.ts.map

package/dist/commands/__tests__/create.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.test.d.ts","sourceRoot":"","sources":["../../../src/commands/__tests__/create.test.ts"],"names":[],"mappings":""}

package/dist/commands/create-workspace.d.ts

@@ -0,0 +1,5 @@
+export interface CreateWorkspaceOptions {
+    json?: boolean;
+}
+export declare function createWorkspaceCommand(opts: CreateWorkspaceOptions): Promise<void>;
+//# sourceMappingURL=create-workspace.d.ts.map

package/dist/commands/create-workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-workspace.d.ts","sourceRoot":"","sources":["../../src/commands/create-workspace.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAiBD,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyDxF"}

package/dist/commands/create-workspace.js

@@ -0,0 +1,80 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const path = require('node:path');
+const promises = require('node:fs/promises');
+const fsExtra = require('fs-extra');
+const execa = require('execa');
+const util_logger = require('../util/logger.js');
+const util_workspace = require('../util/workspace.js');
+const util_templates = require('../util/templates.js');
+
+const _interopDefault = e => e && e.__esModule ? e : { default: e };
+
+const path__default = /*#__PURE__*/_interopDefault(path);
+
+/**
+ * Read the current z2h-cli version from its own package.json — the version
+ * that gets pinned into the workspace's devDependencies. That way the
+ * workspace's `@mondaydotcomorg/z2h-cli` always matches the version that
+ * bootstrapped it.
+ */
+async function readCurrentCliVersion() {
+    // util/templates.ts already locates `<package-root>/src/templates`. The
+    // package's own package.json sits two levels above templates/.
+    const templatesDir = util_templates.getTemplatesDir();
+    const pkgPath = path__default.default.resolve(templatesDir, '..', '..', 'package.json');
+    const pkg = (await fsExtra.readJson(pkgPath));
+    return `^${pkg.version}`;
+}
+async function createWorkspaceCommand(opts) {
+    if (opts.json) {
+        util_logger.setOutputMode('json');
+    }
+    const home = util_workspace.getWorkspaceHome();
+    const templatesDir = util_templates.getTemplatesDir();
+    const wsTemplatesDir = path__default.default.join(templatesDir, 'workspace');
+    // Refuse non-empty target.
+    if (await fsExtra.pathExists(home)) {
+        const entries = await fsExtra.readdir(home);
+        if (entries.length > 0) {
+            throw new Error(`${home} is non-empty. Wipe it before running create-workspace.`);
+        }
+    }
+    else {
+        await fsExtra.ensureDir(home);
+    }
+    const [cliVersion, pkgRaw] = await Promise.all([
+        readCurrentCliVersion(),
+        promises.readFile(path__default.default.join(wsTemplatesDir, 'package.json.tmpl'), 'utf8'),
+    ]);
+    // Sources have plain names (gitignore, yarnrc.yml, nvmrc, npmrc) so they
+    // aren't interpreted as the active config files of *this* package; we
+    // rename to dotfiles at the destination.
+    //
+    // Yarn berry ships inline at .yarn/releases/. The workspace's .yarnrc.yml
+    // sets `yarnPath` to point here, so any `yarn` invocation (system classic
+    // or otherwise) reads the rc, delegates to this binary, and runs as 4.5.1
+    // — no corepack, no global pin needed. Mirrors how bigbrain-z2h ships its
+    // own yarn release.
+    await Promise.all([
+        fsExtra.writeFile(path__default.default.join(home, 'package.json'), util_templates.renderTemplate(pkgRaw, { __Z2H_CLI_VERSION__: cliVersion })),
+        fsExtra.copy(path__default.default.join(wsTemplatesDir, 'gitignore'), path__default.default.join(home, '.gitignore')),
+        fsExtra.copy(path__default.default.join(wsTemplatesDir, 'yarnrc.yml'), path__default.default.join(home, '.yarnrc.yml')),
+        fsExtra.copy(path__default.default.join(wsTemplatesDir, 'nvmrc'), path__default.default.join(home, '.nvmrc')),
+        fsExtra.copy(path__default.default.join(wsTemplatesDir, 'npmrc'), path__default.default.join(home, '.npmrc')),
+        fsExtra.copy(path__default.default.join(wsTemplatesDir, 'README.md'), path__default.default.join(home, 'README.md')),
+        fsExtra.copy(path__default.default.join(wsTemplatesDir, 'yarn-releases', 'yarn-4.5.1.cjs'), path__default.default.join(home, '.yarn', 'releases', 'yarn-4.5.1.cjs')),
+    ]);
+    util_logger.info(`bootstrapping workspace at ${home}`);
+    await execa.execa('yarn', ['install'], {
+        cwd: home,
+        stdio: 'inherit',
+    });
+    util_logger.output(`[z2h-cli] workspace ready at ${home}`, {
+        ok: true,
+        workspace: home,
+        z2hCliVersion: cliVersion,
+    });
+}
+
+exports.createWorkspaceCommand = createWorkspaceCommand;

package/dist/commands/create.d.ts

@@ -0,0 +1,7 @@
+export interface CreateOptions {
+    template?: string;
+    htmlFile?: string;
+    json?: boolean;
+}
+export declare function createCommand(appName: string, opts: CreateOptions): Promise<void>;
+//# sourceMappingURL=create.d.ts.map

package/dist/commands/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AA0BD,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA0EvF"}

package/dist/commands/create.js

@@ -0,0 +1,97 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const path = require('node:path');
+const promises = require('node:fs/promises');
+const fsExtra = require('fs-extra');
+const execa = require('execa');
+const util_logger = require('../util/logger.js');
+const util_workspace = require('../util/workspace.js');
+const util_templates = require('../util/templates.js');
+
+const _interopDefault = e => e && e.__esModule ? e : { default: e };
+
+const path__default = /*#__PURE__*/_interopDefault(path);
+
+const APP_NAME_RE = /^[a-z][a-z0-9-]{1,49}$/;
+/**
+ * Convert kebab-case to PascalCase. `demo-app` → `DemoApp`.
+ */
+function pascalCase(input) {
+    return input
+        .split('-')
+        .filter(Boolean)
+        .map(part => part.charAt(0).toUpperCase() + part.slice(1))
+        .join('');
+}
+/**
+ * Returns true iff `dir` either does not exist or is an empty directory.
+ */
+async function isDirEmpty(dir) {
+    if (!(await fsExtra.pathExists(dir))) {
+        return true;
+    }
+    const entries = await fsExtra.readdir(dir);
+    return entries.length === 0;
+}
+async function createCommand(appName, opts) {
+    if (opts.json) {
+        util_logger.setOutputMode('json');
+    }
+    // Validate workspace.
+    const workspace = await util_workspace.assertWorkspace();
+    // Validate app name.
+    if (!APP_NAME_RE.test(appName)) {
+        throw new Error(`App name "${appName}" is invalid. Use lowercase kebab-case (a-z, 0-9, -), ` +
+            `2-50 chars, starting with a letter.`);
+    }
+    // Resolve template.
+    // `--html-file` implies `--template html-embed` unless the user already picked one.
+    const template = (opts.template ?? (opts.htmlFile ? 'html-embed' : 'default'));
+    if (!util_templates.APP_TEMPLATES.includes(template)) {
+        throw new Error(`Unknown template "${template}". Available: ${util_templates.APP_TEMPLATES.join(', ')}.`);
+    }
+    if (opts.htmlFile && !(await fsExtra.pathExists(opts.htmlFile))) {
+        throw new Error(`HTML file does not exist: ${opts.htmlFile}`);
+    }
+    // Validate target dir.
+    const appDir = path__default.default.join(workspace, appName);
+    if (!(await isDirEmpty(appDir))) {
+        throw new Error(`${appDir} is non-empty. Pick a different name or wipe it first.`);
+    }
+    // Compute substitutions.
+    const vars = {
+        __APP_NAME__: appName,
+        __APP_COMPONENT__: pascalCase(appName),
+    };
+    const appTemplatesDir = path__default.default.join(util_templates.getTemplatesDir(), 'app');
+    await fsExtra.ensureDir(path__default.default.join(appDir, 'src'));
+    await fsExtra.ensureDir(path__default.default.join(appDir, '.claude'));
+    // package.json (templated).
+    const pkgRaw = await promises.readFile(path__default.default.join(appTemplatesDir, 'package.json.tmpl'), 'utf8');
+    await fsExtra.writeFile(path__default.default.join(appDir, 'package.json'), util_templates.renderTemplate(pkgRaw, vars));
+    // src/index.tsx (templated; choice driven by template).
+    const indexTemplate = template === 'html-embed' ? 'html-index.tsx.tmpl' : 'default-index.tsx.tmpl';
+    const indexRaw = await promises.readFile(path__default.default.join(appTemplatesDir, indexTemplate), 'utf8');
+    await fsExtra.writeFile(path__default.default.join(appDir, 'src', 'index.tsx'), util_templates.renderTemplate(indexRaw, vars));
+    // Copy verbatim files.
+    await fsExtra.copy(path__default.default.join(appTemplatesDir, 'gitignore'), path__default.default.join(appDir, '.gitignore'));
+    await fsExtra.copy(path__default.default.join(appTemplatesDir, 'claude-settings.json'), path__default.default.join(appDir, '.claude', 'settings.json'));
+    await fsExtra.copy(path__default.default.join(appTemplatesDir, 'CLAUDE.md'), path__default.default.join(appDir, 'CLAUDE.md'));
+    // html-embed: also copy the source HTML.
+    if (template === 'html-embed' && opts.htmlFile) {
+        await fsExtra.copy(opts.htmlFile, path__default.default.join(appDir, 'src', 'page.html'));
+    }
+    util_logger.info(`installing into workspace at ${workspace}`);
+    await execa.execa('yarn', ['install'], {
+        cwd: workspace,
+        stdio: 'inherit',
+    });
+    util_logger.output(`[z2h-cli] app ready at ${appDir}`, {
+        ok: true,
+        appDir,
+        appName,
+        template,
+    });
+}
+
+exports.createCommand = createCommand;

package/dist/constants.d.ts

@@ -3,21 +3,8 @@
  * one place) stay local to their file to keep this index small.
  */
 export declare const SHADOW_DIR_NAME = ".zth";
-/**
- * Protected runtime deps that MUST resolve to a single instance across the
- * wrapper (.zth) and the consumer's src. Declared as peerDependencies in
- * the shadow pkg so yarn hoists them from the workspace root — which is
- * why we enforce their presence in the consumer's own package.json.
- */
-export declare const PROTECTED_DEPS: Record<string, string>;
-/**
- * Protected dev deps. Same idempotent treatment as PROTECTED_DEPS but live
- * in the consumer's `devDependencies`. These give the LLM-authored consumer
- * code access to monday.com platform types out of the box.
- */
-export declare const PROTECTED_DEV_DEPS: Record<string, string>;
-export declare const WORKSPACE_DEV_DEPS: Record<string, string>;
 export declare const SHADOW_SCRIPTS: Record<string, string>;
+export declare const SHADOW_DEV_DEPS: Record<string, string>;
 export declare const MIN_PORT = 13000;
 export declare const MAX_PORT = 19999;
 export declare const GITIGNORE_ENTRIES: string[];

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,eAAO,MAAM,eAAe,SAAS,CAAC;AAGtC;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMjD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAGrD,CAAC;AAIF,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAKrD,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAGjD,CAAC;AAMF,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAG9B,eAAO,MAAM,iBAAiB,UAAY,CAAC;AAG3C,eAAO,MAAM,YAAY,UAIxB,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,eAAO,MAAM,eAAe,SAAS,CAAC;AAGtC,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAGjD,CAAC;AAQF,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAElD,CAAC;AAMF,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAG9B,eAAO,MAAM,iBAAiB,UAAY,CAAC;AAG3C,eAAO,MAAM,YAAY,UAIxB,CAAC"}

package/dist/constants.js

@@ -6,41 +6,20 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
  */
 // ─────────── Shadow dir layout ───────────
 const SHADOW_DIR_NAME = '.zth';
-// ─────────── Consumer pkg enforcement ──────
-/**
- * Protected runtime deps that MUST resolve to a single instance across the
- * wrapper (.zth) and the consumer's src. Declared as peerDependencies in
- * the shadow pkg so yarn hoists them from the workspace root — which is
- * why we enforce their presence in the consumer's own package.json.
- */
-const PROTECTED_DEPS = {
-    react: '^18.2.0',
-    'react-dom': '^18.2.0',
-    'react-error-boundary': '^3.1.3',
-    '@mondaydotcomorg/trident-runtime': '^1.24.1',
-    '@vibe/core': '^4.0.1',
-};
-/**
- * Protected dev deps. Same idempotent treatment as PROTECTED_DEPS but live
- * in the consumer's `devDependencies`. These give the LLM-authored consumer
- * code access to monday.com platform types out of the box.
- */
-const PROTECTED_DEV_DEPS = {
-    '@mondaydotcomorg/mf-api-types': '^0.1.1',
-    '@mondaydotcomorg/bigbrain-types': '^0.3.3',
-};
-// ─────────── Shadow pkg template ───────────
-// TODO — Add trident mf-types / bigbrain-types opt-in.
-const WORKSPACE_DEV_DEPS = {
-    '@mondaydotcomorg/trident-toolkit': '^2.9.25',
-    '@types/react': '^18.0.14',
-    '@types/react-dom': '^18.0.5',
-    typescript: '^5.7.2',
-};
+// ─────────── Shadow scripts ───────
 const SHADOW_SCRIPTS = {
     start: 'trident start',
     build: 'trident build',
 };
+// ─────────── Shadow dev deps ───────
+// Yarn berry only wires a workspace member's `node_modules/.bin/` PATH
+// for packages that member explicitly declares. The shadow's scripts
+// invoke `trident`, so trident-toolkit must be declared here for the
+// bin to resolve. `*` is fine — yarn workspaces resolve the actual
+// version from the workspace root's pinned entry.
+const SHADOW_DEV_DEPS = {
+    '@mondaydotcomorg/trident-toolkit': '*',
+};
 // ─────────── Auto-allocated dev port range ────
 // High enough to dodge common dev defaults (3000 Next, 5173 Vite, 8080).
 // Collisions within the 7k-port pool are rare for POC; if trident can't
@@ -59,9 +38,7 @@ const YARNRC_LINES = [
 exports.GITIGNORE_ENTRIES = GITIGNORE_ENTRIES;
 exports.MAX_PORT = MAX_PORT;
 exports.MIN_PORT = MIN_PORT;
-exports.PROTECTED_DEPS = PROTECTED_DEPS;
-exports.PROTECTED_DEV_DEPS = PROTECTED_DEV_DEPS;
+exports.SHADOW_DEV_DEPS = SHADOW_DEV_DEPS;
 exports.SHADOW_DIR_NAME = SHADOW_DIR_NAME;
 exports.SHADOW_SCRIPTS = SHADOW_SCRIPTS;
-exports.WORKSPACE_DEV_DEPS = WORKSPACE_DEV_DEPS;
 exports.YARNRC_LINES = YARNRC_LINES;

package/dist/esm/commands/__tests__/create-workspace.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=create-workspace.test.d.ts.map

package/dist/esm/commands/__tests__/create-workspace.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-workspace.test.d.ts","sourceRoot":"","sources":["../../../../src/commands/__tests__/create-workspace.test.ts"],"names":[],"mappings":""}

package/dist/esm/commands/__tests__/create.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=create.test.d.ts.map

package/dist/esm/commands/__tests__/create.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.test.d.ts","sourceRoot":"","sources":["../../../../src/commands/__tests__/create.test.ts"],"names":[],"mappings":""}

package/dist/esm/commands/create-workspace.d.ts

@@ -0,0 +1,5 @@
+export interface CreateWorkspaceOptions {
+    json?: boolean;
+}
+export declare function createWorkspaceCommand(opts: CreateWorkspaceOptions): Promise<void>;
+//# sourceMappingURL=create-workspace.d.ts.map

package/dist/esm/commands/create-workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-workspace.d.ts","sourceRoot":"","sources":["../../../src/commands/create-workspace.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAiBD,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyDxF"}

package/dist/esm/commands/create-workspace.mjs

@@ -0,0 +1,74 @@
+import path from 'node:path';
+import { readFile } from 'node:fs/promises';
+import { pathExists, readdir, ensureDir, writeFile, copy, readJson } from 'fs-extra';
+import { execa } from 'execa';
+import { setOutputMode, info, output } from '../util/logger.mjs';
+import { getWorkspaceHome } from '../util/workspace.mjs';
+import { getTemplatesDir, renderTemplate } from '../util/templates.mjs';
+
+/**
+ * Read the current z2h-cli version from its own package.json — the version
+ * that gets pinned into the workspace's devDependencies. That way the
+ * workspace's `@mondaydotcomorg/z2h-cli` always matches the version that
+ * bootstrapped it.
+ */
+async function readCurrentCliVersion() {
+    // util/templates.ts already locates `<package-root>/src/templates`. The
+    // package's own package.json sits two levels above templates/.
+    const templatesDir = getTemplatesDir();
+    const pkgPath = path.resolve(templatesDir, '..', '..', 'package.json');
+    const pkg = (await readJson(pkgPath));
+    return `^${pkg.version}`;
+}
+async function createWorkspaceCommand(opts) {
+    if (opts.json) {
+        setOutputMode('json');
+    }
+    const home = getWorkspaceHome();
+    const templatesDir = getTemplatesDir();
+    const wsTemplatesDir = path.join(templatesDir, 'workspace');
+    // Refuse non-empty target.
+    if (await pathExists(home)) {
+        const entries = await readdir(home);
+        if (entries.length > 0) {
+            throw new Error(`${home} is non-empty. Wipe it before running create-workspace.`);
+        }
+    }
+    else {
+        await ensureDir(home);
+    }
+    const [cliVersion, pkgRaw] = await Promise.all([
+        readCurrentCliVersion(),
+        readFile(path.join(wsTemplatesDir, 'package.json.tmpl'), 'utf8'),
+    ]);
+    // Sources have plain names (gitignore, yarnrc.yml, nvmrc, npmrc) so they
+    // aren't interpreted as the active config files of *this* package; we
+    // rename to dotfiles at the destination.
+    //
+    // Yarn berry ships inline at .yarn/releases/. The workspace's .yarnrc.yml
+    // sets `yarnPath` to point here, so any `yarn` invocation (system classic
+    // or otherwise) reads the rc, delegates to this binary, and runs as 4.5.1
+    // — no corepack, no global pin needed. Mirrors how bigbrain-z2h ships its
+    // own yarn release.
+    await Promise.all([
+        writeFile(path.join(home, 'package.json'), renderTemplate(pkgRaw, { __Z2H_CLI_VERSION__: cliVersion })),
+        copy(path.join(wsTemplatesDir, 'gitignore'), path.join(home, '.gitignore')),
+        copy(path.join(wsTemplatesDir, 'yarnrc.yml'), path.join(home, '.yarnrc.yml')),
+        copy(path.join(wsTemplatesDir, 'nvmrc'), path.join(home, '.nvmrc')),
+        copy(path.join(wsTemplatesDir, 'npmrc'), path.join(home, '.npmrc')),
+        copy(path.join(wsTemplatesDir, 'README.md'), path.join(home, 'README.md')),
+        copy(path.join(wsTemplatesDir, 'yarn-releases', 'yarn-4.5.1.cjs'), path.join(home, '.yarn', 'releases', 'yarn-4.5.1.cjs')),
+    ]);
+    info(`bootstrapping workspace at ${home}`);
+    await execa('yarn', ['install'], {
+        cwd: home,
+        stdio: 'inherit',
+    });
+    output(`[z2h-cli] workspace ready at ${home}`, {
+        ok: true,
+        workspace: home,
+        z2hCliVersion: cliVersion,
+    });
+}
+
+export { createWorkspaceCommand };

package/dist/esm/commands/create.d.ts

@@ -0,0 +1,7 @@
+export interface CreateOptions {
+    template?: string;
+    htmlFile?: string;
+    json?: boolean;
+}
+export declare function createCommand(appName: string, opts: CreateOptions): Promise<void>;
+//# sourceMappingURL=create.d.ts.map

package/dist/esm/commands/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/commands/create.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AA0BD,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA0EvF"}

package/dist/esm/commands/create.mjs

@@ -0,0 +1,91 @@
+import path from 'node:path';
+import { readFile } from 'node:fs/promises';
+import { pathExists, ensureDir, writeFile, copy, readdir } from 'fs-extra';
+import { execa } from 'execa';
+import { setOutputMode, info, output } from '../util/logger.mjs';
+import { assertWorkspace } from '../util/workspace.mjs';
+import { APP_TEMPLATES, getTemplatesDir, renderTemplate } from '../util/templates.mjs';
+
+const APP_NAME_RE = /^[a-z][a-z0-9-]{1,49}$/;
+/**
+ * Convert kebab-case to PascalCase. `demo-app` → `DemoApp`.
+ */
+function pascalCase(input) {
+    return input
+        .split('-')
+        .filter(Boolean)
+        .map(part => part.charAt(0).toUpperCase() + part.slice(1))
+        .join('');
+}
+/**
+ * Returns true iff `dir` either does not exist or is an empty directory.
+ */
+async function isDirEmpty(dir) {
+    if (!(await pathExists(dir))) {
+        return true;
+    }
+    const entries = await readdir(dir);
+    return entries.length === 0;
+}
+async function createCommand(appName, opts) {
+    if (opts.json) {
+        setOutputMode('json');
+    }
+    // Validate workspace.
+    const workspace = await assertWorkspace();
+    // Validate app name.
+    if (!APP_NAME_RE.test(appName)) {
+        throw new Error(`App name "${appName}" is invalid. Use lowercase kebab-case (a-z, 0-9, -), ` +
+            `2-50 chars, starting with a letter.`);
+    }
+    // Resolve template.
+    // `--html-file` implies `--template html-embed` unless the user already picked one.
+    const template = (opts.template ?? (opts.htmlFile ? 'html-embed' : 'default'));
+    if (!APP_TEMPLATES.includes(template)) {
+        throw new Error(`Unknown template "${template}". Available: ${APP_TEMPLATES.join(', ')}.`);
+    }
+    if (opts.htmlFile && !(await pathExists(opts.htmlFile))) {
+        throw new Error(`HTML file does not exist: ${opts.htmlFile}`);
+    }
+    // Validate target dir.
+    const appDir = path.join(workspace, appName);
+    if (!(await isDirEmpty(appDir))) {
+        throw new Error(`${appDir} is non-empty. Pick a different name or wipe it first.`);
+    }
+    // Compute substitutions.
+    const vars = {
+        __APP_NAME__: appName,
+        __APP_COMPONENT__: pascalCase(appName),
+    };
+    const appTemplatesDir = path.join(getTemplatesDir(), 'app');
+    await ensureDir(path.join(appDir, 'src'));
+    await ensureDir(path.join(appDir, '.claude'));
+    // package.json (templated).
+    const pkgRaw = await readFile(path.join(appTemplatesDir, 'package.json.tmpl'), 'utf8');
+    await writeFile(path.join(appDir, 'package.json'), renderTemplate(pkgRaw, vars));
+    // src/index.tsx (templated; choice driven by template).
+    const indexTemplate = template === 'html-embed' ? 'html-index.tsx.tmpl' : 'default-index.tsx.tmpl';
+    const indexRaw = await readFile(path.join(appTemplatesDir, indexTemplate), 'utf8');
+    await writeFile(path.join(appDir, 'src', 'index.tsx'), renderTemplate(indexRaw, vars));
+    // Copy verbatim files.
+    await copy(path.join(appTemplatesDir, 'gitignore'), path.join(appDir, '.gitignore'));
+    await copy(path.join(appTemplatesDir, 'claude-settings.json'), path.join(appDir, '.claude', 'settings.json'));
+    await copy(path.join(appTemplatesDir, 'CLAUDE.md'), path.join(appDir, 'CLAUDE.md'));
+    // html-embed: also copy the source HTML.
+    if (template === 'html-embed' && opts.htmlFile) {
+        await copy(opts.htmlFile, path.join(appDir, 'src', 'page.html'));
+    }
+    info(`installing into workspace at ${workspace}`);
+    await execa('yarn', ['install'], {
+        cwd: workspace,
+        stdio: 'inherit',
+    });
+    output(`[z2h-cli] app ready at ${appDir}`, {
+        ok: true,
+        appDir,
+        appName,
+        template,
+    });
+}
+
+export { createCommand };

package/dist/esm/constants.d.ts

@@ -3,21 +3,8 @@
  * one place) stay local to their file to keep this index small.
  */
 export declare const SHADOW_DIR_NAME = ".zth";
-/**
- * Protected runtime deps that MUST resolve to a single instance across the
- * wrapper (.zth) and the consumer's src. Declared as peerDependencies in
- * the shadow pkg so yarn hoists them from the workspace root — which is
- * why we enforce their presence in the consumer's own package.json.
- */
-export declare const PROTECTED_DEPS: Record<string, string>;
-/**
- * Protected dev deps. Same idempotent treatment as PROTECTED_DEPS but live
- * in the consumer's `devDependencies`. These give the LLM-authored consumer
- * code access to monday.com platform types out of the box.
- */
-export declare const PROTECTED_DEV_DEPS: Record<string, string>;
-export declare const WORKSPACE_DEV_DEPS: Record<string, string>;
 export declare const SHADOW_SCRIPTS: Record<string, string>;
+export declare const SHADOW_DEV_DEPS: Record<string, string>;
 export declare const MIN_PORT = 13000;
 export declare const MAX_PORT = 19999;
 export declare const GITIGNORE_ENTRIES: string[];

package/dist/esm/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,eAAO,MAAM,eAAe,SAAS,CAAC;AAGtC;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMjD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAGrD,CAAC;AAIF,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAKrD,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAGjD,CAAC;AAMF,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAG9B,eAAO,MAAM,iBAAiB,UAAY,CAAC;AAG3C,eAAO,MAAM,YAAY,UAIxB,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,eAAO,MAAM,eAAe,SAAS,CAAC;AAGtC,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAGjD,CAAC;AAQF,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAElD,CAAC;AAMF,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAG9B,eAAO,MAAM,iBAAiB,UAAY,CAAC;AAG3C,eAAO,MAAM,YAAY,UAIxB,CAAC"}

package/dist/esm/constants.mjs

@@ -4,41 +4,20 @@
  */
 // ─────────── Shadow dir layout ───────────
 const SHADOW_DIR_NAME = '.zth';
-// ─────────── Consumer pkg enforcement ──────
-/**
- * Protected runtime deps that MUST resolve to a single instance across the
- * wrapper (.zth) and the consumer's src. Declared as peerDependencies in
- * the shadow pkg so yarn hoists them from the workspace root — which is
- * why we enforce their presence in the consumer's own package.json.
- */
-const PROTECTED_DEPS = {
-    react: '^18.2.0',
-    'react-dom': '^18.2.0',
-    'react-error-boundary': '^3.1.3',
-    '@mondaydotcomorg/trident-runtime': '^1.24.1',
-    '@vibe/core': '^4.0.1',
-};
-/**
- * Protected dev deps. Same idempotent treatment as PROTECTED_DEPS but live
- * in the consumer's `devDependencies`. These give the LLM-authored consumer
- * code access to monday.com platform types out of the box.
- */
-const PROTECTED_DEV_DEPS = {
-    '@mondaydotcomorg/mf-api-types': '^0.1.1',
-    '@mondaydotcomorg/bigbrain-types': '^0.3.3',
-};
-// ─────────── Shadow pkg template ───────────
-// TODO — Add trident mf-types / bigbrain-types opt-in.
-const WORKSPACE_DEV_DEPS = {
-    '@mondaydotcomorg/trident-toolkit': '^2.9.25',
-    '@types/react': '^18.0.14',
-    '@types/react-dom': '^18.0.5',
-    typescript: '^5.7.2',
-};
+// ─────────── Shadow scripts ───────
 const SHADOW_SCRIPTS = {
     start: 'trident start',
     build: 'trident build',
 };
+// ─────────── Shadow dev deps ───────
+// Yarn berry only wires a workspace member's `node_modules/.bin/` PATH
+// for packages that member explicitly declares. The shadow's scripts
+// invoke `trident`, so trident-toolkit must be declared here for the
+// bin to resolve. `*` is fine — yarn workspaces resolve the actual
+// version from the workspace root's pinned entry.
+const SHADOW_DEV_DEPS = {
+    '@mondaydotcomorg/trident-toolkit': '*',
+};
 // ─────────── Auto-allocated dev port range ────
 // High enough to dodge common dev defaults (3000 Next, 5173 Vite, 8080).
 // Collisions within the 7k-port pool are rare for POC; if trident can't
@@ -54,4 +33,4 @@ const YARNRC_LINES = [
     "npmRegistryServer: 'https://registry.npmjs.org/'",
 ];
 
-export { GITIGNORE_ENTRIES, MAX_PORT, MIN_PORT, PROTECTED_DEPS, PROTECTED_DEV_DEPS, SHADOW_DIR_NAME, SHADOW_SCRIPTS, WORKSPACE_DEV_DEPS, YARNRC_LINES };
+export { GITIGNORE_ENTRIES, MAX_PORT, MIN_PORT, SHADOW_DEV_DEPS, SHADOW_DIR_NAME, SHADOW_SCRIPTS, YARNRC_LINES };

package/dist/esm/index.mjs

@@ -3,6 +3,8 @@ import { devCommand } from './commands/dev.mjs';
 import { buildCommand } from './commands/build.mjs';
 import { cleanCommand } from './commands/clean.mjs';
 import { deployCommand } from './commands/deploy.mjs';
+import { createWorkspaceCommand } from './commands/create-workspace.mjs';
+import { createCommand } from './commands/create.mjs';
 import { errorLog, fail } from './util/logger.mjs';
 
 async function main() {
@@ -74,6 +76,32 @@ async function main() {
             fail(`deploy failed: ${err.message}`, { command: 'deploy' }, 2);
         }
     });
+    program
+        .command('create-workspace')
+        .description('Bootstrap the ~/zth-projects/ yarn workspace (one-time setup)')
+        .option('--json', 'emit structured JSON on stdout')
+        .action(async (opts) => {
+        try {
+            await createWorkspaceCommand(opts);
+        }
+        catch (err) {
+            fail(`create-workspace failed: ${err.message}`, { command: 'create-workspace' }, 1);
+        }
+    });
+    program
+        .command('create <app-name>')
+        .description('Scaffold a new Z2H consumer app inside ~/zth-projects/')
+        .option('--template <name>', 'Template name (default | html-embed)')
+        .option('--html-file <path>', 'Path to an HTML file to embed (implies --template html-embed)')
+        .option('--json', 'emit structured JSON on stdout')
+        .action(async (appName, opts) => {
+        try {
+            await createCommand(appName, opts);
+        }
+        catch (err) {
+            fail(`create failed: ${err.message}`, { command: 'create' }, 1);
+        }
+    });
     await program.parseAsync(process.argv);
 }
 void main()

package/dist/esm/shadow/__tests__/consumer-pkg.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=consumer-pkg.test.d.ts.map