@jasonbelmonti/markdown-engine 3.5.0 → 3.6.0

package/dist-bundled/markdown-engine-cli.mjs

@@ -8047,7 +8047,8 @@ function tableColumnTargets(document3, source) {
   }
   const resolvedColumns = tableResolution.tables.flatMap((table) => {
     const columnIndex = columnIndexForHeader(table, source.column);
-    return columnIndex === void 0 ? [] : [{ table, columnIndex }];
+    const predicateColumnMissing = source.rowWhere !== void 0 && columnIndexForHeader(table, source.rowWhere.column) === void 0;
+    return columnIndex === void 0 || predicateColumnMissing ? [] : [{ table, columnIndex }];
   });
   if (resolvedColumns.length === 0) {
     return {
@@ -8060,7 +8061,7 @@ function tableColumnTargets(document3, source) {
     status: "resolved",
     source,
     targets: resolvedColumns.flatMap(
-      ({ table, columnIndex }) => tableCellTargetsForColumn(document3, table, columnIndex)
+      ({ table, columnIndex }) => tableCellTargetsForColumn(document3, table, columnIndex, source.rowWhere)
     )
   };
 }
@@ -8110,9 +8111,11 @@ function rowMatchesPredicate(table, cells, predicate) {
 function columnIndexForHeader(table, column) {
   return headerCells(table).find((cell) => cell.text === column)?.columnIndex;
 }
-function tableCellTargetsForColumn(document3, table, columnIndex) {
-  return dataRows(table).flatMap((row) => {
-    const cell = row.cells.find((candidate) => candidate.columnIndex === columnIndex);
+function tableCellTargetsForColumn(document3, table, columnIndex, rowWhere) {
+  return dataRows(table).filter((row) => rowMatchesPredicate(table, row.cells, rowWhere)).flatMap((row) => {
+    const cell = row.cells.find(
+      (candidate) => candidate.columnIndex === columnIndex
+    );
     return cell === void 0 ? [] : [tableCellSelectionTarget(document3, table, cell)];
   });
 }
@@ -9603,8 +9606,16 @@ function sourceLengthRequirement(assertion) {
 // src/declarative-validation/assertions/table-column-coverage.ts
 function evaluateTableColumnCoverage(assertion, context) {
   const options = idTokenOptions(assertion);
-  const sourceIds = sourceIdsForCoverage(assertion, context, options);
+  const sourceResolution = resolveTableColumnIdTokens(
+    context.selection.document,
+    assertion.source,
+    options
+  );
+  const sourceIds = sourceResolution.status === "resolved" ? uniqueSourceIds2(sourceResolution.tokens) : [];
   if (sourceIds.length === 0) {
+    if (assertion.allowEmptySource === true && sourceResolution.status === "resolved") {
+      return [];
+    }
     return [emptySelectionDiagnostic(context.rule, context.assertionIndex)];
   }
   const targetResolution = resolveTableColumnIdTokens(
@@ -9614,12 +9625,22 @@ function evaluateTableColumnCoverage(assertion, context) {
   );
   if (targetResolution.status === "missingSection") {
     return sourceIds.map(
-      (sourceId, sourceIdOrder) => missingTargetSectionDiagnostic(assertion, context, sourceId, sourceIdOrder)
+      (sourceId, sourceIdOrder) => missingTargetSectionDiagnostic(
+        assertion,
+        context,
+        sourceId,
+        sourceIdOrder
+      )
     );
   }
   if (targetResolution.status === "missingColumn") {
     return sourceIds.map(
-      (sourceId, sourceIdOrder) => missingTargetColumnDiagnostic(assertion, context, sourceId, sourceIdOrder)
+      (sourceId, sourceIdOrder) => missingTargetColumnDiagnostic(
+        assertion,
+        context,
+        sourceId,
+        sourceIdOrder
+      )
     );
   }
   const targetComparisonValues = new Set(
@@ -9641,17 +9662,6 @@ function evaluateTableColumnCoverage(assertion, context) {
   }
   return diagnostics;
 }
-function sourceIdsForCoverage(assertion, context, options) {
-  const sourceResolution = resolveTableColumnIdTokens(
-    context.selection.document,
-    {
-      section: assertion.source.section,
-      column: assertion.source.column
-    },
-    options
-  );
-  return sourceResolution.status === "resolved" ? uniqueSourceIds2(sourceResolution.tokens) : [];
-}
 function uniqueSourceIds2(tokens) {
   const sourceIdsByComparisonValue = /* @__PURE__ */ new Map();
   for (const token of tokens) {
@@ -9824,6 +9834,40 @@ function tableColumnSortKey(table, diagnosticOrder, column) {
   return `table:${table.target.id}:column:${paddedDiagnosticOrder}:${column}`;
 }
 
+// src/declarative-validation/assertions/visible-text.ts
+function visibleText(document3, target) {
+  const textAt = (nodeTarget) => documentQueries.nodes(document3, { targetId: nodeTarget.id }).map(nodeText2).join("");
+  switch (target.kind) {
+    case "document":
+      return document3.children.map(nodeText2).join("\n");
+    case "section":
+      return [
+        textAt(target.section.headingTarget),
+        ...target.section.bodyTargets.map(textAt)
+      ].join("\n");
+    case "heading":
+      return textAt(target.section.headingTarget);
+    case "table":
+      return textAt(target.table.target);
+    case "tableRow":
+      return target.cells.map((cell) => textAt(cell.target)).join(" ");
+    case "tableCell":
+      return textAt(target.cell.target);
+    case "textSpan":
+      return textAt(target.span.target);
+    case "link":
+      return textAt(target.link.target);
+    case "list":
+      return textAt(target.list.target);
+  }
+}
+function nodeText2(node2) {
+  if (node2.type === "html" || node2.type === "definition" || node2.type === "yaml") {
+    return "";
+  }
+  return node2.children === void 0 ? node2.text ?? "" : node2.children.map(nodeText2).join("");
+}
+
 // src/declarative-validation/assertions/literal-text.ts
 function countNonOverlappingLiteralOccurrences(text5, literal) {
   let count = 0;
@@ -9850,6 +9894,16 @@ function evaluateText(assertion, context) {
 }
 function evaluateTextTarget(assertion, context, target, targetOrder) {
   const diagnostics = [];
+  if (assertion.nonBlank === true && visibleText(context.selection.document, target).trim().length === 0) {
+    diagnostics.push(
+      validationDiagnostic(
+        "profile.validation.textBlank",
+        `Selected ${target.kind} must contain non-whitespace text outside raw HTML.`,
+        context.rule,
+        { assertionIndex: context.assertionIndex, target, targetOrder }
+      )
+    );
+  }
   if (assertion.contains !== void 0 && !target.text.includes(assertion.contains)) {
     diagnostics.push(
       validationDiagnostic(
@@ -10625,6 +10679,48 @@ function stringArray(value) {
   return values;
 }
 
+// src/declarative-validation/profile/cell-predicate-schema.ts
+function cellPredicateFromValue(value, key, diagnostics) {
+  if (!isPlainRecord(value)) {
+    diagnostics.push(invalidShape(`Selector ${key} must be an object.`));
+    return void 0;
+  }
+  unsupportedKeys(value, ["column", "equals", "includes"], diagnostics);
+  const column = requiredNonEmptyStringField(
+    value.column,
+    `Selector ${key}.column`,
+    diagnostics,
+    (field) => `${field} must be a non-empty string.`
+  );
+  if (column === void 0) {
+    return void 0;
+  }
+  const predicate = {
+    ...optionalPredicateString(value, "equals", diagnostics),
+    ...optionalPredicateString(value, "includes", diagnostics)
+  };
+  if (predicate.equals === void 0 && predicate.includes === void 0) {
+    diagnostics.push(
+      invalidShape(
+        `Selector ${key} must include at least one of equals or includes.`
+      )
+    );
+    return void 0;
+  }
+  return {
+    column,
+    ...predicate
+  };
+}
+function optionalPredicateString(record, key, diagnostics) {
+  return optionalStringField(
+    record,
+    key,
+    diagnostics,
+    (field) => `Selector ${field} must be a non-empty string when provided.`
+  );
+}
+
 // src/declarative-validation/profile/selector-schema.ts
 function selectorFromValue(value, diagnostics) {
   if (!isPlainRecord(value)) {
@@ -10746,33 +10842,6 @@ function optionalCellPredicate(record, key, diagnostics) {
   const predicate = cellPredicateFromValue(value, key, diagnostics);
   return predicate === void 0 ? {} : { [key]: predicate };
 }
-function cellPredicateFromValue(value, key, diagnostics) {
-  if (!isPlainRecord(value)) {
-    diagnostics.push(invalidShape(`Selector ${key} must be an object.`));
-    return void 0;
-  }
-  unsupportedKeys(value, ["column", "equals", "includes"], diagnostics);
-  const column = requiredSelectorString(value.column, `${key}.column`, diagnostics);
-  if (column === void 0) {
-    return void 0;
-  }
-  const predicate = {
-    ...optionalSelectorString(value, "equals", diagnostics),
-    ...optionalSelectorString(value, "includes", diagnostics)
-  };
-  if (predicate.equals === void 0 && predicate.includes === void 0) {
-    diagnostics.push(
-      invalidShape(
-        `Selector ${key} must include at least one of equals or includes.`
-      )
-    );
-    return void 0;
-  }
-  return {
-    column,
-    ...predicate
-  };
-}
 function optionalBoolean(record, key, diagnostics) {
   return optionalBooleanField(
     record,
@@ -11122,7 +11191,22 @@ function pushObjectDiagnostic(fieldName, value, ruleId, diagnostics) {
 }
 function pushTextShapeDiagnostics(assertion, ruleId, diagnostics) {
   let valid = true;
-  if (assertion?.contains !== void 0 && !pushNonEmptyStringDiagnostic("contains", assertion.contains, ruleId, diagnostics)) {
+  if (assertion?.nonBlank !== void 0 && assertion.nonBlank !== true) {
+    diagnostics.push(
+      compileDiagnostic(
+        "profile.config.invalidShape",
+        "text.nonBlank must be true when provided.",
+        ruleId
+      )
+    );
+    valid = false;
+  }
+  if (assertion?.contains !== void 0 && !pushNonEmptyStringDiagnostic(
+    "contains",
+    assertion.contains,
+    ruleId,
+    diagnostics
+  )) {
     valid = false;
   }
   if (assertion?.excludes !== void 0 && closedStringArray("excludes", assertion.excludes, ruleId, diagnostics) === void 0) {
@@ -11191,7 +11275,13 @@ function closedTableColumnCoverage(value, ruleId, diagnostics) {
   const record = value;
   const hasSupportedKeys = pushUnsupportedKeyDiagnostics(
     record,
-    ["source", "target", "require"],
+    ["source", "target", "require", "allowEmptySource"],
+    diagnostics
+  );
+  pushOptionalBooleanDiagnostic(
+    "tableColumnCoverage.allowEmptySource",
+    record.allowEmptySource,
+    ruleId,
     diagnostics
   );
   const source = closedTableColumnCoverageSource(
@@ -11217,7 +11307,8 @@ function closedTableColumnCoverage(value, ruleId, diagnostics) {
   return hasSupportedKeys && diagnostics.length === diagnosticCountBefore && source !== void 0 && target !== void 0 && require2 !== void 0 ? {
     source,
     target,
-    require: require2
+    require: require2,
+    ...record.allowEmptySource === void 0 ? {} : { allowEmptySource: record.allowEmptySource }
   } : void 0;
 }
 function closedTableColumnCoverageSource(value, ruleId, diagnostics) {
@@ -11232,7 +11323,7 @@ function closedTableColumnCoverageSource(value, ruleId, diagnostics) {
   const source = value;
   const hasSupportedKeys = pushUnsupportedKeyDiagnostics(
     source,
-    ["section", "column", "prefix", "caseSensitive"],
+    ["section", "column", "prefix", "caseSensitive", "rowWhere"],
     diagnostics
   );
   const hasValidFields = pushNonEmptyStringDiagnostic(
@@ -11256,7 +11347,9 @@ function closedTableColumnCoverageSource(value, ruleId, diagnostics) {
     ruleId,
     diagnostics
   );
-  return hasSupportedKeys && hasValidFields ? {
+  const rowWhere = source.rowWhere === void 0 ? void 0 : cellPredicateFromValue(source.rowWhere, "rowWhere", diagnostics);
+  return hasSupportedKeys && hasValidFields && (source.rowWhere === void 0 || rowWhere !== void 0) ? {
+    ...rowWhere === void 0 ? {} : { rowWhere },
     section: source.section,
     column: source.column,
     ...optionalString("prefix", source.prefix),
@@ -11431,7 +11524,7 @@ function optionalNumber2(key, value) {
   return value === void 0 ? {} : { [key]: value };
 }
 function hasTextPredicate(assertion) {
-  return assertion?.contains !== void 0 || assertion?.excludes !== void 0 && assertion.excludes.length > 0;
+  return assertion?.nonBlank === true || assertion?.contains !== void 0 || assertion?.excludes !== void 0 && assertion.excludes.length > 0;
 }
 
 // src/declarative-validation/profile/ids-assertion-contract.ts
@@ -11856,7 +11949,9 @@ function buildTableColumnCoverageAssertion(assertion, selector, ruleId, syntaxVe
   )) {
     return {
       kind: "tableColumnCoverage",
+      ...tableColumnCoverage.allowEmptySource === void 0 ? {} : { allowEmptySource: tableColumnCoverage.allowEmptySource },
       source: {
+        ...tableColumnCoverage.source.rowWhere === void 0 ? {} : { rowWhere: tableColumnCoverage.source.rowWhere },
         section: tableColumnCoverage.source.section,
         column: tableColumnCoverage.source.column,
         caseSensitive: tableColumnCoverage.source.caseSensitive ?? true,
@@ -11895,13 +11990,13 @@ function buildFrontmatterShapeAssertion(assertion, selector, ruleId, syntaxVersi
   }
   return void 0;
 }
-function buildTextAssertion(assertion, selector, ruleId, _syntaxVersion, diagnostics) {
+function buildTextAssertion(assertion, selector, ruleId, syntaxVersion, diagnostics) {
   if (assertion.text === void 0) {
     return void 0;
   }
   if (!pushObjectDiagnostic("text", assertion.text, ruleId, diagnostics) || !pushUnsupportedKeyDiagnostics(
     assertion.text,
-    ["contains", "excludes"],
+    syntaxVersion === PROFILE_SYNTAX_VERSION_V2 ? ["contains", "excludes", "nonBlank"] : ["contains", "excludes"],
     diagnostics
   ) || !pushTextShapeDiagnostics(assertion.text, ruleId, diagnostics)) {
     return void 0;
@@ -11919,6 +12014,7 @@ function buildTextAssertion(assertion, selector, ruleId, _syntaxVersion, diagnos
   if (pushCompatibilityDiagnostic("text", selector, ruleId, diagnostics)) {
     return {
       kind: "text",
+      ...assertion.text.nonBlank === true ? { nonBlank: true } : {},
       ...optionalString("contains", assertion.text.contains),
       ...optionalStringArray("excludes", assertion.text.excludes)
     };
@@ -12817,7 +12913,7 @@ function assertionFromValue(value, syntaxVersion, diagnostics) {
     ...tableColumnsRequiredFromValue(value.tableColumnsRequired, diagnostics),
     ...idsFromValue(value.ids, syntaxVersion, diagnostics),
     ...referencesFromValue(value.references, diagnostics),
-    ...textAssertionFromValue(value.text, diagnostics),
+    ...textAssertionFromValue(value.text, syntaxVersion, diagnostics),
     ...textOccurrenceCountFromValue(value.textOccurrenceCount, diagnostics),
     ...textLengthFromValue(value.textLength, diagnostics),
     ...supportsV2AssertionSurface(syntaxVersion) ? selectionCountFromValue(value.selectionCount, diagnostics) : {},
@@ -12833,7 +12929,9 @@ function assertionFromValue(value, syntaxVersion, diagnostics) {
       return void 0;
     }
     diagnostics.push(
-      invalidShape("Rule assert must include at least one supported assertion.")
+      invalidShape(
+        "Rule assert must include at least one supported assertion."
+      )
     );
     return void 0;
   }
@@ -13014,7 +13112,12 @@ function tableColumnCoverageFromValue(value, diagnostics) {
     diagnostics.push(invalidShape("tableColumnCoverage must be an object."));
     return {};
   }
-  unsupportedKeys(value, ["source", "target", "require"], diagnostics);
+  unsupportedKeys(
+    value,
+    ["source", "target", "require", "allowEmptySource"],
+    diagnostics
+  );
+  const emptyPolicy = optionalBoolean2(value, "allowEmptySource", diagnostics);
   const source = tableColumnCoverageSourceFromValue(value.source, diagnostics);
   const target = tableColumnCoverageTargetFromValue(value.target, diagnostics);
   const require2 = value.require === "everySourceId" ? "everySourceId" : void 0;
@@ -13025,6 +13128,7 @@ function tableColumnCoverageFromValue(value, diagnostics) {
   }
   return source === void 0 || target === void 0 || require2 === void 0 ? {} : {
     tableColumnCoverage: {
+      ...emptyPolicy,
       source,
       target,
       require: require2
@@ -13041,7 +13145,7 @@ function tableColumnCoverageSourceFromValue(value, diagnostics) {
   }
   unsupportedKeys(
     value,
-    ["section", "column", "prefix", "caseSensitive"],
+    ["section", "column", "prefix", "caseSensitive", "rowWhere"],
     diagnostics
   );
   const section = requiredAssertionString(
@@ -13054,7 +13158,9 @@ function tableColumnCoverageSourceFromValue(value, diagnostics) {
     "tableColumnCoverage.source.column",
     diagnostics
   );
+  const rowWhere = value.rowWhere === void 0 ? void 0 : cellPredicateFromValue(value.rowWhere, "rowWhere", diagnostics);
   const source = {
+    ...rowWhere === void 0 ? {} : { rowWhere },
     ...optionalTableColumnCoverageSourceString(value, "prefix", diagnostics),
     ...optionalTableColumnCoverageSourceBoolean(
       value,
@@ -13137,7 +13243,7 @@ function frontmatterShapeFromValue2(value, diagnostics) {
   }
   return result.shape === void 0 ? {} : { frontmatterShape: result.shape };
 }
-function textAssertionFromValue(value, diagnostics) {
+function textAssertionFromValue(value, syntaxVersion, diagnostics) {
   if (value === void 0) {
     return {};
   }
@@ -13145,16 +13251,22 @@ function textAssertionFromValue(value, diagnostics) {
     diagnostics.push(invalidShape("text must be an object."));
     return {};
   }
-  unsupportedKeys(value, ["contains", "excludes"], diagnostics);
+  unsupportedKeys(
+    value,
+    syntaxVersion === PROFILE_SYNTAX_VERSION_V2 ? ["contains", "excludes", "nonBlank"] : ["contains", "excludes"],
+    diagnostics
+  );
+  if (value.nonBlank !== void 0 && value.nonBlank !== true) {
+    diagnostics.push(invalidShape("text.nonBlank must be true when provided."));
+  }
   const text5 = {
+    ...value.nonBlank === true ? { nonBlank: true } : {},
     ...optionalAssertionString(value, "contains", diagnostics),
     ...optionalStringArray2(value, "excludes", diagnostics)
   };
   if (!hasTextPredicate2(text5)) {
     diagnostics.push(
-      invalidShape(
-        "text must include contains or a non-empty excludes array."
-      )
+      invalidShape("text must include contains or a non-empty excludes array.")
     );
     return {};
   }
@@ -13299,7 +13411,7 @@ function requiredAssertionString(value, field, diagnostics) {
   );
 }
 function hasTextPredicate2(text5) {
-  return text5?.contains !== void 0 || text5?.excludes !== void 0;
+  return text5?.nonBlank === true || text5?.contains !== void 0 || text5?.excludes !== void 0;
 }
 function isNonNegativeInteger2(value) {
   return Number.isInteger(value) && value >= 0;
@@ -13814,7 +13926,7 @@ function cloneSourceRange2(sourceRange) {
 import { createHash } from "node:crypto";
 
 // src/internal/package-version.ts
-var MARKDOWN_ENGINE_PACKAGE_VERSION = "3.5.0";
+var MARKDOWN_ENGINE_PACKAGE_VERSION = "3.6.0";
 
 // src/internal/stable-json.ts
 function normalizeStableJsonValue(value) {
@@ -26608,7 +26720,7 @@ function toEngineNode(node2, options) {
   const type = typeof node2.type === "string" ? node2.type : "unknown";
   const attributes = nodeAttributes(type, node2, options);
   const sourceRange = toSourceRange(node2.position, options);
-  const text5 = nodeText2(type, node2);
+  const text5 = nodeText3(type, node2);
   const children = childNodes(node2).map((child) => toEngineNode(child, options));
   return {
     type,
@@ -26715,7 +26827,7 @@ function assignStringAttribute(attributes, name, value) {
 function isTableAlignment(alignment) {
   return alignment === "left" || alignment === "right" || alignment === "center" || alignment === null;
 }
-function nodeText2(type, node2) {
+function nodeText3(type, node2) {
   if (typeof node2.value === "string") {
     return node2.value;
   }

package/docs/contracts/declarative-validation.md

@@ -323,7 +323,9 @@ interface DeclarativeAssertion {
     mustAppearIn: readonly string[];
   };
   tableColumnCoverage?: {
+    allowEmptySource?: boolean;
     source: {
+      rowWhere?: { column: string; equals?: string; includes?: string };
       section: string;
       column: string;
       prefix?: string;
@@ -349,6 +351,7 @@ interface DeclarativeAssertion {
     }[];
   };
   text?: {
+    nonBlank?: true; // v2 only
     contains?: string;
     excludes?: readonly string[];
   };
@@ -461,6 +464,22 @@ target section do not satisfy coverage. Missing target sections, missing target
 columns, and missing target-column IDs emit deterministic validation diagnostics
 source-grounded to the source ID when source evidence is available.
 
+The opt-in `source.rowWhere` filter uses the same closed sibling-cell predicate
+as the `tableCell` selector: a non-empty `column` plus `equals`, `includes`, or
+both. Both predicates must match when both are present. Matching uses normalized,
+case-sensitive cell text before ID extraction; `source.caseSensitive` affects ID
+comparison only. Rows marked optional can therefore be excluded without encoding
+consumer vocabulary in the engine. A missing predicate column is unresolved,
+not a resolved empty source.
+
+`allowEmptySource` is an optional boolean. Absent or `false` preserves the existing
+`profile.validation.emptySelection` failure when no source IDs are extracted.
+`true` permits zero extracted IDs only when the source section and column resolve
+(including the predicate column when configured). With no source IDs there are no
+target obligations; target resolution is not evaluated. A missing source structure
+still fails. Pair this policy with consumer shape rules when tables or rows are
+mandatory. This option also permits prose sentinels in reverse declared-ID checks.
+
 For v2 profiles, `frontmatterShape` is admitted as a flat-rule schema and
 internal compiled-plan assertion. It is compatible only with a `document`
 selector because frontmatter is document metadata. `presence` is optional and
@@ -505,7 +524,18 @@ is combined with `equals` or `nonBlank`, a non-string value emits only
 string-predicate diagnostic. Diagnostic messages do not include frontmatter
 values.
 
-`text` must include `contains` or a non-empty `excludes` array.
+`text` must include `contains`, a non-empty `excludes` array, or (v2 only)
+`nonBlank: true`. `nonBlank` cannot be `false`. It requires at least one character
+after JavaScript `trim()` on normalized node text excluding raw `html`, `definition`,
+and `yaml` nodes. Comments, empty HTML tags, and decoded whitespace entities cannot
+satisfy it. Markdown emphasis, link labels, literal code, and escaped angle brackets
+retain their text. Each selected target is checked independently; an empty selector
+still fails. Section selection includes its heading and direct body, as with ordinary
+section text. Original source ranges are optional; the normalized nodes provide the
+content. This is a structural textual-content check, not CSS visibility evaluation
+or browser rendering. It does not evaluate external evidence, freshness, truth,
+or implementation acceptance. Existing `contains`, `excludes`, and `textLength`
+semantics are unchanged, even when combined with `nonBlank`.
 `textOccurrenceCount.count` is a finite number and counts non-overlapping
 literal occurrences per selected target.
 `textLength` must include `min`, `max`, or both. Bounds are non-negative
@@ -592,6 +622,7 @@ an unproven pass.
 | `profile.validation.tableColumnCoverageIdMissing` | Rule severity | A source ID is absent from the configured target table column. |
 | `profile.validation.tableColumnCoverageTargetColumnMissing` | Rule severity | The configured target table column cannot be resolved. |
 | `profile.validation.tableColumnCoverageTargetSectionMissing` | Rule severity | The configured target section cannot be resolved. |
+| `profile.validation.textBlank` | Rule severity | A target configured with `text.nonBlank` lacks non-whitespace text outside raw HTML. |
 | `profile.validation.textExcluded` | Rule severity | A selected target contains forbidden literal text. |
 | `profile.validation.textMissing` | Rule severity | A selected target lacks required literal text from a `text.contains` assertion. |
 | `profile.validation.assertionUnsupported` | `error` | A compiled assertion or compiled assertion feature has no evaluator implementation; this is an internal safety diagnostic. |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jasonbelmonti/markdown-engine",
-  "version": "3.5.0",
+  "version": "3.6.0",
   "description": "Deterministic Markdown parsing and validation engine package.",
   "license": "MIT",
   "type": "module",
@@ -71,7 +71,7 @@
     "test:validation:profile": "npm run build && vitest run tests/declarative-validation-profile.test.ts \"--exclude=.worktrees/**\"",
     "test:validation:compiler": "npm run build && vitest run tests/declarative-validation-compiler.test.ts \"--exclude=.worktrees/**\"",
     "test:validation:selectors": "npm run build && vitest run tests/declarative-validation-selectors.test.ts \"--exclude=.worktrees/**\"",
-    "test:validation:assertions": "npm run build && vitest run tests/declarative-validation-assertions.test.ts tests/declarative-validation-frontmatter-shape-assertions.test.ts tests/declarative-validation-table-column-coverage-fixtures.test.ts tests/declarative-validation-table-columns-exact.test.ts tests/declarative-validation-source-assertion-coverage.test.ts tests/declarative-validation-source-length.test.ts tests/declarative-validation-selection-count.test.ts tests/declarative-validation-normalized-source-ranges.test.ts tests/declarative-validation-grouped-rules-fixtures.test.ts tests/declarative-validation-when-skipped-rules-fixtures.test.ts \"--exclude=.worktrees/**\"",
+    "test:validation:assertions": "npm run build && vitest run tests/declarative-validation-assertions.test.ts tests/declarative-validation-filtered-coverage.test.ts tests/declarative-validation-visible-text.test.ts tests/declarative-validation-frontmatter-shape-assertions.test.ts tests/declarative-validation-table-column-coverage-fixtures.test.ts tests/declarative-validation-table-columns-exact.test.ts tests/declarative-validation-source-assertion-coverage.test.ts tests/declarative-validation-source-length.test.ts tests/declarative-validation-selection-count.test.ts tests/declarative-validation-normalized-source-ranges.test.ts tests/declarative-validation-grouped-rules-fixtures.test.ts tests/declarative-validation-when-skipped-rules-fixtures.test.ts \"--exclude=.worktrees/**\"",
     "test:validation:diagnostics": "npm run build && vitest run tests/declarative-validation-diagnostics.test.ts \"--exclude=.worktrees/**\"",
     "test:validation:cli": "npm run build && vitest run tests/declarative-validation-cli.test.ts \"--exclude=.worktrees/**\"",
     "test:validation:examples": "npm run build && vitest run tests/declarative-validation-examples.test.ts \"--exclude=.worktrees/**\"",

package/scripts/install-markdown-engine-cli.sh

@@ -1,9 +1,9 @@
 #!/usr/bin/env sh
 set -eu
 
-VERSION="3.5.0"
+VERSION="3.6.0"
 PACKAGE="@jasonbelmonti/markdown-engine"
-EXPECTED_SHA256="4a4e9ae7d9ff4797c96a7483555bcba7cbec5852d330c6c50dc0ef8fb2e5d933"
+EXPECTED_SHA256="69b855d4d3623d7cdb91a3ed09631715dde8b96fc57f49864ae2c7c7c071ad83"
 DEFAULT_DATA_HOME="${XDG_DATA_HOME:-$HOME/.local/share}"
 MARKDOWN_ENGINE_HOME="${MARKDOWN_ENGINE_HOME:-$DEFAULT_DATA_HOME/markdown-engine}"
 MARKDOWN_ENGINE_BIN_DIR="${MARKDOWN_ENGINE_BIN_DIR:-$HOME/.local/bin}"