@shoppexio/builder-runtime 0.1.5 → 0.1.6

package/dist/block-settings.d.ts

@@ -0,0 +1,10 @@
+export type BlockSettingsRecord = Record<string, unknown>;
+/**
+ * Manifest fields use scoped keys (`faq.items`). Legacy block code often read short keys (`items`).
+ * Builder persists the manifest path on `block.settings[event.path]`.
+ */
+export declare function blockSettingLookupKeys(blockType: string, shortKey: string): string[];
+export declare function readBlockStringSetting(settings: BlockSettingsRecord, keys: string | readonly string[], fallback?: string | null): string | null;
+export declare function readBlockArraySetting<T>(settings: BlockSettingsRecord, keys: string | readonly string[]): T[] | null;
+export declare function preferNonEmptyBlockList<T>(primary: T[] | null, fallback: T[] | null | undefined): T[];
+//# sourceMappingURL=block-settings.d.ts.map

package/dist/block-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-settings.d.ts","sourceRoot":"","sources":["../src/block-settings.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1D;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAMpF;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,mBAAmB,EAC7B,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,EAChC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GACvB,MAAM,GAAG,IAAI,CASf;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,QAAQ,EAAE,mBAAmB,EAC7B,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAC/B,CAAC,EAAE,GAAG,IAAI,CASZ;AAED,wBAAgB,uBAAuB,CAAC,CAAC,EACvC,OAAO,EAAE,CAAC,EAAE,GAAG,IAAI,EACnB,QAAQ,EAAE,CAAC,EAAE,GAAG,IAAI,GAAG,SAAS,GAC/B,CAAC,EAAE,CAIL"}

package/dist/block-settings.js

@@ -0,0 +1,39 @@
+import { resolveManifestSettingRecordValue } from './manifest-setting-paths.js';
+/**
+ * Manifest fields use scoped keys (`faq.items`). Legacy block code often read short keys (`items`).
+ * Builder persists the manifest path on `block.settings[event.path]`.
+ */
+export function blockSettingLookupKeys(blockType, shortKey) {
+    const scopedKey = `${blockType}.${shortKey}`;
+    if (scopedKey === shortKey) {
+        return [shortKey];
+    }
+    return [scopedKey, shortKey];
+}
+export function readBlockStringSetting(settings, keys, fallback) {
+    const candidates = typeof keys === 'string' ? [keys] : keys;
+    for (const key of candidates) {
+        const resolved = resolveManifestSettingRecordValue(settings, key);
+        if (typeof resolved === 'string') {
+            return resolved;
+        }
+    }
+    return fallback ?? null;
+}
+export function readBlockArraySetting(settings, keys) {
+    const candidates = typeof keys === 'string' ? [keys] : keys;
+    for (const key of candidates) {
+        const resolved = resolveManifestSettingRecordValue(settings, key);
+        if (Array.isArray(resolved)) {
+            return resolved;
+        }
+    }
+    return null;
+}
+export function preferNonEmptyBlockList(primary, fallback) {
+    if (primary && primary.length > 0)
+        return primary;
+    if (fallback && fallback.length > 0)
+        return fallback;
+    return primary ?? fallback ?? [];
+}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from './manifest-setting-paths.js';
+export * from './block-settings.js';
 export * from './preview-fixtures.js';
 export * from './product-page.js';
 export * from './standard-product-page.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,kCAAkC,EAAE,MAAM,4BAA4B,CAAC;AAChF,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,kCAAkC,EAAE,MAAM,4BAA4B,CAAC;AAChF,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -1,4 +1,5 @@
 export * from './manifest-setting-paths.js';
