@mondaydotcomorg/z2h-cli 0.1.0 → 0.2.0

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/build.d.ts

@@ -1,5 +1,6 @@
 export interface BuildOptions {
     json?: boolean;
+    publicUrl?: string;
 }
 export declare function buildCommand(opts: BuildOptions): Promise<void>;
 //# sourceMappingURL=build.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/commands/build.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAgCpE"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/commands/build.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAoCpE"}

package/dist/commands/build.js

@@ -22,7 +22,11 @@ async function buildCommand(opts) {
         stdio: 'inherit',
     });
     util_logger.info(`building "${ctx.appName}" via trident`);
-    await execa.execa('yarn', ['build'], { cwd: ctx.paths.shadowDir, stdio: 'inherit' });
+    await execa.execa('yarn', ['build'], {
+        cwd: ctx.paths.shadowDir,
+        stdio: 'inherit',
+        env: { ...process.env, ...(opts.publicUrl ? { PUBLIC_URL: opts.publicUrl } : {}) },
+    });
     if (!(await fsExtra.pathExists(ctx.paths.shadowBuild))) {
         throw new Error(`Expected build output at ${ctx.paths.shadowBuild} — not found.`);
     }

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,CA0DxF"}

package/dist/commands/create-workspace.js

@@ -0,0 +1,81 @@
+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, 'yarnlock'), path__default.default.join(home, 'yarn.lock')),
+        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":"AAUA,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,CAgFvF"}

package/dist/commands/create.js

@@ -0,0 +1,104 @@
+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 util_manifest = require('../util/manifest.js');
+const util_appName = require('../util/app-name.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.`);
+    }
+    // Check for manifest collision (network call — after all local checks).
+    const manifest = await util_manifest.readManifest();
+    if (manifest[util_appName.mfAppName(appName)]) {
+        throw new Error(`An app named "${appName}" already exists in the Z2H registry. Pick a different name.`);
+    }
+    // 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/commands/deploy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/commands/deploy.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAaD,wBAAsB,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA6EtE"}
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/commands/deploy.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAaD,wBAAsB,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAgFtE"}

package/dist/commands/deploy.js

@@ -1,6 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
 const path = require('node:path');
+const os = require('node:os');
 const fsExtra = require('fs-extra');
 require('execa');
 const util_logger = require('../util/logger.js');
@@ -14,6 +15,7 @@ const commands_build = require('./build.js');
 const _interopDefault = e => e && e.__esModule ? e : { default: e };
 
 const path__default = /*#__PURE__*/_interopDefault(path);
