@playcraft/common 0.0.33 → 0.0.34

package/dist/image-studio/keyframe-sheet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyframe-sheet.d.ts","sourceRoot":"","sources":["../../src/image-studio/keyframe-sheet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAA8B,KAAK,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAW9F,MAAM,MAAM,2BAA2B,GAAG;IACxC,WAAW,EAAE,sBAAsB,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO,CAGhF;AAED,wBAAgB,kCAAkC,CAAC,eAAe,EAAE,MAAM,GAAG,2BAA2B,CAUvG;AAED,wBAAgB,6BAA6B,IAAI,MAAM,CAQtD;AAED,wBAAgB,wBAAwB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,wBAAgB,+BAA+B,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAM/E;AAED,wBAAgB,8BAA8B,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAM9E"}

package/dist/image-studio/keyframe-sheet.js

@@ -0,0 +1,45 @@
+import { normalizeAspectRatioForApi } from './alpha-strategy.js';
+/** 左右分栏关键帧 sheet 的生成尺寸（每半张对应用户选择的宽高比） */
+const KEYFRAME_PANEL_SIZES = {
+    '1:1': { width: 1024, height: 1024 },
+    '16:9': { width: 1920, height: 1080 },
+    '9:16': { width: 768, height: 1536 },
+    '4:3': { width: 1024, height: 768 },
+    '3:4': { width: 768, height: 1024 },
+};
+export function shouldUseKeyframeSheetStrategy(_strategy) {
+    // 宽图分栏对 gemini / 多数生图模型不稳定（多主体、黑边、接缝错位），统一走顺序 + 参考图。
+    return false;
+}
+export function resolveKeyframeSheetGenerationSize(userAspectRatio) {
+    const aspectRatio = normalizeAspectRatioForApi(userAspectRatio);
+    const panel = KEYFRAME_PANEL_SIZES[aspectRatio];
+    return {
+        aspectRatio,
+        panelWidth: panel.width,
+        panelHeight: panel.height,
+        width: panel.width * 2,
+        height: panel.height,
+    };
+}
+export function buildKeyframeSheetInstruction() {
+    return ('Output ONE wide image with exactly two equal square panels side by side, with NO gap, gutter, black bars, or letterboxing. ' +
+        'Each panel must be a full-bleed solid chroma background edge-to-edge. ' +
+        'LEFT panel ONLY: first/starting keyframe — subject perfectly centered in that left panel. ' +
+        'RIGHT panel ONLY: last/ending keyframe — same subject, style, scale, and camera, subject perfectly centered in that right panel. ' +
+        'Do NOT place both subjects near the center seam. Static poses only.');
+}
+export function buildKeyframeSheetPrompt(effectivePrompt) {
+    return `${effectivePrompt.trim()} ${buildKeyframeSheetInstruction()}`;
+}
+export function buildSequentialFirstFramePrompt(effectivePrompt) {
+    return (`${effectivePrompt.trim()} ` +
+        'Generate ONLY the first/starting keyframe of a 2D animation. ' +
+        'Exactly ONE subject instance, centered, static starting pose. No duplicates, no grid, no sheet layout.');
+}
+export function buildSequentialLastFramePrompt(effectivePrompt) {
+    return (`${effectivePrompt.trim()} ` +
+        'Generate ONLY the last/ending keyframe. Use the reference image: keep the SAME single subject, style, scale, camera, and background. ' +
+        'Change ONLY pose/state to the ending keyframe. Exactly ONE subject instance, centered. No duplicates, no grid.');
+}
+//# sourceMappingURL=keyframe-sheet.js.map

