@toaq-oss/omni-mdx 0.1.22 → 0.1.23

package/dist/client.d.cts

@@ -0,0 +1,81 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { Component, ReactNode, ErrorInfo } from 'react';
+
+// AST types (mirror Rust output exactly)
+
+type AttrValueKind =
+  | { kind: "text";       value: string }
+  | { kind: "expression"; value: string }
+  | { kind: "boolean" }
+  | { kind: "ast";        value: AstNode[] };
+
+interface AstNode {
+  node_type:     string;
+  content?:      string;
+  self_closing?: boolean;
+  child_count?:  number;
+  attributes?:   Record<string, AttrValueKind> | string;
+  children?:     AstNode[];
+}
+
+type MDXComponents = Record<string, React.ComponentType<any>>;
+
+interface MDXClientRendererProps {
+    /** AST from parseMdx() — must be JSON-serialisable (pass via Server Component). */
+    ast: AstNode[];
+    /** Component registry — same shape as MDX_COMPONENTS. */
+    components?: MDXComponents;
+}
+declare function MDXClientRenderer({ ast, components, }: MDXClientRendererProps): react_jsx_runtime.JSX.Element | null;
+
+interface Props {
+    children: ReactNode;
+    /** The name of the MDX component being rendered (e.g., 'Chart', 'SplitLayout') */
+    componentName?: string;
+}
+interface State {
+    hasError: boolean;
+    error: Error | null;
+}
+/**
+ * A dedicated Error Boundary for MDX rendering.
+ *
+ * If a React component injected via MDX crashes (e.g., due to a data parsing error
+ * inside a <Chart />), this boundary intercepts the error. This prevents the
+ * entire React tree from unmounting and displays a clean fallback UI to
+ * isolate the defective component.
+ */
+declare class MDXErrorBoundary extends Component<Props, State> {
+    constructor(props: Props);
+    /**
+     * Updates the state when an error occurs to trigger the fallback UI rendering.
+     */
+    static getDerivedStateFromError(error: Error): State;
+    /**
+     * Intercepts the error and its contextual information.
+     * This is the ideal place to hook into monitoring tools (like Sentry or Datadog)
+     * for production environments.
+     */
+    componentDidCatch(error: Error, errorInfo: ErrorInfo): void;
+    render(): string | number | boolean | Iterable<ReactNode> | react_jsx_runtime.JSX.Element | null | undefined;
+}
+
+declare function parseMdxClient(mdx: string | Uint8Array): Promise<AstNode[]>;
+
+declare class MdxBinaryDecoder {
+    private view;
+    private buffer;
+    private offset;
+    private decoder;
+    private stringCache;
+    constructor(buffer: Uint8Array);
+    decode(): AstNode[];
+    private decodeNode;
+    private readU8;
+    private readU16;
+    private readU32;
+    private readStringU16;
+    private readStringU32;
+}
+
+export { type AstNode, MDXClientRenderer, type MDXComponents, MDXErrorBoundary, MdxBinaryDecoder, parseMdxClient as parseMdx };

package/dist/client.d.ts

@@ -0,0 +1,81 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { Component, ReactNode, ErrorInfo } from 'react';
+
+// AST types (mirror Rust output exactly)
+
+type AttrValueKind =
+  | { kind: "text";       value: string }
+  | { kind: "expression"; value: string }
+  | { kind: "boolean" }
+  | { kind: "ast";        value: AstNode[] };
+
+interface AstNode {
+  node_type:     string;
+  content?:      string;
+  self_closing?: boolean;
+  child_count?:  number;
+  attributes?:   Record<string, AttrValueKind> | string;
+  children?:     AstNode[];
+}
+
+type MDXComponents = Record<string, React.ComponentType<any>>;
+
+interface MDXClientRendererProps {
+    /** AST from parseMdx() — must be JSON-serialisable (pass via Server Component). */
+    ast: AstNode[];
+    /** Component registry — same shape as MDX_COMPONENTS. */
+    components?: MDXComponents;
+}
+declare function MDXClientRenderer({ ast, components, }: MDXClientRendererProps): react_jsx_runtime.JSX.Element | null;
+
+interface Props {
+    children: ReactNode;
+    /** The name of the MDX component being rendered (e.g., 'Chart', 'SplitLayout') */
+    componentName?: string;
+}
+interface State {
+    hasError: boolean;
+    error: Error | null;
+}
+/**
+ * A dedicated Error Boundary for MDX rendering.
+ *
+ * If a React component injected via MDX crashes (e.g., due to a data parsing error
+ * inside a <Chart />), this boundary intercepts the error. This prevents the
+ * entire React tree from unmounting and displays a clean fallback UI to
+ * isolate the defective component.
+ */
+declare class MDXErrorBoundary extends Component<Props, State> {
+    constructor(props: Props);
+    /**
+     * Updates the state when an error occurs to trigger the fallback UI rendering.
+     */
+    static getDerivedStateFromError(error: Error): State;
+    /**
+     * Intercepts the error and its contextual information.
+     * This is the ideal place to hook into monitoring tools (like Sentry or Datadog)
+     * for production environments.
+     */
+    componentDidCatch(error: Error, errorInfo: ErrorInfo): void;
+    render(): string | number | boolean | Iterable<ReactNode> | react_jsx_runtime.JSX.Element | null | undefined;
+}
+
+declare function parseMdxClient(mdx: string | Uint8Array): Promise<AstNode[]>;
+
+declare class MdxBinaryDecoder {
+    private view;
+    private buffer;
+    private offset;
+    private decoder;
+    private stringCache;
+    constructor(buffer: Uint8Array);
+    decode(): AstNode[];
+    private decodeNode;
+    private readU8;
+    private readU16;
+    private readU32;
+    private readStringU16;
+    private readStringU32;
+}
+
+export { type AstNode, MDXClientRenderer, type MDXComponents, MDXErrorBoundary, MdxBinaryDecoder, parseMdxClient as parseMdx };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toaq-oss/omni-mdx",
-  "version": "0.1.22",
+  "version": "0.1.23",
   "description": "MDX parser + renderer for Next.js \u2014 Rust core, RSC-compatible",
   "license": "MIT",
   "type": "module",
@@ -10,13 +10,16 @@
   },
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     },
     "./server": {
+      "types": "./dist/server.d.ts",
       "import": "./dist/server.js"
     },
     "./client": {
+      "types": "./dist/client.d.ts",
       "import": "./dist/client.js",
       "require": "./dist/client.cjs"
     },