@shoppexio/builder-contracts 0.1.0 → 0.1.2

package/dist/theme-manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme-manifest.d.ts","sourceRoot":"","sources":["../src/theme-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAI5B,eAAO,MAAM,aAAa,aAAoD,CAAC;AAC/E,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD,eAAO,MAAM,kBAAkB;;;;kBAMpB,CAAC;AACZ,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,kBAAkB;;;;kBAMpB,CAAC;AACZ,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,kBAAkB;;;;;;;;;kBAOpB,CAAC;AACZ,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAQnB,CAAC;AACZ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAWrB,CAAC;AACZ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAQnB,CAAC;AACZ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA+D5B,CAAC;AACL,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAEhE"}
+{"version":3,"file":"theme-manifest.d.ts","sourceRoot":"","sources":["../src/theme-manifest.ts"],"names":[],"mappings":"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"}

package/dist/theme-manifest.js

@@ -49,20 +49,63 @@ export const ThemePresetSchema = z
     .object({
     label: z.string().min(1),
     description: z.string().min(1).optional(),
+    preview: z.string().min(1).optional(),
     content: z.record(z.string().min(1), z.unknown()).default({}),
     layout: z.record(z.string().min(1), z.unknown()).default({}),
     style_slots: StyleSlotDefaultsSchema.default({}),
 })
     .strict();