package/dist/image-studio/keyframe-sheet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyframe-sheet.js","sourceRoot":"","sources":["../../src/image-studio/keyframe-sheet.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAA+B,MAAM,qBAAqB,CAAC;AAE9F,yCAAyC;AACzC,MAAM,oBAAoB,GAAsE;IAC9F,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IACpC,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IACrC,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;IACpC,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;IACnC,KAAK,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;CACpC,CAAC;AAUF,MAAM,UAAU,8BAA8B,CAAC,SAAwB;IACrE,qDAAqD;IACrD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,eAAuB;IACxE,MAAM,WAAW,GAAG,0BAA0B,CAAC,eAAe,CAAC,CAAC;IAChE,MAAM,KAAK,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;IAChD,OAAO;QACL,WAAW;QACX,UAAU,EAAE,KAAK,CAAC,KAAK;QACvB,WAAW,EAAE,KAAK,CAAC,MAAM;QACzB,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,CAAC;QACtB,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B;IAC3C,OAAO,CACL,6HAA6H;QAC7H,wEAAwE;QACxE,4FAA4F;QAC5F,mIAAmI;QACnI,qEAAqE,CACtE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,eAAuB;IAC9D,OAAO,GAAG,eAAe,CAAC,IAAI,EAAE,IAAI,6BAA6B,EAAE,EAAE,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,eAAuB;IACrE,OAAO,CACL,GAAG,eAAe,CAAC,IAAI,EAAE,GAAG;QAC5B,+DAA+D;QAC/D,wGAAwG,CACzG,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,eAAuB;IACpE,OAAO,CACL,GAAG,eAAe,CAAC,IAAI,EAAE,GAAG;QAC5B,uIAAuI;QACvI,gHAAgH,CACjH,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -16,4 +16,5 @@ export * from './recommend/index.js';
 export * from './queue/email-queue.js';
 export * from './queue/remix-cover-queue.js';
 export * from './preview/phone-preview-dimensions.js';
+export * from './image-studio/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uCAAuC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uCAAuC,CAAC;AACtD,cAAc,yBAAyB,CAAC"}

package/dist/index.js

@@ -16,4 +16,5 @@ export * from './recommend/index.js';
 export * from './queue/email-queue.js';
 export * from './queue/remix-cover-queue.js';
 export * from './preview/phone-preview-dimensions.js';
+export * from './image-studio/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uCAAuC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uCAAuC,CAAC;AACtD,cAAc,yBAAyB,CAAC"}

package/dist/prefab/constants.d.ts

@@ -9,8 +9,16 @@ export declare const THEME_I18N_PLATFORM_PATH = "src/theme/i18n.platform.json5";
 /**
  * `i18n.runtime.json5`：SDK 运行时替换 `xplatform.value_type === 'i18n'`
  * 字段值的多语言文案数据源。前端可读可写。
+ *
+ * 主题级别的 theme.i18n.runtime.json5 会覆盖此文件的同 key 值。
+ * 写入操作统一写入主题级别文件。
  */
 export declare const THEME_I18N_RUNTIME_PATH = "src/theme/i18n.runtime.json5";
+/**
+ * 主题级别的 i18n.runtime.json5（按主题覆盖全局 i18n）
+ * 读取时合并，修改时写入此文件。
+ */
+export declare function themeI18nRuntimePath(themeId: string): string;
 export declare function themeDataPath(themeId: string): string;
 export declare const DEFAULT_GAME_PATH = "assets/DefaultGame.json";
 export declare const MANIFEST_PATH = "manifest.json";

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

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/prefab/constants.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,SAAS,cAAc,CAAC;AACrC,eAAO,MAAM,iBAAiB,iCAAiC,CAAC;AAChE,eAAO,MAAM,gBAAgB,uBAAuB,CAAC;AAErD;;;GAGG;AACH,eAAO,MAAM,wBAAwB,kCAAkC,CAAC;AAExE;;;GAGG;AACH,eAAO,MAAM,uBAAuB,iCAAiC,CAAC;AAEtE,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD;AAID,eAAO,MAAM,iBAAiB,4BAA4B,CAAC;AAC3D,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAC7C,eAAO,MAAM,gBAAgB,uBAAuB,CAAC;AACrD,eAAO,MAAM,UAAU,WAAW,CAAC;AACnC,eAAO,MAAM,2BAA2B,0CAA0C,CAAC;AAEnF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjD"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/prefab/constants.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,SAAS,cAAc,CAAC;AACrC,eAAO,MAAM,iBAAiB,iCAAiC,CAAC;AAChE,eAAO,MAAM,gBAAgB,uBAAuB,CAAC;AAErD;;;GAGG;AACH,eAAO,MAAM,wBAAwB,kCAAkC,CAAC;AAExE;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,iCAAiC,CAAC;AAEtE;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD;AAID,eAAO,MAAM,iBAAiB,4BAA4B,CAAC;AAC3D,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAC7C,eAAO,MAAM,gBAAgB,uBAAuB,CAAC;AACrD,eAAO,MAAM,UAAU,WAAW,CAAC;AACnC,eAAO,MAAM,2BAA2B,0CAA0C,CAAC;AAEnF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjD"}

