@astryxdesign/lab 0.1.7-canary.fb9c68c → 0.1.8-canary.0db5dfd

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # @xds/lab
 
+# 0.1.8
+
+---
+
 # 0.1.7
 
 ---

package/dist/CircularProgress/CircularProgress.d.ts

@@ -5,11 +5,10 @@
  * @position Core implementation; consumed by index.ts
  *
  * SYNC: When modified, update these files to stay in sync:
- * - /packages/core/src/CircularProgress/CircularProgress.doc.mjs (props table, features, implementation notes)
- * - /packages/core/src/CircularProgress/CircularProgress.test.tsx (tests for new/changed behavior)
- * - /packages/core/src/CircularProgress/index.ts (exports if types change)
+ * - /packages/lab/src/CircularProgress/CircularProgress.doc.mjs (props table, features, implementation notes)
+ * - /packages/lab/src/CircularProgress/CircularProgress.test.tsx (tests for new/changed behavior)
+ * - /packages/lab/src/CircularProgress/index.ts (exports if types change)
  * - /apps/storybook/stories/CircularProgress.stories.tsx (storybook stories)
- * - /packages/cli/templates/blocks/components/CircularProgress/ (showcase blocks)
  */
 import { type ReactNode } from 'react';
 import type { BaseProps } from '@astryxdesign/core';
@@ -19,7 +18,7 @@ import type { BaseProps } from '@astryxdesign/core';
  * Theme packages can add custom variants via TypeScript module augmentation:
  * @example
  * ```
- * declare module '@astryxdesign/core/CircularProgress' {
+ * declare module '@astryxdesign/lab' {
  *   interface CircularProgressVariantMap {
  *     'brand': true;
  *   }
@@ -40,7 +39,7 @@ export interface CircularProgressProps extends BaseProps<HTMLDivElement> {
     ref?: React.Ref<HTMLDivElement>;
     /**
      * Current value of the circular progress.
-     * When omitted, the component renders an indeterminate spinning animation.
+     * Ignored when `isIndeterminate` is true.
      */
     value?: number;
     /**
@@ -57,9 +56,22 @@ export interface CircularProgressProps extends BaseProps<HTMLDivElement> {
      * @default true
      */
     isLabelHidden?: boolean;
+    /**
+     * When true, displays the formatted value (e.g. "75%") in the center of
+     * the ring. Ignored when `isIndeterminate` is true or when `children`
+     * provide custom center content.
+     * @default false
+     */
+    hasValueLabel?: boolean;
+    /**
+     * Custom formatter for the value label.
+     * @default (value, max) => `${Math.round((value / max) * 100)}%`
+     */
+    formatValueLabel?: (value: number, max: number) => string;
     /**
      * Content displayed in the center of the ring.
      * Typically a percentage string, icon, or custom content.
+     * Takes precedence over `hasValueLabel`.
      */
     children?: ReactNode;
     /**
@@ -75,6 +87,20 @@ export interface CircularProgressProps extends BaseProps<HTMLDivElement> {
      * @default 'accent'
      */
     variant?: CircularProgressVariant;
+    /**
+     * When true, renders an animated indeterminate progress indicator.
+     * Use when the progress amount is unknown (e.g. loading, processing).
+     * The `value` and `hasValueLabel` props are ignored in this mode.
+     * Respects `prefers-reduced-motion` by slowing the animation.
+     * @default false
+     */
+    isIndeterminate?: boolean;
+    /**
+     * When true, the circular progress is visually disabled — the ring and
+     * text use disabled colors. Use for canceled or inactive operations.
+     * @default false
+     */
+    isDisabled?: boolean;
     /**
      * Test ID for testing utilities.
      */
@@ -85,16 +111,19 @@ export interface CircularProgressProps extends BaseProps<HTMLDivElement> {
  *
  * In determinate mode, displays a known value as an arc fill.
  * In indeterminate mode, shows an animated spinning indicator.
- * Supports center content via children for labels, percentages, or icons.
+ * Supports center content via children for labels, percentages, or icons,
+ * or an automatic formatted value label via `hasValueLabel`.
  *
  * @example
  * ```