+export const ThemeManifestMetadataSchema = z
+    .object({
+    author: z.string().min(1).optional(),
+    description: z.string().min(1).optional(),
+    preview: z.string().min(1).optional(),
+    features: z.array(z.string().min(1)).optional(),
+    techStack: z.array(z.string().min(1)).optional(),
+    templates: z.array(z.string().min(1)).optional(),
+    createdAt: z.string().min(1).optional(),
+    demoUrl: z.string().min(1).optional(),
+    audience: z.string().min(1).optional(),
+    tags: z.array(z.string().min(1)).optional(),
+    hotfixPaths: z.array(z.string().min(1)).optional(),
+})
+    .strict();
+export const ThemeManifestLinkGroupSchema = z
+    .object({
+    path: z.string().min(1),
+    label: z.string().min(1),
+    description: z.string().min(1).optional(),
+    pageIds: z.array(z.string().min(1)).optional(),
+})
+    .strict();
+export const ThemeManifestLinkItemSchema = z
+    .object({
+    label: z.string().min(1),
+    href: z.string().min(1),
+})
+    .strict();
 export const ThemeManifestSchema = z
     .object({
     id: ThemeIdSchema,
     name: z.string().min(1),
     version: z.string().min(1),
+    author: ThemeManifestMetadataSchema.shape.author,
+    description: ThemeManifestMetadataSchema.shape.description,
+    preview: ThemeManifestMetadataSchema.shape.preview,
+    features: ThemeManifestMetadataSchema.shape.features,
+    techStack: ThemeManifestMetadataSchema.shape.techStack,
+    templates: ThemeManifestMetadataSchema.shape.templates,
+    createdAt: ThemeManifestMetadataSchema.shape.createdAt,
+    demoUrl: ThemeManifestMetadataSchema.shape.demoUrl,
+    audience: ThemeManifestMetadataSchema.shape.audience,
+    tags: ThemeManifestMetadataSchema.shape.tags,
+    hotfixPaths: ThemeManifestMetadataSchema.shape.hotfixPaths,
     pages: z.record(z.string().min(1), ManifestPageSchema),
     blocks: z.record(z.string().min(1), ManifestBlockSchema),
     styleSlots: StyleSlotDefaultsSchema.default({}),
     presets: z.record(z.string().min(1), ThemePresetSchema).default({}),
+    linkGroups: z.array(ThemeManifestLinkGroupSchema).optional(),
+    defaultLinkItems: z.record(z.string().min(1), z.array(ThemeManifestLinkItemSchema)).optional(),
 })
     .strict()
     .superRefine((manifest, ctx) => {
@@ -117,3 +160,52 @@ export const ThemeManifestSchema = z
 export function parseThemeManifest(input) {
     return ThemeManifestSchema.parse(input);
 }
+export function listThemeManifestPresets(input) {
+    if (!isRecord(input) || !isRecord(input.presets)) {
+        if (isRecord(input) && Array.isArray(input.presets)) {
+            return input.presets.flatMap((preset) => normalizeLegacyPresetListItem(preset));
+        }
+        return [];
+    }
+    const manifest = ThemeManifestSchema.safeParse(input);
+    if (!manifest.success) {
+        return [];
+    }
+    return Object.entries(manifest.data.presets).map(([id, preset]) => ({
+        id,
+        name: preset.label,
+        ...(preset.description ? { description: preset.description } : {}),
+        ...(preset.preview ? { preview: preset.preview } : {}),
+        overrides: {
+            ...(Object.keys(preset.content).length > 0 ? { content: preset.content } : {}),
+            ...(Object.keys(preset.layout).length > 0 ? { layout: preset.layout } : {}),
+            ...(Object.keys(preset.style_slots).length > 0 ? { style_slots: preset.style_slots } : {}),
+        },
+    }));
+}
+function normalizeLegacyPresetListItem(input) {
+    if (!isRecord(input) || typeof input.id !== 'string') {
+        return [];
+    }
+    const overrides = isRecord(input.overrides) ? input.overrides : {};
+    const styleSlots = StyleSlotDefaultsSchema.safeParse(overrides.style_slots ?? overrides.styleSlots);
+    return [{
+            id: input.id,
+            name: typeof input.name === 'string'
+                ? input.name
+                : typeof input.label === 'string'
+                    ? input.label
+                    : input.id,
+            ...(typeof input.description === 'string' ? { description: input.description } : {}),
+            ...(typeof input.preview === 'string' ? { preview: input.preview } : {}),
+            overrides: {
+                ...(isRecord(overrides.content) ? { content: overrides.content } : {}),
+                ...(isRecord(overrides.layout) ? { layout: overrides.layout } : {}),
+                ...(isRecord(overrides.tokens) ? { tokens: overrides.tokens } : {}),
+                ...(styleSlots.success && Object.keys(styleSlots.data).length > 0 ? { style_slots: styleSlots.data } : {}),
+            },
+        }];
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}

package/dist/theme-schemes.d.ts

@@ -0,0 +1,10 @@
+export declare const PUBLIC_BUILDER_THEME_SCHEMES: readonly ["default", "classic", "nebula", "pulse", "phantom", "starlight", "apex", "vault", "clean-minimal"];
+export declare const STARTER_BUILDER_THEME_SCHEMES: readonly ["blank"];
+export declare const BUILDER_READY_THEME_SCHEMES: readonly ["blank", "default", "classic", "nebula", "pulse", "phantom", "starlight", "apex", "vault", "clean-minimal"];
+export type PublicBuilderThemeScheme = (typeof PUBLIC_BUILDER_THEME_SCHEMES)[number];
+export type StarterBuilderThemeScheme = (typeof STARTER_BUILDER_THEME_SCHEMES)[number];
+export type BuilderReadyThemeScheme = (typeof BUILDER_READY_THEME_SCHEMES)[number];
+export declare function isPublicBuilderThemeScheme(value: string): value is PublicBuilderThemeScheme;
+export declare function isStarterBuilderThemeScheme(value: string): value is StarterBuilderThemeScheme;
+export declare function isBuilderReadyThemeScheme(value: string): value is BuilderReadyThemeScheme;
+//# sourceMappingURL=theme-schemes.d.ts.map

package/dist/theme-schemes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-schemes.d.ts","sourceRoot":"","sources":["../src/theme-schemes.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,4BAA4B,8GAU/B,CAAC;AAEX,eAAO,MAAM,6BAA6B,oBAAqB,CAAC;AAEhE,eAAO,MAAM,2BAA2B,uHAG9B,CAAC;AAEX,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,4BAA4B,CAAC,CAAC,MAAM,CAAC,CAAC;AACrF,MAAM,MAAM,yBAAyB,GAAG,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAC;AACvF,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnF,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,wBAAwB,CAE3F;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,yBAAyB,CAE7F;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,uBAAuB,CAEzF"}

package/dist/theme-schemes.js

@@ -0,0 +1,25 @@
+export const PUBLIC_BUILDER_THEME_SCHEMES = [
+    'default',
+    'classic',
+    'nebula',
+    'pulse',
+    'phantom',
+    'starlight',
+    'apex',
+    'vault',
+    'clean-minimal',
+];
+export const STARTER_BUILDER_THEME_SCHEMES = ['blank'];
+export const BUILDER_READY_THEME_SCHEMES = [
+    ...STARTER_BUILDER_THEME_SCHEMES,
+    ...PUBLIC_BUILDER_THEME_SCHEMES,
+];
+export function isPublicBuilderThemeScheme(value) {
+    return PUBLIC_BUILDER_THEME_SCHEMES.includes(value);
+}
+export function isStarterBuilderThemeScheme(value) {
+    return STARTER_BUILDER_THEME_SCHEMES.includes(value);
+}
+export function isBuilderReadyThemeScheme(value) {
+    return BUILDER_READY_THEME_SCHEMES.includes(value);
+}

package/dist/validation.d.ts

@@ -1,6 +1,6 @@
 import type { BuilderSettings } from './builder-settings.ts';
 import type { ThemeManifest } from './theme-manifest.ts';
-export type BuilderManifestValidationIssueCode = 'unknown_page' | 'duplicate_block_id' | 'unknown_block_type' | 'block_not_allowed' | 'too_many_block_instances' | 'unknown_block_variant' | 'unknown_block_setting' | 'unexposed_style_slot';
+export type BuilderManifestValidationIssueCode = 'unknown_page' | 'duplicate_block_id' | 'unknown_block_type' | 'block_not_allowed' | 'too_many_block_instances' | 'unknown_block_variant' | 'unknown_block_setting' | 'unknown_style_slot' | 'unexposed_style_slot';
 export type BuilderManifestValidationIssue = {
     code: BuilderManifestValidationIssueCode;
     path: string;

package/dist/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,MAAM,kCAAkC,GAC1C,cAAc,GACd,oBAAoB,GACpB,oBAAoB,GACpB,mBAAmB,GACnB,0BAA0B,GAC1B,uBAAuB,GACvB,uBAAuB,GACvB,sBAAsB,CAAC;AAE3B,MAAM,MAAM,8BAA8B,GAAG;IAC3C,IAAI,EAAE,kCAAkC,CAAC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,qBAAa,8BAA+B,SAAQ,KAAK;IACvD,QAAQ,CAAC,MAAM,EAAE,8BAA8B,EAAE,CAAC;gBAEtC,MAAM,EAAE,8BAA8B,EAAE;CAKrD;AAED,wBAAgB,sCAAsC,CACpD,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,aAAa,GACtB,8BAA8B,EAAE,CAkElC;AAED,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,aAAa,GACtB,IAAI,CAKN;AAED,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,8BAA8B,EAAE,GACvC,MAAM,CAQR"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAG5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,MAAM,kCAAkC,GAC1C,cAAc,GACd,oBAAoB,GACpB,oBAAoB,GACpB,mBAAmB,GACnB,0BAA0B,GAC1B,uBAAuB,GACvB,uBAAuB,GACvB,oBAAoB,GACpB,sBAAsB,CAAC;AAE3B,MAAM,MAAM,8BAA8B,GAAG;IAC3C,IAAI,EAAE,kCAAkC,CAAC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,qBAAa,8BAA+B,SAAQ,KAAK;IACvD,QAAQ,CAAC,MAAM,EAAE,8BAA8B,EAAE,CAAC;gBAEtC,MAAM,EAAE,8BAA8B,EAAE;CAKrD;AAED,wBAAgB,sCAAsC,CACpD,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,aAAa,GACtB,8BAA8B,EAAE,CAqElC;AAwBD,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,aAAa,GACtB,IAAI,CAKN;AAED,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,8BAA8B,EAAE,GACvC,MAAM,CAQR"}

package/dist/validation.js

@@ -1,3 +1,5 @@
+import { mergeCustomPagesIntoManifest } from "./custom-pages.js";
+import { ThemeStyleSlotIdSchema } from "./style-slots.js";
 export class BuilderManifestValidationError extends Error {
     issues;
     constructor(issues) {
@@ -7,9 +9,11 @@ export class BuilderManifestValidationError extends Error {
     }
 }
 export function validateBuilderSettingsAgainstManifest(settings, manifest) {
+    const effectiveManifest = mergeCustomPagesIntoManifest(manifest, settings);
     const issues = [];
+    validateGlobalStyleSlots(settings, effectiveManifest, issues);
     for (const [pageId, layout] of Object.entries(settings.theme.layout)) {
-        const page = manifest.pages[pageId];
+        const page = effectiveManifest.pages[pageId];
         if (!page) {
             issues.push({
                 code: 'unknown_page',
@@ -30,7 +34,7 @@ export function validateBuilderSettingsAgainstManifest(settings, manifest) {
                 });
             }
             blockIds.add(block.id);
-            const blockDefinition = manifest.blocks[block.type];
+            const blockDefinition = effectiveManifest.blocks[block.type];
             if (!blockDefinition) {
                 issues.push({
                     code: 'unknown_block_type',
@@ -52,7 +56,7 @@ export function validateBuilderSettingsAgainstManifest(settings, manifest) {
             validateBlockStyleOverrides(block, blockDefinition.exposedStyleSlots, blockPath, issues);
         }
         for (const [blockType, count] of blockTypeCounts.entries()) {
-            const maxInstances = manifest.blocks[blockType]?.maxInstances;
+            const maxInstances = effectiveManifest.blocks[blockType]?.maxInstances;
             if (maxInstances !== undefined && count > maxInstances) {
                 issues.push({
                     code: 'too_many_block_instances',
@@ -64,6 +68,21 @@ export function validateBuilderSettingsAgainstManifest(settings, manifest) {
     }
     return issues;
 }
+function validateGlobalStyleSlots(settings, manifest, issues) {
+    const declaredThemeSlots = new Set(Object.keys(manifest.styleSlots));
+    for (const slotId of Object.keys(settings.theme.style_slots)) {
+        if (!ThemeStyleSlotIdSchema.safeParse(slotId).success) {
+            continue;
+        }
+        if (!declaredThemeSlots.has(slotId)) {
+            issues.push({
+                code: 'unknown_style_slot',
+                path: `theme.style_slots.${slotId}`,
+                message: `Theme style slot "${slotId}" is not declared by the manifest`,
+            });
+        }
+    }
+}
 export function assertBuilderSettingsMatchManifest(settings, manifest) {
     const issues = validateBuilderSettingsAgainstManifest(settings, manifest);
     if (issues.length > 0) {
@@ -82,11 +101,7 @@ function validateBlockSettings(block, settingPaths, blockPath, issues) {
     if (settingPaths.length === 0 && Object.keys(block.settings).length === 0) {
         return;
     }
-    const allowedSettings = new Set();
-    for (const path of settingPaths) {
-        allowedSettings.add(path);
-        allowedSettings.add(getShortSettingKey(path));
-    }
+    const allowedSettings = new Set(settingPaths);
     for (const key of Object.keys(block.settings)) {
         if (allowedSettings.has(key)) {
             continue;
@@ -110,10 +125,6 @@ function validateBlockVariant(block, variants, blockPath, issues) {
         });
     }
 }
-function getShortSettingKey(path) {
-    const parts = path.split('.').filter(Boolean);
-    return parts.at(-1) ?? path;
-}
 function validateBlockStyleOverrides(block, exposedStyleSlots, blockPath, issues) {
     if (!block.style_overrides) {
         return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shoppexio/builder-contracts",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Shared Builder v2 contracts for Shoppex dashboard, backend, preview runtime, and themes",
   "type": "module",
   "repository": {
@@ -25,6 +25,12 @@
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
+    "./canonical-settings": {
+      "bun": "./src/canonical-settings.ts",
+      "types": "./dist/canonical-settings.d.ts",
+      "import": "./dist/canonical-settings.js",
+      "default": "./dist/canonical-settings.js"
+    },
     "./builder-settings": {
       "bun": "./src/builder-settings.ts",
       "types": "./dist/builder-settings.d.ts",
@@ -55,12 +61,42 @@
       "import": "./dist/migrations.js",
       "default": "./dist/migrations.js"
     },
+    "./persistence": {
+      "bun": "./src/persistence.ts",
+      "types": "./dist/persistence.d.ts",
+      "import": "./dist/persistence.js",
+      "default": "./dist/persistence.js"
+    },
     "./preview-protocol": {
       "bun": "./src/preview-protocol.ts",
       "types": "./dist/preview-protocol.d.ts",
       "import": "./dist/preview-protocol.js",
       "default": "./dist/preview-protocol.js"
     },
+    "./preview-boot": {
+      "bun": "./src/preview-boot.ts",
+      "types": "./dist/preview-boot.d.ts",
+      "import": "./dist/preview-boot.js",
+      "default": "./dist/preview-boot.js"
+    },
+    "./preview-session-resolve": {
+      "bun": "./src/preview-session-resolve.ts",
+      "types": "./dist/preview-session-resolve.d.ts",
+      "import": "./dist/preview-session-resolve.js",
+      "default": "./dist/preview-session-resolve.js"
+    },
+    "./preview-trusted-origins": {
+      "bun": "./src/preview-trusted-origins.ts",
+      "types": "./dist/preview-trusted-origins.d.ts",
+      "import": "./dist/preview-trusted-origins.js",
+      "default": "./dist/preview-trusted-origins.js"
+    },
+    "./storefront-initial-data-html": {
+      "bun": "./src/storefront-initial-data-html.ts",
+      "types": "./dist/storefront-initial-data-html.d.ts",
+      "import": "./dist/storefront-initial-data-html.js",
+      "default": "./dist/storefront-initial-data-html.js"
+    },
     "./style-slots": {
       "bun": "./src/style-slots.ts",
       "types": "./dist/style-slots.d.ts",
@@ -72,6 +108,12 @@
       "types": "./dist/theme-manifest.d.ts",
       "import": "./dist/theme-manifest.js",
       "default": "./dist/theme-manifest.js"
+    },
+    "./theme-schemes": {
+      "bun": "./src/theme-schemes.ts",
+      "types": "./dist/theme-schemes.d.ts",
+      "import": "./dist/theme-schemes.js",
+      "default": "./dist/theme-schemes.js"
     }
   },
   "files": [