package/dist/prefab/constants.js

@@ -10,8 +10,18 @@ export const THEME_I18N_PLATFORM_PATH = 'src/theme/i18n.platform.json5';
 /**
  * `i18n.runtime.json5`：SDK 运行时替换 `xplatform.value_type === 'i18n'`
  * 字段值的多语言文案数据源。前端可读可写。
+ *
+ * 主题级别的 theme.i18n.runtime.json5 会覆盖此文件的同 key 值。
+ * 写入操作统一写入主题级别文件。
  */
 export const THEME_I18N_RUNTIME_PATH = 'src/theme/i18n.runtime.json5';
+/**
+ * 主题级别的 i18n.runtime.json5（按主题覆盖全局 i18n）
+ * 读取时合并，修改时写入此文件。
+ */
+export function themeI18nRuntimePath(themeId) {
+    return `src/theme/${themeId}/theme.i18n.runtime.json5`;
+}
 export function themeDataPath(themeId) {
     return `src/theme/${themeId}/theme.data.json5`;
 }

package/dist/prefab/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/prefab/constants.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAEhF,MAAM,CAAC,MAAM,SAAS,GAAG,WAAW,CAAC;AACrC,MAAM,CAAC,MAAM,iBAAiB,GAAG,8BAA8B,CAAC;AAChE,MAAM,CAAC,MAAM,gBAAgB,GAAG,oBAAoB,CAAC;AAErD;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,+BAA+B,CAAC;AAExE;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,8BAA8B,CAAC;AAEtE,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO,aAAa,OAAO,mBAAmB,CAAC;AACjD,CAAC;AAED,gFAAgF;AAEhF,MAAM,CAAC,MAAM,iBAAiB,GAAG,yBAAyB,CAAC;AAC3D,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAC;AAC7C,MAAM,CAAC,MAAM,gBAAgB,GAAG,oBAAoB,CAAC;AACrD,MAAM,CAAC,MAAM,UAAU,GAAG,QAAQ,CAAC;AACnC,MAAM,CAAC,MAAM,2BAA2B,GAAG,uCAAuC,CAAC;AAEnF,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,OAAO,GAAG,2BAA2B,IAAI,OAAO,gBAAgB,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO,GAAG,UAAU,IAAI,OAAO,OAAO,CAAC;AACzC,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/prefab/constants.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAEhF,MAAM,CAAC,MAAM,SAAS,GAAG,WAAW,CAAC;AACrC,MAAM,CAAC,MAAM,iBAAiB,GAAG,8BAA8B,CAAC;AAChE,MAAM,CAAC,MAAM,gBAAgB,GAAG,oBAAoB,CAAC;AAErD;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,+BAA+B,CAAC;AAExE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,8BAA8B,CAAC;AAEtE;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,OAAO,aAAa,OAAO,2BAA2B,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO,aAAa,OAAO,mBAAmB,CAAC;AACjD,CAAC;AAED,gFAAgF;AAEhF,MAAM,CAAC,MAAM,iBAAiB,GAAG,yBAAyB,CAAC;AAC3D,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAC;AAC7C,MAAM,CAAC,MAAM,gBAAgB,GAAG,oBAAoB,CAAC;AACrD,MAAM,CAAC,MAAM,UAAU,GAAG,QAAQ,CAAC;AACnC,MAAM,CAAC,MAAM,2BAA2B,GAAG,uCAAuC,CAAC;AAEnF,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,OAAO,GAAG,2BAA2B,IAAI,OAAO,gBAAgB,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO,GAAG,UAAU,IAAI,OAAO,OAAO,CAAC;AACzC,CAAC"}

package/dist/prefab/image-padding-color.d.ts

