@astryxdesign/lab 0.2.0-canary.f7ec5f5 → 0.2.0-canary.fce8b64

package/dist/BottomSheet/BottomSheet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BottomSheet.d.ts","sourceRoot":"","sources":["../../src/BottomSheet/BottomSheet.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAiC,KAAK,SAAS,EAAC,MAAM,OAAO,CAAC;AAErE,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,oBAAoB,CAAC;AAqBlD;;;;;;GAMG;AACH,QAAA,MAAM,cAAc;;;;CAIV,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,cAAc,CAAC;AAuJ5D,MAAM,WAAW,gBAAiB,SAAQ,SAAS,CAAC,iBAAiB,CAAC;IACpE,wDAAwD;IACxD,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAEnC,8EAA8E;IAC9E,MAAM,EAAE,OAAO,CAAC;IAEhB;;;;OAIG;IACH,YAAY,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IAExC;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd,0EAA0E;IAC1E,QAAQ,EAAE,SAAS,CAAC;IAEpB;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,EAAE,iBAAiB,GAAG,MAAM,GAAG,MAAM,CAAC;IAE7C,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CAAC,EAC1B,GAAG,EACH,MAAM,EACN,YAAY,EACZ,KAAK,EACL,QAAQ,EACR,MAAiB,EACjB,MAAM,EACN,GAAG,KAAK,EACT,EAAE,gBAAgB,+BAyKlB;yBAlLe,WAAW"}
+{"version":3,"file":"BottomSheet.d.ts","sourceRoot":"","sources":["../../src/BottomSheet/BottomSheet.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAiC,KAAK,SAAS,EAAC,MAAM,OAAO,CAAC;AAErE,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,oBAAoB,CAAC;AAqBlD;;;;;;GAMG;AACH,QAAA,MAAM,cAAc;;;;CAIV,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,cAAc,CAAC;AAyJ5D,MAAM,WAAW,gBAAiB,SAAQ,SAAS,CAAC,iBAAiB,CAAC;IACpE,wDAAwD;IACxD,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAEnC,8EAA8E;IAC9E,MAAM,EAAE,OAAO,CAAC;IAEhB;;;;OAIG;IACH,YAAY,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IAExC;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd,0EAA0E;IAC1E,QAAQ,EAAE,SAAS,CAAC;IAEpB;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,EAAE,iBAAiB,GAAG,MAAM,GAAG,MAAM,CAAC;IAE7C,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CAAC,EAC1B,GAAG,EACH,MAAM,EACN,YAAY,EACZ,KAAK,EACL,QAAQ,EACR,MAAiB,EACjB,MAAM,EACN,GAAG,KAAK,EACT,EAAE,gBAAgB,+BAyKlB;yBAlLe,WAAW"}

package/dist/BottomSheet/BottomSheet.js

@@ -248,10 +248,10 @@ export function BottomSheet({
   return /*#__PURE__*/_jsx("dialog", {
     ...{
       0: {
-        className: "xixxii4 x10a8y8t x1o6l61p xtdtrs8 x1x1rfll x7ab17h x1ghz6dp x1717udv xjbqb8w x1rea2x4 x47corl x1s85apg x1a2a7pz xnixb3f x1abwkk1 xni466t xxiuuzi xc0dz0a xft5bk6 x15h3t91 x142juwg x1viac0w"
+        className: "xixxii4 x10a8y8t x1o6l61p xtdtrs8 x1x1rfll x7ab17h x1ghz6dp x1717udv xjbqb8w x1rea2x4 x1s85apg x1a2a7pz xnixb3f x1abwkk1 xni466t xxiuuzi xc0dz0a xft5bk6 x15h3t91 x142juwg x1viac0w"
       },
       1: {
-        className: "xixxii4 x10a8y8t x1o6l61p xtdtrs8 x1x1rfll x7ab17h x1ghz6dp x1717udv xjbqb8w x1rea2x4 x47corl x1a2a7pz x1lliihq xnixb3f x1abwkk1 xni466t xxiuuzi xc0dz0a xft5bk6 x15h3t91 x142juwg x1viac0w"
+        className: "xixxii4 x10a8y8t x1o6l61p xtdtrs8 x1x1rfll x7ab17h x1ghz6dp x1717udv xjbqb8w x1rea2x4 x1a2a7pz x1lliihq xnixb3f x1abwkk1 xni466t xxiuuzi xc0dz0a xft5bk6 x15h3t91 x142juwg x1viac0w"
       }
     }[!!isOpen << 0],
     ref: mergeRefs(ref, dialogRef),

package/dist/Chart/index.d.ts

@@ -21,7 +21,7 @@ export { isBandScale, xPixel } from './utils';
 export { useChartColors } from './useChartColors';
 export { getChartColors, getChartColorsFromResolver, type ChartColorsAPI, type SequentialHue, type TokenResolver, } from './getChartColors';
 export { useChartRange, type UseChartRangeOptions, type UseChartRangeReturn, } from './useChartRange';
-export { hexToGL, getCanvasDPR, getWebGLContext, setupGLState, sizeCanvas, mountCanvasOverSVG, compileShader, createProgram as createGLProgram, CIRCLE_FRAG_BODY, POINT_SIZE_COMPENSATION, } from './webgl';
+export { hexToGL, getCanvasDPR, getWebGLContext, setupGLState, sizeCanvas, mountCanvasOverSVG, compileShader, CIRCLE_FRAG_BODY, POINT_SIZE_COMPENSATION, } from './webgl';
 export { ChartBrush, type ChartBrushProps, type BrushMode, type BrushRange, } from './ChartBrush';
 export { ChartZoom, type ChartZoomProps, type ZoomToolbarPosition, } from './ChartZoom';
 export { ChartSelect, type ChartSelectProps } from './ChartSelect';

package/dist/Chart/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Chart/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,KAAK,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,EAAC,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAC,SAAS,EAAE,KAAK,cAAc,EAAC,MAAM,aAAa,CAAC;AAC3D,OAAO,EACL,aAAa,EACb,QAAQ,EACR,OAAO,EACP,SAAS,EACT,SAAS,GACV,MAAM,cAAc,CAAC;AACtB,OAAO,EAAC,SAAS,EAAE,KAAK,cAAc,EAAC,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAC,QAAQ,EAAE,KAAK,aAAa,EAAC,MAAM,YAAY,CAAC;AACxD,OAAO,EAAC,SAAS,EAAE,KAAK,cAAc,EAAC,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAC,SAAS,EAAE,KAAK,cAAc,EAAC,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAC,aAAa,EAAE,KAAK,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AACvE,OAAO,EACL,gBAAgB,EAChB,KAAK,qBAAqB,GAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAC,QAAQ,EAAE,KAAK,aAAa,EAAC,MAAM,YAAY,CAAC;AACxD,OAAO,EAAC,UAAU,EAAE,KAAK,eAAe,EAAC,MAAM,cAAc,CAAC;AAC9D,OAAO,EACL,qBAAqB,EACrB,KAAK,0BAA0B,GAChC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,cAAc,EACd,KAAK,mBAAmB,GACzB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,aAAa,EACb,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,YAAY,EACZ,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,GACxB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,WAAW,EACX,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAC,QAAQ,EAAC,MAAM,gBAAgB,CAAC;AACxC,YAAY,EAAC,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAC,MAAM,SAAS,CAAC;AAC9E,OAAO,EAAC,QAAQ,EAAE,KAAK,OAAO,EAAC,MAAM,MAAM,CAAC;AAC5C,OAAO,EAAC,WAAW,EAAE,MAAM,EAAC,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAC;AAChD,OAAO,EACL,cAAc,EACd,0BAA0B,EAC1B,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,OAAO,EACP,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,aAAa,EACb,aAAa,IAAI,eAAe,EAChC,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,UAAU,EACV,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,UAAU,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,SAAS,EACT,KAAK,cAAc,EACnB,KAAK,mBAAmB,GACzB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAC,WAAW,EAAE,KAAK,gBAAgB,EAAC,MAAM,eAAe,CAAC;AACjE,OAAO,EACL,kBAAkB,EAClB,KAAK,uBAAuB,GAC7B,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Chart/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,KAAK,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,EAAC,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAC,SAAS,EAAE,KAAK,cAAc,EAAC,MAAM,aAAa,CAAC;AAC3D,OAAO,EACL,aAAa,EACb,QAAQ,EACR,OAAO,EACP,SAAS,EACT,SAAS,GACV,MAAM,cAAc,CAAC;AACtB,OAAO,EAAC,SAAS,EAAE,KAAK,cAAc,EAAC,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAC,QAAQ,EAAE,KAAK,aAAa,EAAC,MAAM,YAAY,CAAC;AACxD,OAAO,EAAC,SAAS,EAAE,KAAK,cAAc,EAAC,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAC,SAAS,EAAE,KAAK,cAAc,EAAC,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAC,aAAa,EAAE,KAAK,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AACvE,OAAO,EACL,gBAAgB,EAChB,KAAK,qBAAqB,GAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAC,QAAQ,EAAE,KAAK,aAAa,EAAC,MAAM,YAAY,CAAC;AACxD,OAAO,EAAC,UAAU,EAAE,KAAK,eAAe,EAAC,MAAM,cAAc,CAAC;AAC9D,OAAO,EACL,qBAAqB,EACrB,KAAK,0BAA0B,GAChC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,cAAc,EACd,KAAK,mBAAmB,GACzB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,aAAa,EACb,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,YAAY,EACZ,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,GACxB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,WAAW,EACX,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAC,QAAQ,EAAC,MAAM,gBAAgB,CAAC;AACxC,YAAY,EAAC,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAC,MAAM,SAAS,CAAC;AAC9E,OAAO,EAAC,QAAQ,EAAE,KAAK,OAAO,EAAC,MAAM,MAAM,CAAC;AAC5C,OAAO,EAAC,WAAW,EAAE,MAAM,EAAC,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAC;AAChD,OAAO,EACL,cAAc,EACd,0BAA0B,EAC1B,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,OAAO,EACP,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,UAAU,EACV,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,UAAU,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,SAAS,EACT,KAAK,cAAc,EACnB,KAAK,mBAAmB,GACzB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAC,WAAW,EAAE,KAAK,gBAAgB,EAAC,MAAM,eAAe,CAAC;AACjE,OAAO,EACL,kBAAkB,EAClB,KAAK,uBAAuB,GAC7B,MAAM,sBAAsB,CAAC"}

package/dist/Chart/index.js

@@ -22,7 +22,7 @@ export { isBandScale, xPixel } from "./utils.js";
 export { useChartColors } from "./useChartColors.js";
 export { getChartColors, getChartColorsFromResolver } from "./getChartColors.js";
 export { useChartRange } from "./useChartRange.js";
-export { hexToGL, getCanvasDPR, getWebGLContext, setupGLState, sizeCanvas, mountCanvasOverSVG, compileShader, createProgram as createGLProgram, CIRCLE_FRAG_BODY, POINT_SIZE_COMPENSATION } from "./webgl.js";
+export { hexToGL, getCanvasDPR, getWebGLContext, setupGLState, sizeCanvas, mountCanvasOverSVG, compileShader, CIRCLE_FRAG_BODY, POINT_SIZE_COMPENSATION } from "./webgl.js";
 export { ChartBrush } from "./ChartBrush.js";
 export { ChartZoom } from "./ChartZoom.js";
 export { ChartSelect } from "./ChartSelect.js";

package/dist/RichTextEditor/RichTextEditorAutoLinkPlugin.d.ts

@@ -0,0 +1,85 @@
+/**
+ * @file RichTextEditorAutoLinkPlugin.tsx
+ * @input Uses `@lexical/react/LexicalAutoLinkPlugin` (`AutoLinkPlugin`,
+ *   `createLinkMatcherWithRegExp`) and the shared URL/email matchers from
+ *   `linkUtils`.
+ * @output Exports `RichTextEditorAutoLinkPlugin` and its props type, plus the
+ *   default `DEFAULT_LINK_MATCHERS`.
+ * @position Experimental (lab). Drop into RichTextEditor's `plugins` slot to
+ *   auto-linkify URLs and emails as they are typed or pasted. Requires
+ *   `AutoLinkNode` to be registered (it is, by default).
+ *
+ * SYNC: When modified, update:
+ * - /packages/lab/src/RichTextEditor/index.ts (exports)
+ * - /packages/lab/src/index.ts (barrel re-export)
+ * - /packages/lab/src/RichTextEditor/RichTextEditor.doc.mjs (usage notes)
+ * - /packages/lab/src/RichTextEditor/RichTextEditor.test.tsx (tests)
+ * - /apps/storybook/stories/RichTextEditor.stories.tsx (story)
+ *
+ * NOTE: Experimental `@astryxdesign/lab` component (canary). `lexical` and
+ * `@lexical/*` are OPTIONAL peer dependencies — install them to use this.
+ *
+ * COMPATIBILITY: astryx aims for its RichTextEditor internals to eventually
+ * back Meta's EPS `EPSRichTextArea` (nest/libs/eps-lexical). EPS's auto-link is
+ * matcher-driven and applies `target="_blank"` + `rel="noopener noreferrer"` to
+ * created links (its `NEW_TAB_LINK_ATTRIBUTES`). This plugin uses the same
+ * matcher shape (`createLinkMatcherWithRegExp` + `attributes`) and the same
+ * new-tab defaults, so EPS can pass its own richer matcher set (e.g. shortform
+ * `D123` / `T456` / `S789` intern URLs) through the `matchers` prop without
+ * changing the contract. EPS ships a hardened fork of the transform itself
+ * (expanded separators, code-block exclusion) — astryx stays on the OSS
+ * `AutoLinkPlugin`, and EPS can substitute its own plugin in the same slot.
+ */
+import { type LinkMatcher } from '@lexical/react/LexicalAutoLinkPlugin';
+/**
+ * Attributes written onto every auto-created link so it opens in a new tab.
+ * `rel="noopener noreferrer"` is required whenever `target="_blank"` is set, to
+ * prevent reverse-tabnabbing. Matches EPS eps-lexical's `NEW_TAB_LINK_ATTRIBUTES`.
+ */
+export declare const NEW_TAB_LINK_ATTRIBUTES: {
+    readonly target: "_blank";
+    readonly rel: "noopener noreferrer";
+};
+/**
+ * Default matchers: bare URLs (defaulting to `https://` when scheme-less) and
+ * email addresses (as `mailto:` links). Both carry {@link NEW_TAB_LINK_ATTRIBUTES}.
+ * URLs are passed through {@link sanitizeUrl} so only http/https/mailto/tel
+ * schemes are ever written.
+ */
+export declare const DEFAULT_LINK_MATCHERS: LinkMatcher[];
+export interface RichTextEditorAutoLinkPluginProps {
+    /**
+     * Link matchers to use. Defaults to {@link DEFAULT_LINK_MATCHERS} (URLs +
+     * emails, opening in a new tab). Provide a custom array to recognize
+     * additional patterns (e.g. product-specific shortform references) — build
+     * each with `createLinkMatcherWithRegExp` from
+     * `@lexical/react/LexicalAutoLinkPlugin`.
+     */
+    matchers?: LinkMatcher[];
+    /**
+     * Called when a link is created, updated, or removed by auto-linking.
+     * Receives the new URL (or `null` when removed) and the previous URL.
+     */
+    onChange?: (url: string | null, prevUrl: string | null) => void;
+}
+/**
+ * Automatically converts typed/pasted URLs and email addresses into links.
+ * Render it inside the editor's `plugins` slot — it reaches the editor via
+ * `useLexicalComposerContext()`, so it must live within the editor's
+ * `LexicalComposer`. Requires `AutoLinkNode` (registered by default).
+ *
+ * @example
+ * ```
+ * import {RichTextEditor, RichTextEditorAutoLinkPlugin} from '@astryxdesign/lab';
+ *
+ * <RichTextEditor
+ *   label="Notes"
+ *   plugins={<RichTextEditorAutoLinkPlugin />}
+ * />
+ * ```
+ */
+export declare function RichTextEditorAutoLinkPlugin({ matchers, onChange, }: RichTextEditorAutoLinkPluginProps): import("react").JSX.Element;
+export declare namespace RichTextEditorAutoLinkPlugin {
+    var displayName: string;
+}
+//# sourceMappingURL=RichTextEditorAutoLinkPlugin.d.ts.map

package/dist/RichTextEditor/RichTextEditorAutoLinkPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RichTextEditorAutoLinkPlugin.d.ts","sourceRoot":"","sources":["../../src/RichTextEditor/RichTextEditorAutoLinkPlugin.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,sCAAsC,CAAC;AAG9C;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;;CAG1B,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,WAAW,EAc9C,CAAC;AAEF,MAAM,WAAW,iCAAiC;IAChD;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CACjE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,4BAA4B,CAAC,EAC3C,QAAgC,EAChC,QAAQ,GACT,EAAE,iCAAiC,+BAEnC;yBALe,4BAA4B"}

package/dist/RichTextEditor/RichTextEditorAutoLinkPlugin.js

@@ -0,0 +1,95 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+'use client';
+
+/**
+ * @file RichTextEditorAutoLinkPlugin.tsx
+ * @input Uses `@lexical/react/LexicalAutoLinkPlugin` (`AutoLinkPlugin`,
+ *   `createLinkMatcherWithRegExp`) and the shared URL/email matchers from
+ *   `linkUtils`.
+ * @output Exports `RichTextEditorAutoLinkPlugin` and its props type, plus the
+ *   default `DEFAULT_LINK_MATCHERS`.
+ * @position Experimental (lab). Drop into RichTextEditor's `plugins` slot to
+ *   auto-linkify URLs and emails as they are typed or pasted. Requires
+ *   `AutoLinkNode` to be registered (it is, by default).
+ *
+ * SYNC: When modified, update:
+ * - /packages/lab/src/RichTextEditor/index.ts (exports)
+ * - /packages/lab/src/index.ts (barrel re-export)
+ * - /packages/lab/src/RichTextEditor/RichTextEditor.doc.mjs (usage notes)
+ * - /packages/lab/src/RichTextEditor/RichTextEditor.test.tsx (tests)
+ * - /apps/storybook/stories/RichTextEditor.stories.tsx (story)
+ *
+ * NOTE: Experimental `@astryxdesign/lab` component (canary). `lexical` and
+ * `@lexical/*` are OPTIONAL peer dependencies — install them to use this.
+ *
+ * COMPATIBILITY: astryx aims for its RichTextEditor internals to eventually
+ * back Meta's EPS `EPSRichTextArea` (nest/libs/eps-lexical). EPS's auto-link is
+ * matcher-driven and applies `target="_blank"` + `rel="noopener noreferrer"` to
+ * created links (its `NEW_TAB_LINK_ATTRIBUTES`). This plugin uses the same
+ * matcher shape (`createLinkMatcherWithRegExp` + `attributes`) and the same
+ * new-tab defaults, so EPS can pass its own richer matcher set (e.g. shortform
+ * `D123` / `T456` / `S789` intern URLs) through the `matchers` prop without
+ * changing the contract. EPS ships a hardened fork of the transform itself
+ * (expanded separators, code-block exclusion) — astryx stays on the OSS
+ * `AutoLinkPlugin`, and EPS can substitute its own plugin in the same slot.
+ */
+import { AutoLinkPlugin, createLinkMatcherWithRegExp } from '@lexical/react/LexicalAutoLinkPlugin';
+import { URL_MATCHER, EMAIL_MATCHER, sanitizeUrl } from "./linkUtils.js";
+
+/**
+ * Attributes written onto every auto-created link so it opens in a new tab.
+ * `rel="noopener noreferrer"` is required whenever `target="_blank"` is set, to
+ * prevent reverse-tabnabbing. Matches EPS eps-lexical's `NEW_TAB_LINK_ATTRIBUTES`.
+ */
+import { jsx as _jsx } from "react/jsx-runtime";
+export const NEW_TAB_LINK_ATTRIBUTES = {
+  target: '_blank',
+  rel: 'noopener noreferrer'
+};
+
+/**
+ * Default matchers: bare URLs (defaulting to `https://` when scheme-less) and
+ * email addresses (as `mailto:` links). Both carry {@link NEW_TAB_LINK_ATTRIBUTES}.
+ * URLs are passed through {@link sanitizeUrl} so only http/https/mailto/tel
+ * schemes are ever written.
+ */
+export const DEFAULT_LINK_MATCHERS = [text => {
+  const match = createLinkMatcherWithRegExp(URL_MATCHER, url => sanitizeUrl(url))(text);
+  return match ? {
+    ...match,
+    attributes: NEW_TAB_LINK_ATTRIBUTES
+  } : null;
+}, text => {
+  const match = createLinkMatcherWithRegExp(EMAIL_MATCHER, email => `mailto:${email}`)(text);
+  return match ? {
+    ...match,
+    attributes: NEW_TAB_LINK_ATTRIBUTES
+  } : null;
+}];
+/**
+ * Automatically converts typed/pasted URLs and email addresses into links.
+ * Render it inside the editor's `plugins` slot — it reaches the editor via
+ * `useLexicalComposerContext()`, so it must live within the editor's
+ * `LexicalComposer`. Requires `AutoLinkNode` (registered by default).
+ *
+ * @example
+ * ```
+ * import {RichTextEditor, RichTextEditorAutoLinkPlugin} from '@astryxdesign/lab';
+ *
+ * <RichTextEditor
+ *   label="Notes"
+ *   plugins={<RichTextEditorAutoLinkPlugin />}
+ * />
+ * ```
+ */
+export function RichTextEditorAutoLinkPlugin({
+  matchers = DEFAULT_LINK_MATCHERS,
+  onChange
+}) {
+  return /*#__PURE__*/_jsx(AutoLinkPlugin, {
+    matchers: matchers,
+    onChange: onChange
+  });
+}
+RichTextEditorAutoLinkPlugin.displayName = 'RichTextEditorAutoLinkPlugin';

package/dist/RichTextEditor/RichTextEditorToolbar.d.ts

@@ -0,0 +1,126 @@
+/**
+ * @file RichTextEditorToolbar.tsx
+ * @input Uses React, @lexical/react (composer context), @lexical/rich-text,
+ *   @lexical/selection, @lexical/list, @lexical/utils, and the lexical core
+ *   command constants, plus Astryx Toolbar / ToggleButton / Divider primitives.
+ * @output Exports RichTextEditorToolbar (a composable formatting toolbar) and
+ *   RichTextEditorToolbarProps.
+ * @position Experimental (lab). Drop into RichTextEditor's `plugins` slot to add
+ *   a formatting toolbar. Themed via Astryx Toolbar/ToggleButton, so it inherits
+ *   the active theme with no extra styling.
+ *
+ * SYNC: When modified, update:
+ * - /packages/lab/src/RichTextEditor/index.ts (exports)
+ * - /packages/lab/src/index.ts (barrel re-export)
+ * - /packages/lab/src/RichTextEditor/RichTextEditor.doc.mjs (usage notes)
+ * - /packages/lab/src/RichTextEditor/RichTextEditor.test.tsx (tests)
+ * - /apps/storybook/stories/RichTextEditor.stories.tsx (WithToolbar story)
+ *
+ * NOTE: Experimental `@astryxdesign/lab` component (canary). `lexical` and
+ * `@lexical/*` are OPTIONAL peer dependencies — install them to use this.
+ * Behavior mirrors the Lexical playground toolbar (selection sync + format
+ * commands); the UI is built from Astryx primitives so it matches the theme.
+ *
+ * ICONS: Each control resolves its glyph through the core icon registry under a
+ * stable `richtext:*` key (see {@link RICHTEXT_ICON_KEYS}), falling back to the
+ * bundled inline SVGs below. A theme can restyle any glyph by registering its
+ * own icon for that key — no need to fork the toolbar:
+ *   import {registerIcons} from '@astryxdesign/core/Icon';
+ *   registerIcons({'richtext:bold': <MyBoldIcon />});
+ */
+import { type ReactNode } from 'react';
+/**
+ * Stable icon-registry keys for the toolbar's controls. Themes can override any
+ * of these via `registerIcons({'richtext:bold': <MyIcon />})` from
+ * `@astryxdesign/core/Icon`. Keys are namespaced (`richtext:*`) to avoid
+ * collisions with the core semantic icon set.
+ */
+export declare const RICHTEXT_ICON_KEYS: {
+    readonly bold: "richtext:bold";
+    readonly italic: "richtext:italic";
+    readonly underline: "richtext:underline";
+    readonly strikethrough: "richtext:strikethrough";
+    readonly code: "richtext:code";
+    readonly link: "richtext:link";
+    readonly h1: "richtext:h1";
+    readonly h2: "richtext:h2";
+    readonly h3: "richtext:h3";
+    readonly quote: "richtext:quote";
+    readonly bullet: "richtext:bullet";
+    readonly number: "richtext:number";
+    readonly undo: "richtext:undo";
+    readonly redo: "richtext:redo";
+};
+export interface RichTextEditorToolbarProps {
+    /**
+     * Accessible label for the toolbar element.
+     * @default 'Text formatting'
+     */
+    label?: string;
+    /**
+     * Which heading levels to expose as block-type buttons, in order.
+     * @default ['h1', 'h2', 'h3']
+     */
+    headingLevels?: ReadonlyArray<'h1' | 'h2' | 'h3'>;
+    /** Toolbar size, forwarded to the Astryx Toolbar. @default 'sm' */
+    size?: 'sm' | 'md' | 'lg';
+    /**
+     * Whether to show the insert/edit-link button. When enabled, pressing it on a
+     * collapsed or non-link selection prompts for a URL (via `promptForUrl`,
+     * `window.prompt` by default) and wraps the selection in a link; pressing it
+     * while a link is selected removes the link.
+     *
+     * Requires `LinkNode` to be registered (it is, by default) — no extra setup.
+     * The entered URL is sanitized (see `sanitizeUrl`) so only
+     * http/https/mailto/tel links are written.
+     * @default true
+     */
+    hasLink?: boolean;
+    /**
+     * Called to obtain a URL when the link button is pressed on a non-link
+     * selection. Return the URL string to link, or `null`/`''` to cancel.
+     * Receives the currently selected text as a hint. Defaults to
+     * `window.prompt`. Override to plug in a custom (e.g. Astryx Dialog) prompt.
+     */
+    promptForUrl?: (selectedText: string) => string | null | undefined;
+    /**
+     * Whether links created via the toolbar open in a new tab. When `true`
+     * (default), the created link carries `target="_blank"` and
+     * `rel="noopener noreferrer"` — written into the link node's data (so it
+     * serializes and round-trips), not patched onto the DOM. Set `false` to
+     * create same-tab links.
+     * @default true
+     */
+    linkOpensInNewTab?: boolean;
+    /**
+     * Extra items rendered at the end of the toolbar (after a divider). Use this
+     * to compose product-specific controls (e.g. mentions, AI) alongside the
+     * default formatting buttons.
+     */
+    endContent?: ReactNode;
+}
+/**
+ * A composable formatting toolbar for {@link RichTextEditor}, built from Astryx
+ * `Toolbar` / `ToggleButton` primitives so it matches the active theme. Reads
+ * the current selection to keep the active states in sync and dispatches the
+ * standard Lexical formatting commands.
+ *
+ * Render it inside the editor's `plugins` slot — it uses
+ * `useLexicalComposerContext()` to reach the editor, so it must live within the
+ * `LexicalComposer` the editor sets up.
+ *
+ * @example
+ * ```
+ * import {RichTextEditor, RichTextEditorToolbar} from '@astryxdesign/lab';
+ *
+ * <RichTextEditor
+ *   label="Notes"
+ *   plugins={<RichTextEditorToolbar />}
+ * />
+ * ```
+ */
+export declare function RichTextEditorToolbar({ label, headingLevels, size, hasLink, promptForUrl, linkOpensInNewTab, endContent, }: RichTextEditorToolbarProps): import("react").JSX.Element;
+export declare namespace RichTextEditorToolbar {
+    var displayName: string;
+}
+//# sourceMappingURL=RichTextEditorToolbar.d.ts.map

package/dist/RichTextEditor/RichTextEditorToolbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RichTextEditorToolbar.d.ts","sourceRoot":"","sources":["../../src/RichTextEditor/RichTextEditorToolbar.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAmC,KAAK,SAAS,EAAC,MAAM,OAAO,CAAC;AAqEvE;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;CAerB,CAAC;AAyNX,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC;IAClD,mEAAmE;IACnE,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACnE;;;;;;;OAOG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;OAIG;IACH,UAAU,CAAC,EAAE,SAAS,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,KAAyB,EACzB,aAAkC,EAClC,IAAW,EACX,OAAc,EACd,YAAY,EACZ,iBAAwB,EACxB,UAAU,GACX,EAAE,0BAA0B,+BA+W5B;yBAvXe,qBAAqB"}