@astryxdesign/core 0.6.2-canary.d993f65 → 0.6.2-canary.eec3a19

package/dist/Markdown/plugins/index.d.ts

@@ -4,5 +4,7 @@
  * @position Subpath entry point: `@astryxdesign/core/Markdown/plugins`
  */
 export { createMarkdownPlugin, isMarkdownExtensionNode } from './protocol';
+export { createMarkdownTextTransform } from './textTransform';
+export type { MarkdownTextTransformContext, MarkdownTextTransformOptions, } from './textTransform';
 export type { MarkdownPluginData, MarkdownExtensionNode, MarkdownTokenizerInput, MarkdownTokenizeResult, MarkdownSyntaxContribution, MarkdownSyntaxCapability, MarkdownTransformContext, MarkdownTransform, MarkdownExtensionRenderer, MarkdownExtensionRenderers, MarkdownSyntaxPluginDefinition, MarkdownTransformPluginDefinition, MarkdownPluginDefinition, MarkdownPluginEntry, MarkdownNodeOf, MarkdownExtensionsOf, } from './protocol';
 //# sourceMappingURL=index.d.ts.map

package/dist/Markdown/plugins/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/Markdown/plugins/index.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,OAAO,EAAC,oBAAoB,EAAE,uBAAuB,EAAC,MAAM,YAAY,CAAC;AACzE,YAAY,EACV,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,0BAA0B,EAC1B,wBAAwB,EACxB,wBAAwB,EACxB,iBAAiB,EACjB,yBAAyB,EACzB,0BAA0B,EAC1B,8BAA8B,EAC9B,iCAAiC,EACjC,wBAAwB,EACxB,mBAAmB,EACnB,cAAc,EACd,oBAAoB,GACrB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/Markdown/plugins/index.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,OAAO,EAAC,oBAAoB,EAAE,uBAAuB,EAAC,MAAM,YAAY,CAAC;AACzE,OAAO,EAAC,2BAA2B,EAAC,MAAM,iBAAiB,CAAC;AAC5D,YAAY,EACV,4BAA4B,EAC5B,4BAA4B,GAC7B,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,0BAA0B,EAC1B,wBAAwB,EACxB,wBAAwB,EACxB,iBAAiB,EACjB,yBAAyB,EACzB,0BAA0B,EAC1B,8BAA8B,EAC9B,iCAAiC,EACjC,wBAAwB,EACxB,mBAAmB,EACnB,cAAc,EACd,oBAAoB,GACrB,MAAM,YAAY,CAAC"}

package/dist/Markdown/plugins/index.js

@@ -6,4 +6,5 @@
  * @position Subpath entry point: `@astryxdesign/core/Markdown/plugins`
  */
 
-export { createMarkdownPlugin, isMarkdownExtensionNode } from "./protocol.js";
+export { createMarkdownPlugin, isMarkdownExtensionNode } from "./protocol.js";
+export { createMarkdownTextTransform } from "./textTransform.js";

package/dist/Markdown/plugins/protocol.d.ts

@@ -57,7 +57,13 @@ export interface MarkdownTransformContext {
     readonly display: 'inline' | 'block';
     report(message: string): void;
 }