@@ -0,0 +1,17 @@
+/** contain 留边默认填充色（schema 未配置 padding_color 时） */
+export declare const DEFAULT_PADDING_COLOR = "transparent";
+export type SharpRgbaBackground = {
+    r: number;
+    g: number;
+    b: number;
+    alpha: number;
+};
+/** 规范化 schema ext.padding_color：transparent | #RRGGBB | #RRGGBBAA | #RGB */
+export declare function normalizePaddingColor(raw: string | undefined): string;
+/** 从 schema ext.padding_color 解析留边色；未配置时透明留边。 */
+export declare function resolvePaddingColorFromSchema(schemaPaddingColor?: string): string;
+/** 转为 sharp resize / flatten 使用的 RGBA background。 */
+export declare function paddingColorToSharpBackground(paddingColor: string, options?: {
+    forceOpaque?: boolean;
+}): SharpRgbaBackground;
+//# sourceMappingURL=image-padding-color.d.ts.map

package/dist/prefab/image-padding-color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-padding-color.d.ts","sourceRoot":"","sources":["../../src/prefab/image-padding-color.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,eAAO,MAAM,qBAAqB,gBAAgB,CAAC;AAEnD,MAAM,MAAM,mBAAmB,GAAG;IAChC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAIF,4EAA4E;AAC5E,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAoBrE;AAED,iDAAiD;AACjD,wBAAgB,6BAA6B,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED,qDAAqD;AACrD,wBAAgB,6BAA6B,CAC3C,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GAClC,mBAAmB,CAoBrB"}

package/dist/prefab/image-padding-color.js

@@ -0,0 +1,49 @@
+/** contain 留边默认填充色（schema 未配置 padding_color 时） */
+export const DEFAULT_PADDING_COLOR = 'transparent';
+const TRANSPARENT_PADDING_COLOR = 'transparent';
+/** 规范化 schema ext.padding_color：transparent | #RRGGBB | #RRGGBBAA | #RGB */
+export function normalizePaddingColor(raw) {
+    if (!raw?.trim())
+        return DEFAULT_PADDING_COLOR;
+    const v = raw.trim();
+    if (v.toLowerCase() === TRANSPARENT_PADDING_COLOR)
+        return TRANSPARENT_PADDING_COLOR;
+    const hex = v.startsWith('#') ? v.slice(1) : v;
+    if (/^[a-f\d]{3}$/i.test(hex)) {
+        const r = hex[0];
+        const g = hex[1];
+        const b = hex[2];
+        return `#${r}${r}${g}${g}${b}${b}`.toUpperCase();
+    }
+    if (/^[a-f\d]{6}$/i.test(hex)) {
+        return `#${hex}`.toUpperCase();
+    }
+    if (/^[a-f\d]{8}$/i.test(hex)) {
+        return `#${hex}`.toUpperCase();
+    }
+    return DEFAULT_PADDING_COLOR;
+}
+/** 从 schema ext.padding_color 解析留边色；未配置时透明留边。 */
+export function resolvePaddingColorFromSchema(schemaPaddingColor) {
+    return normalizePaddingColor(schemaPaddingColor);
+}
+/** 转为 sharp resize / flatten 使用的 RGBA background。 */
+export function paddingColorToSharpBackground(paddingColor, options) {
+    const normalized = normalizePaddingColor(paddingColor);
+    if (normalized === TRANSPARENT_PADDING_COLOR) {
+        if (options?.forceOpaque) {
+            return { r: 255, g: 255, b: 255, alpha: 1 };
+        }
+        return { r: 0, g: 0, b: 0, alpha: 0 };
+    }
+    const hex = normalized.slice(1);
+    const r = parseInt(hex.slice(0, 2), 16);
+    const g = parseInt(hex.slice(2, 4), 16);
+    const b = parseInt(hex.slice(4, 6), 16);
+    const alpha = hex.length >= 8 ? parseInt(hex.slice(6, 8), 16) / 255 : 1;
+    if (options?.forceOpaque || alpha >= 1) {
+        return { r, g, b, alpha: 1 };
+    }
+    return { r, g, b, alpha };
+}
+//# sourceMappingURL=image-padding-color.js.map

package/dist/prefab/image-padding-color.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-padding-color.js","sourceRoot":"","sources":["../../src/prefab/image-padding-color.ts"],"names":[],"mappings":"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"}

package/dist/prefab/index.d.ts

@@ -7,4 +7,6 @@ export * from './scene-resolver.js';
 export * from './validator.js';
 export * from './descriptor.js';
 export * from './diff.js';
+export * from './image-padding-color.js';
+export * from './mime-type-list.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/prefab/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prefab/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prefab/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC"}

package/dist/prefab/index.js

