@vmz/vmz 0.1.13 → 0.1.14

package/dist/delivery-profile.d.ts

@@ -4,7 +4,7 @@
  */
 export declare const DELIVERY_PROFILE_AUTHORING_SCHEMA = "vmz.delivery.authoring.v0";
 export declare const BUILD_PROFILE_SELECTION_SCHEMA = "vmz.build.profile_selection.v0";
-/** Browser-era assembly kinds (04 B5). */
+/** Browser-era assembly kinds (04 B5). `static-cdn` was renamed to `web-static`. */
 export declare const ASSEMBLIES: readonly string[];
 export declare const SERVER_RUNTIMES: readonly string[];
 /** Official built-in aliases when not overridden in config. */
@@ -13,7 +13,7 @@ export declare const BUILTIN_PROFILES: Readonly<{
         host: string;
         assembly: string;
     };
-    'web-static': {
+    static: {
         host: string;
         assembly: string;
     };
@@ -28,10 +28,36 @@ export declare const BUILTIN_PROFILES: Readonly<{
         serverRuntime: string;
     };
 }>;
+/**
+ * Profile artifact directory name under CLI `--out-dir` (default = profile id).
+ * @param {string} id
+ * @param {unknown} rawName
+ * @param {Array<{ code: string, message: string }>} diagnostics
+ * @returns {string | null}
+ */
+export declare function normalizeProfileArtifactName(id: any, rawName: any, diagnostics: any): string;
+/**
+ * Workspace `--out-dir` + profile `name` → artifact root.
+ * Always nests: `path.join(outDir, name)` where `name` defaults to profile id
+ * (`name: 'cdn'` → `dist/cdn`; omit → `dist/static` for profile `static`).
+ * @param {string} outDir
+ * @param {{ name?: string, id?: string } | null | undefined} profile
+ */
+export declare function resolveProfileArtifactDir(outDir: any, profile: any): any;
 export declare function pickSiteAuthoring(raw: any): {
     artifact: string;
     sources: any;
 };