- * <CircularProgress value={75} label="Upload progress" />
- * <CircularProgress value={75} label="Progress" max={100}>75%</CircularProgress>
- * <CircularProgress label="Loading..." />
+ * <CircularProgress value={75} label="Upload progress" hasValueLabel />
+ * <CircularProgress isIndeterminate label="Loading..." />
+ * <CircularProgress value={3.2} max={5} label="Disk usage" hasValueLabel
+ *   formatValueLabel={(v, m) => `${v} GB / ${m} GB`} />
+ * <CircularProgress value={30} label="Canceled" isDisabled hasValueLabel />
  * ```
  */
-export declare function CircularProgress({ value, max, label, isLabelHidden, children, size, variant, xstyle, className, style, 'data-testid': dataTestId, ref, ...rest }: CircularProgressProps): import("react").JSX.Element;
+export declare function CircularProgress({ value, max, label, isLabelHidden, hasValueLabel, formatValueLabel, children, size, variant, isIndeterminate, isDisabled, xstyle, className, style, 'data-testid': dataTestId, ref, ...rest }: CircularProgressProps): import("react").JSX.Element;
 export declare namespace CircularProgress {
     var displayName: string;
 }

package/dist/CircularProgress/CircularProgress.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CircularProgress.d.ts","sourceRoot":"","sources":["../../src/CircularProgress/CircularProgress.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAQ,KAAK,SAAS,EAAC,MAAM,OAAO,CAAC;AAY5C,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,oBAAoB,CAAC;AAGlD;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,IAAI,CAAC;IACb,OAAO,EAAE,IAAI,CAAC;IACd,OAAO,EAAE,IAAI,CAAC;IACd,KAAK,EAAE,IAAI,CAAC;IACZ,OAAO,EAAE,IAAI,CAAC;CACf;AAED,MAAM,MAAM,uBAAuB,GAAG,MAAM,0BAA0B,CAAC;AAEvE,MAAM,MAAM,oBAAoB,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAQtD,MAAM,WAAW,qBAAsB,SAAQ,SAAS,CAAC,cAAc,CAAC;IACtE,wCAAwC;IACxC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAChC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,oBAAoB,CAAC;IAC5B;;;OAGG;IACH,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAClC;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAiJD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,KAAK,EACL,GAAS,EACT,KAAK,EACL,aAAoB,EACpB,QAAQ,EACR,IAAW,EACX,OAAkB,EAClB,MAAM,EACN,SAAS,EACT,KAAK,EACL,aAAa,EAAE,UAAU,EACzB,GAAG,EACH,GAAG,IAAI,EACR,EAAE,qBAAqB,+BAyFvB;yBAvGe,gBAAgB"}
+{"version":3,"file":"CircularProgress.d.ts","sourceRoot":"","sources":["../../src/CircularProgress/CircularProgress.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAQ,KAAK,SAAS,EAAC,MAAM,OAAO,CAAC;AAY5C,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,oBAAoB,CAAC;AAGlD;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,IAAI,CAAC;IACb,OAAO,EAAE,IAAI,CAAC;IACd,OAAO,EAAE,IAAI,CAAC;IACd,KAAK,EAAE,IAAI,CAAC;IACZ,OAAO,EAAE,IAAI,CAAC;CACf;AAED,MAAM,MAAM,uBAAuB,GAAG,MAAM,0BAA0B,CAAC;AAEvE,MAAM,MAAM,oBAAoB,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAQtD,MAAM,WAAW,qBAAsB,SAAQ,SAAS,CAAC,cAAc,CAAC;IACtE,wCAAwC;IACxC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAChC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IAC1D;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,oBAAoB,CAAC;IAC5B;;;OAGG;IACH,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAClC;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAqKD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,KAAS,EACT,GAAS,EACT,KAAK,EACL,aAAoB,EACpB,aAAqB,EACrB,gBAA0C,EAC1C,QAAQ,EACR,IAAW,EACX,OAAkB,EAClB,eAAuB,EACvB,UAAkB,EAClB,MAAM,EACN,SAAS,EACT,KAAK,EACL,aAAa,EAAE,UAAU,EACzB,GAAG,EACH,GAAG,IAAI,EACR,EAAE,qBAAqB,+BAuHvB;yBAzIe,gBAAgB"}

package/dist/CircularProgress/CircularProgress.js

@@ -9,11 +9,10 @@
  * @position Core implementation; consumed by index.ts
  *
  * SYNC: When modified, update these files to stay in sync:
- * - /packages/core/src/CircularProgress/CircularProgress.doc.mjs (props table, features, implementation notes)
- * - /packages/core/src/CircularProgress/CircularProgress.test.tsx (tests for new/changed behavior)
- * - /packages/core/src/CircularProgress/index.ts (exports if types change)
+ * - /packages/lab/src/CircularProgress/CircularProgress.doc.mjs (props table, features, implementation notes)
+ * - /packages/lab/src/CircularProgress/CircularProgress.test.tsx (tests for new/changed behavior)
+ * - /packages/lab/src/CircularProgress/index.ts (exports if types change)
  * - /apps/storybook/stories/CircularProgress.stories.tsx (storybook stories)
- * - /packages/cli/templates/blocks/components/CircularProgress/ (showcase blocks)
  */
 import { useId } from 'react';
 import * as stylex from '@stylexjs/stylex';
@@ -28,7 +27,7 @@ import { themeProps } from '@astryxdesign/core/utils';
  * Theme packages can add custom variants via TypeScript module augmentation:
  * @example
  * ```