-export type MarkdownTransform = (document: MarkdownAstRoot<MarkdownExtensionNode>, context: MarkdownTransformContext) => MarkdownAstRoot<MarkdownExtensionNode>;
+declare const markdownTransformNode: unique symbol;
+export interface MarkdownTransform<Node extends MarkdownExtensionNode = never> {
+    (document: MarkdownAstRoot<MarkdownExtensionNode>, context: MarkdownTransformContext): MarkdownAstRoot<MarkdownExtensionNode>;
+    readonly [markdownTransformNode]?: Node;
+}
+/** @internal Registers a cheap source-level claim check for a helper transform. */
+export declare function markMarkdownTransformClaim<Node extends MarkdownExtensionNode = never>(transform: MarkdownTransform<Node>, claims: (source: string) => boolean): MarkdownTransform<Node>;
 export interface MarkdownExtensionRenderer<Node extends MarkdownExtensionNode> {
     /** Pure render callback. Hooks belong in components returned by this callback. */
     readonly render: (props: {
@@ -77,11 +83,11 @@ interface MarkdownPluginDefinitionBase<Name extends string> {
 export interface MarkdownSyntaxPluginDefinition<Name extends string, Node extends MarkdownExtensionNode<Name>> extends MarkdownPluginDefinitionBase<Name> {
     readonly parseKey: string;
     readonly syntax: MarkdownSyntaxCapability<Node>;
-    readonly transform?: MarkdownTransform;
+    readonly transform?: MarkdownTransform<Node>;
     readonly renderers: MarkdownExtensionRenderers<Node>;
 }
 export type MarkdownTransformPluginDefinition<Name extends string, Node extends MarkdownExtensionNode<Name> = never> = MarkdownPluginDefinitionBase<Name> & {
-    readonly transform: MarkdownTransform;
+    readonly transform: MarkdownTransform<Node>;
     readonly parseKey?: never;
     readonly syntax?: never;
 } & ([Node] extends [never] ? {
@@ -109,7 +115,8 @@ export interface PreparedSyntaxContribution {
 }
 interface PreparedTransform {
     readonly pluginName: string;
-    readonly transform: MarkdownTransform;
+    readonly transform: MarkdownTransform<MarkdownExtensionNode>;
+    readonly claims?: (source: string) => boolean;
 }
 interface PreparedRenderer {
     readonly pluginName: string;

package/dist/Markdown/plugins/protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../src/Markdown/plugins/protocol.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EACV,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EAEnB,eAAe,EAChB,MAAM,QAAQ,CAAC;AAEhB,MAAM,MAAM,kBAAkB,GAAG,oBAAoB,CAAC;AAEtD,MAAM,MAAM,qBAAqB,CAC/B,UAAU,SAAS,MAAM,GAAG,MAAM,EAClC,QAAQ,SAAS,MAAM,GAAG,MAAM,EAChC,IAAI,SAAS,kBAAkB,GAAG,kBAAkB,EACpD,OAAO,SAAS,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,IACrD,wBAAwB,CAAC,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AAElE,wBAAgB,uBAAuB,CAAC,IAAI,SAAS,qBAAqB,EACxE,IAAI,EAAE,mBAAmB,GAAG;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAC,EACnD,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,EACtB,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,GACjB,IAAI,IAAI,IAAI,CAMd;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,mCAAmC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,KAAK,8BAA8B,CAAC,IAAI,SAAS,qBAAqB,IAAI,IAAI,CAC5E,IAAI,EACJ,QAAQ,GAAG,UAAU,CACtB,CAAC;AAEF,MAAM,MAAM,sBAAsB,CAAC,IAAI,SAAS,qBAAqB,IACjE;IAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;CAAC,GAC7B;IAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CAAC,GAC1B;IACE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,8BAA8B,CAAC,IAAI,CAAC,CAAC;CACrD,CAAC;AAEN,MAAM,WAAW,0BAA0B,CACzC,IAAI,SAAS,qBAAqB,GAAG,qBAAqB;IAE1D,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACpD,gEAAgE;IAChE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,sBAAsB,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;CACvE;AAED,KAAK,mBAAmB,CACtB,IAAI,SAAS,qBAAqB,EAClC,OAAO,SAAS,QAAQ,GAAG,OAAO,IAChC,OAAO,SAAS,IAAI,CAAC,SAAS,CAAC,GAC/B,IAAI,GAAG;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAAC,GAClC,KAAK,CAAC;AAEV,MAAM,WAAW,wBAAwB,CACvC,IAAI,SAAS,qBAAqB,GAAG,qBAAqB;IAE1D,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS;QACzB,0BAA0B,CAAC,mBAAmB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC/D,GAAG,0BAA0B,CAAC,mBAAmB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,EAAE;KACrE,CAAC;IACF,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS;QACxB,0BAA0B,CAAC,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC9D,GAAG,0BAA0B,CAAC,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,EAAE;KACpE,CAAC;CACH;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC;IACrC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,MAAM,iBAAiB,GAAG,CAC9B,QAAQ,EAAE,eAAe,CAAC,qBAAqB,CAAC,EAChD,OAAO,EAAE,wBAAwB,KAC9B,eAAe,CAAC,qBAAqB,CAAC,CAAC;AAE5C,MAAM,WAAW,yBAAyB,CAAC,IAAI,SAAS,qBAAqB;IAC3E,kFAAkF;IAClF,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE;QAAC,IAAI,EAAE,IAAI,CAAA;KAAC,KAAK,KAAK,CAAC,SAAS,CAAC;IAC1D,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC;CACzC;AAED,MAAM,MAAM,0BAA0B,CAAC,IAAI,SAAS,qBAAqB,IACvE,QAAQ,CAAC;KACN,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,yBAAyB,CACnD,OAAO,CAAC,IAAI,EAAE;QAAC,IAAI,EAAE,QAAQ,CAAA;KAAC,CAAC,CAChC;CACF,CAAC,CAAC;AAEL,UAAU,4BAA4B,CAAC,IAAI,SAAS,MAAM;IACxD,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,8BAA8B,CAC7C,IAAI,SAAS,MAAM,EACnB,IAAI,SAAS,qBAAqB,CAAC,IAAI,CAAC,CACxC,SAAQ,4BAA4B,CAAC,IAAI,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC,IAAI,CAAC,CAAC;IAChD,QAAQ,CAAC,SAAS,CAAC,EAAE,iBAAiB,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,0BAA0B,CAAC,IAAI,CAAC,CAAC;CACtD;AAED,MAAM,MAAM,iCAAiC,CAC3C,IAAI,SAAS,MAAM,EACnB,IAAI,SAAS,qBAAqB,CAAC,IAAI,CAAC,GAAG,KAAK,IAC9C,4BAA4B,CAAC,IAAI,CAAC,GAAG;IACvC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC;CACzB,GAAG,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GACrB;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,CAAA;CAAC,GAC5B;IAAC,QAAQ,CAAC,SAAS,EAAE,0BAA0B,CAAC,IAAI,CAAC,CAAA;CAAC,CAAC,CAAC;AAE9D,MAAM,MAAM,wBAAwB,CAClC,IAAI,SAAS,MAAM,EACnB,IAAI,SAAS,qBAAqB,CAAC,IAAI,CAAC,GAAG,KAAK,IAE9C,8BAA8B,CAAC,IAAI,EAAE,IAAI,CAAC,GAC1C,iCAAiC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAElD,OAAO,CAAC,MAAM,kBAAkB,EAAE,OAAO,MAAM,CAAC;AAEhD,2EAA2E;AAC3E,MAAM,WAAW,mBAAmB,CAClC,IAAI,SAAS,qBAAqB,GAAG,qBAAqB;IAE1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;IACvB,QAAQ,CAAC,CAAC,kBAAkB,CAAC,EAAE,IAAI,CAAC;CACrC;AAED,MAAM,MAAM,cAAc,CAAC,KAAK,IAC9B,KAAK,SAAS,mBAAmB,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,CAAC;AAE/D,MAAM,MAAM,oBAAoB,CAC9B,OAAO,SAAS,aAAa,CAAC,mBAAmB,CAAC,IAChD,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;AA0FpC,wBAAgB,oBAAoB,CAClC,KAAK,CAAC,IAAI,SAAS,MAAM,EACzB,KAAK,CAAC,IAAI,SAAS,qBAAqB,CAAC,IAAI,CAAC,EAE9C,UAAU,EAAE,8BAA8B,CAAC,IAAI,EAAE,IAAI,CAAC,GACrD,mBAAmB,CAAC,IAAI,CAAC,CAAC;AAC7B,wBAAgB,oBAAoB,CAAC,KAAK,CAAC,IAAI,SAAS,MAAM,EAC5D,UAAU,EAAE,iCAAiC,CAAC,IAAI,EAAE,KAAK,CAAC,GACzD,mBAAmB,CAAC,KAAK,CAAC,CAAC;AAC9B,wBAAgB,oBAAoB,CAClC,KAAK,CAAC,IAAI,SAAS,MAAM,EACzB,KAAK,CAAC,IAAI,SAAS,qBAAqB,CAAC,IAAI,CAAC,EAE9C,UAAU,EAAE,iCAAiC,CAAC,IAAI,EAAE,IAAI,CAAC,GACxD,mBAAmB,CAAC,IAAI,CAAC,CAAC;AA2C7B,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,0BAA0B,CAAC;CACnD;AAED,UAAU,iBAAiB;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;CACvC;AAED,UAAU,gBAAgB;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAC,qBAAqB,CAAC,CAAC;CACrE;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;IACrD,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;IAC3D,QAAQ,CAAC,sBAAsB,EAAE,WAAW,CAC1C,MAAM,EACN,aAAa,CAAC,0BAA0B,CAAC,CAC1C,CAAC;IACF,QAAQ,CAAC,qBAAqB,EAAE,WAAW,CACzC,MAAM,EACN,aAAa,CAAC,0BAA0B,CAAC,CAC1C,CAAC;IACF,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;IACtD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC3D;AAoCD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,aAAa,CAAC,mBAAmB,CAAC,GAC1C,uBAAuB,GAAG,SAAS,CAuFrC;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,IAAI,GAAE,GAAG,CAAC,MAAM,CAAa,GAC5B,KAAK,IAAI,kBAAkB,CA2B7B;AAED,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,kBAAkB,EACnE,KAAK,EAAE,CAAC,GACP,CAAC,CAQH;AA+bD,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,QAAQ,GAAG,WAAW,GAAG,QAAQ,EACxC,KAAK,EAAE,OAAO,GACb,IAAI,CAWN;AAED,wBAAgB,uBAAuB,CAAC,IAAI,SAAS,qBAAqB,EACxE,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC,EAC3B,OAAO,EAAE,uBAAuB,GAAG,SAAS,EAC5C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,QAAQ,GAAG,OAAO,GAC1B,eAAe,CAAC,IAAI,CAAC,CAuDvB;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,uBAAuB,GAAG,SAAS,EAC5C,IAAI,EAAE,qBAAqB,GAC1B,yBAAyB,CAAC,qBAAqB,CAAC,GAAG,SAAS,CAE9D;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,uBAAuB,GAAG,SAAS,EAC5C,IAAI,EAAE,qBAAqB,GAC1B,MAAM,CAWR"}
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../src/Markdown/plugins/protocol.ts"],"names":[],"mappings":"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"}

package/dist/Markdown/plugins/protocol.js

@@ -12,6 +12,17 @@ import { isSafeMarkdownParserUrl } from "../url.js";
 export function isMarkdownExtensionNode(node, plugin, name) {
   return node.type === 'extension' && node.plugin === plugin && node.name === name;
 }
+const markdownTransformClaim = Symbol('MarkdownTransformClaim');
+/** @internal Registers a cheap source-level claim check for a helper transform. */
+export function markMarkdownTransformClaim(transform, claims) {
+  Object.defineProperty(transform, markdownTransformClaim, {
+    configurable: false,
+    enumerable: false,
+    value: claims,
+    writable: false
+  });
+  return transform;
+}
 
 /** Opaque, covariant entry safe to store in heterogeneous plugin lists. */
 
@@ -147,7 +158,8 @@ export function prepareMarkdownPlugins(plugins) {
     if (definition.transform != null) {
       transforms.push({
         pluginName: definition.name,
-        transform: definition.transform
+        transform: definition.transform,
+        claims: definition.transform[markdownTransformClaim]
       });
     }
     if (definition.renderers != null) {
@@ -503,9 +515,19 @@ export function applyMarkdownTransforms(root, plugins, source, isFinal, display)
   }
   const pluginNames = new Set(plugins.entries.map(entry => entry.name));
   const rendererKeys = new Set(plugins.renderers.keys());
-  const sourceHeadingMarkers = markSourceHeadings(root);
-  let document = freezeAst(root);
+  let document = root;
+  let sourceHeadingMarkers;
+  let started = false;
+  let priorTransformChangedTree = false;
   for (const prepared of plugins.transforms) {
+    if (!priorTransformChangedTree && prepared.claims?.(source) === false) {
+      continue;
+    }
+    if (!started) {
+      sourceHeadingMarkers = markSourceHeadings(root);
+      document = freezeAst(root);
+      started = true;
+    }
     try {
       const next = prepared.transform(document, {
         source,
@@ -527,6 +549,7 @@ export function applyMarkdownTransforms(root, plugins, source, isFinal, display)
       if (!validateAst(next, pluginNames, rendererKeys, positions, sourceHeadingMarkers, prepared.pluginName, existingExtensions, display)) {
         throw new TypeError('Transform returned an invalid Markdown document');
       }
+      priorTransformChangedTree = true;
       document = freezeAst(next);
     } catch (error) {
       reportMarkdownPluginFailure(prepared.pluginName, 'transform', error);

package/dist/Markdown/plugins/textTransform.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @file textTransform.ts
+ * @input Regex selectors and replacement callbacks for eligible Markdown prose
+ * @output Immutable Markdown transforms with protected-context traversal
+ * @position Optional helper layer compiled onto the core transform protocol
+ */
+import type { MarkdownAstPhrasingContent } from '../ast';
+import { type MarkdownExtensionNode, type MarkdownTransform } from './protocol';
+export interface MarkdownTextTransformContext {
+    readonly parentType: 'heading' | 'paragraph' | 'strong' | 'emphasis' | 'delete' | 'tableCell';
+}
+export interface MarkdownTextTransformOptions<Node extends MarkdownExtensionNode = never> {
+    /** Global expression matched against eligible built-in prose only. */
+    readonly pattern: RegExp;
+    /**
+     * Literal substrings such that source containing an eligible match contains
+     * at least one. Core uses them to skip the transform without walking the AST
+     * when none are present. Omit this optimization when no conservative literal
+     * exists; the helper will inspect eligible prose on every run. This fast path
+     * is also disabled for case-insensitive patterns so JavaScript case folding
+     * remains exact.
+     */
+    readonly requiredSubstrings?: readonly [string, ...string[]];
+    /** Optionally decline or extend a regex claim. */
+    readonly getEndIndex?: (text: string, match: RegExpExecArray) => number | false;
+    replace(match: RegExpExecArray, context: MarkdownTextTransformContext): MarkdownAstPhrasingContent<Node> | ReadonlyArray<MarkdownAstPhrasingContent<Node>>;
+}
+export declare function createMarkdownTextTransform(options: MarkdownTextTransformOptions<never>): MarkdownTransform<never>;
+export declare function createMarkdownTextTransform<Node extends MarkdownExtensionNode>(options: MarkdownTextTransformOptions<Node>): MarkdownTransform<Node>;
+//# sourceMappingURL=textTransform.d.ts.map

package/dist/Markdown/plugins/textTransform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textTransform.d.ts","sourceRoot":"","sources":["../../../src/Markdown/plugins/textTransform.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,OAAO,KAAK,EAA0B,0BAA0B,EAAC,MAAM,QAAQ,CAAC;AAChF,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACvB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,UAAU,EACjB,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,WAAW,CAAC;CAC5E;AAED,MAAM,WAAW,4BAA4B,CAC3C,IAAI,SAAS,qBAAqB,GAAG,KAAK;IAE1C,sEAAsE;IACtE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;;;;;OAOG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IAC7D,kDAAkD;IAClD,QAAQ,CAAC,WAAW,CAAC,EAAE,CACrB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,eAAe,KACnB,MAAM,GAAG,KAAK,CAAC;IACpB,OAAO,CACL,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,4BAA4B,GAEnC,0BAA0B,CAAC,IAAI,CAAC,GAChC,aAAa,CAAC,0BAA0B,CAAC,IAAI,CAAC,CAAC,CAAC;CACrD;AA6ND,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,4BAA4B,CAAC,KAAK,CAAC,GAC3C,iBAAiB,CAAC,KAAK,CAAC,CAAC;AAC5B,wBAAgB,2BAA2B,CAAC,IAAI,SAAS,qBAAqB,EAC5E,OAAO,EAAE,4BAA4B,CAAC,IAAI,CAAC,GAC1C,iBAAiB,CAAC,IAAI,CAAC,CAAC"}

package/dist/Markdown/plugins/textTransform.js

@@ -0,0 +1,226 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file textTransform.ts
+ * @input Regex selectors and replacement callbacks for eligible Markdown prose
+ * @output Immutable Markdown transforms with protected-context traversal
+ * @position Optional helper layer compiled onto the core transform protocol
+ */
+
+import { markMarkdownTransformClaim } from "./protocol.js";
+function sameItems(left, right) {
+  return left.length === right.length && left.every((value, index) => value === right[index]);
+}
+function cloneReplacement(value, seen = new Map()) {
+  if (value == null || typeof value !== 'object') {
+    return value;
+  }
+  const cached = seen.get(value);
+  if (cached != null) {
+    return cached;
+  }
+  if (Array.isArray(value)) {
+    const clone = [];
+    seen.set(value, clone);
+    for (const item of value) {
+      clone.push(cloneReplacement(item, seen));
+    }
+    return clone;
+  }
+  if (Object.getPrototypeOf(value) !== Object.prototype) {
+    return value;
+  }
+  const clone = {};
+  seen.set(value, clone);
+  for (const [key, nested] of Object.entries(value)) {
+    clone[key] = cloneReplacement(nested, seen);
+  }
+  return clone;
+}
+function advanceStringIndex(value, index, unicode) {
+  if (!unicode || index >= value.length) {
+    return index + 1;
+  }
+  const first = value.charCodeAt(index);
+  if (first < 0xd800 || first > 0xdbff || index + 1 >= value.length) {
+    return index + 1;
+  }
+  const second = value.charCodeAt(index + 1);
+  return second >= 0xdc00 && second <= 0xdfff ? index + 2 : index + 1;
+}
+function replaceTextNode(value, options, parentType) {
+  const pattern = new RegExp(options.pattern.source, options.pattern.flags);
+  const output = [];
+  let cursor = 0;
+  let changed = false;
+  let match;
+  while ((match = pattern.exec(value)) != null) {
+    const start = match.index;
+    const defaultEnd = start + match[0].length;
+    const resolvedEnd = options.getEndIndex?.(value, match) ?? defaultEnd;
+    if (resolvedEnd === false) {
+      if (match[0].length === 0) {
+        pattern.lastIndex = advanceStringIndex(value, pattern.lastIndex, pattern.unicode || pattern.flags.includes('v'));
+      }
+      continue;
+    }
+    if (!Number.isInteger(resolvedEnd) || resolvedEnd < defaultEnd || resolvedEnd < start || resolvedEnd > value.length) {
+      throw new TypeError('Markdown text transform returned an invalid end index');
+    }
+    if (start < cursor) {
+      continue;
+    }
+    if (start > cursor) {
+      output.push({
+        type: 'text',
+        value: value.slice(cursor, start)
+      });
+    }
+    const replacement = options.replace(match, {
+      parentType
+    });
+    const replacements = Array.isArray(replacement) ? replacement : [replacement];
+    for (const replacementNode of replacements) {
+      output.push(cloneReplacement(replacementNode));
+    }
+    cursor = resolvedEnd;
+    pattern.lastIndex = resolvedEnd === start ? advanceStringIndex(value, pattern.lastIndex, pattern.unicode || pattern.flags.includes('v')) : Math.max(pattern.lastIndex, resolvedEnd);
+    changed = true;
+  }
+  if (!changed) {
+    return null;
+  }
+  if (cursor < value.length) {
+    output.push({
+      type: 'text',
+      value: value.slice(cursor)
+    });
+  }
+  return output;
+}
+function transformPhrasing(children, options, parentType) {
+  const next = [];
+  for (const node of children) {
+    if (node.type === 'text') {
+      next.push(...(replaceTextNode(node.value, options, parentType) ?? [node]));
+      continue;
+    }
+    if (node.type === 'strong' || node.type === 'emphasis' || node.type === 'delete') {
+      const nested = transformPhrasing(node.children, options, node.type);
+      next.push(sameItems(node.children, nested) ? node : {
+        ...node,
+        children: nested
+      });
+      continue;
+    }
+    // Links, images, code, math, citations, breaks, and accepted extension
+    // syntax are protected contexts owned by their existing semantics.
+    next.push(node);
+  }
+  return sameItems(children, next) ? children : next;
+}
+function transformBlocks(blocks, options) {
+  const next = blocks.map(block => {
+    switch (block.type) {
+      case 'heading':
+      case 'paragraph':
+        {
+          const children = transformPhrasing(block.children, options, block.type);
+          return children === block.children ? block : {
+            ...block,
+            children
+          };
+        }
+      case 'blockquote':
+        {
+          const children = transformBlocks(block.children, options);
+          return children === block.children ? block : {
+            ...block,
+            children
+          };
+        }
+      case 'list':
+        {
+          let changed = false;
+          const children = block.children.map(item => {
+            const itemChildren = transformBlocks(item.children, options);
+            if (itemChildren === item.children) {
+              return item;
+            }
+            changed = true;
+            return {
+              ...item,
+              children: itemChildren
+            };
+          });
+          return changed ? {
+            ...block,
+            children
+          } : block;
+        }
+      case 'table':
+        {
+          let changed = false;
+          const children = block.children.map(row => {
+            let rowChanged = false;
+            const cells = row.children.map(cell => {
+              const cellChildren = transformPhrasing(cell.children, options, 'tableCell');
+              if (cellChildren === cell.children) {
+                return cell;
+              }
+              rowChanged = true;
+              return {
+                ...cell,
+                children: cellChildren
+              };
+            });
+            if (!rowChanged) {
+              return row;
+            }
+            changed = true;
+            return {
+              ...row,
+              children: cells
+            };
+          });
+          return changed ? {
+            ...block,
+            children
+          } : block;
+        }
+      case 'code':
+      case 'math':
+      case 'image':
+      case 'thematicBreak':
+      case 'extension':
+        return block;
+    }
+  });
+  return sameItems(blocks, next) ? blocks : next;
+}
+export function createMarkdownTextTransform(options) {
+  if (!options.pattern.global) {
+    throw new TypeError('Markdown text transform patterns must use the global flag');
+  }
+  if (options.requiredSubstrings != null && (!Array.isArray(options.requiredSubstrings) || options.requiredSubstrings.length === 0 || options.requiredSubstrings.some(value => typeof value !== 'string' || value === ''))) {
+    throw new TypeError('Markdown text transform requiredSubstrings must be non-empty strings');
+  }
+  const requiredSubstrings = options.requiredSubstrings == null ? undefined : Object.freeze([...options.requiredSubstrings]);
+  const normalizedOptions = Object.freeze({
+    pattern: new RegExp(options.pattern.source, options.pattern.flags),
+    requiredSubstrings,
+    getEndIndex: options.getEndIndex,
+    replace: options.replace
+  });
+  const transform = root => {
+    const children = transformBlocks(root.children, normalizedOptions);
+    return children === root.children ? root : {
+      ...root,
+      children
+    };
+  };
+  if (requiredSubstrings == null || options.pattern.ignoreCase) {
+    return transform;
+  }
+  return markMarkdownTransformClaim(transform, source => requiredSubstrings.some(required => source.includes(required)));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astryxdesign/core",
-  "version": "0.6.2-canary.d993f65",
+  "version": "0.6.2-canary.eec3a19",
   "displayName": "Astryx Core",
   "description": "The component library. Accessible, themeable React components with built-in spacing, dark mode, and StyleX styling.",
   "author": "Meta Open Source",
@@ -677,8 +677,8 @@
     "react-dom": ">=19.0.0"
   },
   "devDependencies": {
-    "@astryxdesign/a11y-spec": "0.6.2-canary.d993f65",
-    "@astryxdesign/cli": "0.6.2-canary.d993f65",
+    "@astryxdesign/a11y-spec": "0.6.2-canary.eec3a19",
+    "@astryxdesign/cli": "0.6.2-canary.eec3a19",
     "@babel/cli": "^7.29.7",
     "@babel/core": "^7.29.7",
     "@babel/preset-react": "^7.29.7",

package/src/Markdown/Markdown.doc.mjs

@@ -252,6 +252,11 @@ export const docs = {
         description:
           'Use plugins created by createMarkdownPlugin for reusable syntax, immutable AST transforms, and typed extension rendering. Keep the ordered list stable while its syntax configuration is unchanged.',
       },
+      {
+        guidance: true,
+        description:
+          'Use createMarkdownTextTransform for prose matching; it preserves code, links, images, citations, math, and accepted extension syntax as protected contexts. Provide requiredSubstrings only when they conservatively cover every possible match.',
+      },
       {
         guidance: true,
         description:
@@ -302,24 +307,22 @@ import {Text} from '@astryxdesign/core/Text';
 `,
     },
     {
-      label: 'Immutable transform plugin',
+      label: 'Text transform helper',
       code: `
 import {Markdown} from '@astryxdesign/core/Markdown';
-import {createMarkdownPlugin} from '@astryxdesign/core/Markdown/plugins';
+import {
+  createMarkdownPlugin,
+  createMarkdownTextTransform,
+} from '@astryxdesign/core/Markdown/plugins';
 
 const finalLabels = createMarkdownPlugin({
   name: 'final-labels',
   apiVersion: 1,
-  transform(root) {
-    return {
-      ...root,
-      children: root.children.map(node =>
-        node.type === 'heading'
-          ? {...node, children: [{type: 'text', value: 'Final'}]}
-          : node,
-      ),
-    };
-  },
+  transform: createMarkdownTextTransform({
+    pattern: /\\bDraft\\b/g,
+    requiredSubstrings: ['Draft'],
+    replace: () => ({type: 'text', value: 'Final'}),
+  }),
 });
 
 <Markdown plugins={[finalLabels]}># Draft</Markdown>;
@@ -553,6 +556,11 @@ export const docsZh = {
         description:
           'Use plugins created by createMarkdownPlugin for reusable syntax, immutable AST transforms, and typed extension rendering. Keep the ordered list stable while its syntax configuration is unchanged.',
       },
+      {
+        guidance: true,
+        description:
+          'Use createMarkdownTextTransform for prose matching; it preserves code, links, images, citations, math, and accepted extension syntax as protected contexts. Provide requiredSubstrings only when they conservatively cover every possible match.',
+      },
       {
         guidance: true,
         description:
@@ -605,6 +613,11 @@ export const docsDense = {
         description:
           'Use plugins created by createMarkdownPlugin for reusable syntax, immutable AST transforms, and typed extension rendering. Keep the ordered list stable while its syntax configuration is unchanged.',
       },
+      {
+        guidance: true,
+        description:
+          'Use createMarkdownTextTransform for prose matching; it preserves code, links, images, citations, math, and accepted extension syntax as protected contexts. Provide requiredSubstrings only when they conservatively cover every possible match.',
+      },
       {
         guidance: true,
         description:

package/src/Markdown/Markdown.helpers.perf.test.ts

@@ -0,0 +1,89 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file Markdown.helpers.perf.test.ts
+ * @input Deterministic 200/500-section Markdown and zero-work text helpers
+ * @output Zero helper-transform invocations for hinted no-claim plugins
+ * @position Helper dispatch regression; full FR23 evidence lands after all helpers
+ */
+
+import {describe, expect, it} from 'vitest';
+import {parseMarkdown} from './parser';
+import {createMarkdownPlugin} from './plugins';
+import type {MarkdownTransform} from './plugins/protocol';
+import {createMarkdownTextTransform} from './plugins/textTransform';
+
+let transformCalls = 0;
+
+function benchmarkDocument(sections: number): string {
+  return Array.from({length: sections}, (_, index) =>
+    [
+      `## Section ${index}`,
+      '',
+      `AST-${index} belongs to @{owner-${index}} with TODO follow-up.`,
+      '',
+      `- First item ${index}`,
+      '- Second item',
+      '',
+      `> Quoted detail ${index}`,
+      '',
+      '| Item | Detail |',
+      '| --- | --- |',
+      `| ${index} | ordinary prose |`,
+      '',
+      '```text',
+      `opaque ${index}`,
+      '```',
+    ].join('\n'),
+  ).join('\n\n');
+}
+
+function observeTransformCalls(
+  transform: MarkdownTransform,
+): MarkdownTransform {
+  const observed: MarkdownTransform = (root, context) => {
+    transformCalls++;
+    return transform(root, context);
+  };
+  // Preserve the helper's private source-claim metadata on the observer.
+  Object.defineProperties(
+    observed,
+    Object.getOwnPropertyDescriptors(transform),
+  );
+  return observed;
+}
+
+const zeroWorkPlugins = Array.from({length: 5}, (_, index) =>
+  createMarkdownPlugin({
+    name: `zero-work-${index}`,
+    apiVersion: 1,
+    transform: observeTransformCalls(
+      createMarkdownTextTransform({
+        pattern: new RegExp(`NEVER_MATCH_${index}`, 'g'),
+        requiredSubstrings: [`NEVER_MATCH_${index}`],
+        replace: () => {
+          throw new Error('An unclaimed helper callback ran');
+        },
+      }),
+    ),
+  }),
+);
+
+describe('Markdown helper performance', () => {
+  it.each([200, 500])(
+    'skips five hinted no-claim helpers at %i sections',
+    sections => {
+      const source = benchmarkDocument(sections);
+      const baseline = parseMarkdown(source);
+      transformCalls = 0;
+
+      expect(parseMarkdown(source, {plugins: zeroWorkPlugins})).toEqual(
+        baseline,
+      );
+      expect(parseMarkdown(source, {plugins: [...zeroWorkPlugins]})).toEqual(
+        baseline,
+      );
+      expect(transformCalls).toBe(0);
+    },
+  );
+});

package/src/Markdown/Markdown.public.test.ts

@@ -15,7 +15,11 @@ import {
   parseMarkdownIncremental,
   visitMarkdownNodes,
 } from './index';
-import {createMarkdownPlugin, isMarkdownExtensionNode} from './plugins';
+import {
+  createMarkdownPlugin,
+  createMarkdownTextTransform,
+  isMarkdownExtensionNode,
+} from './plugins';
 import type {
   MarkdownExtensionNode,
   MarkdownSyntaxPluginDefinition,
@@ -193,6 +197,7 @@ describe('Markdown public parser types', () => {
 
     expectTypeOf(nodes).toEqualTypeOf<InlineNode<PublicNode>[]>();
     expectTypeOf(visitMarkdownNodes).toBeFunction();
+    expectTypeOf(createMarkdownTextTransform).toBeFunction();
     expectTypeOf(isMarkdownExtensionNode).toBeFunction();
 
     function compileOnlyPluginGuards() {

package/src/Markdown/plugins/index.ts

@@ -7,6 +7,11 @@
  */
 
 export {createMarkdownPlugin, isMarkdownExtensionNode} from './protocol';
+export {createMarkdownTextTransform} from './textTransform';
+export type {
+  MarkdownTextTransformContext,
+  MarkdownTextTransformOptions,
+} from './textTransform';
 export type {
   MarkdownPluginData,
   MarkdownExtensionNode,