@forgeax/engine-pack 0.1.20 → 0.1.23

package/dist/parameterized-pack.d.ts

@@ -0,0 +1,233 @@
+import type { Asset, AssetGuid, Result } from '@forgeax/engine-types';
+import { PackageId } from './guid.js';
+import type { ScriptablePackSceneComponentInput } from './scriptable-pack.js';
+/** Values deliberately stay finite and serialisable at the authoring boundary. */
+export type PackParameterScalar = boolean | number | string;
+export type PackParameterValue = PackParameterScalar | readonly number[] | AssetGuid;
+export type PackParameterType = 'bool' | 'u32' | 'i32' | 'f32' | 'f64' | 'string' | 'enum' | 'vec2' | 'vec3' | 'vec4' | 'color' | 'asset-guid';
+export declare const PACK_PARAMETER_TYPES: readonly ["bool", "u32", "i32", "f32", "f64", "string", "enum", "vec2", "vec3", "vec4", "color", "asset-guid"];
+export interface PackParameterDefinition<TName extends string = string, TType extends PackParameterType = PackParameterType, TDefault extends PackParameterValue = PackParameterValue> {
+    readonly name: TName;
+    readonly type: TType;
+    readonly default: TDefault;
+    readonly minimum?: number;
+    readonly maximum?: number;
+    /** Closed choices are required for `enum` and forbidden for other types. */
+    readonly values?: readonly PackParameterScalar[];
+    /** Optional authoring-only kind constraint for asset GUID parameters. */
+    readonly kind?: Asset['kind'];
+}
+export type PackParameterValueFor<T extends PackParameterType> = T extends 'bool' ? boolean : T extends 'u32' | 'i32' | 'f32' | 'f64' ? number : T extends 'string' | 'enum' ? string : T extends 'vec2' ? readonly [number, number] : T extends 'vec3' ? readonly [number, number, number] : T extends 'vec4' | 'color' ? readonly [number, number, number, number] : T extends 'asset-guid' ? AssetGuid : never;
+export type PackParameterValues<TParameters extends readonly PackParameterDefinition[]> = Readonly<{
+    [TParameter in TParameters[number] as TParameter['name']]: TParameter extends {
+        readonly type: infer TType extends PackParameterType;
+    } ? TType extends 'enum' ? TParameter extends {
+        readonly values: readonly (infer TValue)[];
+    } ? Extract<TValue, string> : string : PackParameterValueFor<TType> : never;
+}>;
+export interface PackAuthoringError {
+    readonly code: PackAuthoringErrorCode;
+    readonly expected: string;
+    readonly hint: string;
+    readonly actual?: string;
+    readonly detail: Readonly<Record<string, unknown>>;
+}
+export type PackAuthoringErrorCode = 'pack-package-id-invalid' | 'pack-package-id-collision' | 'pack-source-key-invalid' | 'pack-guid-collision' | 'pack-parent-not-found' | 'pack-parent-cycle' | 'pack-parent-not-parameterized' | 'pack-parameter-invalid' | 'pack-content-dependency-stalled' | 'pack-output-reference-missing' | 'pack-output-reference-conflict' | 'pack-output-not-materialized' | 'asset-not-ready' | 'pack-source-revision-conflict' | 'pack-source-path-invalid' | 'pack-source-not-found' | 'pack-source-mutation-unsupported' | 'pack-source-write-failed';
+export interface PackBuildReadContext {
+    readByGuid<TAsset extends Asset = Asset>(guid: AssetGuid): Promise<Result<TAsset, unknown>>;
+}
+export interface PackBuildContextWithoutParameters extends PackBuildReadContext {
+    readonly packageId: PackageId;
+}
+export interface PackBuildContextWithParameters<TParameters extends readonly PackParameterDefinition[]> extends PackBuildReadContext {
+    readonly packageId: PackageId;
+    readonly values: PackParameterValues<TParameters>;
+}
+export type PackBuildContext<TParameters extends readonly PackParameterDefinition[] | undefined> = TParameters extends readonly PackParameterDefinition[] ? PackBuildContextWithParameters<TParameters> : PackBuildContextWithoutParameters;
+export type PackOutputMap = Readonly<Record<string, Asset>>;
+export type PackBuildResult<TError = unknown> = Result<PackOutputMap, TError> | Promise<Result<PackOutputMap, TError>>;
+interface PackDefinitionBase {
+    readonly schemaVersion: '2.0.0';
+    readonly packageId: PackageId;
+    readonly name?: string;
+    /** Neutral component schemas used only to externalize SceneAsset refs at cook time. */
+    readonly sceneComponents?: readonly ScriptablePackSceneComponentInput[];
+}
+export type ParameterizedPackDefinition<TParameters extends readonly PackParameterDefinition[] | undefined = undefined> = PackDefinitionBase & (TParameters extends readonly PackParameterDefinition[] ? {
+    readonly parameters: TParameters;
+    readonly build: (context: PackBuildContextWithParameters<TParameters>) => PackBuildResult;
+} : {
+    readonly build: (context: PackBuildContextWithoutParameters) => PackBuildResult;
+});
+export type PackDefinition = ParameterizedPackDefinition<undefined> | ParameterizedPackDefinition<readonly [PackParameterDefinition, ...PackParameterDefinition[]]>;
+export type PackParameterList = readonly [PackParameterDefinition, ...PackParameterDefinition[]];
+type NonEmptyParameters = PackParameterList;
+type NoParameterPackInput = PackDefinitionBase & {
+    readonly parameters?: never;
+    readonly build: (context: PackBuildContextWithoutParameters) => PackBuildResult;
+};
+type ParameterizedPackInput<TParameters extends NonEmptyParameters> = PackDefinitionBase & {
+    readonly parameters: TParameters;
+    readonly build: (context: PackBuildContextWithParameters<TParameters>) => PackBuildResult;
+};
+/** Convert a UUID literal into the distinct Pack-level identity brand. */
+export declare function definePackageId(value: string | PackageId): PackageId;
+/**
+ * Define the only executable authoring shape. A missing `parameters` property
+ * is meaningful: its build context has no `values` member.
+ */
+export declare function definePack(definition: NoParameterPackInput): ParameterizedPackDefinition<undefined>;
+export declare function definePack<const TParameters extends NonEmptyParameters>(definition: ParameterizedPackInput<TParameters>): ParameterizedPackDefinition<TParameters>;
+/** Union used only at orchestration boundaries that accept either source form. */
+export type AnyParameterizedPackDefinition = ParameterizedPackDefinition<PackParameterList> | ParameterizedPackDefinition<undefined>;
+export interface ParameterizedPackSourceMeta {
+    readonly schemaVersion: '2.0.0';
+    readonly kind: 'parameterized-pack-source';
+    readonly packageId: string;
+    readonly source: string;
+    readonly parameters?: readonly Readonly<Record<string, unknown>>[];
+}
+/** Ephemeral scan evidence; it intentionally contains no output GUID table. */
+export declare function projectParameterizedPackMeta(definition: AnyParameterizedPackDefinition, sourcePath: string): ParameterizedPackSourceMeta;
+/** Runtime validation used by the isolated module loader and source scanner. */
+export declare function validatePackDefinition(value: unknown, sourcePath?: string): Result<ParameterizedPackDefinition<NonEmptyParameters> | ParameterizedPackDefinition<undefined>, PackAuthoringError>;
+export declare function isParameterizedPack(value: ParameterizedPackDefinition | unknown): value is ParameterizedPackDefinition<NonEmptyParameters>;
+/** Resolve defaults plus a sparse instance override with shallow replacement. */
+export declare function resolvePackParameterValues(definition: ParameterizedPackDefinition<NonEmptyParameters>, overrides?: unknown, inheritedValues?: Readonly<Record<string, PackParameterValue>>): Result<PackParameterValues<NonEmptyParameters>, PackAuthoringError>;
+export interface DirectPackJsonAsset {
+    readonly kind: string;
+    readonly payload: Readonly<Record<string, unknown>>;
+    readonly refs: readonly string[];
+    readonly name?: string;
+    readonly artifacts?: Readonly<Record<string, Readonly<Record<string, unknown>>>>;
+}
+export interface DirectPackJson {
+    readonly schemaVersion: '3.0.0';
+    readonly packageId: string;
+    readonly assets: Readonly<Record<string, DirectPackJsonAsset>>;
+}
+export interface PackInstanceJson {
+    readonly schemaVersion: '3.0.0';
+    readonly packageId: string;
+    readonly parent: string;
+    readonly values: Readonly<Record<string, unknown>>;
+}
+export interface ParsedDirectPackJson {
+    readonly format: 'direct';
+    readonly schemaVersion: '3.0.0';
+    readonly packageId: PackageId;
+    readonly assets: Readonly<Record<string, DirectPackJsonAsset>>;
+}
+export interface ParsedPackInstanceJson {
+    readonly format: 'instance';
+    readonly schemaVersion: '3.0.0';
+    readonly packageId: PackageId;
+    readonly parent: PackageId;
+    readonly values: Readonly<Record<string, unknown>>;
+}
+export type ParsedPackJson = ParsedDirectPackJson | ParsedPackInstanceJson;
+/** Parse the two mutually exclusive v3 pack.json branches. */
+export declare function parseParameterizedPackJson(value: unknown): Result<ParsedPackJson, PackAuthoringError>;
+export declare const parsePackJson: typeof parseParameterizedPackJson;
+export declare const parsePackAuthoringJson: typeof parseParameterizedPackJson;
+export interface DirectPackAssetProjection extends DirectPackJsonAsset {
+    readonly guid: string;
+    readonly sourceKey: string;
+}
+export interface DirectPackProjection {
+    readonly packageId: string;
+    readonly assets: readonly DirectPackAssetProjection[];
+}
+/** Add the computed GUIDs needed by the ordinary Pack v2 publication path. */
+export declare function projectDirectPackJson(value: ParsedDirectPackJson | DirectPackJson): Result<DirectPackProjection, PackAuthoringError>;
+export interface PackParameterRootSubject {
+    readonly format: 'source';
+    readonly packageId: PackageId;
+    readonly parameters: readonly PackParameterDefinition[];
+}
+export interface PackParameterInstanceSubject {
+    readonly format: 'instance';
+    readonly packageId: PackageId;
+    readonly parent: PackageId;
+    readonly values: Readonly<Record<string, unknown>>;
+}
+export interface PackDirectSubject {
+    readonly format: 'direct';
+    readonly packageId: PackageId;
+}
+export type PackParameterInheritanceSubject = PackParameterRootSubject | PackParameterInstanceSubject | PackDirectSubject;
+export interface ResolvedPackParameterInheritance {
+    readonly packageId: PackageId;
+    readonly rootPackageId: PackageId;
+    readonly values: Readonly<Record<string, PackParameterValue>>;
+    readonly parentChain: readonly string[];
+    readonly parameters: readonly PackParameterDefinition[];
+}
+export type PackParameterSubjectReader = (packageId: PackageId) => PackParameterInheritanceSubject | undefined | Promise<PackParameterInheritanceSubject | undefined>;
+/** Resolve one finite parent chain. Every instance keeps its own packageId. */
+export declare function resolvePackParameterInheritance(subject: PackParameterInheritanceSubject, readParent: PackParameterSubjectReader): Promise<Result<ResolvedPackParameterInheritance, PackAuthoringError>>;
+export declare const resolvePackInheritance: typeof resolvePackParameterInheritance;
+export declare const PARAMETERIZED_PACK_OPERATION_IDS: readonly ["asset.list", "asset.inspect", "asset.resolve", "asset.verify", "asset-source.create", "asset-source.clone", "asset-source.create-instance", "asset-source.apply-values", "asset-source.rebuild", "asset-source.cold-cook"];
+export type ParameterizedPackOperationId = (typeof PARAMETERIZED_PACK_OPERATION_IDS)[number];
+export interface ParameterizedPackOperation {
+    readonly requestId: string;
+    readonly expectedRevision?: string;
+    readonly operation: ParameterizedPackOperationId;
+    readonly subject?: string;
+    readonly sourcePath?: string;
+    readonly targetPath?: string;
+    readonly packageId?: string;
+    /** Parent package identity used by asset-source.create-instance. */
+    readonly parentPackageId?: string;
+    /** JSON-facing alias accepted by adapters at the operation boundary. */
+    readonly parent?: string;
+    readonly sourceKey?: string;
+    readonly values?: Readonly<Record<string, unknown>>;
+    /** `pack.ts` or `pack.json`; omitted defaults to the target extension. */
+    readonly format?: 'pack.ts' | 'pack.json';
+    /** Direct v3 entries for asset-source.create. */
+    readonly initialAssets?: Readonly<Record<string, DirectPackJsonAsset>>;
+    /** Explicit non-empty parameter declarations for a generated pack.ts scaffold. */
+    readonly parameters?: readonly Readonly<Record<string, unknown>>[];
+    /** Required proof level for asset.resolve. */
+    readonly require?: 'identity' | 'present' | 'ready';
+}
+export type ParameterizedPackResolutionStatus = 'identity' | 'present' | 'ready';
+export interface ParameterizedPackOperationResult {
+    readonly operation: ParameterizedPackOperationId;
+    readonly requestId: string;
+    readonly sourcePath?: string;
+    readonly targetPath?: string;
+    readonly revision?: string;
+    readonly packageId?: string;
+    readonly parentPackageId?: string;
+    readonly sourceKey?: string;
+    readonly guid?: string;
+    readonly format?: 'pack.ts' | 'pack.json' | 'direct' | 'instance';
+    readonly status?: ParameterizedPackResolutionStatus;
+    readonly kind?: string;
+    readonly parameters?: readonly Readonly<Record<string, unknown>>[];
+    readonly values?: Readonly<Record<string, unknown>>;
+    readonly effectiveValues?: Readonly<Record<string, unknown>>;
+    readonly parentChain?: readonly string[];
+    readonly assets?: readonly Readonly<Record<string, unknown>>[];
+    readonly sources?: readonly Readonly<Record<string, unknown>>[];
+    readonly capabilities?: readonly ParameterizedPackOperationId[];
+    readonly snapshot?: {
+        readonly sourceCount: number;
+        readonly assetCount: number;
+    };
+}
+export interface ParameterizedPackGatewayPort<TResult = unknown> {
+    execute(operation: ParameterizedPackOperation): Promise<Result<TResult, PackAuthoringError>>;
+}
+/** One idempotent gateway wrapper shared by Editor and CLI adapters. */
+export declare function createParameterizedPackAuthoringGateway<TResult = unknown>(port: ParameterizedPackGatewayPort<TResult>): ParameterizedPackGatewayPort<TResult>;
+export declare const PARAMETERIZED_PACK_OPERATION_DESCRIPTORS: readonly {
+    id: ParameterizedPackOperationId;
+    domain: "asset" | "session";
+    readOnly: boolean;
+    requiresRevision: boolean;
+}[];
+export {};
+//# sourceMappingURL=parameterized-pack.d.ts.map