- * declare module '@astryxdesign/core/CircularProgress' {
+ * declare module '@astryxdesign/lab' {
  *   interface CircularProgressVariantMap {
  *     'brand': true;
  *   }
@@ -118,6 +117,10 @@ const variantStyles = {
   neutral: {
     kjVXCG: "xuxf9kk",
     $$css: true
+  },
+  disabled: {
+    kjVXCG: "xuxf9kk",
+    $$css: true
   }
 };
 const trackVariantStyles = {
@@ -142,29 +145,40 @@ const trackVariantStyles = {
     $$css: true
   }
 };
+function defaultFormatValueLabel(value, max) {
+  const pct = max > 0 ? Math.round(value / max * 100) : 0;
+  return `${pct}%`;
+}
 
 /**
  * A circular/radial progress indicator that shows completion as a ring.
  *
  * In determinate mode, displays a known value as an arc fill.
  * In indeterminate mode, shows an animated spinning indicator.
- * Supports center content via children for labels, percentages, or icons.
+ * Supports center content via children for labels, percentages, or icons,
+ * or an automatic formatted value label via `hasValueLabel`.
  *
  * @example
  * ```
- * <CircularProgress value={75} label="Upload progress" />
- * <CircularProgress value={75} label="Progress" max={100}>75%</CircularProgress>
- * <CircularProgress label="Loading..." />
+ * <CircularProgress value={75} label="Upload progress" hasValueLabel />
+ * <CircularProgress isIndeterminate label="Loading..." />
+ * <CircularProgress value={3.2} max={5} label="Disk usage" hasValueLabel
+ *   formatValueLabel={(v, m) => `${v} GB / ${m} GB`} />
+ * <CircularProgress value={30} label="Canceled" isDisabled hasValueLabel />
  * ```
  */
 export function CircularProgress({
-  value,
+  value = 0,
   max = 100,
   label,
   isLabelHidden = true,
+  hasValueLabel = false,
+  formatValueLabel = defaultFormatValueLabel,
   children,
   size = 'md',
   variant = 'accent',
+  isIndeterminate = false,
+  isDisabled = false,
   xstyle,
   className,
   style,
@@ -173,19 +187,29 @@ export function CircularProgress({
   ...rest
 }) {
   const labelId = useId();
-  const isIndeterminate = value == null;
   const {
     diameter,
     strokeWidth
   } = SIZE_CONFIG[size];
   const radius = (diameter - strokeWidth) / 2;
   const circumference = 2 * Math.PI * radius;
-  const resolvedValue = value ?? 0;
-  const clampedValue = Math.min(Math.max(0, resolvedValue), max);
-  const percentage = max > 0 ? clampedValue / max : 0;
+
+  // A non-finite value or max (e.g. a NaN from an upstream `loaded / total`
+  // with total 0) would otherwise leak into aria-valuenow, the value label,
+  // and the arc geometry as the string "NaN". Treat it as empty progress,
+  // matching the max=0 handling below.
+  const safeValue = Number.isFinite(value) ? value : 0;
+  const safeMax = Number.isFinite(max) ? max : 0;
+  const clampedValue = Math.min(Math.max(0, safeValue), safeMax);
+  const percentage = safeMax > 0 ? clampedValue / safeMax : 0;
   const dashoffset = circumference * (1 - percentage);
+  const valueText = formatValueLabel(clampedValue, safeMax);
   const center = diameter / 2;
   const showLabel = !isLabelHidden;
+  const showValueLabel = hasValueLabel && !isIndeterminate;
+  const centerContent = children != null ? children : showValueLabel ? valueText : null;
+  const fillVariant = isDisabled ? 'disabled' : variant;
+  const trackVariant = isDisabled ? 'neutral' : variant;
   return /*#__PURE__*/_jsxs("div", {
     ref: ref,
     ...mergeProps(themeProps('circular-progress', {
@@ -200,21 +224,28 @@ export function CircularProgress({
         0: {
           className: "x10l6tqk x1i1rx1s xjm9jq1 x1717udv xkdpibf xb3r6kr xzpqnlu xuxw1ft xc342km"
         },
-        1: {
+        2: {
           className: "x141an7d x1ltkj2j x1e4wzip xv1l7n4"
+        },
+        1: {
+          className: "x10l6tqk x1i1rx1s xjm9jq1 x1717udv xkdpibf xb3r6kr xzpqnlu xuxw1ft xc342km xnbbluu"
+        },
+        3: {
+          className: "x141an7d x1ltkj2j x1e4wzip xnbbluu"
         }
-      }[!!showLabel << 0],
+      }[!!showLabel << 1 | !!(showLabel && isDisabled) << 0],
       children: label
     }), /*#__PURE__*/_jsxs("div", {
       ...{
         className: "x1n2onr6 x3nfvp2"
       },
       children: [/*#__PURE__*/_jsxs("svg", {
-        role: isIndeterminate ? 'progressbar' : 'meter',
+        role: "progressbar",
         "aria-labelledby": labelId,
         "aria-valuenow": isIndeterminate ? undefined : clampedValue,
         "aria-valuemin": isIndeterminate ? undefined : 0,
-        "aria-valuemax": isIndeterminate ? undefined : max,
+        "aria-valuemax": isIndeterminate ? undefined : safeMax,
+        "aria-valuetext": isIndeterminate ? undefined : valueText,
         width: diameter,
         height: diameter,
         viewBox: `0 0 ${diameter} ${diameter}`,
@@ -227,23 +258,23 @@ export function CircularProgress({
           }
         }[!!isIndeterminate << 0],
         children: [/*#__PURE__*/_jsx("circle", {
-          ...mergeProps(themeProps('circular-progress-track'), stylex.props(styles.track, trackVariantStyles[variant])),
+          ...mergeProps(themeProps('circular-progress-track'), stylex.props(styles.track, trackVariantStyles[trackVariant])),
           cx: center,
           cy: center,
           r: radius,
           strokeWidth: strokeWidth
         }), isIndeterminate ? /*#__PURE__*/_jsx("circle", {
           ...mergeProps(themeProps('circular-progress-fill', {
-            variant
-          }), stylex.props(styles.fillIndeterminate, variantStyles[variant])),
+            variant: fillVariant
+          }), stylex.props(styles.fillIndeterminate, variantStyles[fillVariant])),
           cx: center,
           cy: center,
           r: radius,
           strokeWidth: strokeWidth
         }) : /*#__PURE__*/_jsx("circle", {
           ...mergeProps(themeProps('circular-progress-fill', {
-            variant
-          }), stylex.props(styles.fill, variantStyles[variant])),
+            variant: fillVariant
+          }), stylex.props(styles.fill, variantStyles[fillVariant])),
           cx: center,
           cy: center,
           r: radius,
@@ -251,11 +282,21 @@ export function CircularProgress({
           strokeDasharray: circumference,
           strokeDashoffset: dashoffset
         })]
-      }), children != null && /*#__PURE__*/_jsx("div", {
+      }), centerContent != null && /*#__PURE__*/_jsx("div", {
         ...{
           className: "x10l6tqk x10a8y8t x78zum5 x6s0dn4 xl56j7k x47corl"
         },
-        children: children
+        children: children != null ? children : /*#__PURE__*/_jsx("span", {
+          ...{
+            0: {
+              className: "x141an7d x1ltkj2j x1sodnla xv1l7n4"
+            },
+            1: {
+              className: "x141an7d x1ltkj2j x1sodnla xnbbluu"
+            }
+          }[!!isDisabled << 0],
+          children: valueText
+        })
       })]
     })]
   });

package/dist/RichTextEditor/RichTextEditor.d.ts

@@ -0,0 +1,145 @@
+/**
+ * @file RichTextEditor.tsx
+ * @input Uses React, useId, Lexical (lexical + @lexical/react), Field, design tokens
+ * @output Exports RichTextEditor component, RichTextEditorProps, RichTextEditorStatus,
+ *   RichTextEditorStatusType, RichTextEditorSize
+ * @position Experimental (lab) implementation; consumed by RichTextEditor/index.ts and
+ *   re-exported from @astryxdesign/lab. Tested by RichTextEditor.test.tsx.
+ *
+ * SYNC: When modified, update these files to stay in sync:
+ * - /packages/lab/src/RichTextEditor/RichTextEditor.doc.mjs (props table, features, implementation notes)
+ * - /packages/lab/src/RichTextEditor/RichTextEditor.test.tsx (tests for new/changed behavior)
+ * - /packages/lab/src/RichTextEditor/index.ts (exports if types change)
+ * - /packages/lab/src/index.ts (barrel re-export)
+ * - /apps/storybook/stories/RichTextEditor.stories.tsx (storybook stories)
+ *
+ * NOTE: This is an EXPERIMENTAL component in @astryxdesign/lab (published only under
+ * the `@canary` dist-tag, never as stable `latest`). It is the initial landing for the
+ * OSS Lexical editor RFC; the goal is graduation to @astryxdesign/core after the
+ * Component Specification Protocol. `lexical` and `@lexical/*` are OPTIONAL peer
+ * dependencies — install them to use this component.
+ */
+import { type ReactNode } from 'react';
+import type { BaseProps } from '@astryxdesign/core';
+import type { SizeValue } from '@astryxdesign/core/utils';
+import type { EditorState, Klass, LexicalEditor, LexicalNode } from 'lexical';
+export type RichTextEditorStatusType = 'warning' | 'error' | 'success';
+export type RichTextEditorSize = 'sm' | 'md' | 'lg';
+export interface RichTextEditorStatus {
+    /** The type of status to display. */
+    type: RichTextEditorStatusType;
+    /** Optional message to display below the editor. */
+    message?: string;
+}
+export interface RichTextEditorProps extends Omit<BaseProps, 'onChange' | 'defaultValue'> {
+    /** Label text for the editor (always rendered for accessibility). */
+    label: string;
+    /**
+     * Whether to visually hide the label (still accessible to screen readers).
+     * @default false
+     */
+    isLabelHidden?: boolean;
+    /** Description text displayed between the label and editor. */
+    description?: string;
+    /**
+     * Whether the field is optional. Mutually exclusive with isRequired.
+     * @default false
+     */
+    isOptional?: boolean;
+    /**
+     * Whether the field is required. Mutually exclusive with isOptional.
+     * @default false
+     */
+    isRequired?: boolean;
+    /**
+     * Initial serialized editor state (a JSON string produced by
+     * `JSON.stringify(editorState.toJSON())`), used to seed the editor on mount.
+     * The editor is uncontrolled: this is read once.
+     */
+    defaultValue?: string;
+    /**
+     * Callback fired when the editor content changes. Receives the current
+     * `EditorState` and the `LexicalEditor` instance. Serialize with
+     * `editorState.toJSON()` for persistence.
+     */
+    onChange?: (editorState: EditorState, editor: LexicalEditor) => void;
+    /** Placeholder text shown when the editor is empty. */
+    placeholder?: string;
+    /**
+     * Whether the editor is read-only (non-editable).
+     * @default false
+     */
+    isReadOnly?: boolean;
+    /**
+     * Whether the editor is disabled (non-editable, dimmed).
+     * @default false
+     */
+    isDisabled?: boolean;
+    /**
+     * Status indicator. When set, displays a colored border. If message is
+     * provided, displays a message box below the editor.
+     */
+    status?: RichTextEditorStatus;
+    /**
+     * Width of the field. Numbers are treated as pixels, strings are used as-is
+     * (e.g. `'100%'`).
+     */
+    width?: SizeValue;
+    /** Tooltip text to display in an info icon at the end of the label. */
+    labelTooltip?: string;
+    /**
+     * The size of the editor, affecting internal padding.
+     * @default 'md'
+     */
+    size?: RichTextEditorSize;
+    /**
+     * Additional Lexical nodes to register beyond the default OSS set
+     * (Heading, Quote, List, Link, Code). Use this extension point to plug in
+     * custom nodes (e.g. mentions, images) without forking the editor.
+     */
+    nodes?: ReadonlyArray<Klass<LexicalNode>>;
+    /**
+     * Additional Lexical plugins to render inside the composer. Use this to
+     * compose extra behaviour (toolbars, mentions, autolink, etc.) on top of the
+     * base editor. Plugins receive the editor via `useLexicalComposerContext()`.
+     */
+    plugins?: ReactNode;
+    /**
+     * Whether to enable Markdown shortcut typing (e.g. `# ` for a heading,
+     * `- ` for a list). Uses the default `@lexical/markdown` transformers.
+     * @default true
+     */
+    hasMarkdownShortcuts?: boolean;
+    /** Whether to automatically focus the editor on mount. @default false */
+    hasAutoFocus?: boolean;
+    /**
+     * The Lexical composer namespace, used for editor identity.
+     * @default 'astryx-editor'
+     */
+    namespace?: string;
+}
+/**
+ * A WYSIWYG rich-text editor built on Lexical, styled with Astryx design
+ * tokens. Experimental — ships from `@astryxdesign/lab` (canary). `lexical` and
+ * `@lexical/*` are optional peer dependencies — install them to use this
+ * component.
+ *
+ * The editor is intentionally minimal and extensible: pass `nodes` and
+ * `plugins` to layer richer behaviour (toolbars, mentions, hover cards) on top
+ * without forking.
+ *
+ * @example
+ * ```
+ * import {RichTextEditor} from '@astryxdesign/lab';
+ * <RichTextEditor
+ *   label="Notes"
+ *   placeholder="Write something..."
+ *   onChange={state => save(JSON.stringify(state.toJSON()))}
+ * />
+ * ```
+ */
+export declare function RichTextEditor({ label, isLabelHidden, description, isOptional, isRequired, defaultValue, onChange, placeholder, isReadOnly, isDisabled, status, width, labelTooltip, size: sizeProp, nodes, plugins, hasMarkdownShortcuts, hasAutoFocus, namespace, xstyle, className, style, ...rest }: RichTextEditorProps): import("react").JSX.Element;
+export declare namespace RichTextEditor {
+    var displayName: string;
+}
+//# sourceMappingURL=RichTextEditor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RichTextEditor.d.ts","sourceRoot":"","sources":["../../src/RichTextEditor/RichTextEditor.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAA2B,KAAK,SAAS,EAAC,MAAM,OAAO,CAAC;AAgB/D,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,0BAA0B,CAAC;AAuBxD,OAAO,KAAK,EACV,WAAW,EACX,KAAK,EACL,aAAa,EACb,WAAW,EAEZ,MAAM,SAAS,CAAC;AAiEjB,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAEvE,MAAM,MAAM,kBAAkB,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEpD,MAAM,WAAW,oBAAoB;IACnC,qCAAqC;IACrC,IAAI,EAAE,wBAAwB,CAAC;IAC/B,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAC/C,SAAS,EACT,UAAU,GAAG,cAAc,CAC5B;IACC,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,KAAK,IAAI,CAAC;IACrE,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B;;;;OAIG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;IAC1C;;;;OAIG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,yEAAyE;IACzE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,aAAqB,EACrB,WAAW,EACX,UAAkB,EAClB,UAAkB,EAClB,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,UAAkB,EAClB,UAAkB,EAClB,MAAM,EACN,KAAK,EACL,YAAY,EACZ,IAAI,EAAE,QAAQ,EACd,KAAK,EACL,OAAO,EACP,oBAA2B,EAC3B,YAAoB,EACpB,SAA2B,EAC3B,MAAM,EACN,SAAS,EACT,KAAK,EACL,GAAG,IAAI,EACR,EAAE,mBAAmB,+BAkHrB;yBA1Ie,cAAc"}