@khairold/xml-render 0.1.0

package/dist/react/catalog.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Component Catalog for React XML Renderer
+ *
+ * Creates a type-safe mapping from segment types to React components.
+ * The catalog ensures that each registered tag type has a corresponding
+ * renderer component with properly typed props.
+ */
+import type { ComponentType } from "react";
+import type { TagDefinitions, Registry } from "../registry";
+import type { ParsedSegment } from "../parser";
+/**
+ * Props passed to segment renderer components
+ */
+export interface SegmentProps<TDefs extends TagDefinitions, TType extends keyof TDefs | "text"> {
+    /** The segment being rendered */
+    segment: ParsedSegment<TDefs, TType>;
+    /** Index of this segment in the segments array */
+    index: number;
+}
+/**
+ * Props for the text segment renderer
+ */
+export interface TextSegmentProps<TDefs extends TagDefinitions> {
+    segment: ParsedSegment<TDefs, "text">;
+    index: number;
+}
+/**
+ * A component that renders a specific segment type
+ */
+export type SegmentRenderer<TDefs extends TagDefinitions, TType extends keyof TDefs> = ComponentType<SegmentProps<TDefs, TType>>;
+/**
+ * A component that renders text segments
+ */
+export type TextRenderer<TDefs extends TagDefinitions> = ComponentType<TextSegmentProps<TDefs>>;
+/**
+ * Component definitions for the catalog - maps tag names to renderers
+ */
+export type CatalogComponents<TDefs extends TagDefinitions> = {
+    [K in keyof TDefs]: SegmentRenderer<TDefs, K>;
+};
+/**
+ * The catalog interface returned by createCatalog
+ */
+export interface Catalog<TDefs extends TagDefinitions> {
+    /** Get the renderer component for a specific segment type */
+    getRenderer<K extends keyof TDefs>(type: K): SegmentRenderer<TDefs, K> | undefined;
+    /** Get the text segment renderer */
+    getTextRenderer(): TextRenderer<TDefs> | undefined;
+    /** Check if a renderer exists for a segment type */
+    hasRenderer(type: keyof TDefs | "text"): boolean;
+    /** The registry this catalog is based on */
+    readonly registry: Registry<TDefs>;
+    /** All registered component renderers */
+    readonly components: Readonly<Partial<CatalogComponents<TDefs>>>;
+}
+/**
+ * Options for creating a catalog
+ */
+export interface CatalogOptions<TDefs extends TagDefinitions> {
+    /** Component renderers for each tag type */
+    components: Partial<CatalogComponents<TDefs>>;
+    /** Optional text segment renderer (default renders plain text in a span) */
+    textRenderer?: TextRenderer<TDefs>;
+}
+/**
+ * Create a component catalog for rendering XML segments.
+ *
+ * The catalog maps registered tag types to React components that render them.
+ * TypeScript ensures that component props match the tag's attribute schema.
+ *
+ * @example
+ * ```tsx
+ * import { createCatalog } from '@aura/xml-render/react';
+ * import { registry } from './xml-registry';
+ *
+ * const catalog = createCatalog(registry, {
+ *   components: {
+ *     callout: ({ segment }) => (
+ *       <div className={`callout callout-${segment.attributes?.type}`}>
+ *         {segment.content}
+ *       </div>
+ *     ),
+ *     chart: ({ segment }) => (
+ *       <ChartComponent
+ *         type={segment.attributes?.type}
+ *         data={segment.content}
+ *       />
+ *     ),
+ *   },
+ *   textRenderer: ({ segment }) => <span>{segment.content}</span>,
+ * });
+ * ```
+ *
+ * @param registry - The tag registry defining valid segment types
+ * @param options - Component renderers and optional text renderer
+ * @returns A catalog instance for use with XmlRenderProvider
+ */
+export declare function createCatalog<TDefs extends TagDefinitions>(registry: Registry<TDefs>, options: CatalogOptions<TDefs>): Catalog<TDefs>;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/react/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/react/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EACV,cAAc,EACd,QAAQ,EAET,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,YAAY,CAC3B,KAAK,SAAS,cAAc,EAC5B,KAAK,SAAS,MAAM,KAAK,GAAG,MAAM;IAElC,iCAAiC;IACjC,OAAO,EAAE,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACrC,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,KAAK,SAAS,cAAc;IAC5D,OAAO,EAAE,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACtC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,CACzB,KAAK,SAAS,cAAc,EAC5B,KAAK,SAAS,MAAM,KAAK,IACvB,aAAa,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AAE9C;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,KAAK,SAAS,cAAc,IAAI,aAAa,CACpE,gBAAgB,CAAC,KAAK,CAAC,CACxB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,CAAC,KAAK,SAAS,cAAc,IAAI;KAC3D,CAAC,IAAI,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,EAAE,CAAC,CAAC;CAC9C,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,OAAO,CAAC,KAAK,SAAS,cAAc;IACnD,6DAA6D;IAC7D,WAAW,CAAC,CAAC,SAAS,MAAM,KAAK,EAAE,IAAI,EAAE,CAAC,GAAG,eAAe,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC;IAEnF,oCAAoC;IACpC,eAAe,IAAI,YAAY,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC;IAEnD,oDAAoD;IACpD,WAAW,CAAC,IAAI,EAAE,MAAM,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;IAEjD,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAEnC,yCAAyC;IACzC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;CAClE;AAED;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,KAAK,SAAS,cAAc;IAC1D,4CAA4C;IAC5C,UAAU,EAAE,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9C,4EAA4E;IAC5E,YAAY,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,aAAa,CAAC,KAAK,SAAS,cAAc,EACxD,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,EACzB,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,GAC7B,OAAO,CAAC,KAAK,CAAC,CA4BhB"}

