@spintax/core 0.3.0 → 0.3.1

package/dist/index.d.cts

@@ -81,7 +81,7 @@ interface PluralIssue {
  * (which injects a fixture's `rng` strategy). Keeping the rng a parameter is what
  * lets the deterministic parity fixtures assert exact output.
  *
- * Order: strip stray sentinels → collapse-once #set + tree-walk (+ #include) →
+ * Order: strip stray sentinels → build vars, roll #def, tree-walk (+ #include) →
  * cosmetic post-process (if on) → mandatory neutralize safety-restore (always).
  */
 

package/dist/index.d.ts

@@ -81,7 +81,7 @@ interface PluralIssue {
  * (which injects a fixture's `rng` strategy). Keeping the rng a parameter is what
  * lets the deterministic parity fixtures assert exact output.
  *
- * Order: strip stray sentinels → collapse-once #set + tree-walk (+ #include) →
+ * Order: strip stray sentinels → build vars, roll #def, tree-walk (+ #include) →
  * cosmetic post-process (if on) → mandatory neutralize safety-restore (always).
  */
 

package/dist/index.js

@@ -21,13 +21,38 @@ function isParsedAst(value) {
   return typeof value === "object" && value !== null && value.astVersion === AST_VERSION && typeof value.source === "string" && Array.isArray(value.nodes);
 }
 
+// src/internal/neutralize.ts
+var STRUCTURAL = ["{", "}", "[", "]", "%", "#"];
+var SENTINEL_BASE = 57344;
+var SHIELD = /* @__PURE__ */ new Map();
+var RESTORE = /* @__PURE__ */ new Map();
+STRUCTURAL.forEach((ch, i) => {
+  const sentinel = String.fromCharCode(SENTINEL_BASE + i);
+  SHIELD.set(ch, sentinel);
+  RESTORE.set(sentinel, ch);
+});
+var SHIELD_RE = /[{}[\]%#]/gu;
+var RESTORE_RE = new RegExp(
+  `[${String.fromCharCode(SENTINEL_BASE)}-${String.fromCharCode(SENTINEL_BASE + STRUCTURAL.length - 1)}]`,
+  "gu"
+);
+function neutralize(value) {
+  return value.replace(SHIELD_RE, (ch) => SHIELD.get(ch) ?? ch);
+}
+function safetyRestore(text) {
+  return text.replace(RESTORE_RE, (ch) => RESTORE.get(ch) ?? ch);
+}
+function stripSentinels(text) {
+  return text.replace(RESTORE_RE, "");
+}
+
 // src/internal/parser.ts
 var VARIABLE_RE = /^%(\w+)%/;
 var DIRECTIVE_RE = /^[ \t]*#(set|def)[ \t]+%(\w+)%[ \t]*=[ \t]*(.*?)[ \t]*\r?$/gmu;
 var CONDITIONAL_NAME_RE = /^[A-Za-z_]\w*/;
 var PLURAL_PREFIX = "plural ";
 function parseTemplate(src) {
-  const { body, setDefs, defDefs } = extractDirectives(stripComments(src));
+  const { body, setDefs, defDefs } = extractDirectives(stripComments(stripSentinels(src)));
   return { astVersion: AST_VERSION, source: src, setDefs, defDefs, nodes: parseSequence(body) };
 }
 function extractDirectives(text) {
@@ -700,31 +725,6 @@ var NotImplementedError = class extends SpintaxError {
   }
 };
 
-// src/internal/neutralize.ts
-var STRUCTURAL = ["{", "}", "[", "]", "%", "#"];
-var SENTINEL_BASE = 57344;
-var SHIELD = /* @__PURE__ */ new Map();
-var RESTORE = /* @__PURE__ */ new Map();
-STRUCTURAL.forEach((ch, i) => {
-  const sentinel = String.fromCharCode(SENTINEL_BASE + i);
-  SHIELD.set(ch, sentinel);
-  RESTORE.set(sentinel, ch);
-});
-var SHIELD_RE = /[{}[\]%#]/gu;
-var RESTORE_RE = new RegExp(
-  `[${String.fromCharCode(SENTINEL_BASE)}-${String.fromCharCode(SENTINEL_BASE + STRUCTURAL.length - 1)}]`,
-  "gu"
-);
-function neutralize(value) {
-  return value.replace(SHIELD_RE, (ch) => SHIELD.get(ch) ?? ch);
-}
-function safetyRestore(text) {
-  return text.replace(RESTORE_RE, (ch) => RESTORE.get(ch) ?? ch);
-}
-function stripSentinels(text) {
-  return text.replace(RESTORE_RE, "");
-}
-
 // src/internal/render.ts
 var MAX_VARIABLE_DEPTH = 50;
 var INCLUDE_LINE_RE = /^[ \t]*#include[ \t\n\r\f\x0B]+"([^"]+)"[ \t\n\r\f\x0B]*$/gmu;
@@ -751,7 +751,7 @@ function resolveIncludes(text, ctx) {
       throw new IncludeResolverError(`includeResolver threw for "${ref}"`, { cause });
     }
     if (included === null) return "";
-    return renderAst(parseTemplate(stripSentinels(included)), {
+    return renderAst(parseTemplate(included), {
       ...ctx,
       runtimeContext: ctx.runtimeContext,
       // child inherits runtime, not parent #set
@@ -877,7 +877,7 @@ function renderPlural(node, opts) {
   if (/[{}[\]]/u.test(formsRaw)) {
     report({
       code: "plural.nested-brackets",
-      message: "Plural form slot contains nested spintax brackets; extract via #set first.",
+      message: "Plural form slot contains nested spintax brackets; extract via #def first \u2014 a #set is substituted verbatim and would put the brackets straight back.",
       construct: rawConstruct(countRaw, formsRaw),
       locale: base
     });
@@ -1111,7 +1111,7 @@ function renderWith(input, rng, opts = {}) {
     includeStack: [],
     onPluralError: opts.onPluralError
   };
-  const ast = resolveAst(typeof input === "string" ? stripSentinels(input) : input);
+  const ast = resolveAst(input);
   let out = renderAst(ast, ctx);
   if (opts.postProcess !== false) out = postProcess(out);
   return safetyRestore(out);