@promptframe/cli 0.1.57 → 0.1.63

package/dist/index.js

@@ -8,6 +8,7 @@ import { basename, dirname, extname, join, relative, resolve } from 'node:path';
 import { inflateRawSync } from 'node:zlib';
 import { COMPONENT_MANIFEST_SCHEMA_VERSION, COMPONENT_PUBLIC_RESOURCES_CONTRACT_VERSION, COMPONENT_REF_VERSION, COMPONENT_STANDARD_SOURCE_HASH, COMPONENT_STANDARD_VERSION, PROMPTFRAME_AUTHORING_STANDARD_RELEASE, PROMPTFRAME_PUBLIC_RESOURCE_LIMITS, PROMPTFRAME_PUBLIC_RESOURCE_POLICY, PROMPTFRAME_PUBLIC_SECURITY_POLICY, PROMPTFRAME_PUBLIC_SECURITY_POLICY_DIGEST, PROMPTFRAME_PUBLIC_STANDARD_POLICY, PROMPTFRAME_LAYOUT_POLICY_RULE_IDS, PROMPTFRAME_CONTRACTS_VERSION, PROMPTFRAME_PUBLIC_DEPENDENCY_POLICY, detectPromptFrameUnknownCustomStyleProps, evaluatePromptFrameLayoutPolicy, evaluatePromptFrameDependencyPolicy, authoringUploadTargetSchema, parseComponentManifest, } from '@promptframe/contracts';
 import { evaluatePromptFrameSecurityPolicySource, } from '@promptframe/contracts/security-evaluator';
+import { evaluatePromptFrameSchemaSource, } from '@promptframe/contracts/schema-evaluator';
 import { applyPackageChanges, buildFreshnessDecision, computePackageChanges, computePackageFreshnessDiagnostics, computeScaffoldFreshnessDiagnostics, resolveLocalPreviewScript, } from './lifecycle.js';
 import { evaluateLocalReusability, reusabilityDiagnostics, } from './reusability.js';
 import { assertPreviewEnvelope, writeLocalPreviewReport, } from './preview-report.js';