package/dist/parameterized-pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameterized-pack.d.ts","sourceRoot":"","sources":["../src/parameterized-pack.ts"],"names":[],"mappings":"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"}

package/dist/resolve-asset-source.d.ts

@@ -1,4 +1,2 @@
-import type { Result } from '@forgeax/engine-types';
-import { PackError } from './errors.js';
-export declare function resolveAssetSource(metaPath: string, source: string | undefined, paths: Record<string, string>): Result<string, PackError>;
+export declare function resolveAssetSource(metaPath: string, source: string | undefined): string;
 //# sourceMappingURL=resolve-asset-source.d.ts.map

package/dist/resolve-asset-source.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-asset-source.d.ts","sourceRoot":"","sources":["../src/resolve-asset-source.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAGpD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAaxC,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5B,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAkE3B"}
+{"version":3,"file":"resolve-asset-source.d.ts","sourceRoot":"","sources":["../src/resolve-asset-source.ts"],"names":[],"mappings":"AAOA,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAQvF"}

package/dist/resolve-asset-source.mjs

@@ -1,5 +1,4 @@
-import { dirname, resolve, posix } from 'path';
-import { ok, err, PACK_ERROR_HINTS } from '@forgeax/engine-types';
+import { dirname, resolve } from 'path';
 
 // src/resolve-asset-source.ts
 