package/dist/react/catalog.js

@@ -0,0 +1,55 @@
+/**
+ * Create a component catalog for rendering XML segments.
+ *
+ * The catalog maps registered tag types to React components that render them.
+ * TypeScript ensures that component props match the tag's attribute schema.
+ *
+ * @example
+ * ```tsx
+ * import { createCatalog } from '@aura/xml-render/react';
+ * import { registry } from './xml-registry';
+ *
+ * const catalog = createCatalog(registry, {
+ *   components: {
+ *     callout: ({ segment }) => (
+ *       <div className={`callout callout-${segment.attributes?.type}`}>
+ *         {segment.content}
+ *       </div>
+ *     ),
+ *     chart: ({ segment }) => (
+ *       <ChartComponent
+ *         type={segment.attributes?.type}
+ *         data={segment.content}
+ *       />
+ *     ),
+ *   },
+ *   textRenderer: ({ segment }) => <span>{segment.content}</span>,
+ * });
+ * ```
+ *
+ * @param registry - The tag registry defining valid segment types
+ * @param options - Component renderers and optional text renderer
+ * @returns A catalog instance for use with XmlRenderProvider
+ */
+export function createCatalog(registry, options) {
+    const { components, textRenderer } = options;
+    const frozenComponents = Object.freeze({ ...components });
+    const catalog = {
+        registry,
+        components: frozenComponents,
+        getRenderer(type) {
+            return frozenComponents[type];
+        },
+        getTextRenderer() {
+            return textRenderer;
+        },
+        hasRenderer(type) {
+            if (type === "text") {
+                return textRenderer !== undefined;
+            }
+            return type in frozenComponents;
+        },
+    };
+    return Object.freeze(catalog);
+}
+//# sourceMappingURL=catalog.js.map

package/dist/react/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/react/catalog.ts"],"names":[],"mappings":"AAwFA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAyB,EACzB,OAA8B;IAE9B,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IAE7C,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,UAAU,EAAE,CAEvD,CAAC;IAEF,MAAM,OAAO,GAAmB;QAC9B,QAAQ;QACR,UAAU,EAAE,gBAAgB;QAE5B,WAAW,CAAwB,IAAO;YACxC,OAAO,gBAAgB,CAAC,IAAI,CAA0C,CAAC;QACzE,CAAC;QAED,eAAe;YACb,OAAO,YAAY,CAAC;QACtB,CAAC;QAED,WAAW,CAAC,IAA0B;YACpC,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;gBACpB,OAAO,YAAY,KAAK,SAAS,CAAC;YACpC,CAAC;YACD,OAAO,IAAI,IAAI,gBAAgB,CAAC;QAClC,CAAC;KACF,CAAC;IAEF,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC"}

