webpipe-js 2.0.10 → 2.0.12

package/dist/index.cjs

@@ -25,6 +25,7 @@ __export(index_exports, {
   formatPipelineStep: () => formatPipelineStep,
   formatStepConfig: () => formatStepConfig,
   formatTag: () => formatTag,
+  formatTagExpr: () => formatTagExpr,
   formatTags: () => formatTags,
   formatWhen: () => formatWhen,
   getPipelineRanges: () => getPipelineRanges,
@@ -461,8 +462,29 @@ var Parser = class {
     if (ifStep) return ifStep;
     const dispatchStep = this.tryParse(() => this.parseDispatchStep());
     if (dispatchStep) return dispatchStep;
+    const foreachStep = this.tryParse(() => this.parseForeachStep());
+    if (foreachStep) return foreachStep;
     return this.parseRegularStep();
   }
+  parseForeachStep() {
+    this.skipWhitespaceOnly();
+    this.expect("|>");
+    this.skipInlineSpaces();
+    this.expect("foreach");
+    if (this.cur() !== " " && this.cur() !== "	") {
+      throw new ParseFailure("space after foreach", this.pos);
+    }
+    this.skipInlineSpaces();
+    const selector = this.consumeWhile((c) => c !== "\n" && c !== "#").trim();
+    if (selector.length === 0) {
+      throw new ParseFailure("foreach selector", this.pos);
+    }
+    this.skipSpaces();
+    const pipeline = this.parseIfPipeline("end");
+    this.skipSpaces();
+    this.expect("end");
+    return { kind: "Foreach", selector, pipeline };
+  }
   parseRegularStep() {
     this.skipWhitespaceOnly();
     this.expect("|>");
@@ -588,11 +610,69 @@ var Parser = class {
     this.skipSpaces();
     this.expect("case");
     this.skipInlineSpaces();
-    const tag = this.parseTag();
+    const condition = this.parseTagExpr();
+    this.skipInlineSpaces();
     this.expect(":");
     this.skipSpaces();
     const pipeline = this.parseIfPipeline("case", "default:", "end");
-    return { tag, pipeline };
+    return { condition, pipeline };
+  }
+  /**
+   * Parse a tag expression with boolean operators (and, or) and grouping
+   * Grammar (precedence: AND > OR):
+   *   tag_expr := or_expr
+   *   or_expr  := and_expr ("or" and_expr)*
+   *   and_expr := primary ("and" primary)*
+   *   primary  := tag | "(" tag_expr ")"
+   */
+  parseTagExpr() {
+    return this.parseOrExpr();
+  }
+  parseOrExpr() {
+    let left = this.parseAndExpr();
+    while (true) {
+      const saved = this.pos;
+      this.skipInlineSpaces();
+      if (this.text.startsWith("or", this.pos) && !this.isIdentCont(this.text[this.pos + 2] || "")) {
+        this.pos += 2;
+        this.skipInlineSpaces();
+        const right = this.parseAndExpr();
+        left = { kind: "Or", left, right };
+      } else {
+        this.pos = saved;
+        break;
+      }
+    }
+    return left;
+  }
+  parseAndExpr() {
+    let left = this.parseTagPrimary();
+    while (true) {
+      const saved = this.pos;
+      this.skipInlineSpaces();
+      if (this.text.startsWith("and", this.pos) && !this.isIdentCont(this.text[this.pos + 3] || "")) {
+        this.pos += 3;
+        this.skipInlineSpaces();
+        const right = this.parseTagPrimary();
+        left = { kind: "And", left, right };
+      } else {
+        this.pos = saved;
+        break;
+      }
+    }
+    return left;
+  }
+  parseTagPrimary() {
+    if (this.cur() === "(") {
+      this.pos++;
+      this.skipInlineSpaces();
+      const expr = this.parseTagExpr();
+      this.skipInlineSpaces();
+      this.expect(")");
+      return expr;
+    }
+    const tag = this.parseTag();
+    return { kind: "Tag", tag };
   }
   parseIfPipeline(...stopKeywords) {
     const steps = [];
@@ -1143,10 +1223,10 @@ function formatPipelineStep(step, indent = "  ") {
       });
     }
     return lines.join("\n");
-  } else {
+  } else if (step.kind === "Dispatch") {
     const lines = [`${indent}|> dispatch`];
     step.branches.forEach((branch) => {
-      lines.push(`${indent}  case ${formatTag(branch.tag)}:`);
+      lines.push(`${indent}  case ${formatTagExpr(branch.condition)}:`);
       branch.pipeline.steps.forEach((branchStep) => {
         lines.push(formatPipelineStep(branchStep, indent + "    "));
       });
@@ -1158,6 +1238,13 @@ function formatPipelineStep(step, indent = "  ") {
       });
     }
     return lines.join("\n");
+  } else {
+    const lines = [`${indent}|> foreach ${step.selector}`];
+    step.pipeline.steps.forEach((innerStep) => {
+      lines.push(formatPipelineStep(innerStep, indent + "  "));
+    });
+    lines.push(`${indent}end`);
+    return lines.join("\n");
   }
 }
 function formatStepConfig(config, configType) {
@@ -1178,6 +1265,19 @@ function formatTag(tag) {
   const args = tag.args.length > 0 ? `(${tag.args.join(",")})` : "";
   return `@${negation}${tag.name}${args}`;
 }
+function formatTagExpr(expr) {
+  switch (expr.kind) {
+    case "Tag":
+      return formatTag(expr.tag);
+    case "And": {
+      const leftStr = expr.left.kind === "Or" ? `(${formatTagExpr(expr.left)})` : formatTagExpr(expr.left);
+      const rightStr = expr.right.kind === "Or" ? `(${formatTagExpr(expr.right)})` : formatTagExpr(expr.right);
+      return `${leftStr} and ${rightStr}`;
+    }
+    case "Or":
+      return `${formatTagExpr(expr.left)} or ${formatTagExpr(expr.right)}`;
+  }
+}
 function formatPipelineRef(ref) {
   if (ref.kind === "Named") {
     return [`  |> pipeline: ${ref.name}`];
@@ -1206,6 +1306,7 @@ function formatWhen(when) {
   formatPipelineStep,
   formatStepConfig,
   formatTag,
+  formatTagExpr,
   formatTags,
   formatWhen,
   getPipelineRanges,

package/dist/index.d.cts

@@ -93,6 +93,19 @@ interface Tag {
     negated: boolean;
     args: string[];
 }
+/** A boolean expression of tags for dispatch routing */
+type TagExpr = {
+    kind: 'Tag';
+    tag: Tag;
+} | {
+    kind: 'And';
+    left: TagExpr;
+    right: TagExpr;
+} | {
+    kind: 'Or';
+    left: TagExpr;
+    right: TagExpr;
+};
 type PipelineStep = {
     kind: 'Regular';
     name: string;
@@ -112,9 +125,13 @@ type PipelineStep = {
     kind: 'Dispatch';
     branches: DispatchBranch[];
     default?: Pipeline;
+} | {
+    kind: 'Foreach';
+    selector: string;
+    pipeline: Pipeline;
 };
 interface DispatchBranch {
-    tag: Tag;
+    condition: TagExpr;
     pipeline: Pipeline;
 }
 interface ResultBranch {
@@ -205,7 +222,8 @@ declare function formatPipelineStep(step: PipelineStep, indent?: string): string
 declare function formatStepConfig(config: string, configType: ConfigType): string;
 declare function formatTags(tags: Tag[]): string;
 declare function formatTag(tag: Tag): string;
+declare function formatTagExpr(expr: TagExpr): string;
 declare function formatPipelineRef(ref: PipelineRef): string[];
 declare function formatWhen(when: When): string;
 
-export { type Comment, type Condition, type Config, type ConfigProperty, type ConfigType, type ConfigValue, type Describe, type DiagnosticSeverity, type DispatchBranch, type GraphQLSchema, type It, type Mock, type MutationResolver, type NamedPipeline, type ParseDiagnostic, type Pipeline, type PipelineRef, type PipelineStep, type Program, type QueryResolver, type ResultBranch, type ResultBranchType, type Route, type Tag, type Variable, type When, formatConfigValue, formatPipelineRef, formatPipelineStep, formatStepConfig, formatTag, formatTags, formatWhen, getPipelineRanges, getVariableRanges, parseProgram, parseProgramWithDiagnostics, prettyPrint, printComment, printCondition, printConfig, printDescribe, printGraphQLSchema, printMock, printMutationResolver, printPipeline, printQueryResolver, printRoute, printTest, printVariable };
+export { type Comment, type Condition, type Config, type ConfigProperty, type ConfigType, type ConfigValue, type Describe, type DiagnosticSeverity, type DispatchBranch, type GraphQLSchema, type It, type Mock, type MutationResolver, type NamedPipeline, type ParseDiagnostic, type Pipeline, type PipelineRef, type PipelineStep, type Program, type QueryResolver, type ResultBranch, type ResultBranchType, type Route, type Tag, type TagExpr, type Variable, type When, formatConfigValue, formatPipelineRef, formatPipelineStep, formatStepConfig, formatTag, formatTagExpr, formatTags, formatWhen, getPipelineRanges, getVariableRanges, parseProgram, parseProgramWithDiagnostics, prettyPrint, printComment, printCondition, printConfig, printDescribe, printGraphQLSchema, printMock, printMutationResolver, printPipeline, printQueryResolver, printRoute, printTest, printVariable };

package/dist/index.d.ts

@@ -93,6 +93,19 @@ interface Tag {
     negated: boolean;
     args: string[];
 }
+/** A boolean expression of tags for dispatch routing */
+type TagExpr = {
+    kind: 'Tag';
+    tag: Tag;
+} | {
+    kind: 'And';
+    left: TagExpr;
+    right: TagExpr;
+} | {
+    kind: 'Or';
+    left: TagExpr;
+    right: TagExpr;
+};
 type PipelineStep = {
     kind: 'Regular';
     name: string;
@@ -112,9 +125,13 @@ type PipelineStep = {
     kind: 'Dispatch';
     branches: DispatchBranch[];
     default?: Pipeline;
+} | {
+    kind: 'Foreach';
+    selector: string;
+    pipeline: Pipeline;
 };
 interface DispatchBranch {
-    tag: Tag;
+    condition: TagExpr;
     pipeline: Pipeline;
 }
 interface ResultBranch {
@@ -205,7 +222,8 @@ declare function formatPipelineStep(step: PipelineStep, indent?: string): string
 declare function formatStepConfig(config: string, configType: ConfigType): string;
 declare function formatTags(tags: Tag[]): string;
 declare function formatTag(tag: Tag): string;
+declare function formatTagExpr(expr: TagExpr): string;
 declare function formatPipelineRef(ref: PipelineRef): string[];
 declare function formatWhen(when: When): string;
 
-export { type Comment, type Condition, type Config, type ConfigProperty, type ConfigType, type ConfigValue, type Describe, type DiagnosticSeverity, type DispatchBranch, type GraphQLSchema, type It, type Mock, type MutationResolver, type NamedPipeline, type ParseDiagnostic, type Pipeline, type PipelineRef, type PipelineStep, type Program, type QueryResolver, type ResultBranch, type ResultBranchType, type Route, type Tag, type Variable, type When, formatConfigValue, formatPipelineRef, formatPipelineStep, formatStepConfig, formatTag, formatTags, formatWhen, getPipelineRanges, getVariableRanges, parseProgram, parseProgramWithDiagnostics, prettyPrint, printComment, printCondition, printConfig, printDescribe, printGraphQLSchema, printMock, printMutationResolver, printPipeline, printQueryResolver, printRoute, printTest, printVariable };
+export { type Comment, type Condition, type Config, type ConfigProperty, type ConfigType, type ConfigValue, type Describe, type DiagnosticSeverity, type DispatchBranch, type GraphQLSchema, type It, type Mock, type MutationResolver, type NamedPipeline, type ParseDiagnostic, type Pipeline, type PipelineRef, type PipelineStep, type Program, type QueryResolver, type ResultBranch, type ResultBranchType, type Route, type Tag, type TagExpr, type Variable, type When, formatConfigValue, formatPipelineRef, formatPipelineStep, formatStepConfig, formatTag, formatTagExpr, formatTags, formatWhen, getPipelineRanges, getVariableRanges, parseProgram, parseProgramWithDiagnostics, prettyPrint, printComment, printCondition, printConfig, printDescribe, printGraphQLSchema, printMock, printMutationResolver, printPipeline, printQueryResolver, printRoute, printTest, printVariable };

package/dist/index.mjs

@@ -412,8 +412,29 @@ var Parser = class {
     if (ifStep) return ifStep;
     const dispatchStep = this.tryParse(() => this.parseDispatchStep());
     if (dispatchStep) return dispatchStep;
+    const foreachStep = this.tryParse(() => this.parseForeachStep());
+    if (foreachStep) return foreachStep;
     return this.parseRegularStep();
   }
+  parseForeachStep() {
+    this.skipWhitespaceOnly();
+    this.expect("|>");
+    this.skipInlineSpaces();
+    this.expect("foreach");
+    if (this.cur() !== " " && this.cur() !== "	") {
+      throw new ParseFailure("space after foreach", this.pos);
+    }
+    this.skipInlineSpaces();
+    const selector = this.consumeWhile((c) => c !== "\n" && c !== "#").trim();
+    if (selector.length === 0) {
+      throw new ParseFailure("foreach selector", this.pos);
+    }
+    this.skipSpaces();
+    const pipeline = this.parseIfPipeline("end");
+    this.skipSpaces();
+    this.expect("end");
+    return { kind: "Foreach", selector, pipeline };
+  }
   parseRegularStep() {
     this.skipWhitespaceOnly();
     this.expect("|>");
@@ -539,11 +560,69 @@ var Parser = class {
     this.skipSpaces();
     this.expect("case");
     this.skipInlineSpaces();
-    const tag = this.parseTag();
+    const condition = this.parseTagExpr();
+    this.skipInlineSpaces();
     this.expect(":");
     this.skipSpaces();
     const pipeline = this.parseIfPipeline("case", "default:", "end");
-    return { tag, pipeline };
+    return { condition, pipeline };
+  }
+  /**
+   * Parse a tag expression with boolean operators (and, or) and grouping
+   * Grammar (precedence: AND > OR):
+   *   tag_expr := or_expr
+   *   or_expr  := and_expr ("or" and_expr)*
+   *   and_expr := primary ("and" primary)*
+   *   primary  := tag | "(" tag_expr ")"
+   */
+  parseTagExpr() {
+    return this.parseOrExpr();
+  }
+  parseOrExpr() {
+    let left = this.parseAndExpr();
+    while (true) {
+      const saved = this.pos;
+      this.skipInlineSpaces();
+      if (this.text.startsWith("or", this.pos) && !this.isIdentCont(this.text[this.pos + 2] || "")) {
+        this.pos += 2;
+        this.skipInlineSpaces();
+        const right = this.parseAndExpr();
+        left = { kind: "Or", left, right };
+      } else {
+        this.pos = saved;
+        break;
+      }
+    }
+    return left;
+  }
+  parseAndExpr() {
+    let left = this.parseTagPrimary();
+    while (true) {
+      const saved = this.pos;
+      this.skipInlineSpaces();
+      if (this.text.startsWith("and", this.pos) && !this.isIdentCont(this.text[this.pos + 3] || "")) {
+        this.pos += 3;
+        this.skipInlineSpaces();
+        const right = this.parseTagPrimary();
+        left = { kind: "And", left, right };
+      } else {
+        this.pos = saved;
+        break;
+      }
+    }
+    return left;
+  }
+  parseTagPrimary() {
+    if (this.cur() === "(") {
+      this.pos++;
+      this.skipInlineSpaces();
+      const expr = this.parseTagExpr();
+      this.skipInlineSpaces();
+      this.expect(")");
+      return expr;
+    }
+    const tag = this.parseTag();
+    return { kind: "Tag", tag };
   }
   parseIfPipeline(...stopKeywords) {
     const steps = [];
@@ -1094,10 +1173,10 @@ function formatPipelineStep(step, indent = "  ") {
       });
     }
     return lines.join("\n");
-  } else {
+  } else if (step.kind === "Dispatch") {
     const lines = [`${indent}|> dispatch`];
     step.branches.forEach((branch) => {
-      lines.push(`${indent}  case ${formatTag(branch.tag)}:`);
+      lines.push(`${indent}  case ${formatTagExpr(branch.condition)}:`);
       branch.pipeline.steps.forEach((branchStep) => {
         lines.push(formatPipelineStep(branchStep, indent + "    "));
       });
@@ -1109,6 +1188,13 @@ function formatPipelineStep(step, indent = "  ") {
       });
     }
     return lines.join("\n");
+  } else {
+    const lines = [`${indent}|> foreach ${step.selector}`];
+    step.pipeline.steps.forEach((innerStep) => {
+      lines.push(formatPipelineStep(innerStep, indent + "  "));
+    });
+    lines.push(`${indent}end`);
+    return lines.join("\n");
   }
 }
 function formatStepConfig(config, configType) {
@@ -1129,6 +1215,19 @@ function formatTag(tag) {
   const args = tag.args.length > 0 ? `(${tag.args.join(",")})` : "";
   return `@${negation}${tag.name}${args}`;
 }
+function formatTagExpr(expr) {
+  switch (expr.kind) {
+    case "Tag":
+      return formatTag(expr.tag);
+    case "And": {
+      const leftStr = expr.left.kind === "Or" ? `(${formatTagExpr(expr.left)})` : formatTagExpr(expr.left);
+      const rightStr = expr.right.kind === "Or" ? `(${formatTagExpr(expr.right)})` : formatTagExpr(expr.right);
+      return `${leftStr} and ${rightStr}`;
+    }
+    case "Or":
+      return `${formatTagExpr(expr.left)} or ${formatTagExpr(expr.right)}`;
+  }
+}
 function formatPipelineRef(ref) {
   if (ref.kind === "Named") {
     return [`  |> pipeline: ${ref.name}`];
@@ -1156,6 +1255,7 @@ export {
   formatPipelineStep,
   formatStepConfig,
   formatTag,
+  formatTagExpr,
   formatTags,
   formatWhen,
   getPipelineRanges,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "webpipe-js",
-  "version": "2.0.10",
+  "version": "2.0.12",
   "description": "Web Pipe parser",
   "license": "ISC",
   "author": "William Cotton",