@@ -9,99 +8,25 @@ function baseName(p) {
   const idx = Math.max(trimmed.lastIndexOf("/"), trimmed.lastIndexOf("\\"));
   return idx === -1 ? trimmed : trimmed.slice(idx + 1);
 }
-function deriveAssetName(packagePath, assetCount, storedName) {
+function deriveAssetName(packagePath, _assetCount, storedName) {
   if (packagePath === null) {
     return "";
   }
-  {
-    return baseName(packagePath);
-  }
+  return baseName(packagePath);
 }
 
-// src/errors.ts
-var PackError = class extends Error {
-  code;
-  expected;
-  hint;
-  detail;
-  constructor(args) {
-    super(`[PackError ${args.code}] expected: ${args.expected}; hint: ${args.hint}`);
-    this.name = "PackError";
-    this.code = args.code;
-    this.expected = args.expected;
-    this.hint = args.hint;
-    this.detail = args.detail;
-  }
-};
-
 // src/resolve-asset-source.ts
 function deriveSourceName(metaFileName) {
   return metaFileName.replace(/\.meta\.json$/, "");
 }
-var PATH_REF_RE = /^@([^/]+)\/(.+)$/;
-function isPathEscape(pathDir, resolved) {
-  const rel = posix.relative(pathDir, resolved);
-  return rel.startsWith("..") || posix.isAbsolute(rel);
-}
-function resolveAssetSource(metaPath, source, paths) {
+function resolveAssetSource(metaPath, source) {
   if (source === void 0) {
     const metaDir = dirname(metaPath);
     const metaName = deriveAssetName(metaPath);
     const derived = deriveSourceName(metaName);
-    return ok(resolve(metaDir, derived));
-  }
-  if (source.startsWith("@")) {
-    const match = source.match(PATH_REF_RE);
-    if (!match) {
-      return err(
-        new PackError({
-          code: "pack-malformed-path-ref",
-          expected: "source in format @<name>/<rest>",
-          hint: PACK_ERROR_HINTS["pack-malformed-path-ref"],
-          detail: {
-            code: "pack-malformed-path-ref",
-            reason: "format",
-            rawSource: source,
-            expectedFormat: "@<name>/<rest>"
-          }
-        })
-      );
-    }
-    const [, name, rest] = match;
-    const pathDir = paths[name];
-    if (pathDir === void 0) {
-      return err(
-        new PackError({
-          code: "pack-unknown-path",
-          expected: "path name found in package.json#forgeax.assets.paths",
-          hint: PACK_ERROR_HINTS["pack-unknown-path"],
-          detail: {
-            code: "pack-unknown-path",
-            pathName: name,
-            knownNames: Object.keys(paths)
-          }
-        })
-      );
-    }
-    const resolved = resolve(pathDir, rest);
-    if (isPathEscape(pathDir, resolved)) {
-      return err(
-        new PackError({
-          code: "pack-malformed-path-ref",
-          expected: "rest path must not escape the declared path directory",
-          hint: PACK_ERROR_HINTS["pack-malformed-path-ref"],
-          detail: {
-            code: "pack-malformed-path-ref",
-            reason: "escape",
-            rawSource: source,
-            expectedFormat: "@<name>/<rest>"
-          }
-        })
-      );
-    }
-    return ok(resolved);
+    return resolve(metaDir, derived);
   }
-  return ok(resolve(dirname(metaPath), source));
+  return resolve(dirname(metaPath), source);
 }
 
 export { resolveAssetSource };

package/dist/resolve-asset-source.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/deriveAssetName.ts","../src/errors.ts","../src/resolve-asset-source.ts"],"names":["resultOk","resultErr"],"mappings":"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","file":"resolve-asset-source.mjs","sourcesContent":["/**\n * Last path segment of a `/`- or `\\`-separated path, trailing separators\n * stripped. Inlined rather than imported from `node:path` so this module stays\n * browser-safe: the dev-server pack path (`vite-plugin-pack` `/__pack/`) runs\n * `buildCatalog` -> `deriveAssetName` in client code where `node:path` is\n * externalized and `path.basename` throws.\n */\nfunction baseName(p: string): string {\n  const trimmed = p.replace(/[/\\\\]+$/, '');\n  const idx = Math.max(trimmed.lastIndexOf('/'), trimmed.lastIndexOf('\\\\'));\n  return idx === -1 ? trimmed : trimmed.slice(idx + 1);\n}\n\n/**\n * Derive an asset's display name from package metadata.\n *\n * Pure function -- zero IO, zero side effects, browser-safe. Build-time\n * (build-catalog) and runtime (resolveName) share this single source of truth\n * for the XOR name-resolution rules (plan-strategy D-6).\n *\n * Branches:\n *   1. single-asset package (assetCount === 1)      -> baseName(packagePath)\n *   2. multi-asset package + storedName              -> storedName\n *   3. multi-asset package + no storedName (AC-15.1) -> baseName(packagePath)\n *   4. null packagePath + no storedName  (AC-15.2)   -> ''\n */\nexport function deriveAssetName(\n  packagePath: string | null,\n  assetCount: number,\n  storedName?: string,\n): string {\n  if (packagePath === null) {\n    return storedName ?? '';\n  }\n  if (assetCount === 1) {\n    return baseName(packagePath);\n  }\n  if (storedName !== undefined) {\n    return storedName;\n  }\n  return baseName(packagePath);\n}\n","// errors.ts — PackError class (feat-20260513-guid-asset-package-system w15)\n//\n// Four-field surface: .code / .expected / .hint / .detail\n// Structurally parallel to AssetError / RhiError / RemoteError\n// (charter proposition 5 consistent abstraction).\n//\n// .detail is narrowed per .code via PackErrorDetail discriminated union\n// (requirements §6.2 AC-07; plan-strategy §D-5).\n\nimport type { PackErrorCode, PackErrorDetail } from '@forgeax/engine-types';\n\n/**\n * Structured error for the engine-pack disk scanner fail-fast chain.\n *\n * AI users consume via exhaustive switch on .code — no default case needed:\n * ```ts\n * switch (err.code) {\n *   case 'pack-guid-collision':\n *     console.error(err.detail.paths);\n *     break;\n *   case 'pack-cyclic-reference':\n *     console.error(err.detail.cycle);\n *     break;\n *   // ...all 8 cases\n * }\n * ```\n */\nexport class PackError extends Error {\n  readonly code: PackErrorCode;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: PackErrorDetail;\n\n  constructor(args: {\n    code: PackErrorCode;\n    expected: string;\n    hint: string;\n    detail: PackErrorDetail;\n  }) {\n    super(`[PackError ${args.code}] expected: ${args.expected}; hint: ${args.hint}`);\n    this.name = 'PackError';\n    this.code = args.code;\n    this.expected = args.expected;\n    this.hint = args.hint;\n    this.detail = args.detail;\n  }\n}\n","import { dirname, posix, resolve } from 'node:path';\nimport type { Result } from '@forgeax/engine-types';\nimport { PACK_ERROR_HINTS, err as resultErr, ok as resultOk } from '@forgeax/engine-types';\nimport { deriveAssetName } from './deriveAssetName.js';\nimport { PackError } from './errors.js';\n\nfunction deriveSourceName(metaFileName: string): string {\n  return metaFileName.replace(/\\.meta\\.json$/, '');\n}\n\nconst PATH_REF_RE = /^@([^/]+)\\/(.+)$/;\n\nfunction isPathEscape(pathDir: string, resolved: string): boolean {\n  const rel = posix.relative(pathDir, resolved);\n  return rel.startsWith('..') || posix.isAbsolute(rel);\n}\n\nexport function resolveAssetSource(\n  metaPath: string,\n  source: string | undefined,\n  paths: Record<string, string>,\n): Result<string, PackError> {\n  if (source === undefined) {\n    const metaDir = dirname(metaPath);\n    const metaName = deriveAssetName(metaPath, 1);\n    const derived = deriveSourceName(metaName);\n    return resultOk(resolve(metaDir, derived));\n  }\n\n  if (source.startsWith('@')) {\n    const match = source.match(PATH_REF_RE);\n    if (!match) {\n      return resultErr(\n        new PackError({\n          code: 'pack-malformed-path-ref',\n          expected: 'source in format @<name>/<rest>',\n          hint: PACK_ERROR_HINTS['pack-malformed-path-ref'],\n          detail: {\n            code: 'pack-malformed-path-ref',\n            reason: 'format',\n            rawSource: source,\n            expectedFormat: '@<name>/<rest>',\n          },\n        }),\n      );\n    }\n\n    const [, name, rest] = match as [string, string, string];\n    const pathDir = paths[name];\n\n    if (pathDir === undefined) {\n      return resultErr(\n        new PackError({\n          code: 'pack-unknown-path',\n          expected: 'path name found in package.json#forgeax.assets.paths',\n          hint: PACK_ERROR_HINTS['pack-unknown-path'],\n          detail: {\n            code: 'pack-unknown-path',\n            pathName: name,\n            knownNames: Object.keys(paths),\n          },\n        }),\n      );\n    }\n\n    const resolved = resolve(pathDir, rest);\n\n    if (isPathEscape(pathDir, resolved)) {\n      return resultErr(\n        new PackError({\n          code: 'pack-malformed-path-ref',\n          expected: 'rest path must not escape the declared path directory',\n          hint: PACK_ERROR_HINTS['pack-malformed-path-ref'],\n          detail: {\n            code: 'pack-malformed-path-ref',\n            reason: 'escape',\n            rawSource: source,\n            expectedFormat: '@<name>/<rest>',\n          },\n        }),\n      );\n    }\n\n    return resultOk(resolved);\n  }\n\n  return resultOk(resolve(dirname(metaPath), source));\n}\n"]}
+{"version":3,"sources":["../src/deriveAssetName.ts","../src/resolve-asset-source.ts"],"names":[],"mappings":";;;;;AAOA,SAAS,SAAS,CAAA,EAAmB;AACnC,EAAA,MAAM,OAAA,GAAU,CAAA,CAAE,OAAA,CAAQ,SAAA,EAAW,EAAE,CAAA;AACvC,EAAA,MAAM,GAAA,GAAM,IAAA,CAAK,GAAA,CAAI,OAAA,CAAQ,WAAA,CAAY,GAAG,CAAA,EAAG,OAAA,CAAQ,WAAA,CAAY,IAAI,CAAC,CAAA;AACxE,EAAA,OAAO,QAAQ,EAAA,GAAK,OAAA,GAAU,OAAA,CAAQ,KAAA,CAAM,MAAM,CAAC,CAAA;AACrD;AAmBO,SAAS,eAAA,CACd,WAAA,EACA,WAAA,EACA,UAAA,EACQ;AAIR,EAAA,IAAI,gBAAgB,IAAA,EAAM;AACxB,IAAA,OAAO,EAAA;AAAA,EACT;AACA,EAAA,OAAO,SAAS,WAAW,CAAA;AAC7B;;;ACvCA,SAAS,iBAAiB,YAAA,EAA8B;AACtD,EAAA,OAAO,YAAA,CAAa,OAAA,CAAQ,eAAA,EAAiB,EAAE,CAAA;AACjD;AAEO,SAAS,kBAAA,CAAmB,UAAkB,MAAA,EAAoC;AACvF,EAAA,IAAI,WAAW,MAAA,EAAW;AACxB,IAAA,MAAM,OAAA,GAAU,QAAQ,QAAQ,CAAA;AAChC,IAAA,MAAM,QAAA,GAAW,eAAA,CAAgB,QAAW,CAAA;AAC5C,IAAA,MAAM,OAAA,GAAU,iBAAiB,QAAQ,CAAA;AACzC,IAAA,OAAO,OAAA,CAAQ,SAAS,OAAO,CAAA;AAAA,EACjC;AACA,EAAA,OAAO,OAAA,CAAQ,OAAA,CAAQ,QAAQ,CAAA,EAAG,MAAM,CAAA;AAC1C","file":"resolve-asset-source.mjs","sourcesContent":["/**\n * Last path segment of a `/`- or `\\`-separated path, trailing separators\n * stripped. Inlined rather than imported from `node:path` so this module stays\n * browser-safe: the dev-server pack path (`vite-plugin-pack` `/__pack/`) runs\n * `buildCatalog` -> `deriveAssetName` in client code where `node:path` is\n * externalized and `path.basename` throws.\n */\nfunction baseName(p: string): string {\n  const trimmed = p.replace(/[/\\\\]+$/, '');\n  const idx = Math.max(trimmed.lastIndexOf('/'), trimmed.lastIndexOf('\\\\'));\n  return idx === -1 ? trimmed : trimmed.slice(idx + 1);\n}\n\n/**\n * Derive an asset's display name from package metadata.\n *\n * Pure function -- zero IO, zero side effects, browser-safe. Build-time\n * (build-catalog) and runtime (resolveName) share this single source of truth\n * for deterministic asset display-name resolution.\n *\n * Resolution contract:\n *   - an explicit storedName is authoritative;\n *   - a package path is the fallback when no storedName is present;\n *   - an asset without a package and without a storedName resolves to ''.\n *\n * `assetCount` remains in the signature because callers derive it from their\n * package model, but it must not erase an explicitly authored name. In\n * particular, a single authored entry in `Materials.pack.json` resolves to its\n * entry name rather than temporarily appearing as the package basename.\n */\nexport function deriveAssetName(\n  packagePath: string | null,\n  _assetCount: number,\n  storedName?: string,\n): string {\n  if (storedName !== undefined) {\n    return storedName;\n  }\n  if (packagePath === null) {\n    return '';\n  }\n  return baseName(packagePath);\n}\n","import { dirname, resolve } from 'node:path';\nimport { deriveAssetName } from './deriveAssetName.js';\n\nfunction deriveSourceName(metaFileName: string): string {\n  return metaFileName.replace(/\\.meta\\.json$/, '');\n}\n\nexport function resolveAssetSource(metaPath: string, source: string | undefined): string {\n  if (source === undefined) {\n    const metaDir = dirname(metaPath);\n    const metaName = deriveAssetName(metaPath, 1);\n    const derived = deriveSourceName(metaName);\n    return resolve(metaDir, derived);\n  }\n  return resolve(dirname(metaPath), source);\n}\n"]}

package/dist/runtime.mjs

@@ -6859,7 +6859,7 @@ var meta_schema_default = {
     source: {
       type: "string",
       minLength: 1,
-      description: "Optional. Omit to derive the companion file in the same directory (strip .meta.json suffix from the meta filename). Or write @<name>/<rest> to reference a declared path table entry (see package.json#forgeax.assets.paths). Existing relative paths remain unchanged."
+      description: "Optional. Omit to derive the companion file in the same directory (strip .meta.json suffix from the meta filename). An explicit source is resolved relative to this sidecar."
     },
     importSettings: {
       type: "object",
@@ -7000,11 +7000,11 @@ var pack_schema_default = {
   $comment: "The ordinary durable consumer matrix is SCRIPTABLE_PACK_ASSET_KINDS in @forgeax/engine-pack/source. Pack kind fields remain open for registered producer extensions.",
   type: "object",
   additionalProperties: false,
-  required: ["schemaVersion", "kind", "assets"],
+  required: ["schemaVersion"],
   properties: {
     schemaVersion: {
       type: "string",
-      enum: ["1.0.0", "2.0.0"]
+      enum: ["1.0.0", "2.0.0", "3.0.0"]
     },
     kind: {
       type: "string",
@@ -7026,12 +7026,58 @@ var pack_schema_default = {
       items: { $ref: "#/$defs/diagnostic" }
     },
     assets: {
-      type: "array",
-      items: {
-        $ref: "#/$defs/asset"
-      }
+      oneOf: [
+        {
+          type: "array",
+          items: { $ref: "#/$defs/asset" }
+        },
+        { $ref: "#/$defs/authoringAssets" }
+      ]
+    },
+    parent: {
+      $ref: "#/$defs/guid36",
+      description: "Parent parameterized Pack packageId for one v3 instance."
+    },
+    values: {
+      type: "object",
+      additionalProperties: true,
+      description: "Sparse shallow parameter overrides for one v3 instance."
     }
   },
+  oneOf: [
+    {
+      required: ["kind", "assets"],
+      properties: {
+        schemaVersion: { enum: ["1.0.0", "2.0.0"] },
+        kind: { const: "internal-text-package" },
+        assets: { type: "array" },
+        parent: false,
+        values: false
+      }
+    },
+    {
+      required: ["packageId", "assets"],
+      properties: {
+        schemaVersion: { const: "3.0.0" },
+        kind: false,
+        packageId: { $ref: "#/$defs/guid36" },
+        assets: { $ref: "#/$defs/authoringAssets" },
+        parent: false,
+        values: false
+      }
+    },
+    {
+      required: ["packageId", "parent", "values"],
+      properties: {
+        schemaVersion: { const: "3.0.0" },
+        kind: false,
+        packageId: { $ref: "#/$defs/guid36" },
+        parent: { $ref: "#/$defs/guid36" },
+        values: { type: "object" },
+        assets: false
+      }
+    }
+  ],
   allOf: [
     {
       if: {
@@ -7123,6 +7169,30 @@ var pack_schema_default = {
         }
       ]
     },
+    authoringAssets: {
+      type: "object",
+      additionalProperties: false,
+      patternProperties: {
+        "^[a-z0-9][a-z0-9._-]*(/[a-z0-9][a-z0-9._-]*)*$": {
+          $ref: "#/$defs/authoringAsset"
+        }
+      }
+    },
+    authoringAsset: {
+      type: "object",
+      additionalProperties: false,
+      required: ["kind", "payload", "refs"],
+      properties: {
+        kind: { type: "string", minLength: 1 },
+        name: { type: "string", minLength: 1 },
+        payload: { type: "object" },
+        refs: {
+          type: "array",
+          items: { $ref: "#/$defs/guid36" }
+        },
+        artifacts: { $ref: "#/$defs/artifacts" }
+      }
+    },
     artifacts: {
       type: "object",
       additionalProperties: false,