package/dist/react/context.d.ts

@@ -0,0 +1,66 @@
+/**
+ * React Context for XML Render
+ *
+ * Provides the component catalog to the render tree via React Context.
+ * This allows XmlRender components to access the catalog without prop drilling.
+ */
+import React, { type ReactNode } from "react";
+import type { TagDefinitions } from "../registry";
+import type { Catalog } from "./catalog";
+/**
+ * Context value type containing the catalog
+ */
+interface XmlRenderContextValue<TDefs extends TagDefinitions> {
+    catalog: Catalog<TDefs>;
+}
+/**
+ * Props for XmlRenderProvider
+ */
+export interface XmlRenderProviderProps<TDefs extends TagDefinitions> {
+    /** The component catalog to provide to the tree */
+    catalog: Catalog<TDefs>;
+    /** Child components that can use XmlRender */
+    children: ReactNode;
+}
+/**
+ * Provider component that makes the catalog available to XmlRender components.
+ *
+ * Wrap your application or component tree with this provider to enable
+ * XML segment rendering.
+ *
+ * @example
+ * ```tsx
+ * import { XmlRenderProvider } from '@aura/xml-render/react';
+ * import { catalog } from './xml-catalog';
+ *
+ * function App() {
+ *   return (
+ *     <XmlRenderProvider catalog={catalog}>
+ *       <MyContent />
+ *     </XmlRenderProvider>
+ *   );
+ * }
+ * ```
+ */
+export declare function XmlRenderProvider<TDefs extends TagDefinitions>({ catalog, children, }: XmlRenderProviderProps<TDefs>): React.ReactElement;
+/**
+ * Hook to access the XML render catalog from context.
+ *
+ * Must be used within an XmlRenderProvider.
+ *
+ * @throws Error if used outside of XmlRenderProvider
+ * @returns The current catalog from context
+ *
+ * @example
+ * ```tsx
+ * import { useXmlRenderContext } from '@aura/xml-render/react';
+ *
+ * function CustomRenderer() {
+ *   const { catalog } = useXmlRenderContext();
+ *   // Use catalog to look up renderers...
+ * }
+ * ```
+ */
+export declare function useXmlRenderContext<TDefs extends TagDefinitions = TagDefinitions>(): XmlRenderContextValue<TDefs>;
+export {};
+//# sourceMappingURL=context.d.ts.map

package/dist/react/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/react/context.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,EAA6B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;GAEG;AACH,UAAU,qBAAqB,CAAC,KAAK,SAAS,cAAc;IAC1D,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACzB;AAeD;;GAEG;AACH,MAAM,WAAW,sBAAsB,CAAC,KAAK,SAAS,cAAc;IAClE,mDAAmD;IACnD,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACxB,8CAA8C;IAC9C,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,SAAS,cAAc,EAAE,EAC9D,OAAO,EACP,QAAQ,GACT,EAAE,sBAAsB,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,YAAY,CAQpD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,SAAS,cAAc,GAAG,cAAc,KAC1C,qBAAqB,CAAC,KAAK,CAAC,CAWhC"}

package/dist/react/context.js

