npm - @djvlc/contracts-schemas - Versions diffs - 1.4.0 → 1.5.0 - Mend

@djvlc/contracts-schemas 1.4.0 → 1.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/dist/index.d.mts +232 -2
package/dist/index.d.ts +232 -2
package/dist/index.js +106 -5
package/dist/index.mjs +106 -5
package/dist/schemas/page-schema.json +111 -5
package/package.json +1 -1

package/dist/index.d.mts CHANGED Viewed

@@ -154,6 +154,26 @@ declare const pageSchema: {
             };
         };
         PageConfig: {
+            type: string;
+            description: string;
+            additionalProperties: boolean;
+            required: string[];
+            properties: {
+                layout: {
+                    $ref: string;
+                    description: string;
+                };
+                styles: {
+                    $ref: string;
+                    description: string;
+                };
+                behavior: {
+                    $ref: string;
+                    description: string;
+                };
+            };
+        };
+        PageLayoutConfig: {
             type: string;
             description: string;
             additionalProperties: boolean;
@@ -180,6 +200,71 @@ declare const pageSchema: {
                     };
                     description: string;
                 };
+                maxWidth: {
+                    type: string;
+                    minimum: number;
+                    description: string;
+                };
+                padding: {
+                    type: string;
+                    additionalProperties: boolean;
+                    properties: {
+                        top: {
+                            type: string;
+                            minimum: number;
+                        };
+                        right: {
+                            type: string;
+                            minimum: number;
+                        };
+                        bottom: {
+                            type: string;
+                            minimum: number;
+                        };
+                        left: {
+                            type: string;
+                            minimum: number;
+                        };
+                    };
+                    description: string;
+                };
+                viewport: {
+                    $ref: string;
+                    description: string;
+                };
+            };
+        };
+        ViewportConfig: {
+            type: string;
+            description: string;
+            additionalProperties: boolean;
+            properties: {
+                mobile: {
+                    type: string;
+                    minimum: number;
+                    description: string;
+                };
+                tablet: {
+                    type: string;
+                    minimum: number;
+                    description: string;
+                };
+                desktop: {
+                    type: string;
+                    minimum: number;
+                    description: string;
+                };
+            };
+        };
+        PageStylesConfig: {
+            type: string;
+            description: string;
+            additionalProperties: boolean;
+            properties: {
+                theme: {
+                    $ref: string;
+                    description: string;
+                };
                 background: {
                     $ref: string;
                 };
@@ -190,10 +275,40 @@ declare const pageSchema: {
                     };
                     description: string;
                 };
-                customStyles: {
+                customCSS: {
+                    type: string;
+                    description: string;
+                };
+            };
+        };
+        ThemeConfig: {
+            type: string;
+            description: string;
+            additionalProperties: boolean;
+            properties: {
+                preset: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                variables: {
+                    type: string;
+                    additionalProperties: {
+                        type: string;
+                    };
+                    description: string;
+                };
+                transition: {
                     type: string;
                     description: string;
                 };
+            };
+        };
+        PageBehaviorConfig: {
+            type: string;
+            description: string;
+            additionalProperties: boolean;
+            properties: {
                 debug: {
                     type: string;
                     description: string;
@@ -4434,6 +4549,26 @@ declare const schemas: {
                 };
             };
             PageConfig: {
+                type: string;
+                description: string;
+                additionalProperties: boolean;
+                required: string[];
+                properties: {
+                    layout: {
+                        $ref: string;
+                        description: string;
+                    };
+                    styles: {
+                        $ref: string;
+                        description: string;
+                    };
+                    behavior: {
+                        $ref: string;
+                        description: string;
+                    };
+                };
+            };
+            PageLayoutConfig: {
                 type: string;
                 description: string;
                 additionalProperties: boolean;
@@ -4460,6 +4595,71 @@ declare const schemas: {
                         };
                         description: string;
                     };
+                    maxWidth: {
+                        type: string;
+                        minimum: number;
+                        description: string;
+                    };
+                    padding: {
+                        type: string;
+                        additionalProperties: boolean;
+                        properties: {
+                            top: {
+                                type: string;
+                                minimum: number;
+                            };
+                            right: {
+                                type: string;
+                                minimum: number;
+                            };
+                            bottom: {
+                                type: string;
+                                minimum: number;
+                            };
+                            left: {
+                                type: string;
+                                minimum: number;
+                            };
+                        };
+                        description: string;
+                    };
+                    viewport: {
+                        $ref: string;
+                        description: string;
+                    };
+                };
+            };
+            ViewportConfig: {
+                type: string;
+                description: string;
+                additionalProperties: boolean;
+                properties: {
+                    mobile: {
+                        type: string;
+                        minimum: number;
+                        description: string;
+                    };
+                    tablet: {
+                        type: string;
+                        minimum: number;
+                        description: string;
+                    };
+                    desktop: {
+                        type: string;
+                        minimum: number;
+                        description: string;
+                    };
+                };
+            };
+            PageStylesConfig: {
+                type: string;
+                description: string;
+                additionalProperties: boolean;
+                properties: {
+                    theme: {
+                        $ref: string;
+                        description: string;
+                    };
                     background: {
                         $ref: string;
                     };
@@ -4470,10 +4670,40 @@ declare const schemas: {
                         };
                         description: string;
                     };
-                    customStyles: {
+                    customCSS: {
+                        type: string;
+                        description: string;
+                    };
+                };
+            };
+            ThemeConfig: {
+                type: string;
+                description: string;
+                additionalProperties: boolean;
+                properties: {
+                    preset: {
+                        type: string;
+                        enum: string[];
+                        description: string;
+                    };
+                    variables: {
+                        type: string;
+                        additionalProperties: {
+                            type: string;
+                        };
+                        description: string;
+                    };
+                    transition: {
                         type: string;
                         description: string;
                     };
+                };
+            };
+            PageBehaviorConfig: {
+                type: string;
+                description: string;
+                additionalProperties: boolean;
+                properties: {
                     debug: {
                         type: string;
                         description: string;

package/dist/index.d.ts CHANGED Viewed

@@ -154,6 +154,26 @@ declare const pageSchema: {
             };
         };
         PageConfig: {
+            type: string;
+            description: string;
+            additionalProperties: boolean;
+            required: string[];
+            properties: {
+                layout: {
+                    $ref: string;
+                    description: string;
+                };
+                styles: {
+                    $ref: string;
+                    description: string;
+                };
+                behavior: {
+                    $ref: string;
+                    description: string;
+                };
+            };
+        };
+        PageLayoutConfig: {
             type: string;
             description: string;
             additionalProperties: boolean;
@@ -180,6 +200,71 @@ declare const pageSchema: {
                     };
                     description: string;
                 };
+                maxWidth: {
+                    type: string;
+                    minimum: number;
+                    description: string;
+                };
+                padding: {
+                    type: string;
+                    additionalProperties: boolean;
+                    properties: {
+                        top: {
+                            type: string;
+                            minimum: number;
+                        };
+                        right: {
+                            type: string;
+                            minimum: number;
+                        };
+                        bottom: {
+                            type: string;
+                            minimum: number;
+                        };
+                        left: {
+                            type: string;
+                            minimum: number;
+                        };
+                    };
+                    description: string;
+                };
+                viewport: {
+                    $ref: string;
+                    description: string;
+                };
+            };
+        };
+        ViewportConfig: {
+            type: string;
+            description: string;
+            additionalProperties: boolean;
+            properties: {
+                mobile: {
+                    type: string;
+                    minimum: number;
+                    description: string;
+                };
+                tablet: {
+                    type: string;
+                    minimum: number;
+                    description: string;
+                };
+                desktop: {
+                    type: string;
+                    minimum: number;
+                    description: string;
+                };
+            };
+        };
+        PageStylesConfig: {
+            type: string;
+            description: string;
+            additionalProperties: boolean;
+            properties: {
+                theme: {
+                    $ref: string;
+                    description: string;
+                };
                 background: {
                     $ref: string;
                 };
@@ -190,10 +275,40 @@ declare const pageSchema: {
                     };
                     description: string;
                 };
-                customStyles: {
+                customCSS: {
+                    type: string;
+                    description: string;
+                };
+            };
+        };
+        ThemeConfig: {
+            type: string;
+            description: string;
+            additionalProperties: boolean;
+            properties: {
+                preset: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                variables: {
+                    type: string;
+                    additionalProperties: {
+                        type: string;
+                    };
+                    description: string;
+                };
+                transition: {
                     type: string;
                     description: string;
                 };
+            };
+        };
+        PageBehaviorConfig: {
+            type: string;
+            description: string;
+            additionalProperties: boolean;
+            properties: {
                 debug: {
                     type: string;
                     description: string;
@@ -4434,6 +4549,26 @@ declare const schemas: {
                 };
             };
             PageConfig: {
+                type: string;
+                description: string;
+                additionalProperties: boolean;
+                required: string[];
+                properties: {
+                    layout: {
+                        $ref: string;
+                        description: string;
+                    };
+                    styles: {
+                        $ref: string;
+                        description: string;
+                    };
+                    behavior: {
+                        $ref: string;
+                        description: string;
+                    };
+                };
+            };
+            PageLayoutConfig: {
                 type: string;
                 description: string;
                 additionalProperties: boolean;
@@ -4460,6 +4595,71 @@ declare const schemas: {
                         };
                         description: string;
                     };
+                    maxWidth: {
+                        type: string;
+                        minimum: number;
+                        description: string;
+                    };
+                    padding: {
+                        type: string;
+                        additionalProperties: boolean;
+                        properties: {
+                            top: {
+                                type: string;
+                                minimum: number;
+                            };
+                            right: {
+                                type: string;
+                                minimum: number;
+                            };
+                            bottom: {
+                                type: string;
+                                minimum: number;
+                            };
+                            left: {
+                                type: string;
+                                minimum: number;
+                            };
+                        };
+                        description: string;
+                    };
+                    viewport: {
+                        $ref: string;
+                        description: string;
+                    };
+                };
+            };
+            ViewportConfig: {
+                type: string;
+                description: string;
+                additionalProperties: boolean;
+                properties: {
+                    mobile: {
+                        type: string;
+                        minimum: number;
+                        description: string;
+                    };
+                    tablet: {
+                        type: string;
+                        minimum: number;
+                        description: string;
+                    };
+                    desktop: {
+                        type: string;
+                        minimum: number;
+                        description: string;
+                    };
+                };
+            };
+            PageStylesConfig: {
+                type: string;
+                description: string;
+                additionalProperties: boolean;
+                properties: {
+                    theme: {
+                        $ref: string;
+                        description: string;
+                    };
                     background: {
                         $ref: string;
                     };
@@ -4470,10 +4670,40 @@ declare const schemas: {
                         };
                         description: string;
                     };
-                    customStyles: {
+                    customCSS: {
+                        type: string;
+                        description: string;
+                    };
+                };
+            };
+            ThemeConfig: {
+                type: string;
+                description: string;
+                additionalProperties: boolean;
+                properties: {
+                    preset: {
+                        type: string;
+                        enum: string[];
+                        description: string;
+                    };
+                    variables: {
+                        type: string;
+                        additionalProperties: {
+                            type: string;
+                        };
+                        description: string;
+                    };
+                    transition: {
                         type: string;
                         description: string;
                     };
+                };
+            };
+            PageBehaviorConfig: {
+                type: string;
+                description: string;
+                additionalProperties: boolean;
+                properties: {
                     debug: {
                         type: string;
                         description: string;

package/dist/index.js CHANGED Viewed

@@ -132,7 +132,27 @@ var page_schema_default = {
     },
     PageConfig: {
       type: "object",
-      description: "\u9875\u9762\u914D\u7F6E",
+      description: "\u9875\u9762\u914D\u7F6E\uFF08\u4E09\u5C42\u5206\u79BB\uFF1Alayout / styles / behavior\uFF09",
+      additionalProperties: false,
+      required: ["layout"],
+      properties: {
+        layout: {
+          $ref: "#/definitions/PageLayoutConfig",
+          description: "\u5E03\u5C40\u914D\u7F6E"
+        },
+        styles: {
+          $ref: "#/definitions/PageStylesConfig",
+          description: "\u6837\u5F0F\u914D\u7F6E"
+        },
+        behavior: {
+          $ref: "#/definitions/PageBehaviorConfig",
+          description: "\u884C\u4E3A\u914D\u7F6E"
+        }
+      }
+    },
+    PageLayoutConfig: {
+      type: "object",
+      description: "\u9875\u9762\u5E03\u5C40\u914D\u7F6E\uFF08\u8FD0\u884C\u65F6\u9700\u7B2C\u4E00\u65F6\u95F4\u89E3\u6790\uFF0C\u5F71\u54CD\u6574\u4F53\u6E32\u67D3\u7B56\u7565\uFF09",
       additionalProperties: false,
       required: ["canvasType"],
       properties: {
@@ -149,18 +169,99 @@ var page_schema_default = {
             width: { type: "integer", minimum: 1 },
             height: { type: "integer", minimum: 1 }
           },
-          description: "\u753B\u5E03\u5C3A\u5BF8"
+          description: "\u753B\u5E03\u5C3A\u5BF8\uFF08\u4EC5 canvasType \u975E responsive \u65F6\u751F\u6548\uFF09"
+        },
+        maxWidth: {
+          type: "integer",
+          minimum: 1,
+          description: "\u5185\u5BB9\u6700\u5927\u5BBD\u5EA6\uFF08\u54CD\u5E94\u5F0F\u9875\u9762\u5E38\u7528\uFF09"
+        },
+        padding: {
+          type: "object",
+          additionalProperties: false,
+          properties: {
+            top: { type: "number", minimum: 0 },
+            right: { type: "number", minimum: 0 },
+            bottom: { type: "number", minimum: 0 },
+            left: { type: "number", minimum: 0 }
+          },
+          description: "\u9875\u9762\u5BB9\u5668\u5185\u8FB9\u8DDD"
+        },
+        viewport: {
+          $ref: "#/definitions/ViewportConfig",
+          description: "\u89C6\u53E3\u65AD\u70B9\u914D\u7F6E\uFF08\u54CD\u5E94\u5F0F\u9875\u9762\u4F7F\u7528\uFF09"
+        }
+      }
+    },
+    ViewportConfig: {
+      type: "object",
+      description: "\u89C6\u53E3\u65AD\u70B9\u914D\u7F6E",
+      additionalProperties: false,
+      properties: {
+        mobile: {
+          type: "integer",
+          minimum: 1,
+          description: "\u79FB\u52A8\u7AEF\u65AD\u70B9\uFF08\u9ED8\u8BA4 768px\uFF09"
+        },
+        tablet: {
+          type: "integer",
+          minimum: 1,
+          description: "\u5E73\u677F\u65AD\u70B9\uFF08\u9ED8\u8BA4 1024px\uFF09"
+        },
+        desktop: {
+          type: "integer",
+          minimum: 1,
+          description: "\u684C\u9762\u65AD\u70B9\uFF08\u9ED8\u8BA4 1440px\uFF09"
+        }
+      }
+    },
+    PageStylesConfig: {
+      type: "object",
+      description: "\u9875\u9762\u6837\u5F0F\u914D\u7F6E\uFF08\u7EAF\u89C6\u89C9\u6837\u5F0F\uFF0C\u53EF\u5EF6\u8FDF\u6216\u589E\u91CF\u5E94\u7528\uFF09",
+      additionalProperties: false,
+      properties: {
+        theme: {
+          $ref: "#/definitions/ThemeConfig",
+          description: "\u4E3B\u9898\u914D\u7F6E"
         },
         background: { $ref: "#/definitions/BackgroundConfig" },
         cssVariables: {
           type: "object",
           additionalProperties: { type: "string" },
-          description: "\u9875\u9762\u7EA7 CSS \u53D8\u91CF"
+          description: "\u9875\u9762\u7EA7 CSS \u53D8\u91CF\uFF08\u4E0E theme.variables \u5408\u5E76\uFF0C\u6B64\u5904\u4F18\u5148\u7EA7\u66F4\u9AD8\uFF09"
         },
-        customStyles: {
+        customCSS: {
+          type: "string",
+          description: "\u9875\u9762\u7EA7\u81EA\u5B9A\u4E49\u6837\u5F0F\uFF08\u6CE8\u5165 <style>\uFF09"
+        }
+      }
+    },
+    ThemeConfig: {
+      type: "object",
+      description: "\u4E3B\u9898\u914D\u7F6E",
+      additionalProperties: false,
+      properties: {
+        preset: {
           type: "string",
-          description: "\u9875\u9762\u7EA7\u81EA\u5B9A\u4E49\u6837\u5F0F"
+          enum: ["light", "dark", "system", "custom"],
+          description: "\u9884\u8BBE\u4E3B\u9898"
+        },
+        variables: {
+          type: "object",
+          additionalProperties: { type: "string" },
+          description: "\u4E3B\u9898\u53D8\u91CF\u8986\u76D6\uFF08\u4F18\u5148\u7EA7\u9AD8\u4E8E preset\uFF09"
         },
+        transition: {
+          type: "boolean",
+          description: "\u989C\u8272\u6A21\u5F0F\u5207\u6362\u65F6\u7684\u8FC7\u6E21\u52A8\u753B"
+        }
+      }
+    },
+    PageBehaviorConfig: {
+      type: "object",
+      description: "\u9875\u9762\u884C\u4E3A\u914D\u7F6E\uFF08\u63A7\u5236\u8FD0\u884C\u65F6\u884C\u4E3A\uFF0C\u4E0E\u6E32\u67D3\u65E0\u76F4\u63A5\u5173\u7CFB\uFF09",
+      additionalProperties: false,
+      properties: {
         debug: {
           type: "boolean",
           description: "\u662F\u5426\u542F\u7528\u8C03\u8BD5\u6A21\u5F0F"

package/dist/index.mjs CHANGED Viewed

@@ -130,7 +130,27 @@ var page_schema_default = {
     },
     PageConfig: {
       type: "object",
-      description: "\u9875\u9762\u914D\u7F6E",
+      description: "\u9875\u9762\u914D\u7F6E\uFF08\u4E09\u5C42\u5206\u79BB\uFF1Alayout / styles / behavior\uFF09",
+      additionalProperties: false,
+      required: ["layout"],
+      properties: {
+        layout: {
+          $ref: "#/definitions/PageLayoutConfig",
+          description: "\u5E03\u5C40\u914D\u7F6E"
+        },
+        styles: {
+          $ref: "#/definitions/PageStylesConfig",
+          description: "\u6837\u5F0F\u914D\u7F6E"
+        },
+        behavior: {
+          $ref: "#/definitions/PageBehaviorConfig",
+          description: "\u884C\u4E3A\u914D\u7F6E"
+        }
+      }
+    },
+    PageLayoutConfig: {
+      type: "object",
+      description: "\u9875\u9762\u5E03\u5C40\u914D\u7F6E\uFF08\u8FD0\u884C\u65F6\u9700\u7B2C\u4E00\u65F6\u95F4\u89E3\u6790\uFF0C\u5F71\u54CD\u6574\u4F53\u6E32\u67D3\u7B56\u7565\uFF09",
       additionalProperties: false,
       required: ["canvasType"],
       properties: {
@@ -147,18 +167,99 @@ var page_schema_default = {
             width: { type: "integer", minimum: 1 },
             height: { type: "integer", minimum: 1 }
           },
-          description: "\u753B\u5E03\u5C3A\u5BF8"
+          description: "\u753B\u5E03\u5C3A\u5BF8\uFF08\u4EC5 canvasType \u975E responsive \u65F6\u751F\u6548\uFF09"
+        },
+        maxWidth: {
+          type: "integer",
+          minimum: 1,
+          description: "\u5185\u5BB9\u6700\u5927\u5BBD\u5EA6\uFF08\u54CD\u5E94\u5F0F\u9875\u9762\u5E38\u7528\uFF09"
+        },
+        padding: {
+          type: "object",
+          additionalProperties: false,
+          properties: {
+            top: { type: "number", minimum: 0 },
+            right: { type: "number", minimum: 0 },
+            bottom: { type: "number", minimum: 0 },
+            left: { type: "number", minimum: 0 }
+          },
+          description: "\u9875\u9762\u5BB9\u5668\u5185\u8FB9\u8DDD"
+        },
+        viewport: {
+          $ref: "#/definitions/ViewportConfig",
+          description: "\u89C6\u53E3\u65AD\u70B9\u914D\u7F6E\uFF08\u54CD\u5E94\u5F0F\u9875\u9762\u4F7F\u7528\uFF09"
+        }
+      }
+    },
+    ViewportConfig: {
+      type: "object",
+      description: "\u89C6\u53E3\u65AD\u70B9\u914D\u7F6E",
+      additionalProperties: false,
+      properties: {
+        mobile: {
+          type: "integer",
+          minimum: 1,
+          description: "\u79FB\u52A8\u7AEF\u65AD\u70B9\uFF08\u9ED8\u8BA4 768px\uFF09"
+        },
+        tablet: {
+          type: "integer",
+          minimum: 1,
+          description: "\u5E73\u677F\u65AD\u70B9\uFF08\u9ED8\u8BA4 1024px\uFF09"
+        },
+        desktop: {
+          type: "integer",
+          minimum: 1,
+          description: "\u684C\u9762\u65AD\u70B9\uFF08\u9ED8\u8BA4 1440px\uFF09"
+        }
+      }
+    },
+    PageStylesConfig: {
+      type: "object",
+      description: "\u9875\u9762\u6837\u5F0F\u914D\u7F6E\uFF08\u7EAF\u89C6\u89C9\u6837\u5F0F\uFF0C\u53EF\u5EF6\u8FDF\u6216\u589E\u91CF\u5E94\u7528\uFF09",
+      additionalProperties: false,
+      properties: {
+        theme: {
+          $ref: "#/definitions/ThemeConfig",
+          description: "\u4E3B\u9898\u914D\u7F6E"
         },
         background: { $ref: "#/definitions/BackgroundConfig" },
         cssVariables: {
           type: "object",
           additionalProperties: { type: "string" },
-          description: "\u9875\u9762\u7EA7 CSS \u53D8\u91CF"
+          description: "\u9875\u9762\u7EA7 CSS \u53D8\u91CF\uFF08\u4E0E theme.variables \u5408\u5E76\uFF0C\u6B64\u5904\u4F18\u5148\u7EA7\u66F4\u9AD8\uFF09"
         },
-        customStyles: {
+        customCSS: {
+          type: "string",
+          description: "\u9875\u9762\u7EA7\u81EA\u5B9A\u4E49\u6837\u5F0F\uFF08\u6CE8\u5165 <style>\uFF09"
+        }
+      }
+    },
+    ThemeConfig: {
+      type: "object",
+      description: "\u4E3B\u9898\u914D\u7F6E",
+      additionalProperties: false,
+      properties: {
+        preset: {
           type: "string",
-          description: "\u9875\u9762\u7EA7\u81EA\u5B9A\u4E49\u6837\u5F0F"
+          enum: ["light", "dark", "system", "custom"],
+          description: "\u9884\u8BBE\u4E3B\u9898"
+        },
+        variables: {
+          type: "object",
+          additionalProperties: { type: "string" },
+          description: "\u4E3B\u9898\u53D8\u91CF\u8986\u76D6\uFF08\u4F18\u5148\u7EA7\u9AD8\u4E8E preset\uFF09"
         },
+        transition: {
+          type: "boolean",
+          description: "\u989C\u8272\u6A21\u5F0F\u5207\u6362\u65F6\u7684\u8FC7\u6E21\u52A8\u753B"
+        }
+      }
+    },
+    PageBehaviorConfig: {
+      type: "object",
+      description: "\u9875\u9762\u884C\u4E3A\u914D\u7F6E\uFF08\u63A7\u5236\u8FD0\u884C\u65F6\u884C\u4E3A\uFF0C\u4E0E\u6E32\u67D3\u65E0\u76F4\u63A5\u5173\u7CFB\uFF09",
+      additionalProperties: false,
+      properties: {
         debug: {
           type: "boolean",
           description: "\u662F\u5426\u542F\u7528\u8C03\u8BD5\u6A21\u5F0F"

package/dist/schemas/page-schema.json CHANGED Viewed

@@ -137,7 +137,28 @@
     "PageConfig": {
       "type": "object",
-      "description": "页面配置",
+      "description": "页面配置（三层分离：layout / styles / behavior）",
+      "additionalProperties": false,
+      "required": ["layout"],
+      "properties": {
+        "layout": {
+          "$ref": "#/definitions/PageLayoutConfig",
+          "description": "布局配置"
+        },
+        "styles": {
+          "$ref": "#/definitions/PageStylesConfig",
+          "description": "样式配置"
+        },
+        "behavior": {
+          "$ref": "#/definitions/PageBehaviorConfig",
+          "description": "行为配置"
+        }
+      }
+    },
+    "PageLayoutConfig": {
+      "type": "object",
+      "description": "页面布局配置（运行时需第一时间解析，影响整体渲染策略）",
       "additionalProperties": false,
       "required": ["canvasType"],
       "properties": {
@@ -154,18 +175,103 @@
             "width": { "type": "integer", "minimum": 1 },
             "height": { "type": "integer", "minimum": 1 }
           },
-          "description": "画布尺寸"
+          "description": "画布尺寸（仅 canvasType 非 responsive 时生效）"
+        },
+        "maxWidth": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "内容最大宽度（响应式页面常用）"
+        },
+        "padding": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "top": { "type": "number", "minimum": 0 },
+            "right": { "type": "number", "minimum": 0 },
+            "bottom": { "type": "number", "minimum": 0 },
+            "left": { "type": "number", "minimum": 0 }
+          },
+          "description": "页面容器内边距"
+        },
+        "viewport": {
+          "$ref": "#/definitions/ViewportConfig",
+          "description": "视口断点配置（响应式页面使用）"
+        }
+      }
+    },
+    "ViewportConfig": {
+      "type": "object",
+      "description": "视口断点配置",
+      "additionalProperties": false,
+      "properties": {
+        "mobile": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "移动端断点（默认 768px）"
+        },
+        "tablet": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "平板断点（默认 1024px）"
+        },
+        "desktop": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "桌面断点（默认 1440px）"
+        }
+      }
+    },
+    "PageStylesConfig": {
+      "type": "object",
+      "description": "页面样式配置（纯视觉样式，可延迟或增量应用）",
+      "additionalProperties": false,
+      "properties": {
+        "theme": {
+          "$ref": "#/definitions/ThemeConfig",
+          "description": "主题配置"
         },
         "background": { "$ref": "#/definitions/BackgroundConfig" },
         "cssVariables": {
           "type": "object",
           "additionalProperties": { "type": "string" },
-          "description": "页面级 CSS 变量"
+          "description": "页面级 CSS 变量（与 theme.variables 合并，此处优先级更高）"
         },
-        "customStyles": {
+        "customCSS": {
           "type": "string",
-          "description": "页面级自定义样式"
+          "description": "页面级自定义样式（注入 <style>）"
+        }
+      }
+    },
+    "ThemeConfig": {
+      "type": "object",
+      "description": "主题配置",
+      "additionalProperties": false,
+      "properties": {
+        "preset": {
+          "type": "string",
+          "enum": ["light", "dark", "system", "custom"],
+          "description": "预设主题"
         },
+        "variables": {
+          "type": "object",
+          "additionalProperties": { "type": "string" },
+          "description": "主题变量覆盖（优先级高于 preset）"
+        },
+        "transition": {
+          "type": "boolean",
+          "description": "颜色模式切换时的过渡动画"
+        }
+      }
+    },
+    "PageBehaviorConfig": {
+      "type": "object",
+      "description": "页面行为配置（控制运行时行为，与渲染无直接关系）",
+      "additionalProperties": false,
+      "properties": {
         "debug": {
           "type": "boolean",
           "description": "是否启用调试模式"

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@djvlc/contracts-schemas",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "DJVLC Low-code Platform JSON Schema 定义",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",