+const os__default = /*#__PURE__*/_interopDefault(os);
 
 const APONO_BUNDLE = '<APONO_BUNDLE_NAME>'; // TODO: replace with actual bundle name once infra setup is complete
 async function requestAponoAccess() {
@@ -28,14 +30,19 @@ async function deployCommand(opts) {
     }
     util_logger.info('checking S3 bucket');
     await util_s3_client.assertBucketExists();
-    util_logger.info('building');
-    await commands_build.buildCommand({ json: opts.json });
     const paths = shadow_paths.resolveConsumerPaths(process.cwd());
     const consumerPkg = (await fsExtra.readJson(paths.consumerPkg));
     if (!consumerPkg.name) {
         throw new Error('Consumer package.json must have a "name" field');
     }
     const appName = util_appName.mfAppName(consumerPkg.name);
+    util_logger.info('reading current Z2H manifest');
+    const manifest = await util_manifest.readManifest();
+    const version = util_manifest.nextVersion(manifest, appName);
+    const keyPrefix = `${appName}/${version}`;
+    const url = `${util_s3_client.BUCKET_READ_DNS_URL}/${keyPrefix}`;
+    util_logger.info('building');
+    await commands_build.buildCommand({ json: opts.json, publicUrl: url });
     if (!(await fsExtra.pathExists(paths.shadowBuild))) {
         throw new Error(`No build output at ${paths.shadowBuild} after build step.`);
     }
@@ -45,11 +52,6 @@ async function deployCommand(opts) {
         throw new Error(`Missing asset-manifest.json at ${assetManifestPath}.`);
     }
     const assetManifest = (await fsExtra.readJson(assetManifestPath));
-    util_logger.info('reading current Z2H manifest');
-    const manifest = await util_manifest.readManifest();
-    const version = util_manifest.nextVersion(manifest, appName);
-    const keyPrefix = `${appName}/${version}`;
-    const url = `${util_s3_client.BUCKET_READ_DNS_URL}/${keyPrefix}`;
     if (opts.dryRun) {
         util_logger.output(`[z2h-cli] dry-run: would upload to s3://${util_s3_client.BUCKET_WRITE_NAME}/${keyPrefix}/ as v${version}`, {
             ok: true,
@@ -64,13 +66,15 @@ async function deployCommand(opts) {
         return;
     }
     await requestAponoAccess();
-    util_logger.info(`uploading build → s3://${util_s3_client.BUCKET_WRITE_NAME}/${keyPrefix}/`);
-    await util_s3_upload.uploadDir(paths.shadowBuild, keyPrefix);
+    const deployedBy = os__default.default.userInfo().username;
     const entry = {
         ...assetManifest,
         version,
         url,
+        deployedBy,
     };
+    util_logger.info(`uploading build → s3://${util_s3_client.BUCKET_WRITE_NAME}/${keyPrefix}/`);
+    await util_s3_upload.uploadDir(paths.shadowBuild, keyPrefix);
     util_logger.info(`updating manifest entry "${appName}" → v${version}`);
     await util_manifest.writeManifest(util_manifest.upsertEntry(manifest, appName, entry));
     // The host MF parses the app name from the URL and prepends `mf-` itself

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

@@ -1 +1 @@
-{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAID,wBAAsB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAgDhE"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAID,wBAAsB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAuEhE"}

package/dist/commands/dev.js

@@ -1,5 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
+const path = require('node:path');
+const fs = require('node:fs');
 const fsExtra = require('fs-extra');
 const chokidar = require('chokidar');
 const execa = require('execa');
@@ -8,6 +10,11 @@ const shadow_prepare = require('../shadow/prepare.js');
 const shadow_consumerPkg = require('../shadow/consumer-pkg.js');
 const shadow_sync = require('../shadow/sync.js');
 
+const _interopDefault = e => e && e.__esModule ? e : { default: e };
+
+const path__default = /*#__PURE__*/_interopDefault(path);
+const fs__default = /*#__PURE__*/_interopDefault(fs);
+
 const TRIDENT_READY_PATTERN = /Server started at/i;
 async function devCommand(opts) {
     if (opts.json) {
@@ -24,6 +31,28 @@ async function devCommand(opts) {
         cwd: ctx.paths.shadowDir,
         stdio: ['inherit', 'pipe', 'inherit'],
     });
+    const pidFile = path__default.default.join(ctx.paths.shadowDir, 'dev.pid');
+    if (server.pid) {
+        await fsExtra.writeFile(pidFile, String(server.pid));
+    }
+    const cleanupPid = () => {
+        try {
+            fs__default.default.unlinkSync(pidFile);
+        }
+        catch (_) {
+            // file already gone — ignore
+        }
+    };
+    server.on('exit', cleanupPid);
+    process.on('exit', cleanupPid);
+    process.on('SIGINT', () => {
+        server.kill();
+        process.exit(0);
+    });
+    process.on('SIGTERM', () => {
+        server.kill();
+        process.exit(0);
+    });
     let readyPrinted = false;
     server.stdout?.on('data', (chunk) => {
         process.stdout.write(chunk);

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/build.d.ts

@@ -1,5 +1,6 @@
 export interface BuildOptions {
     json?: boolean;
+    publicUrl?: string;
 }
 export declare function buildCommand(opts: BuildOptions): Promise<void>;
 //# sourceMappingURL=build.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/commands/build.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAgCpE"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/commands/build.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAoCpE"}

package/dist/esm/commands/build.mjs

@@ -20,7 +20,11 @@ async function buildCommand(opts) {
         stdio: 'inherit',
     });
     info(`building "${ctx.appName}" via trident`);
-    await execa('yarn', ['build'], { cwd: ctx.paths.shadowDir, stdio: 'inherit' });
+    await execa('yarn', ['build'], {
+        cwd: ctx.paths.shadowDir,
+        stdio: 'inherit',
+        env: { ...process.env, ...(opts.publicUrl ? { PUBLIC_URL: opts.publicUrl } : {}) },
+    });
     if (!(await pathExists(ctx.paths.shadowBuild))) {
         throw new Error(`Expected build output at ${ctx.paths.shadowBuild} — not found.`);
     }

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,CA0DxF"}

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

@@ -0,0 +1,75 @@
+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, 'yarnlock'), path.join(home, 'yarn.lock')),
+        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":"AAUA,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,CAgFvF"}