@@ -0,0 +1,63 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * React Context for XML Render
+ *
+ * Provides the component catalog to the render tree via React Context.
+ * This allows XmlRender components to access the catalog without prop drilling.
+ */
+import { createContext, useContext } from "react";
+/**
+ * Internal context - stores catalog as unknown, typed at provider/consumer level
+ */
+const XmlRenderContext = createContext(null);
+/**
+ * Provider component that makes the catalog available to XmlRender components.
+ *
+ * Wrap your application or component tree with this provider to enable
+ * XML segment rendering.
+ *
+ * @example
+ * ```tsx
+ * import { XmlRenderProvider } from '@aura/xml-render/react';
+ * import { catalog } from './xml-catalog';
+ *
+ * function App() {
+ *   return (
+ *     <XmlRenderProvider catalog={catalog}>
+ *       <MyContent />
+ *     </XmlRenderProvider>
+ *   );
+ * }
+ * ```
+ */
+export function XmlRenderProvider({ catalog, children, }) {
+    const value = { catalog };
+    return (_jsx(XmlRenderContext.Provider, { value: value, children: children }));
+}
+/**
+ * Hook to access the XML render catalog from context.
+ *
+ * Must be used within an XmlRenderProvider.
+ *
+ * @throws Error if used outside of XmlRenderProvider
+ * @returns The current catalog from context
+ *
+ * @example
+ * ```tsx
+ * import { useXmlRenderContext } from '@aura/xml-render/react';
+ *
+ * function CustomRenderer() {
+ *   const { catalog } = useXmlRenderContext();
+ *   // Use catalog to look up renderers...
+ * }
+ * ```
+ */
+export function useXmlRenderContext() {
+    const context = useContext(XmlRenderContext);
+    if (!context) {
+        throw new Error("useXmlRenderContext must be used within an XmlRenderProvider");
+    }
+    // Cast the internal unknown catalog back to the typed version
+    return { catalog: context.catalog };
+}
+//# sourceMappingURL=context.js.map

package/dist/react/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/react/context.tsx"],"names":[],"mappings":";AAAA;;;;;GAKG;AACH,OAAc,EAAE,aAAa,EAAE,UAAU,EAAkB,MAAM,OAAO,CAAC;AAmBzE;;GAEG;AACH,MAAM,gBAAgB,GAAG,aAAa,CAA8B,IAAI,CAAC,CAAC;AAY1E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,iBAAiB,CAA+B,EAC9D,OAAO,EACP,QAAQ,GACsB;IAC9B,MAAM,KAAK,GAAyB,EAAE,OAAO,EAAE,CAAC;IAEhD,OAAO,CACL,KAAC,gBAAgB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YACpC,QAAQ,GACiB,CAC7B,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,mBAAmB;IAGjC,MAAM,OAAO,GAAG,UAAU,CAAC,gBAAgB,CAAC,CAAC;IAE7C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,8DAA8D,CAC/D,CAAC;IACJ,CAAC;IAED,8DAA8D;IAC9D,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,OAAyB,EAAE,CAAC;AACxD,CAAC"}