@@ -7,4 +7,6 @@ export * from './scene-resolver.js';
 export * from './validator.js';
 export * from './descriptor.js';
 export * from './diff.js';
+export * from './image-padding-color.js';
+export * from './mime-type-list.js';
 //# sourceMappingURL=index.js.map

package/dist/prefab/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prefab/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prefab/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC"}

package/dist/prefab/mime-type-list.d.ts

@@ -0,0 +1,37 @@
+/**
+ * xplatform.mime_type 解析：支持单个 MIME 或逗号/分号分隔的多 MIME 列表。
+ * Remix 文件选择、AI 生图输出格式等共用。
+ */
+export type AiImageOutputFormat = 'png' | 'webp' | 'jpeg';
+/** 解析 mime_type 字段为 MIME 列表（去重、小写、trim）。 */
+export declare function parseMimeTypeList(raw: string | undefined): string[];
+/** 单个 MIME → 文件格式标识（png/webp/jpeg）；无法识别时 undefined。 */
+export declare function mimeTypeToImageFormat(mimeType: string | undefined): string | undefined;
+/** 单个 MIME → 匹配扩展名（小写，含点）。 */
+export declare function mimeToFileExtensions(mime: string): string[];
+/** 多 MIME 字符串 → 并集扩展名列表。 */
+export declare function mimeListToFileExtensions(mimeListRaw: string | undefined): string[];
+/** HTML input accept 属性值（逗号分隔、无空格）。 */
+export declare function mimeListToAcceptAttribute(mimeListRaw: string | undefined): string | undefined;
+/**
+ * 从 schema mime_type（可多个）与上下文解析 AI 生图落盘格式。
+ *
+ * 优先级（schema 有允许列表时）：
+ * 1. 当前资产路径扩展名（在允许列表内）
+ * 2. 参考图格式（在允许列表内）
+ * 3. remove_background → png（在允许列表内）
+ * 4. 列表第一项
+ *
+ * 无 schema mime 时：参考图格式 → defaultFormat（png）
+ */
+export declare function resolveAiImageOutputFormat(input: {
+    schemaMimeType?: string;
+    assetPath?: string;
+    referenceFormat?: string;
+    removeBackground?: boolean;
+    defaultFormat?: AiImageOutputFormat;
+}): {
+    format: AiImageOutputFormat;
+    fromSchema: boolean;
+};
+//# sourceMappingURL=mime-type-list.d.ts.map

package/dist/prefab/mime-type-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mime-type-list.d.ts","sourceRoot":"","sources":["../../src/prefab/mime-type-list.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,mBAAmB,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAmB1D,4CAA4C;AAC5C,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAWnE;AAED,uDAAuD;AACvD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAGtF;AAED,8BAA8B;AAC9B,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAW3D;AAED,4BAA4B;AAC5B,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAUlF;AAED,uCAAuC;AACvC,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAO7F;AAiBD;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,aAAa,CAAC,EAAE,mBAAmB,CAAC;CACrC,GAAG;IAAE,MAAM,EAAE,mBAAmB,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CA+BvD"}

package/dist/prefab/mime-type-list.js

