@shoppexio/builder-runtime 0.1.5 → 0.1.7

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/builder-nav-href.d.ts

@@ -0,0 +1,6 @@
+import type { MouseEvent } from 'react';
+export declare function resolveBuilderNavHref(value: string | undefined | null, fallback: string): string;
+export declare function isHashBuilderNavHref(href: string): boolean;
+export declare function isInternalBuilderNavHref(href: string): boolean;
+export declare function handleBuilderHashNavClick(event: MouseEvent<HTMLAnchorElement>, href: string): void;
+//# sourceMappingURL=builder-nav-href.d.ts.map

package/dist/builder-nav-href.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder-nav-href.d.ts","sourceRoot":"","sources":["../src/builder-nav-href.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAExC,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAChC,QAAQ,EAAE,MAAM,GACf,MAAM,CAGR;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,UAAU,CAAC,iBAAiB,CAAC,EACpC,IAAI,EAAE,MAAM,GACX,IAAI,CAiBN"}

package/dist/builder-nav-href.js

@@ -0,0 +1,25 @@
+export function resolveBuilderNavHref(value, fallback) {
+    const trimmed = typeof value === 'string' ? value.trim() : '';
+    return trimmed.length > 0 ? trimmed : fallback;
+}
+export function isHashBuilderNavHref(href) {
+    return href.startsWith('#');
+}
+export function isInternalBuilderNavHref(href) {
+    return href.startsWith('/') && !href.startsWith('//');
+}
+export function handleBuilderHashNavClick(event, href) {
+    if (!isHashBuilderNavHref(href)) {
+        return;
+    }
+    const id = href.slice(1);
+    if (!id) {
+        return;
+    }
+    const target = document.getElementById(id);
+    if (!target) {
+        return;
+    }
+    event.preventDefault();
+    target.scrollIntoView({ behavior: 'smooth', block: 'start' });
+}

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';
@@ -13,4 +14,5 @@ export * from './style-slots.js';
 export * from './block-style-settings.js';
 export * from './preview-mode.js';
 export * from './youtube.js';
+export * from './builder-nav-href.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,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;AAC7B,cAAc,uBAAuB,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';
@@ -13,3 +14,4 @@ export * from './style-slots.js';
 export * from './block-style-settings.js';
 export * from './preview-mode.js';
 export * from './youtube.js';
+export * from './builder-nav-href.js';

package/dist/react.d.ts

@@ -1,6 +1,7 @@
 import type { BlockInstance, BuilderSettings, Breakpoint, StyleSlotId } from '@shoppex/builder-contracts';
 import { type ComponentPropsWithoutRef, type ComponentType, type ElementType, type ReactNode } from 'react';
 import { type BuilderAttributeMap } from './attributes.js';
+export { handleBuilderHashNavClick, isHashBuilderNavHref, isInternalBuilderNavHref, resolveBuilderNavHref, } from './builder-nav-href.js';
 type BuilderRuntimeContextValue = {
     settings: BuilderSettings;
 };

package/dist/react.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"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"}

package/dist/react.js

@@ -9,6 +9,7 @@ import { builderBlock } from './attributes.js';
 import { getPageBlocks, getPageLayout, getVisiblePageBlocks } from './layout.js';
 import { getNavigationHeaderSettings, resolveSearchBarSettings, } from './search-bar-settings.js';
 import { resolveStyleSlotValue } from './style-slots.js';
+export { handleBuilderHashNavClick, isHashBuilderNavHref, isInternalBuilderNavHref, resolveBuilderNavHref, } from './builder-nav-href.js';
 const BUILDER_SETTINGS_WINDOW_KEY = '__SHOPPEX_BUILDER_SETTINGS__';
 const BUILDER_STATE_EVENT_NAME = 'shoppex:builder-state';
 const BUILDER_BLOCK_SELECTOR = '[data-builder-block]';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shoppexio/builder-runtime",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "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/builder-nav-href.test.ts

@@ -0,0 +1,20 @@
+import { describe, expect, test } from 'bun:test';
+import {
+  isHashBuilderNavHref,
+  isInternalBuilderNavHref,
+  resolveBuilderNavHref,
+} from './builder-nav-href.js';
+
+describe('builder-nav-href', () => {
+  test('resolveBuilderNavHref uses fallback for empty values', () => {
+    expect(resolveBuilderNavHref(undefined, '/products')).toBe('/products');
+    expect(resolveBuilderNavHref('  ', '/products')).toBe('/products');
+    expect(resolveBuilderNavHref(' /contact ', '/products')).toBe('/contact');
+  });
+
+  test('classifies internal and hash hrefs', () => {
+    expect(isInternalBuilderNavHref('/products')).toBe(true);
+    expect(isInternalBuilderNavHref('//cdn.example.com')).toBe(false);
+    expect(isHashBuilderNavHref('#products')).toBe(true);
+  });
+});

package/src/builder-nav-href.ts

@@ -0,0 +1,39 @@
+import type { MouseEvent } from 'react';
+
+export function resolveBuilderNavHref(
+  value: string | undefined | null,
+  fallback: string,
+): string {
+  const trimmed = typeof value === 'string' ? value.trim() : '';
+  return trimmed.length > 0 ? trimmed : fallback;
+}
+
+export function isHashBuilderNavHref(href: string): boolean {
+  return href.startsWith('#');
+}
+
+export function isInternalBuilderNavHref(href: string): boolean {
+  return href.startsWith('/') && !href.startsWith('//');
+}
+
+export function handleBuilderHashNavClick(
+  event: MouseEvent<HTMLAnchorElement>,
+  href: string,
+): void {
+  if (!isHashBuilderNavHref(href)) {
+    return;
+  }
+
+  const id = href.slice(1);
+  if (!id) {
+    return;
+  }
+
+  const target = document.getElementById(id);
+  if (!target) {
+    return;
+  }
+
+  event.preventDefault();
+  target.scrollIntoView({ behavior: 'smooth', block: 'start' });
+}

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';
@@ -13,3 +14,4 @@ export * from './style-slots.js';
 export * from './block-style-settings.js';
 export * from './preview-mode.js';
 export * from './youtube.js';
+export * from './builder-nav-href.js';

package/src/react.tsx

@@ -37,6 +37,12 @@ import {
   resolveSearchBarSettings,
 } from './search-bar-settings.js';
 import { resolveStyleSlotValue } from './style-slots.js';
+export {
+  handleBuilderHashNavClick,
+  isHashBuilderNavHref,
+  isInternalBuilderNavHref,
+  resolveBuilderNavHref,
+} from './builder-nav-href.js';
 
 type BuilderRuntimeContextValue = {
   settings: BuilderSettings;