package/dist/react/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @aura/xml-render/react - React Renderer
+ *
+ * React components for rendering parsed XML segments.
+ * Use this entry point for web applications.
+ *
+ * @example
+ * ```tsx
+ * import { XmlRenderProvider, XmlRender, createCatalog } from '@aura/xml-render/react';
+ * import { createParser, createRegistry } from '@aura/xml-render';
+ *
+ * // Create catalog with your component renderers
+ * const catalog = createCatalog(registry, {
+ *   components: {
+ *     callout: ({ segment }) => <Callout type={segment.attributes?.type}>{segment.content}</Callout>,
+ *   },
+ * });
+ *
+ * // Render segments
+ * <XmlRenderProvider catalog={catalog}>
+ *   <XmlRender segments={parser.parse(text)} />
+ * </XmlRenderProvider>
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { createCatalog } from "./catalog";
+export { XmlRenderProvider, useXmlRenderContext } from "./context";
+export { XmlRender } from "./XmlRender";
+export { ErrorBoundary } from "./ErrorBoundary";
+export type { Catalog, CatalogOptions, CatalogComponents, SegmentProps, SegmentRenderer, TextRenderer, TextSegmentProps, } from "./catalog";
+export type { XmlRenderProviderProps } from "./context";
+export type { XmlRenderProps } from "./XmlRender";
+export type { ErrorBoundaryProps } from "./ErrorBoundary";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAOH,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAO1C,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAGnE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAOhD,YAAY,EACV,OAAO,EACP,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAGnB,YAAY,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAGxD,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/react/index.js

@@ -0,0 +1,41 @@
+/**
+ * @aura/xml-render/react - React Renderer
+ *
+ * React components for rendering parsed XML segments.
+ * Use this entry point for web applications.
+ *
+ * @example
+ * ```tsx
+ * import { XmlRenderProvider, XmlRender, createCatalog } from '@aura/xml-render/react';
+ * import { createParser, createRegistry } from '@aura/xml-render';
+ *
+ * // Create catalog with your component renderers
+ * const catalog = createCatalog(registry, {
+ *   components: {
+ *     callout: ({ segment }) => <Callout type={segment.attributes?.type}>{segment.content}</Callout>,
+ *   },
+ * });
+ *
+ * // Render segments
+ * <XmlRenderProvider catalog={catalog}>
+ *   <XmlRender segments={parser.parse(text)} />
+ * </XmlRenderProvider>
+ * ```
+ *
+ * @packageDocumentation
+ */
+// ============================================================================
+// Core Functions
+// ============================================================================
+// Catalog - Create component mappings
+export { createCatalog } from "./catalog";
+// ============================================================================
+// Components
+// ============================================================================
+// Provider and consumer hook
+export { XmlRenderProvider, useXmlRenderContext } from "./context";
+// Main render component
+export { XmlRender } from "./XmlRender";
+// Error boundary for safe rendering
+export { ErrorBoundary } from "./ErrorBoundary";
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E,sCAAsC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E,6BAA6B;AAC7B,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEnE,wBAAwB;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,oCAAoC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/react-native/ErrorBoundary.d.ts

@@ -0,0 +1,60 @@
+/**
+ * ErrorBoundary Component for React Native
+ *
+ * Catches render errors in segment components and displays a fallback UI.
+ * Prevents a single segment error from crashing the entire content area.
+ */
+import { Component, type ReactNode, type ErrorInfo } from "react";
+/**
+ * Props for the ErrorBoundary component
+ */
+export interface ErrorBoundaryProps {
+    /** The child components to render */
+    children: ReactNode;
+    /** The segment type being rendered (for error messages) */
+    segmentType: string;
+    /** Optional custom fallback renderer */
+    fallback?: (error: Error, segmentType: string) => ReactNode;
+}
+/**
+ * State for the ErrorBoundary component
+ */
+interface ErrorBoundaryState {
+    hasError: boolean;
+    error: Error | null;
+}
+/**
+ * Error boundary component that catches render errors in child components.
+ *
+ * In development mode, displays a visible error message with segment type and error details.
+ * In production mode, renders a minimal hidden fallback to avoid disrupting the UI.
+ *
+ * @example
+ * ```tsx
+ * <ErrorBoundary segmentType="chart">
+ *   <ChartComponent data={data} />
+ * </ErrorBoundary>
+ * ```
+ *
+ * @example With custom fallback
+ * ```tsx
+ * <ErrorBoundary
+ *   segmentType="table"
+ *   fallback={(error, type) => (
+ *     <View>
+ *       <Text>Failed to render {type}: {error.message}</Text>
+ *     </View>
+ *   )}
+ * >
+ *   <TableComponent data={data} />
+ * </ErrorBoundary>
+ * ```
+ */
+export declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
+    constructor(props: ErrorBoundaryProps);
+    static getDerivedStateFromError(error: Error): ErrorBoundaryState;
+    componentDidCatch(error: Error, errorInfo: ErrorInfo): void;
+    render(): ReactNode;
+}
+export {};
+//# sourceMappingURL=ErrorBoundary.d.ts.map

package/dist/react-native/ErrorBoundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorBoundary.d.ts","sourceRoot":"","sources":["../../src/react-native/ErrorBoundary.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAc,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGzE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,qCAAqC;IACrC,QAAQ,EAAE,SAAS,CAAC;IACpB,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,KAAK,SAAS,CAAC;CAC7D;AAED;;GAEG;AACH,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,aAAc,SAAQ,SAAS,CAC1C,kBAAkB,EAClB,kBAAkB,CACnB;gBACa,KAAK,EAAE,kBAAkB;IAKrC,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,kBAAkB;IAIjE,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI;IAS3D,MAAM,IAAI,SAAS;CAwBpB"}

package/dist/react-native/ErrorBoundary.js

@@ -0,0 +1,84 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+/**
+ * ErrorBoundary Component for React Native
+ *
+ * Catches render errors in segment components and displays a fallback UI.
+ * Prevents a single segment error from crashing the entire content area.
+ */
+import { Component } from "react";
+import { View, Text, StyleSheet } from "react-native";
+/**
+ * Error boundary component that catches render errors in child components.
+ *
+ * In development mode, displays a visible error message with segment type and error details.
+ * In production mode, renders a minimal hidden fallback to avoid disrupting the UI.
+ *
+ * @example
+ * ```tsx
+ * <ErrorBoundary segmentType="chart">
+ *   <ChartComponent data={data} />
+ * </ErrorBoundary>
+ * ```
+ *
+ * @example With custom fallback
+ * ```tsx
+ * <ErrorBoundary
+ *   segmentType="table"
+ *   fallback={(error, type) => (
+ *     <View>
+ *       <Text>Failed to render {type}: {error.message}</Text>
+ *     </View>
+ *   )}
+ * >
+ *   <TableComponent data={data} />
+ * </ErrorBoundary>
+ * ```
+ */
+export class ErrorBoundary extends Component {
+    constructor(props) {
+        super(props);
+        this.state = { hasError: false, error: null };
+    }
+    static getDerivedStateFromError(error) {
+        return { hasError: true, error };
+    }
+    componentDidCatch(error, errorInfo) {
+        // Log the error for debugging
+        console.error(`XmlRender ErrorBoundary: Failed to render segment type "${this.props.segmentType}"`, error, errorInfo.componentStack);
+    }
+    render() {
+        if (this.state.hasError && this.state.error) {
+            // Use custom fallback if provided
+            if (this.props.fallback) {
+                return this.props.fallback(this.state.error, this.props.segmentType);
+            }
+            // Development: show detailed error info
+            if (process.env.NODE_ENV === "development") {
+                return (_jsx(View, { style: styles.errorContainer, children: _jsxs(Text, { style: styles.errorText, children: ["Error in [", this.props.segmentType, "]: ", this.state.error.message] }) }));
+            }
+            // Production: minimal hidden fallback
+            return _jsx(View, { style: styles.hidden });
+        }
+        return this.props.children;
+    }
+}
+const styles = StyleSheet.create({
+    errorContainer: {
+        padding: 8,
+        backgroundColor: "#fee2e2",
+        borderWidth: 1,
+        borderColor: "#ef4444",
+        borderRadius: 4,
+    },
+    errorText: {
+        color: "#991b1b",
+        fontSize: 12,
+        fontFamily: "monospace",
+    },
+    hidden: {
+        width: 0,
+        height: 0,
+        overflow: "hidden",
+    },
+});
+//# sourceMappingURL=ErrorBoundary.js.map

package/dist/react-native/ErrorBoundary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorBoundary.js","sourceRoot":"","sources":["../../src/react-native/ErrorBoundary.tsx"],"names":[],"mappings":";AAAA;;;;;GAKG;AACH,OAAc,EAAE,SAAS,EAAkC,MAAM,OAAO,CAAC;AACzE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAsBtD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,OAAO,aAAc,SAAQ,SAGlC;IACC,YAAY,KAAyB;QACnC,KAAK,CAAC,KAAK,CAAC,CAAC;QACb,IAAI,CAAC,KAAK,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAChD,CAAC;IAED,MAAM,CAAC,wBAAwB,CAAC,KAAY;QAC1C,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACnC,CAAC;IAED,iBAAiB,CAAC,KAAY,EAAE,SAAoB;QAClD,8BAA8B;QAC9B,OAAO,CAAC,KAAK,CACX,2DAA2D,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,EACpF,KAAK,EACL,SAAS,CAAC,cAAc,CACzB,CAAC;IACJ,CAAC;IAED,MAAM;QACJ,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YAC5C,kCAAkC;YAClC,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACxB,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YACvE,CAAC;YAED,wCAAwC;YACxC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;gBAC3C,OAAO,CACL,KAAC,IAAI,IAAC,KAAK,EAAE,MAAM,CAAC,cAAc,YAChC,MAAC,IAAI,IAAC,KAAK,EAAE,MAAM,CAAC,SAAS,2BAChB,IAAI,CAAC,KAAK,CAAC,WAAW,SAAK,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,IACzD,GACF,CACR,CAAC;YACJ,CAAC;YAED,sCAAsC;YACtC,OAAO,KAAC,IAAI,IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,GAAI,CAAC;QACxC,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;IAC/B,cAAc,EAAE;QACd,OAAO,EAAE,CAAC;QACV,eAAe,EAAE,SAAS;QAC1B,WAAW,EAAE,CAAC;QACd,WAAW,EAAE,SAAS;QACtB,YAAY,EAAE,CAAC;KAChB;IACD,SAAS,EAAE;QACT,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE,WAAW;KACxB;IACD,MAAM,EAAE;QACN,KAAK,EAAE,CAAC;QACR,MAAM,EAAE,CAAC;QACT,QAAQ,EAAE,QAAQ;KACnB;CACF,CAAC,CAAC"}

package/dist/react-native/XmlRender.d.ts

@@ -0,0 +1,62 @@
+/**
+ * XmlRender Component for React Native
+ *
+ * Renders an array of parsed segments using the component catalog.
+ * Each segment is rendered by its corresponding component from the catalog.
+ */
+import { type ReactElement, type ReactNode } from "react";
+import type { TagDefinitions } from "../registry";
+import type { Segments, ParsedSegment } from "../parser";
+import type { Catalog } from "./catalog";
+/**
+ * Props for the XmlRender component
+ */
+export interface XmlRenderProps<TDefs extends TagDefinitions> {
+    /** Array of parsed segments to render */
+    segments: Segments<TDefs>;
+    /** Optional fallback renderer for unknown segment types */
+    fallback?: (segment: ParsedSegment<TDefs>, index: number) => ReactNode;
+    /** Optional catalog override (uses context catalog if not provided) */
+    catalog?: Catalog<TDefs>;
+    /** Optional custom error fallback renderer */
+    errorFallback?: (error: Error, segmentType: string) => ReactNode;
+}
+/**
+ * Renders an array of parsed XML segments using the component catalog.
+ *
+ * Each segment is matched to its corresponding renderer component from the catalog.
+ * Text segments use the catalog's text renderer or a default Text component renderer.
+ * Unknown segment types use the fallback prop or render content as plain text.
+ *
+ * @example
+ * ```tsx
+ * import { XmlRender, XmlRenderProvider } from '@aura/xml-render/react-native';
+ * import { createParser } from '@aura/xml-render';
+ * import { registry, catalog } from './xml-config';
+ *
+ * function RichContent({ text }: { text: string }) {
+ *   const parser = createParser(registry);
+ *   const segments = parser.parse(text);
+ *
+ *   return (
+ *     <XmlRenderProvider catalog={catalog}>
+ *       <XmlRender segments={segments} />
+ *     </XmlRenderProvider>
+ *   );
+ * }
+ * ```
+ *
+ * @example With custom fallback
+ * ```tsx
+ * <XmlRender
+ *   segments={segments}
+ *   fallback={(segment, index) => (
+ *     <View style={styles.unknownSegment}>
+ *       <Text>Unknown: {segment.type} - {segment.content}</Text>
+ *     </View>
+ *   )}
+ * />
+ * ```
+ */
+export declare function XmlRender<TDefs extends TagDefinitions>({ segments, fallback, catalog: catalogProp, errorFallback, }: XmlRenderProps<TDefs>): ReactElement;
+//# sourceMappingURL=XmlRender.d.ts.map

package/dist/react-native/XmlRender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"XmlRender.d.ts","sourceRoot":"","sources":["../../src/react-native/XmlRender.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAc,EAAE,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAEzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,KAAK,SAAS,cAAc;IAC1D,yCAAyC;IACzC,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC1B,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC;IACvE,uEAAuE;IACvE,OAAO,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACzB,8CAA8C;IAC9C,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,KAAK,SAAS,CAAC;CAClE;AAqED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,SAAS,CAAC,KAAK,SAAS,cAAc,EAAE,EACtD,QAAQ,EACR,QAAQ,EACR,OAAO,EAAE,WAAW,EACpB,aAAa,GACd,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,YAAY,CAwBtC"}