@@ -0,0 +1,135 @@
+/**
+ * xplatform.mime_type 解析：支持单个 MIME 或逗号/分号分隔的多 MIME 列表。
+ * Remix 文件选择、AI 生图输出格式等共用。
+ */
+const MIME_TO_FORMAT = {
+    'image/png': 'png',
+    'image/webp': 'webp',
+    'image/jpeg': 'jpeg',
+    'image/jpg': 'jpeg',
+    'image/gif': 'gif',
+};
+const EXT_TO_FORMAT = {
+    webp: 'webp',
+    jpg: 'jpeg',
+    jpeg: 'jpeg',
+    png: 'png',
+};
+const AI_OUTPUT_FORMATS = new Set(['png', 'webp', 'jpeg']);
+/** 解析 mime_type 字段为 MIME 列表（去重、小写、trim）。 */
+export function parseMimeTypeList(raw) {
+    if (!raw?.trim())
+        return [];
+    const seen = new Set();
+    const out = [];
+    for (const part of raw.split(/[,;|]/)) {
+        const mime = part.trim().toLowerCase();
+        if (!mime || seen.has(mime))
+            continue;
+        seen.add(mime);
+        out.push(mime);
+    }
+    return out;
+}
+/** 单个 MIME → 文件格式标识（png/webp/jpeg）；无法识别时 undefined。 */
+export function mimeTypeToImageFormat(mimeType) {
+    if (!mimeType?.trim())
+        return undefined;
+    return MIME_TO_FORMAT[mimeType.trim().toLowerCase()];
+}
+/** 单个 MIME → 匹配扩展名（小写，含点）。 */
+export function mimeToFileExtensions(mime) {
+    const m = mime.trim().toLowerCase();
+    if (m === 'image/png')
+        return ['.png'];
+    if (m === 'image/jpeg' || m === 'image/jpg')
+        return ['.jpg', '.jpeg'];
+    if (m === 'image/webp')
+        return ['.webp'];
+    if (m === 'image/gif')
+        return ['.gif'];
+    if (m === 'image/svg+xml')
+        return ['.svg'];
+    if (m.startsWith('image/'))
+        return ['.png', '.jpg', '.jpeg', '.webp', '.gif', '.svg', '.bmp'];
+    if (m.startsWith('audio/'))
+        return ['.mp3', '.ogg', '.wav', '.m4a', '.aac'];
+    if (m.startsWith('video/'))
+        return ['.mp4', '.webm', '.mov'];
+    return [];
+}
+/** 多 MIME 字符串 → 并集扩展名列表。 */
+export function mimeListToFileExtensions(mimeListRaw) {
+    const list = parseMimeTypeList(mimeListRaw);
+    if (list.length === 0)
+        return mimeToFileExtensions(mimeListRaw ?? '');
+    const exts = new Set();
+    for (const mime of list) {
+        for (const ext of mimeToFileExtensions(mime)) {
+            exts.add(ext);
+        }
+    }
+    return [...exts];
+}
+/** HTML input accept 属性值（逗号分隔、无空格）。 */
+export function mimeListToAcceptAttribute(mimeListRaw) {
+    const list = parseMimeTypeList(mimeListRaw);
+    if (list.length === 0) {
+        const trimmed = mimeListRaw?.trim();
+        return trimmed || undefined;
+    }
+    return list.join(',');
+}
+function normalizeReferenceFormat(format) {
+    if (!format?.trim())
+        return undefined;
+    const normalized = format.trim().toLowerCase();
+    const mapped = normalized === 'jpg' ? 'jpeg' : normalized;
+    return AI_OUTPUT_FORMATS.has(mapped)
+        ? mapped
+        : undefined;
+}
+function formatFromAssetPath(assetPath) {
+    const ext = assetPath?.match(/\.([a-z0-9]+)$/i)?.[1]?.toLowerCase();
+    if (!ext)
+        return undefined;
+    return EXT_TO_FORMAT[ext];
+}
+/**
+ * 从 schema mime_type（可多个）与上下文解析 AI 生图落盘格式。
+ *
+ * 优先级（schema 有允许列表时）：
+ * 1. 当前资产路径扩展名（在允许列表内）
+ * 2. 参考图格式（在允许列表内）
+ * 3. remove_background → png（在允许列表内）
+ * 4. 列表第一项
+ *
+ * 无 schema mime 时：参考图格式 → defaultFormat（png）
+ */
+export function resolveAiImageOutputFormat(input) {
+    const defaultFormat = input.defaultFormat ?? 'png';
+    const hasSchemaMime = Boolean(input.schemaMimeType?.trim());
+    const allowedFromSchema = parseMimeTypeList(input.schemaMimeType)
+        .map((m) => mimeTypeToImageFormat(m))
+        .filter((f) => f != null && AI_OUTPUT_FORMATS.has(f));
+    if (allowedFromSchema.length > 0) {
+        const fromPath = formatFromAssetPath(input.assetPath);
+        if (fromPath && allowedFromSchema.includes(fromPath)) {
+            return { format: fromPath, fromSchema: hasSchemaMime };
+        }
+        const fromRef = normalizeReferenceFormat(input.referenceFormat);
+        if (fromRef && allowedFromSchema.includes(fromRef)) {
+            return { format: fromRef, fromSchema: hasSchemaMime };
+        }
+        if (input.removeBackground && allowedFromSchema.includes('png')) {
+            return { format: 'png', fromSchema: hasSchemaMime };
+        }
+        return { format: allowedFromSchema[0], fromSchema: hasSchemaMime };
+    }
+    const fromRef = normalizeReferenceFormat(input.referenceFormat);
+    if (fromRef) {
+        return { format: fromRef, fromSchema: false };
+    }
+    return { format: defaultFormat, fromSchema: false };
+}
+//# sourceMappingURL=mime-type-list.js.map