+export * from './block-settings.js';
 export * from './preview-fixtures.js';
 export * from './product-page.js';
 export * from './standard-product-page.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shoppexio/builder-runtime",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "Theme-side Builder v2 runtime helpers for Shoppex storefront themes",
   "type": "module",
   "repository": {

package/src/block-settings.test.ts

@@ -0,0 +1,66 @@
+import { describe, expect, it } from 'vitest';
+import {
+  blockSettingLookupKeys,
+  preferNonEmptyBlockList,
+  readBlockArraySetting,
+  readBlockStringSetting,
+} from './block-settings.js';
+
+describe('block-settings', () => {
+  it('builds scoped and short lookup keys for block types', () => {
+    expect(blockSettingLookupKeys('faq', 'items')).toEqual(['faq.items', 'items']);
+    expect(blockSettingLookupKeys('hero', 'title')).toEqual(['hero.title', 'title']);
+  });
+
+  it('reads list settings from manifest-scoped block keys', () => {
+    const settings = {
+      'faq.items': [{ question: 'Q1', answer: 'A1' }],
+    };
+
+    expect(
+      readBlockArraySetting<{ question: string; answer: string }>(
+        settings,
+        blockSettingLookupKeys('faq', 'items'),
+      ),
+    ).toEqual([{ question: 'Q1', answer: 'A1' }]);
+  });
+
+  it('falls back to short keys when legacy data used items only', () => {
+    const settings = {
+      items: [{ question: 'Legacy', answer: 'Still works' }],
+    };
+
+    expect(
+      readBlockArraySetting<{ question: string; answer: string }>(
+        settings,
+        blockSettingLookupKeys('faq', 'items'),
+      ),
+    ).toEqual([{ question: 'Legacy', answer: 'Still works' }]);
+  });
+
+  it('reads string settings from scoped manifest keys', () => {
+    const settings = {
+      'faq.title': 'Help center',
+    };
+
+    expect(
+      readBlockStringSetting(settings, blockSettingLookupKeys('faq', 'title'), 'Default'),
+    ).toBe('Help center');
+  });
+
+  it('prefers non-empty primary lists over fallbacks', () => {
+    expect(
+      preferNonEmptyBlockList(
+        [{ question: 'Block', answer: 'A' }],
+        [{ question: 'Content', answer: 'B' }],
+      ),
+    ).toEqual([{ question: 'Block', answer: 'A' }]);
+
+    expect(
+      preferNonEmptyBlockList(
+        [],
+        [{ question: 'Content', answer: 'B' }],
+      ),
+    ).toEqual([{ question: 'Content', answer: 'B' }]);
+  });
+});

package/src/block-settings.ts

@@ -0,0 +1,53 @@
+import { resolveManifestSettingRecordValue } from './manifest-setting-paths.js';
+
+export type BlockSettingsRecord = Record<string, unknown>;
+
+/**
+ * Manifest fields use scoped keys (`faq.items`). Legacy block code often read short keys (`items`).
+ * Builder persists the manifest path on `block.settings[event.path]`.
+ */
+export function blockSettingLookupKeys(blockType: string, shortKey: string): string[] {
+  const scopedKey = `${blockType}.${shortKey}`;
+  if (scopedKey === shortKey) {
+    return [shortKey];
+  }
+  return [scopedKey, shortKey];
+}
+
+export function readBlockStringSetting(
+  settings: BlockSettingsRecord,
+  keys: string | readonly string[],
+  fallback?: string | null,
+): string | null {
+  const candidates = typeof keys === 'string' ? [keys] : keys;
+  for (const key of candidates) {
+    const resolved = resolveManifestSettingRecordValue(settings, key);
+    if (typeof resolved === 'string') {
+      return resolved;
+    }
+  }
+  return fallback ?? null;
+}
+
+export function readBlockArraySetting<T>(
+  settings: BlockSettingsRecord,
+  keys: string | readonly string[],
+): T[] | null {
+  const candidates = typeof keys === 'string' ? [keys] : keys;
+  for (const key of candidates) {
+    const resolved = resolveManifestSettingRecordValue(settings, key);
+    if (Array.isArray(resolved)) {
+      return resolved as T[];
+    }
+  }
+  return null;
+}
+
+export function preferNonEmptyBlockList<T>(
+  primary: T[] | null,
+  fallback: T[] | null | undefined,
+): T[] {
+  if (primary && primary.length > 0) return primary;
+  if (fallback && fallback.length > 0) return fallback;
+  return primary ?? fallback ?? [];
+}

package/src/index.ts

@@ -1,4 +1,5 @@
 export * from './manifest-setting-paths.js';
+export * from './block-settings.js';
 export * from './preview-fixtures.js';
 export * from './product-page.js';
 export * from './standard-product-page.js';