@@ -470,6 +471,11 @@ function preview(argv) {
     console.log(`Run: npm run ${previewScript}`);
 }
 async function dev(argv) {
+    const workspaceRoot = autoWorkspaceRoot(argv);
+    if (workspaceRoot) {
+        await devWorkspace(workspaceRoot, argv);
+        return;
+    }
     const input = resolveComponentInput(argv);
     const dir = input.dir;
     const target = resolveUploadTarget(argv);
@@ -518,6 +524,48 @@ async function dev(argv) {
         return;
     await runDevServer(dir, devCommand);
 }
+async function devWorkspace(root, argv) {
+    const studioOrigin = valueAfter(argv, '--studio-origin')
+        ?? fail('Workspace dev requires --studio-origin <exact-origin> for its local connection.', 'dev.workspace.origin_required', 2);
+    const host = valueAfter(argv, '--host') ?? '127.0.0.1';
+    const port = Number(valueAfter(argv, '--port') ?? '0');
+    if ((host !== '127.0.0.1' && host !== '::1') || !Number.isSafeInteger(port) || port < 0 || port > 65535) {
+        fail('Workspace dev binds one explicit loopback address and port (0 chooses one actual free port).', 'dev.workspace.address_invalid', 2);
+    }
+    const workspace = readWorkspaceConfig(root);
+    if (hasFlag(argv, '--json') && !hasFlag(argv, '--dry-run')) {
+        fail('dev --json requires --dry-run so stdout remains machine-readable.', 'dev.json_requires_dry_run');
+    }
+    if (hasFlag(argv, '--dry-run')) {
+        printJson({ command: 'dev.workspace', workspace: workspaceSummary(root), modules: workspace.components,
+            host, port, studioOrigin, status: 'declared', checked: false, playerLoaded: false });
+        return;
+    }
+    // Lazy import keeps ordinary validate/check free of a Vite server lifecycle.
+    const { startDevelopmentWorkspace } = await import('./development-workspace.js');
+    let stop;
+    const stopped = new Promise(resolve => { stop = resolve; });
+    process.once('SIGINT', stop);
+    process.once('SIGTERM', stop);
+    try {
+        const server = await startDevelopmentWorkspace({ root, modules: workspace.components, studioOrigin, host, port });
+        try {
+            // This short-lived credential is for explicit local tooling, never an
+            // application login token or something to embed in component code.
+            printJson({ command: 'dev.workspace', contractVersion: 'promptframe-development.v1',
+                connectionId: server.connectionId, url: server.url, studioOrigin: server.studioOrigin,
+                credential: server.credential, expiresAt: server.expiresAt, playerLoaded: false });
+            await stopped;
+        }
+        finally {
+            await server.close();
+        }
+    }
+    finally {
+        process.removeListener('SIGINT', stop);
+        process.removeListener('SIGTERM', stop);
+    }
+}
 function packageComponent(argv) {
     const input = resolveComponentInput(argv);
     const artifact = packageDirectory(input.dir, valueAfter(argv, '--out'));
@@ -1619,6 +1667,7 @@ const POSITIONAL_VALUE_FLAGS = new Set([
     '--endpoint',
     '--expires-at',
     '--host',
+    '--studio-origin',
     '--id',
     '--level',
     '--name',
@@ -3232,8 +3281,10 @@ function validatePreviewProps(dir, manifest) {
     const preview = readPreviewProps(dir);
     assertPreviewEnvelope(preview, 'src/preview-props.json', fail);
     assertPreviewDurationMatchesManifest(preview, manifest);
-    assertPreviewPropsMatchStaticSchema(dir, manifest, preview);
-    assertStaticPropsHaveDescriptions(readIfExists(join(dir, manifest.entry.propsSchemaPath)), manifest.entry.propsSchemaPath);
+    const schemaFacts = evaluatePromptFrameSchemaSource(readIfExists(join(dir, manifest.entry.propsSchemaPath)));
+    assertStaticSchemaResolved(schemaFacts, manifest.entry.propsSchemaPath);
+    assertPreviewPropsMatchStaticSchema(manifest, preview, schemaFacts);
+    assertStaticPropsHaveDescriptions(schemaFacts, manifest.entry.propsSchemaPath);
 }
 function assertPreviewDurationMatchesManifest(preview, manifest) {
     const durationFrames = Number(preview.durationFrames);
@@ -3250,12 +3301,12 @@ function readPreviewProps(dir) {
     }
     return preview;
 }
-function assertPreviewPropsMatchStaticSchema(dir, manifest, preview) {
+function assertPreviewPropsMatchStaticSchema(manifest, preview, schemaFacts) {
     const previewProps = asRecord(preview.props) ?? {};
     const previewPropNames = Object.keys(previewProps);
     if (previewPropNames.length === 0)
         return;
-    const schemaKeys = extractStaticZodObjectKeys(readIfExists(join(dir, manifest.entry.propsSchemaPath)));
+    const schemaKeys = new Set(schemaFacts.propKeys);
     if (schemaKeys.size === 0)
         return;
     const unknown = previewPropNames.filter((name) => !schemaKeys.has(name));
@@ -3263,210 +3314,25 @@ function assertPreviewPropsMatchStaticSchema(dir, manifest, preview) {
         return;
     fail(`src/preview-props.json props include fields not declared in ${manifest.entry.propsSchemaPath}: ${unknown.join(', ')}`, 'component_standard.preview_props.unknown_prop');
 }
-function extractStaticZodObjectKeys(source) {
-    return new Set(extractStaticZodObjectProps(source).map((prop) => prop.key));
-}
-function extractStaticZodObjectProps(source) {
-    const openBrace = findPropsSchemaZodObjectOpenBrace(source) ?? findFirstZodObjectOpenBrace(source);
-    if (openBrace < 0)
-        return [];
-    const closeBrace = findMatchingBrace(source, openBrace);
-    if (closeBrace < 0)
-        return [];
-    return collectTopLevelObjectProps(source.slice(openBrace + 1, closeBrace));
+function assertStaticSchemaResolved(facts, sourcePath) {
+    if (facts.status === 'resolved')
+        return;
+    const diagnostic = facts.diagnostics.find((item) => item.code !== 'schema.props_schema_not_static');
+    // Legacy zero-prop fixtures may omit propsSchema entirely. Preserve that compatibility,
+    // while any declared but unresolved schema remains fail-visible.
+    if (!diagnostic)
+        return;
+    const location = diagnostic ? ` at ${diagnostic.line}:${diagnostic.column}` : '';
+    const prop = diagnostic?.propPath ? ` for ${diagnostic.propPath}` : '';
+    fail(`${sourcePath} could not be resolved by ${facts.evaluatorVersion}${prop}${location}: ${diagnostic?.message ?? 'schema is not static'}`, 'component_standard.props.schema_unresolved', 1, 'Use inline Zod expressions, named static schemas, an official PromptFrame helper, or a locally provable transparent wrapper. Unknown/dynamic wrappers are not executed or guessed.');
 }
-function assertStaticPropsHaveDescriptions(source, sourcePath) {
-    const missingProps = extractStaticZodObjectProps(source)
-        .filter((prop) => !hasStaticZodDescription(prop.valueSource))
-        .map((prop) => prop.key);
+function assertStaticPropsHaveDescriptions(facts, sourcePath) {
+    const missingProps = facts.propKeys.filter((key) => !facts.properties[key]?.description?.trim());
     if (missingProps.length === 0)
         return;
     const missingText = missingProps.join(', ');
     fail(`${sourcePath} props must include readable descriptions for: ${missingText}.`, 'component_standard.props.description_missing', 1, 'Add .describe("...") to each public propsSchema field, or provide equivalent metadata.parameterDescriptions before upload.');
 }
-function hasStaticZodDescription(source) {
-    return /\.describe\s*\(\s*(?:"[^"]+"|'[^']+'|`[^`]+`)\s*\)/m.test(source);
-}
-function findPropsSchemaZodObjectOpenBrace(source) {
-    const propsSchemaMatch = /\bpropsSchema\s*=\s*z\s*\.\s*object\s*\(/.exec(source);
-    if (!propsSchemaMatch)
-        return undefined;
-    const openParen = source.indexOf('(', propsSchemaMatch.index);
-    if (openParen < 0)
-        return undefined;
-    const openBrace = nextNonWhitespaceIndex(source, openParen + 1);
-    return openBrace >= 0 && source[openBrace] === '{' ? openBrace : undefined;
-}
-function findFirstZodObjectOpenBrace(source) {
-    const objectCallMatch = /\bz\s*\.\s*object\s*\(/.exec(source);
-    if (!objectCallMatch)
-        return -1;
-    const openParen = source.indexOf('(', objectCallMatch.index);
-    if (openParen < 0)
-        return -1;
-    const openBrace = nextNonWhitespaceIndex(source, openParen + 1);
-    return openBrace >= 0 && source[openBrace] === '{' ? openBrace : -1;
-}
-function nextNonWhitespaceIndex(source, start) {
-    for (let index = start; index < source.length; index += 1) {
-        if (!/\s/.test(source[index]))
-            return index;
-    }
-    return -1;
-}
-function findMatchingBrace(source, openIndex) {
-    let depth = 0;
-    let quote;
-    let escaped = false;
-    for (let index = openIndex; index < source.length; index += 1) {
-        const char = source[index];
-        const next = source[index + 1];
-        if (quote) {
-            if (escaped) {
-                escaped = false;
-            }
-            else if (char === '\\') {
-                escaped = true;
-            }
-            else if (char === quote) {
-                quote = undefined;
-            }
-            continue;
-        }
-        if (char === '/' && next === '/') {
-            index = skipLineComment(source, index + 2);
-            continue;
-        }
-        if (char === '/' && next === '*') {
-            index = skipBlockComment(source, index + 2);
-            continue;
-        }
-        if (char === '"' || char === '\'' || char === '`') {
-            quote = char;
-            continue;
-        }
-        if (char === '{')
-            depth += 1;
-        if (char === '}') {
-            depth -= 1;
-            if (depth === 0)
-                return index;
-        }
-    }
-    return -1;
-}
-function collectTopLevelObjectProps(body) {
-    const props = [];
-    let index = 0;
-    while (index < body.length) {
-        index = skipWhitespaceAndCommas(body, index);
-        if (index >= body.length)
-            break;
-        if (body.startsWith('...', index)) {
-            index = skipTopLevelValue(body, index + 3);
-            continue;
-        }
-        const keyResult = readObjectKey(body, index);
-        if (!keyResult) {
-            index += 1;
-            continue;
-        }
-        index = skipWhitespaceAndCommas(body, keyResult.nextIndex);
-        if (body[index] === ':') {
-            const valueStart = index + 1;
-            const valueEnd = skipTopLevelValue(body, valueStart);
-            props.push({
-                key: keyResult.key,
-                valueSource: body.slice(valueStart, valueEnd),
-            });
-            index = valueEnd;
-            continue;
-        }
-        index = keyResult.nextIndex;
-    }
-    return props;
-}
-function skipWhitespaceAndCommas(source, start) {
-    let index = start;
-    while (index < source.length && (/[\s,]/.test(source[index])))
-        index += 1;
-    return index;
-}
-function readObjectKey(source, start) {
-    const char = source[start];
-    if (char === '"' || char === '\'') {
-        let escaped = false;
-        let value = '';
-        for (let index = start + 1; index < source.length; index += 1) {
-            const current = source[index];
-            if (escaped) {
-                value += current;
-                escaped = false;
-                continue;
-            }
-            if (current === '\\') {
-                escaped = true;
-                continue;
-            }
-            if (current === char)
-                return { key: value, nextIndex: index + 1 };
-            value += current;
-        }
-        return undefined;
-    }
-    const identifier = /^[A-Za-z_$][\w$]*/.exec(source.slice(start));
-    if (!identifier)
-        return undefined;
-    return { key: identifier[0], nextIndex: start + identifier[0].length };
-}
-function skipTopLevelValue(source, start) {
-    let depth = 0;
-    let quote;
-    let escaped = false;
-    for (let index = start; index < source.length; index += 1) {
-        const char = source[index];
-        const next = source[index + 1];
-        if (quote) {
-            if (escaped) {
-                escaped = false;
-            }
-            else if (char === '\\') {
-                escaped = true;
-            }
-            else if (char === quote) {
-                quote = undefined;
-            }
-            continue;
-        }
-        if (char === '/' && next === '/') {
-            index = skipLineComment(source, index + 2);
-            continue;
-        }
-        if (char === '/' && next === '*') {
-            index = skipBlockComment(source, index + 2);
-            continue;
-        }
-        if (char === '"' || char === '\'' || char === '`') {
-            quote = char;
-            continue;
-        }
-        if (char === '(' || char === '[' || char === '{')
-            depth += 1;
-        if (char === ')' || char === ']' || char === '}')
-            depth -= 1;
-        if (char === ',' && depth <= 0)
-            return index + 1;
-    }
-    return source.length;
-}
-function skipLineComment(source, start) {
-    const nextLine = source.indexOf('\n', start);
-    return nextLine < 0 ? source.length : nextLine;
-}
-function skipBlockComment(source, start) {
-    const end = source.indexOf('*/', start);
-    return end < 0 ? source.length : end + 1;
-}
 function evaluateDirectoryReusability(dir, manifest, uploadTarget) {
     return evaluateLocalReusability({
         manifest,
@@ -3672,7 +3538,9 @@ function assertZipPropsHaveDescriptions(path) {
     const schemaEntry = readZipEntry(zip, (entryName) => isComponentSourceZipEntry(entryName, manifest.entry.propsSchemaPath));
     if (!schemaEntry)
         return;
-    assertStaticPropsHaveDescriptions(schemaEntry.toString('utf8'), manifest.entry.propsSchemaPath);
+    const facts = evaluatePromptFrameSchemaSource(schemaEntry.toString('utf8'));
+    assertStaticSchemaResolved(facts, manifest.entry.propsSchemaPath);
+    assertStaticPropsHaveDescriptions(facts, manifest.entry.propsSchemaPath);
 }
 function packageArtifactFromZip(path) {
     const file = readFileSync(path);
@@ -4432,6 +4300,7 @@ Commands:
   preview <dir>                    Validate and print local Remotion preview envelope
     --write-local-report           Write .promptframe/local-previews/preview-report.json
   dev <dir>                        Start the local Remotion Player preview server
+    --studio-origin <origin>        Required for a multi-component workspace's checked-module connection
   package <dir> --out <zip>        Validate and package a component source zip
   upload <dir|zip>                 Upload component source package to PromptFrame
     --target <target>              marketplace_authoring or project_private_generation