@open-slot-ui/core 0.9.0 → 0.10.0

package/dist/index.d.cts

@@ -1652,6 +1652,10 @@ interface ResponsiveOverride {
 type BlockSpec = {
     /** Rules-audit topics this block covers (see `auditRules`). */
     covers?: string[];
+    /** The declared mode id this block EXPLAINS (e.g. `'bonus'`). Every declared mode
+     *  must have its own rules section — a heading naming it, or blocks tagged with
+     *  `explains` — with real prose; the audit enforces it (see `auditRules`). */
+    explains?: string;
 } & ({
     kind: 'slider';
     id: string;

package/dist/index.d.ts

@@ -1652,6 +1652,10 @@ interface ResponsiveOverride {
 type BlockSpec = {
     /** Rules-audit topics this block covers (see `auditRules`). */
     covers?: string[];
+    /** The declared mode id this block EXPLAINS (e.g. `'bonus'`). Every declared mode
+     *  must have its own rules section — a heading naming it, or blocks tagged with
+     *  `explains` — with real prose; the audit enforces it (see `auditRules`). */
+    explains?: string;
 } & ({
     kind: 'slider';
     id: string;

package/dist/index.js

@@ -1410,6 +1410,9 @@ function validateSpec(spec) {
           return;
         }
         seeId(b.id, `${p}.id`);
+        if (b.explains && b.explains !== "freeSpins" && spec.facts?.modes?.length && !spec.facts.modes.some((m) => m.id === b.explains)) {
+          add("warn", `${p}.explains`, "explains-unknown-mode", `explains "${b.explains}" matches no declared mode id (facts.modes)`);
+        }
         if (b.kind === "select" && (!b.options || b.options.length === 0)) {
           add("error", `${p}.options`, "select-empty", "a select block needs at least one option");
         }
@@ -1762,14 +1765,29 @@ function factsVars(facts, extra) {
   return extra ? { ...vars, ...extra } : vars;
 }
 function scanBlocks(blocks, resolve = (s) => s) {
-  const scan = { text: "", headings: "", covers: /* @__PURE__ */ new Set(), hasModeStats: false, hasLegal: false };
+  const scan = { text: "", headings: "", covers: /* @__PURE__ */ new Set(), hasModeStats: false, hasLegal: false, sections: [] };
+  let section = { heading: "", text: "", explains: /* @__PURE__ */ new Set(), covers: /* @__PURE__ */ new Set() };
+  scan.sections.push(section);
   const addText = (t) => {
-    if (typeof t === "string" && t) scan.text += `
-${resolve(t)}`;
+    if (typeof t === "string" && t) {
+      const r = resolve(t);
+      scan.text += `
+${r}`;
+      section.text += `
+${r}`;
+    }
   };
   const walk = (list) => {
     for (const b of list ?? []) {
-      for (const c of b.covers ?? []) scan.covers.add(c);
+      if (b.kind === "heading" || b.kind === "subheading") {
+        section = { heading: resolve(b.text), text: "", explains: /* @__PURE__ */ new Set(), covers: /* @__PURE__ */ new Set() };
+        scan.sections.push(section);
+      }
+      for (const c of b.covers ?? []) {
+        scan.covers.add(c);
+        section.covers.add(c);
+      }
+      if (b.explains) section.explains.add(b.explains);
       const anyB = b;
       switch (b.kind) {
         case "mode-stats":
@@ -1784,11 +1802,14 @@ ${resolve(t)}`;
           addText(b.text);
           break;
         case "heading":
-        case "subheading":
+        case "subheading": {
+          const r = resolve(b.text);
           scan.headings += `
-${resolve(b.text)}`;
-          addText(b.text);
+${r}`;
+          scan.text += `
+${r}`;
           break;
+        }
         case "text":
           addText(b.text);
           break;
@@ -1857,6 +1878,17 @@ function mentionsTimes(text, x) {
   return new RegExp(`\\b${grouped}${frac}\\s*[x\xD7]`, "i").test(text);
 }
 var mentionsName = (text, name) => text.toLowerCase().includes(name.toLowerCase());
+function mentionsCost(text, cost) {
+  if (mentionsTimes(text, cost) || mentionsTimes(text, cost + 1)) return true;
+  if (cost > 0 && cost < 1) return new RegExp(`\\b${Math.round(cost * 100)}\\s*%`).test(text);
+  return false;
+}
+function findModeSection(sections, m) {
+  return sections.find(
+    (s) => s.explains.has(m.id) || s.covers.has(`feature:${m.id}`) || s.heading !== "" && m.name !== "" && mentionsName(s.heading, m.name) || (m.kind === "base" || !m.kind) && /how to play|about the game/i.test(s.heading)
+  );
+}
+var MIN_SECTION_PROSE = 40;
 function auditRules(facts, rules, opts = {}) {
   const out = [];
   try {
@@ -1877,8 +1909,17 @@ function auditRules(facts, rules, opts = {}) {
       } else if (!(scan.hasModeStats || covered(`maxwin:${m.id}`) || nameIn && mentionsTimes(scan.text, m.maxWinX))) {
         add("required", "rules-missing-maxwin", `maxwin:${m.id}`, `The max win of \u201C${m.name}\u201D (${formatTimes(m.maxWinX)}) is not stated in the rules.`);
       }
-      if (m.kind && m.kind !== "base" && !(covered(`feature:${m.id}`) || nameIn)) {
-        add("required", "rules-missing-feature", `feature:${m.id}`, `The configured feature \u201C${m.name}\u201D is not described in the rules.`);
+      if (!m.id) continue;
+      const sec = findModeSection(scan.sections, m);
+      if (!sec) {
+        add("required", "rules-missing-mode-section", `section:${m.id}`, `\u201C${m.name}\u201D has no rules section of its own \u2014 add a heading naming it (or tag its blocks with explains: "${m.id}") and explain how the mode plays.`);
+      } else {
+        if (sec.text.trim().length < MIN_SECTION_PROSE) {
+          add("required", "rules-mode-section-empty", `section:${m.id}`, `The \u201C${m.name}\u201D section has a heading but no real explanation \u2014 describe how the mode actually plays.`);
+        }
+        if (m.kind && m.kind !== "base" && m.cost != null && !(sec.covers.has(`cost:${m.id}`) || mentionsCost(sec.text, m.cost))) {
+          add("required", "rules-mode-missing-cost", `cost:${m.id}`, `State what \u201C${m.name}\u201D costs (${formatTimes(m.cost)} the bet \u2014 e.g. via {{cost.${m.id}}}) inside its own section.`);
+        }
       }
     }
     const fs = facts?.freeSpins;