+/**
+ * `delivery.packaging.wechat` — vendor identity, not WeChat JSON / wx APIs.
+ * @param {unknown} raw
+ * @param {Array<{ code: string, message: string }>} diagnostics
+ */
+export declare function pickDeliveryPackaging(raw: any, diagnostics: any): {
+    wechat?: undefined;
+} | {
+    wechat: {};
+};
 export declare function normalizeDeliveryAuthoring(raw: any): {
     ok: boolean;
     table: {
@@ -59,6 +85,8 @@ export declare function selectBuildProfile(table: any, cliProfile?: string): {
     selection: {
         schema: string;
         profileId: any;
+        name: any;
+        nameExplicit: boolean;
         host: any;
         assembly: any;
         serverRuntime: any;

package/dist/delivery-profile.js

@@ -4,18 +4,67 @@
  */
 // @ts-nocheck
 import crypto from 'node:crypto';
+import path from 'node:path';
 export const DELIVERY_PROFILE_AUTHORING_SCHEMA = 'vmz.delivery.authoring.v0';
 export const BUILD_PROFILE_SELECTION_SCHEMA = 'vmz.build.profile_selection.v0';
-/** Browser-era assembly kinds (04 B5). */
-export const ASSEMBLIES = Object.freeze(['local-static', 'static-cdn', 'server-host', 'cdn+server', 'rust-embedded']);
+/** Browser-era assembly kinds (04 B5). `static-cdn` was renamed to `web-static`. */
+export const ASSEMBLIES = Object.freeze(['local-static', 'web-static', 'server-host', 'cdn+server', 'rust-embedded']);
 export const SERVER_RUNTIMES = Object.freeze(['node', 'worker', 'deno', 'bun', 'rust-host']);
 /** Official built-in aliases when not overridden in config. */
 export const BUILTIN_PROFILES = Object.freeze({
     'web-client': { host: 'browser', assembly: 'local-static' },
-    'web-static': { host: 'browser', assembly: 'static-cdn' },
+    static: { host: 'browser', assembly: 'web-static' },
     'web-ssr': { host: 'browser', assembly: 'server-host', serverRuntime: 'node' },
     'web-hybrid': { host: 'browser', assembly: 'cdn+server', serverRuntime: 'node' },
 });
+/**
+ * Profile artifact directory name under CLI `--out-dir` (default = profile id).
+ * @param {string} id
+ * @param {unknown} rawName
+ * @param {Array<{ code: string, message: string }>} diagnostics
+ * @returns {string | null}
+ */
+export function normalizeProfileArtifactName(id, rawName, diagnostics) {
+    const fallback = String(id || '').trim();
+    if (rawName == null || rawName === '')
+        return fallback || null;
+    if (typeof rawName !== 'string') {
+        diagnostics.push({
+            code: 'delivery.profile.name',
+            message: `profiles.${id}.name must be a string (got ${typeof rawName})`,
+        });
+        return null;
+    }
+    const name = rawName.trim();
+    if (!name) {
+        diagnostics.push({
+            code: 'delivery.profile.name',
+            message: `profiles.${id}.name must be a non-empty string`,
+        });
+        return null;
+    }
+    if (name === '.' || name === '..' || name.includes('/') || name.includes('\\') || name.includes('\0')) {
+        diagnostics.push({
+            code: 'delivery.profile.name',
+            message: `profiles.${id}.name must be a single path segment under --out-dir (got '${name}')`,
+        });
+        return null;
+    }
+    return name;
+}
+/**
+ * Workspace `--out-dir` + profile `name` → artifact root.
+ * Always nests: `path.join(outDir, name)` where `name` defaults to profile id
+ * (`name: 'cdn'` → `dist/cdn`; omit → `dist/static` for profile `static`).
+ * @param {string} outDir
+ * @param {{ name?: string, id?: string } | null | undefined} profile
+ */
+export function resolveProfileArtifactDir(outDir, profile) {
+    const name = String(profile?.name || profile?.id || '').trim();
+    if (!name)
+        return outDir;
+    return path.join(outDir, name);
+}
 function isPlainObject(v) {
     return v != null && typeof v === 'object' && !Array.isArray(v);
 }
@@ -49,6 +98,67 @@ export function pickSiteAuthoring(raw) {
     }
     return site;
 }
+/**
+ * `delivery.packaging.wechat` — vendor identity, not WeChat JSON / wx APIs.
+ * @param {unknown} raw
+ * @param {Array<{ code: string, message: string }>} diagnostics
+ */
+export function pickDeliveryPackaging(raw, diagnostics) {
+    if (!isPlainObject(raw) || raw.packaging == null)
+        return null;
+    if (!isPlainObject(raw.packaging)) {
+        diagnostics.push({ code: 'delivery.packaging', message: 'delivery.packaging must be an object' });
+        return null;
+    }
+    for (const key of Object.keys(raw.packaging)) {
+        if (key !== 'wechat') {
+            diagnostics.push({
+                code: 'delivery.packaging.vendor',
+                message: `delivery.packaging.${key} is not a known vendor (wechat)`,
+            });
+        }
+    }
+    const wechat = raw.packaging.wechat;
+    if (wechat == null)
+        return {};
+    if (!isPlainObject(wechat)) {
+        diagnostics.push({
+            code: 'delivery.packaging.wechat',
+            message: 'delivery.packaging.wechat must be an object',
+        });
+        return null;
+    }
+    for (const [k, v] of Object.entries(wechat)) {
+        if (typeof v === 'function') {
+            diagnostics.push({
+                code: 'delivery.packaging.executable',
+                message: `delivery.packaging.wechat.${k} must be pure data (no functions)`,
+            });
+            continue;
+        }
+        if (k !== 'appId' && k !== 'projectName' && k !== 'title') {
+            diagnostics.push({
+                code: 'delivery.packaging.wechat.field',
+                message: `delivery.packaging.wechat.${k} is not a known field (appId|projectName|title)`,
+            });
+        }
+        else if (v != null && typeof v !== 'string') {
+            diagnostics.push({
+                code: 'delivery.packaging.wechat.type',
+                message: `delivery.packaging.wechat.${k} must be a string`,
+            });
+        }
+    }
+    const out = {};
+    if (typeof wechat.appId === 'string' && wechat.appId.trim())
+        out.appId = wechat.appId.trim();
+    if (typeof wechat.projectName === 'string' && wechat.projectName.trim()) {
+        out.projectName = wechat.projectName.trim();
+    }
+    if (typeof wechat.title === 'string' && wechat.title.trim())
+        out.title = wechat.title.trim();
+    return { wechat: out };
+}
 function normalizeProfileEntry(entry, id, diagnostics) {
     if (!isPlainObject(entry)) {
         diagnostics.push({ code: 'delivery.profile.invalid', message: `profiles.${id} must be an object` });
@@ -61,7 +171,14 @@ function normalizeProfileEntry(entry, id, diagnostics) {
             message: `profiles.${id}.host: only 'browser' is supported before Browser Production (got ${host})`,
         });
     }
-    const assembly = String(entry.assembly || '').trim();
+    let assembly = String(entry.assembly || '').trim();
+    if (assembly === 'static-cdn') {
+        diagnostics.push({
+            code: 'delivery.profile.assembly.renamed',
+            message: `profiles.${id}.assembly 'static-cdn' was renamed to 'web-static'`,
+        });
+        return null;
+    }
     if (!ASSEMBLIES.includes(assembly)) {
         diagnostics.push({
             code: 'delivery.profile.assembly',
@@ -69,6 +186,10 @@ function normalizeProfileEntry(entry, id, diagnostics) {
         });
         return null;
     }
+    const nameExplicit = entry.name != null && String(entry.name).trim() !== '';
+    const name = normalizeProfileArtifactName(id, nameExplicit ? entry.name : id, diagnostics);
+    if (!name)
+        return null;
     let serverRuntime = null;
     if (assembly === 'server-host' || assembly === 'cdn+server') {
         serverRuntime = String(entry.serverRuntime || 'node');
@@ -110,6 +231,9 @@ function normalizeProfileEntry(entry, id, diagnostics) {
     }
     return {
         id,
+        name,
+        /** True when author set `profiles.<id>.name`; false → `name` defaulted to profile id. */
+        nameExplicit,
         host: 'browser',
         assembly,
         serverRuntime,
@@ -183,6 +307,10 @@ export function normalizeDeliveryAuthoring(raw) {
             },
         };
     }
+    else if (isPlainObject(raw.packaging)) {
+        defaultId = String(raw.default || 'web-ssr').trim() || 'web-ssr';
+        profileInputs = { ...BUILTIN_PROFILES };
+    }
     else {
         return {
             ok: false,
@@ -206,6 +334,9 @@ export function normalizeDeliveryAuthoring(raw) {
             message: `delivery.default '${defaultId}' is not a known profile`,
         });
     }
+    if (diagnostics.length)
+        return { ok: false, diagnostics };
+    const packaging = pickDeliveryPackaging(raw, diagnostics);
     if (diagnostics.length)
         return { ok: false, diagnostics };
     const table = {
@@ -213,6 +344,7 @@ export function normalizeDeliveryAuthoring(raw) {
         default: defaultId,
         profiles,
         sugar,
+        ...(packaging ? { packaging } : {}),
     };
     table.digest = sha256Hex(canonicalJson(table));
     return { ok: true, table };
@@ -234,6 +366,8 @@ export function selectBuildProfile(table, cliProfile = '') {
     const selection = {
         schema: BUILD_PROFILE_SELECTION_SCHEMA,
         profileId: id,
+        name: profile.name,
+        nameExplicit: Boolean(profile.nameExplicit),
         host: profile.host,
         assembly: profile.assembly,
         serverRuntime: profile.serverRuntime,
@@ -246,7 +380,7 @@ export function selectBuildProfile(table, cliProfile = '') {
 }
 export function semanticIdsForAssembly(assembly) {
     switch (assembly) {
-        case 'static-cdn':
+        case 'web-static':
             return ['static-delivery', 'asset-graph'];
         case 'server-host':
             return ['server-host', 'asset-graph'];

package/dist/dev-session.d.ts

@@ -16,6 +16,7 @@
  * @property {string} [host]
  * @property {number} [port]
  * @property {number} [pollMs]
+ * @property {'browser' | 'mini-program-wechat'} [target]
  * @property {AbortSignal} [signal]
  * @property {typeof createWorkspace} [createWorkspaceFn]
  * @property {(opts: { project: string, outDir: string, host: string, port: number }) => import('node:child_process').ChildProcess} [spawnHostFn]