package/dist/prefab/mime-type-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mime-type-list.js","sourceRoot":"","sources":["../../src/prefab/mime-type-list.ts"],"names":[],"mappings":"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"}

package/dist/prefab/types.d.ts

@@ -23,7 +23,14 @@ export type PrefabInfo = {
     /** File path that holds the actual data for read/write */
     dataFilePath?: string;
 };
-/** JSON Schema node (External Theme) */
+/** 条件操作符 */
+export type ConditionOp = 'eq' | 'neq' | 'in' | 'notIn' | 'gt' | 'gte' | 'lt' | 'lte';
+/** 单条显示条件：field 为相对同级 object 的路径，如 'fontId' 或 'color.mode' */
+export type Condition = {
+    field: string;
+    op: ConditionOp;
+    value: unknown;
+};
 export type JsonSchemaNode = {
     /** JSON Schema allows a single type or a union (e.g. `["string","number"]`) */
     type?: string | string[];
@@ -39,6 +46,34 @@ export type JsonSchemaNode = {
     xplatform?: {
         value_type?: string;
         mime_type?: string;
+        fit_mode?: 'contain' | 'cover' | 'fill';
+        /** AI 生图后处理扩展协议（唯一真相源） */
+        ext?: {
+            /** 目标像素尺寸，如 "1920x1080" */
+            resolution?: string;
+            /** 目标宽高比，如 "16:9" / "1:1" / "9:16" / "4:3" / "3:4" / "2:3" / "3:2" / "21:9" */
+            ratio?: '16:9' | '1:1' | '9:16' | '4:3' | '3:4' | '2:3' | '3:2' | '21:9';
+            /** 推荐参考图：项目内路径或绝对 URL */
+            reference_image: string[];
+            /** 默认生成提示词（打开对话框时预填） */
+            prompt?: string;
+            remove_background?: boolean;
+            /** contain 留边填充色：transparent | #RRGGBB | #RRGGBBAA | #RGB */
+            padding_color?: string;
+            fit_mode?: 'contain' | 'cover' | 'fill';
+        };
+        /** 显示条件：不满足时隐藏该字段（数组 = AND 组合） */
+        showIf?: Condition | Condition[];
+        /** 显示条件：满足任意项时显示（OR 组合） */
+        showIfAny?: Condition[];
+        /** 枚举动态切换：根据某个字段值，显示不同的 enum/enumLabels */
+        switchEnum?: {
+            field: string;
+            cases: Record<string, {
+                enum?: unknown[];
+                enumLabels?: Record<string, string>;
+            }>;
+        };
     };
 };
 /** LiteCreator ConfigSchema field definition */

package/dist/prefab/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/prefab/types.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,GAAG,cAAc,CAAC;AAEjE,yEAAyE;AACzE,MAAM,MAAM,OAAO,GAAG;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,yCAAyC;AACzC,MAAM,MAAM,UAAU,GAAG;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,wCAAwC;AACxC,MAAM,MAAM,cAAc,GAAG;IAC3B,+EAA+E;IAC/E,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC5C,SAAS,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACzD,CAAC;AAEF,gDAAgD;AAChD,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,kDAAkD;AAClD,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,wBAAwB;AACxB,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/prefab/types.ts"],"names":[],"mappings":"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"}

package/dist/recommend/atom-graph/basic-atom-graph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"basic-atom-graph.d.ts","sourceRoot":"","sources":["../../../src/recommend/atom-graph/basic-atom-graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAY,SAAS,EAAY,MAAM,YAAY,CAAC;AA2BhE,eAAO,MAAM,cAAc,EAAE,SA+R5B,CAAC"}
+{"version":3,"file":"basic-atom-graph.d.ts","sourceRoot":"","sources":["../../../src/recommend/atom-graph/basic-atom-graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAY,SAAS,EAAY,MAAM,YAAY,CAAC;AA2BhE,eAAO,MAAM,cAAc,EAAE,SA2wB5B,CAAC"}