@akinon/pz-theme 2.0.88-rc.0 → 2.0.89-beta.0

package/CHANGELOG.md

@@ -1,38 +1,20 @@
 # @akinon/pz-theme
 
-## 2.0.88-rc.0
-
-### Patch Changes
-
-- Updated dependencies [86187b1c]
-- Updated dependencies [0cf9ea239]
-- Updated dependencies [324f97d55]
-- Updated dependencies [51ea06888]
-- Updated dependencies
-- Updated dependencies [2fea41430]
-- Updated dependencies [b55acb768]
-- Updated dependencies [760258c1c]
-- Updated dependencies [143be2b9d]
-- Updated dependencies [7889b08fe]
-- Updated dependencies [9f8cd3bc5]
-- Updated dependencies [bfafa3f49]
-- Updated dependencies [57d7eb305]
-- Updated dependencies [d99a6a7d5]
-- Updated dependencies [9db81a714]
-- Updated dependencies [591e345e1]
-- Updated dependencies [4de5303c5]
-- Updated dependencies [95b139dc1]
-- Updated dependencies [1d00f2d06]
-- Updated dependencies [4ac7b2a1e]
-- Updated dependencies [e9598c71d]
-- Updated dependencies [4998a9631]
-- Updated dependencies [804d2bd6c]
-- Updated dependencies [3909d3224]
-- Updated dependencies [6a3d8a631]
-- Updated dependencies [e18836b20]
-- Updated dependencies [b1111d7b]
-  - @akinon/next@2.0.88-rc.0
-  - @akinon/theme-contract@2.0.88-rc.0
+## 2.0.89-beta.0
+
+### Patch Changes
+
+- Updated dependencies [cbbbfd757]
+  - @akinon/next@2.0.89-beta.0
+  - @akinon/theme-contract@2.0.89-beta.0
+
+## 2.0.88
+
+### Patch Changes
+
+- c871a38a: ZERO-4903: Add a brand search-term transform hook to the search box Merchandiser synonym/typo tables are brand data
+  - @akinon/next@2.0.88
+  - @akinon/theme-contract@2.0.88
 
 ## 2.0.87
 

package/package.json

@@ -1,26 +1,26 @@
 {
   "name": "@akinon/pz-theme",
   "description": "Theme package for Project Zero Next — ThemePlaceholder system and theme editor infrastructure",
-  "version": "2.0.88-rc.0",
+  "version": "2.0.89-beta.0",
   "license": "MIT",
   "main": "src/index.ts",
   "scripts": {
     "test": "jest"
   },
   "peerDependencies": {
-    "@akinon/next": "2.0.88-rc.0",
+    "@akinon/next": "2.0.89-beta.0",
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "dependencies": {
-    "@akinon/theme-contract": "2.0.88-rc.0",
+    "@akinon/theme-contract": "2.0.89-beta.0",
     "clsx": "2.1.1",
     "lottie-web": "^5.13.0",
     "tailwind-merge": "^2.5.4",
     "zod": "4.4.1"
   },
   "devDependencies": {
-    "@akinon/next": "2.0.88-rc.0",
+    "@akinon/next": "2.0.89-beta.0",
     "@testing-library/jest-dom": "5.16.4",
     "@testing-library/react": "16.3.2",
     "@testing-library/user-event": "14.1.1",

package/src/blocks/search-box-block.tsx

@@ -4,6 +4,7 @@ import React, { useRef, useState } from 'react';
 import { useRouter } from 'next/navigation';
 import { getResponsiveValue, partAttrs, resolveForceOpen } from '../utils';
 import { emitCommerceEvent } from '../utils/analytics';
+import { applySearchTermTransform } from '../utils/search-transform';
 import { useOverlay } from '../hooks/use-overlay';
 import ThemeBlock from '../theme-block';
 import { BlockRendererProps } from './block-renderer-registry';
@@ -183,7 +184,9 @@ const SearchBoxBlock = ({
 
   const submit = (event: React.FormEvent) => {
     event.preventDefault();
-    const value = term.trim();
+    // The brand's synonym/typo transform (ZERO-4903) rewrites the query the
+    // way the merchandiser's table says before anything runs or reports it.
+    const value = applySearchTermTransform(term.trim());
     if (!value || isDesigner) return;
     emitCommerceEvent('search', { searchTerm: value });
     const separator = searchUrl.includes('?') ? '&' : '?';

package/src/utils/__tests__/search-transform.test.ts

@@ -0,0 +1,34 @@
+import {
+  __resetSearchTermTransformForTests,
+  applySearchTermTransform,
+  registerSearchTermTransform
+} from '../search-transform';
+
+describe('search term transform registry (ZERO-4903)', () => {
+  afterEach(() => __resetSearchTermTransformForTests());
+
+  it('is the identity when no brand registered', () => {
+    expect(applySearchTermTransform('spka')).toBe('spka');
+  });
+
+  it('runs the registered transform and can unregister it', () => {
+    const detach = registerSearchTermTransform((text) =>
+      text.replace('spka', 'şapka')
+    );
+    expect(applySearchTermTransform('spka')).toBe('şapka');
+
+    detach();
+    expect(applySearchTermTransform('spka')).toBe('spka');
+  });
+
+  it('falls back to the input when the transform throws or empties', () => {
+    registerSearchTermTransform(() => {
+      throw new Error('brand bug');
+    });
+    expect(applySearchTermTransform('polo')).toBe('polo');
+
+    __resetSearchTermTransformForTests();
+    registerSearchTermTransform(() => '');
+    expect(applySearchTermTransform('polo')).toBe('polo');
+  });
+});

package/src/utils/search-transform.ts

@@ -0,0 +1,42 @@
+/**
+ * Brand hook for search-term rewriting (ZERO-4903).
+ *
+ * Merchandisers maintain synonym/typo tables ("spka" → "şapka") that the
+ * query must pass through BEFORE it is searched — but the table's source and
+ * matching rules are brand decisions, so the composed search box never learns
+ * them. A brand registers one transform from its own code (the same ownership
+ * pattern as the analytics bridge), and the search-box block runs every
+ * submitted query through it. No registration means identity: stores without
+ * a table keep exactly today's behavior.
+ */
+
+type SearchTermTransform = (text: string) => string;
+
+let transform: SearchTermTransform | null = null;
+
+/** Register the brand's transform. Returns an unregister function. */
+export const registerSearchTermTransform = (
+  fn: SearchTermTransform
+): (() => void) => {
+  transform = fn;
+  return () => {
+    if (transform === fn) transform = null;
+  };
+};
+
+/** The query the search should run — the input itself when no brand hooked in
+ * or the transform throws (a brand bug must never break search). */
+export const applySearchTermTransform = (text: string): string => {
+  if (!transform) return text;
+  try {
+    const result = transform(text);
+    return typeof result === 'string' && result.length > 0 ? result : text;
+  } catch {
+    return text;
+  }
+};
+
+/** Test-only: reset the registry between cases. */
+export const __resetSearchTermTransformForTests = (): void => {
+  transform = null;
+};