@playcraft/common 0.0.32 → 0.0.34

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/preview/phone-preview-dimensions.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 与前端 PhoneFrame / BuildPreviewFrame 对齐的预览尺寸（单源常量）。
+ * @see packages/frontend/src/components/device-frames/phone-frame.tsx
+ */
+export type PhonePreviewOrientation = 'portrait' | 'landscape';
+/** PhoneFrame 外框尺寸 */
+export declare const PHONE_FRAME_OUTER: {
+    readonly portrait: {
+        readonly width: 490;
+        readonly height: 1000;
+    };
+    readonly landscape: {
+        readonly width: 1000;
+        readonly height: 490;
+    };
+};
+/** 屏幕区域（FRAME.screen） */
+export declare const PHONE_FRAME_SCREEN: {
+    readonly portrait: {
+        readonly width: 454;
+        readonly height: 964;
+    };
+    readonly landscape: {
+        readonly width: 964;
+        readonly height: 454;
+    };
+};
+/** 状态栏高度（与 phone-frame STATUS_BAR_H 一致） */
+export declare const PHONE_STATUS_BAR_HEIGHT: {
+    readonly portrait: 75;
+    readonly landscape: 50;
+};
+/** Playwright / 可玩内容区视窗（iframe 实际显示区域） */
+export declare const PHONE_CONTENT_VIEWPORT: {
+    readonly portrait: {
+        readonly width: 454;
+        readonly height: number;
+    };
+    readonly landscape: {
+        readonly width: 964;
+        readonly height: number;
+    };
+};
+export declare function getPhoneContentViewport(orientation?: PhonePreviewOrientation): {
+    width: number;
+    height: number;
+};
+//# sourceMappingURL=phone-preview-dimensions.d.ts.map

package/dist/preview/phone-preview-dimensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phone-preview-dimensions.d.ts","sourceRoot":"","sources":["../../src/preview/phone-preview-dimensions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,uBAAuB,GAAG,UAAU,GAAG,WAAW,CAAC;AAE/D,sBAAsB;AACtB,eAAO,MAAM,iBAAiB;;;;;;;;;CAGpB,CAAC;AAEX,yBAAyB;AACzB,eAAO,MAAM,kBAAkB;;;;;;;;;CAGrB,CAAC;AAEX,2CAA2C;AAC3C,eAAO,MAAM,uBAAuB;;;CAG1B,CAAC;AAEX,0CAA0C;AAC1C,eAAO,MAAM,sBAAsB;;;;;;;;;CASzB,CAAC;AAEX,wBAAgB,uBAAuB,CACrC,WAAW,GAAE,uBAAoC,GAChD;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAEnC"}

package/dist/preview/phone-preview-dimensions.js

@@ -0,0 +1,34 @@
+/**
+ * 与前端 PhoneFrame / BuildPreviewFrame 对齐的预览尺寸（单源常量）。
+ * @see packages/frontend/src/components/device-frames/phone-frame.tsx
+ */
+/** PhoneFrame 外框尺寸 */
+export const PHONE_FRAME_OUTER = {
+    portrait: { width: 490, height: 1000 },
+    landscape: { width: 1000, height: 490 },
+};
+/** 屏幕区域（FRAME.screen） */
+export const PHONE_FRAME_SCREEN = {
+    portrait: { width: 454, height: 964 },
+    landscape: { width: 964, height: 454 },
+};
+/** 状态栏高度（与 phone-frame STATUS_BAR_H 一致） */
+export const PHONE_STATUS_BAR_HEIGHT = {
+    portrait: 75,
+    landscape: 50,
+};
+/** Playwright / 可玩内容区视窗（iframe 实际显示区域） */
+export const PHONE_CONTENT_VIEWPORT = {
+    portrait: {
+        width: PHONE_FRAME_SCREEN.portrait.width,
+        height: PHONE_FRAME_SCREEN.portrait.height - PHONE_STATUS_BAR_HEIGHT.portrait,
+    },
+    landscape: {
+        width: PHONE_FRAME_SCREEN.landscape.width,
+        height: PHONE_FRAME_SCREEN.landscape.height - PHONE_STATUS_BAR_HEIGHT.landscape,
+    },
+};
+export function getPhoneContentViewport(orientation = 'portrait') {
+    return PHONE_CONTENT_VIEWPORT[orientation];
+}
+//# sourceMappingURL=phone-preview-dimensions.js.map

package/dist/preview/phone-preview-dimensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phone-preview-dimensions.js","sourceRoot":"","sources":["../../src/preview/phone-preview-dimensions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,sBAAsB;AACtB,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,QAAQ,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;IACtC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;CAC/B,CAAC;AAEX,yBAAyB;AACzB,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,QAAQ,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;IACrC,SAAS,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;CAC9B,CAAC;AAEX,2CAA2C;AAC3C,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,QAAQ,EAAE,EAAE;IACZ,SAAS,EAAE,EAAE;CACL,CAAC;AAEX,0CAA0C;AAC1C,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,QAAQ,EAAE;QACR,KAAK,EAAE,kBAAkB,CAAC,QAAQ,CAAC,KAAK;QACxC,MAAM,EAAE,kBAAkB,CAAC,QAAQ,CAAC,MAAM,GAAG,uBAAuB,CAAC,QAAQ;KAC9E;IACD,SAAS,EAAE;QACT,KAAK,EAAE,kBAAkB,CAAC,SAAS,CAAC,KAAK;QACzC,MAAM,EAAE,kBAAkB,CAAC,SAAS,CAAC,MAAM,GAAG,uBAAuB,CAAC,SAAS;KAChF;CACO,CAAC;AAEX,MAAM,UAAU,uBAAuB,CACrC,cAAuC,UAAU;IAEjD,OAAO,sBAAsB,CAAC,WAAW,CAAC,CAAC;AAC7C,CAAC"}

package/dist/queue/remix-cover-queue.d.ts

@@ -0,0 +1,5 @@
+/**
+ * BullMQ remix-cover 队列名（Backend Producer / Worker Consumer 共用）
+ */
+export declare function getRemixCoverQueueName(): string;
+//# sourceMappingURL=remix-cover-queue.d.ts.map

package/dist/queue/remix-cover-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remix-cover-queue.d.ts","sourceRoot":"","sources":["../../src/queue/remix-cover-queue.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAS/C"}

package/dist/queue/remix-cover-queue.js

@@ -0,0 +1,14 @@
+/**
+ * BullMQ remix-cover 队列名（Backend Producer / Worker Consumer 共用）
+ */
+export function getRemixCoverQueueName() {
+    if (process.env.REMIX_COVER_QUEUE_NAME) {
+        return process.env.REMIX_COVER_QUEUE_NAME;
+    }
+    if (process.env.NODE_ENV === 'production') {
+        return 'remix-cover';
+    }
+    const user = process.env.USER || process.env.USERNAME || 'dev';
+    return `remix-cover-dev-${user}`;
+}
+//# sourceMappingURL=remix-cover-queue.js.map

package/dist/queue/remix-cover-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remix-cover-queue.js","sourceRoot":"","sources":["../../src/queue/remix-cover-queue.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACpC,IAAI,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,CAAC;QACvC,OAAO,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;IAC5C,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;QAC1C,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,KAAK,CAAC;IAC/D,OAAO,mBAAmB,IAAI,EAAE,CAAC;AACnC,CAAC"}

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