@zalkera/client 0.14.0 → 0.15.0

package/dist/index.d.cts

@@ -949,7 +949,7 @@ declare class ZalkeraError extends Error {
  * 이 패키지는 그 방언을 읽는 헬퍼([asHandle]·[asHandleArray]·[assetPath]·[readConfig])를 실어 나른다.
  * 그래서 아래 `SECTION_CONTRACT` 리터럴은 rev 3 과 **바이트 동일**하다(동기 스크립트가 확인한다).
  */
-declare const SECTION_CONTRACT_REV = 4;
+declare const SECTION_CONTRACT_REV = 5;
 /** 업종 분류 — 콘솔 섹션 픽커의 그룹핑에 쓴다(테넌트 업종 필드는 아직 없다·memo102 §5). */
 type SectionVertical = "BEAUTY" | "GENERAL";
 interface SectionSpec {
@@ -972,6 +972,17 @@ interface SectionSpec {
      * **필수성의 집행 지점은 팩/시드뿐이다** — 런타임은 그대로 관용이다(렌더러 스킵·콘솔 raw 편집 허용).
      */
     readonly requiredRefs: readonly string[];
+    /**
+     * **참조 그룹**(rev 5) — 각 그룹에서 **하나 이상**이 채워져야 한다.
+     *
+     * rev 3 은 필수성을 키 하나(`productIds`)에 걸었는데, rev 5 에서 갈래 참조(`categorySlug`)가 같은
+     * 역할을 하게 되면서 필수의 단위가 **"참조 존재"**로 옮겨갔다. 막으려는 것은 그대로다 — 아무것도
+     * 안 가리킨 채 시드에 들어와 개시 직후 조용히 사라지는 섹션.
+     *
+     * `requiredRefs`(무조건 필수)와 **함께** 쓴다: 그룹으로 표현되는 섹션은 `requiredRefs` 가 빈 배열이고,
+     * 종전처럼 단일 키가 무조건 필수인 섹션은 이 필드가 빈 배열이다. 둘 다 빈 배열이면 참조 요구가 없다.
+     */
+    readonly requiredRefsAnyOf: readonly (readonly string[])[];
 }
 /**
  * 아는 섹션 전량. **순서는 콘솔 픽커의 노출 순서**(관행 아크: 주목→가치→신뢰→행동).
@@ -985,62 +996,74 @@ declare const SECTION_CONTRACT: readonly [{
     readonly type: "SERVICE_MENU";
     readonly vertical: "BEAUTY";
     readonly jsonLd: "ItemList";
-    readonly requiredRefs: readonly ["productIds"];
+    readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [readonly ["productIds", "categorySlug"]];
 }, {
     readonly type: "BEFORE_AFTER_GALLERY";
     readonly vertical: "BEAUTY";
     readonly jsonLd: null;
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }, {
     readonly type: "BOOKING_CTA";
     readonly vertical: "BEAUTY";
     readonly jsonLd: null;
-    readonly requiredRefs: readonly ["productId"];
+    readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [readonly ["productId", "categorySlug"]];
 }, {
     readonly type: "DOCTOR_INTRO";
     readonly vertical: "BEAUTY";
     readonly jsonLd: null;
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }, {
     readonly type: "HERO";
     readonly vertical: "GENERAL";
     readonly jsonLd: null;
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }, {
     readonly type: "FEATURE_GRID";
     readonly vertical: "GENERAL";
     readonly jsonLd: null;
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }, {
     readonly type: "TEXT_MEDIA";
     readonly vertical: "GENERAL";
     readonly jsonLd: null;
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }, {
     readonly type: "LOGO_WALL";
     readonly vertical: "GENERAL";
     readonly jsonLd: null;
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }, {
     readonly type: "STATS_BAND";
     readonly vertical: "GENERAL";
     readonly jsonLd: null;
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }, {
     readonly type: "TESTIMONIALS";
     readonly vertical: "GENERAL";
     readonly jsonLd: null;
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }, {
     readonly type: "FAQ_LIST";
     readonly vertical: "GENERAL";
     readonly jsonLd: "FAQPage";
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }, {
     readonly type: "LEAD_CTA";
     readonly vertical: "GENERAL";
     readonly jsonLd: null;
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }];
 /** 지금 렌더러가 아는 섹션 타입. 이 밖의 값이 와도 정상이다(스킵). */
 type KnownSectionType = (typeof SECTION_CONTRACT)[number]["type"];

package/dist/index.d.ts

@@ -949,7 +949,7 @@ declare class ZalkeraError extends Error {
  * 이 패키지는 그 방언을 읽는 헬퍼([asHandle]·[asHandleArray]·[assetPath]·[readConfig])를 실어 나른다.
  * 그래서 아래 `SECTION_CONTRACT` 리터럴은 rev 3 과 **바이트 동일**하다(동기 스크립트가 확인한다).
  */
-declare const SECTION_CONTRACT_REV = 4;
+declare const SECTION_CONTRACT_REV = 5;
 /** 업종 분류 — 콘솔 섹션 픽커의 그룹핑에 쓴다(테넌트 업종 필드는 아직 없다·memo102 §5). */
 type SectionVertical = "BEAUTY" | "GENERAL";
 interface SectionSpec {
@@ -972,6 +972,17 @@ interface SectionSpec {
      * **필수성의 집행 지점은 팩/시드뿐이다** — 런타임은 그대로 관용이다(렌더러 스킵·콘솔 raw 편집 허용).
      */
     readonly requiredRefs: readonly string[];
+    /**
+     * **참조 그룹**(rev 5) — 각 그룹에서 **하나 이상**이 채워져야 한다.
+     *
+     * rev 3 은 필수성을 키 하나(`productIds`)에 걸었는데, rev 5 에서 갈래 참조(`categorySlug`)가 같은
+     * 역할을 하게 되면서 필수의 단위가 **"참조 존재"**로 옮겨갔다. 막으려는 것은 그대로다 — 아무것도
+     * 안 가리킨 채 시드에 들어와 개시 직후 조용히 사라지는 섹션.
+     *
+     * `requiredRefs`(무조건 필수)와 **함께** 쓴다: 그룹으로 표현되는 섹션은 `requiredRefs` 가 빈 배열이고,
+     * 종전처럼 단일 키가 무조건 필수인 섹션은 이 필드가 빈 배열이다. 둘 다 빈 배열이면 참조 요구가 없다.
+     */
+    readonly requiredRefsAnyOf: readonly (readonly string[])[];
 }
 /**
  * 아는 섹션 전량. **순서는 콘솔 픽커의 노출 순서**(관행 아크: 주목→가치→신뢰→행동).
@@ -985,62 +996,74 @@ declare const SECTION_CONTRACT: readonly [{
     readonly type: "SERVICE_MENU";
     readonly vertical: "BEAUTY";
     readonly jsonLd: "ItemList";
-    readonly requiredRefs: readonly ["productIds"];
+    readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [readonly ["productIds", "categorySlug"]];
 }, {
     readonly type: "BEFORE_AFTER_GALLERY";
     readonly vertical: "BEAUTY";
     readonly jsonLd: null;
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }, {
     readonly type: "BOOKING_CTA";
     readonly vertical: "BEAUTY";
     readonly jsonLd: null;
-    readonly requiredRefs: readonly ["productId"];
+    readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [readonly ["productId", "categorySlug"]];
 }, {
     readonly type: "DOCTOR_INTRO";
     readonly vertical: "BEAUTY";
     readonly jsonLd: null;
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }, {
     readonly type: "HERO";
     readonly vertical: "GENERAL";
     readonly jsonLd: null;
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }, {
     readonly type: "FEATURE_GRID";
     readonly vertical: "GENERAL";
     readonly jsonLd: null;
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }, {
     readonly type: "TEXT_MEDIA";
     readonly vertical: "GENERAL";
     readonly jsonLd: null;
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }, {
     readonly type: "LOGO_WALL";
     readonly vertical: "GENERAL";
     readonly jsonLd: null;
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }, {
     readonly type: "STATS_BAND";
     readonly vertical: "GENERAL";
     readonly jsonLd: null;
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }, {
     readonly type: "TESTIMONIALS";
     readonly vertical: "GENERAL";
     readonly jsonLd: null;
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }, {
     readonly type: "FAQ_LIST";
     readonly vertical: "GENERAL";
     readonly jsonLd: "FAQPage";
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }, {
     readonly type: "LEAD_CTA";
     readonly vertical: "GENERAL";
     readonly jsonLd: null;
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }];
 /** 지금 렌더러가 아는 섹션 타입. 이 밖의 값이 와도 정상이다(스킵). */
 type KnownSectionType = (typeof SECTION_CONTRACT)[number]["type"];

package/dist/index.js

@@ -290,7 +290,7 @@ function safeJsonParse(text) {
 }
 
 // src/sections.ts
-var SECTION_CONTRACT_REV = 4;
+var SECTION_CONTRACT_REV = 5;
 var SECTION_CONTRACT = [
   // 뷰티(memo47) — append-only 계약상 불변
   // SERVICE_MENU 의 ItemList 는 rev 2 에서 올라왔다(memo119 T6-ⓒ): 쇼핑몰 유형엔 상품 목록 표면을
@@ -298,19 +298,19 @@ var SECTION_CONTRACT = [
   // 정위치는 별도 라우트가 아니라 홈의 이 섹션이라, FAQ_LIST→FAQPage 와 같은 형태로 섹션이 직접 낸다.
   // rev 3 에서 productIds 의 `?` 가 떨어졌다 — 목록을 내겠다고 선언한 섹션이 목록을 안 가리키는 상태가
   // 계약상 성립하지 않게 됐다(BOOKING_CTA.productId 는 rev 1 부터 필수였다·비대칭 해소).
-  { type: "SERVICE_MENU", vertical: "BEAUTY", jsonLd: "ItemList", requiredRefs: ["productIds"] },
-  { type: "BEFORE_AFTER_GALLERY", vertical: "BEAUTY", jsonLd: null, requiredRefs: [] },
-  { type: "BOOKING_CTA", vertical: "BEAUTY", jsonLd: null, requiredRefs: ["productId"] },
-  { type: "DOCTOR_INTRO", vertical: "BEAUTY", jsonLd: null, requiredRefs: [] },
+  { type: "SERVICE_MENU", vertical: "BEAUTY", jsonLd: "ItemList", requiredRefs: [], requiredRefsAnyOf: [["productIds", "categorySlug"]] },
+  { type: "BEFORE_AFTER_GALLERY", vertical: "BEAUTY", jsonLd: null, requiredRefs: [], requiredRefsAnyOf: [] },
+  { type: "BOOKING_CTA", vertical: "BEAUTY", jsonLd: null, requiredRefs: [], requiredRefsAnyOf: [["productId", "categorySlug"]] },
+  { type: "DOCTOR_INTRO", vertical: "BEAUTY", jsonLd: null, requiredRefs: [], requiredRefsAnyOf: [] },
   // 기업 마케팅(memo102 §2)
-  { type: "HERO", vertical: "GENERAL", jsonLd: null, requiredRefs: [] },
-  { type: "FEATURE_GRID", vertical: "GENERAL", jsonLd: null, requiredRefs: [] },
-  { type: "TEXT_MEDIA", vertical: "GENERAL", jsonLd: null, requiredRefs: [] },
-  { type: "LOGO_WALL", vertical: "GENERAL", jsonLd: null, requiredRefs: [] },
-  { type: "STATS_BAND", vertical: "GENERAL", jsonLd: null, requiredRefs: [] },
-  { type: "TESTIMONIALS", vertical: "GENERAL", jsonLd: null, requiredRefs: [] },
-  { type: "FAQ_LIST", vertical: "GENERAL", jsonLd: "FAQPage", requiredRefs: [] },
-  { type: "LEAD_CTA", vertical: "GENERAL", jsonLd: null, requiredRefs: [] }
+  { type: "HERO", vertical: "GENERAL", jsonLd: null, requiredRefs: [], requiredRefsAnyOf: [] },
+  { type: "FEATURE_GRID", vertical: "GENERAL", jsonLd: null, requiredRefs: [], requiredRefsAnyOf: [] },
+  { type: "TEXT_MEDIA", vertical: "GENERAL", jsonLd: null, requiredRefs: [], requiredRefsAnyOf: [] },
+  { type: "LOGO_WALL", vertical: "GENERAL", jsonLd: null, requiredRefs: [], requiredRefsAnyOf: [] },
+  { type: "STATS_BAND", vertical: "GENERAL", jsonLd: null, requiredRefs: [], requiredRefsAnyOf: [] },
+  { type: "TESTIMONIALS", vertical: "GENERAL", jsonLd: null, requiredRefs: [], requiredRefsAnyOf: [] },
+  { type: "FAQ_LIST", vertical: "GENERAL", jsonLd: "FAQPage", requiredRefs: [], requiredRefsAnyOf: [] },
+  { type: "LEAD_CTA", vertical: "GENERAL", jsonLd: null, requiredRefs: [], requiredRefsAnyOf: [] }
 ];
 function sectionsOfVertical(vertical) {
   return SECTION_CONTRACT.filter((s) => s.vertical === vertical);