@khairold/xml-render 0.1.0

package/dist/react-native/XmlRender.js

@@ -0,0 +1,91 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { View, Text } from "react-native";
+import { useXmlRenderContext } from "./context";
+import { ErrorBoundary } from "./ErrorBoundary";
+/**
+ * Default text renderer - renders plain text in a Text component
+ */
+function DefaultTextRenderer({ segment, }) {
+    return _jsx(Text, { children: segment.content });
+}
+/**
+ * Default fallback renderer for unknown segment types
+ */
+function DefaultFallback({ segment, }) {
+    // In development, show a warning; in production, render content as text
+    if (process.env.NODE_ENV === "development") {
+        console.warn(`XmlRender: No renderer found for segment type "${String(segment.type)}"`);
+    }
+    return _jsx(Text, { children: segment.content });
+}
+/**
+ * Render a single segment using the catalog (without key or ErrorBoundary wrapper)
+ */
+function renderSegmentContent(segment, index, catalog, fallback) {
+    const segmentType = segment.type;
+    // Handle text segments
+    if (segmentType === "text") {
+        const TextRenderer = catalog.getTextRenderer();
+        if (TextRenderer) {
+            return (_jsx(TextRenderer, { segment: segment, index: index }));
+        }
+        return _jsx(DefaultTextRenderer, { segment: segment });
+    }
+    // Handle registered tag segments
+    const Renderer = catalog.getRenderer(segmentType);
+    if (Renderer) {
+        return _jsx(Renderer, { segment: segment, index: index });
+    }
+    // Use fallback for unknown segment types
+    if (fallback) {
+        return fallback(segment, index);
+    }
+    return _jsx(DefaultFallback, { segment: segment });
+}
+/**
+ * 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 function XmlRender({ segments, fallback, catalog: catalogProp, errorFallback, }) {
+    // Use provided catalog or get from context
+    const contextValue = catalogProp ? null : useXmlRenderContext();
+    const catalog = catalogProp ?? contextValue?.catalog;
+    if (!catalog) {
+        throw new Error("XmlRender requires a catalog prop or must be used within XmlRenderProvider");
+    }
+    return (_jsx(View, { children: segments.map((segment, index) => (_jsx(ErrorBoundary, { segmentType: String(segment.type), fallback: errorFallback, children: renderSegmentContent(segment, index, catalog, fallback) }, index))) }));
+}
+//# sourceMappingURL=XmlRender.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"XmlRender.js","sourceRoot":"","sources":["../../src/react-native/XmlRender.tsx"],"names":[],"mappings":";AAOA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAG1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAgBhD;;GAEG;AACH,SAAS,mBAAmB,CAA+B,EACzD,OAAO,GAGR;IACC,OAAO,KAAC,IAAI,cAAE,OAAO,CAAC,OAAO,GAAQ,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAA+B,EACrD,OAAO,GAGR;IACC,wEAAwE;IACxE,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;QAC3C,OAAO,CAAC,IAAI,CACV,kDAAkD,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAC1E,CAAC;IACJ,CAAC;IACD,OAAO,KAAC,IAAI,cAAE,OAAO,CAAC,OAAO,GAAQ,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAC3B,OAA6B,EAC7B,KAAa,EACb,OAAuB,EACvB,QAAsE;IAEtE,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAEjC,uBAAuB;IACvB,IAAI,WAAW,KAAK,MAAM,EAAE,CAAC;QAC3B,MAAM,YAAY,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;QAC/C,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,CACL,KAAC,YAAY,IACX,OAAO,EAAE,OAAuC,EAChD,KAAK,EAAE,KAAK,GACZ,CACH,CAAC;QACJ,CAAC;QACD,OAAO,KAAC,mBAAmB,IAAC,OAAO,EAAE,OAAuC,GAAI,CAAC;IACnF,CAAC;IAED,iCAAiC;IACjC,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,WAA0B,CAAC,CAAC;IACjE,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,KAAC,QAAQ,IAAC,OAAO,EAAE,OAA4C,EAAE,KAAK,EAAE,KAAK,GAAI,CAAC;IAC3F,CAAC;IAED,yCAAyC;IACzC,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,KAAC,eAAe,IAAC,OAAO,EAAE,OAAO,GAAI,CAAC;AAC/C,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,UAAU,SAAS,CAA+B,EACtD,QAAQ,EACR,QAAQ,EACR,OAAO,EAAE,WAAW,EACpB,aAAa,GACS;IACtB,2CAA2C;IAC3C,MAAM,YAAY,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB,EAAS,CAAC;IACvE,MAAM,OAAO,GAAG,WAAW,IAAI,YAAY,EAAE,OAAO,CAAC;IAErD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,4EAA4E,CAC7E,CAAC;IACJ,CAAC;IAED,OAAO,CACL,KAAC,IAAI,cACF,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,CAChC,KAAC,aAAa,IAEZ,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EACjC,QAAQ,EAAE,aAAa,YAEtB,oBAAoB,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,IAJnD,KAAK,CAKI,CACjB,CAAC,GACG,CACR,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,100 @@
+/**
+ * Component Catalog for React Native XML Renderer
+ *
+ * Creates a type-safe mapping from segment types to React Native 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 Text component) */
+    textRenderer?: TextRenderer<TDefs>;
+}
+/**
+ * Create a component catalog for rendering XML segments in React Native.
+ *
+ * The catalog maps registered tag types to React Native components that render them.
+ * TypeScript ensures that component props match the tag's attribute schema.
+ *
+ * @example
+ * ```tsx
+ * import { createCatalog } from '@aura/xml-render/react-native';
+ * import { View, Text } from 'react-native';
+ * import { registry } from './xml-registry';
+ *
+ * const catalog = createCatalog(registry, {
+ *   components: {
+ *     callout: ({ segment }) => (
+ *       <View style={styles.callout}>
+ *         <Text>{segment.content}</Text>
+ *       </View>
+ *     ),
+ *     chart: ({ segment }) => (
+ *       <ChartComponent
+ *         type={segment.attributes?.type}
+ *         data={segment.content}
+ *       />
+ *     ),
+ *   },
+ *   textRenderer: ({ segment }) => <Text>{segment.content}</Text>,
+ * });
+ * ```
+ *
+ * @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-native/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/react-native/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,sFAAsF;IACtF,YAAY,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;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-native/catalog.js

@@ -0,0 +1,56 @@
+/**
+ * Create a component catalog for rendering XML segments in React Native.
+ *
+ * The catalog maps registered tag types to React Native components that render them.
+ * TypeScript ensures that component props match the tag's attribute schema.
+ *
+ * @example
+ * ```tsx
+ * import { createCatalog } from '@aura/xml-render/react-native';
+ * import { View, Text } from 'react-native';
+ * import { registry } from './xml-registry';
+ *
+ * const catalog = createCatalog(registry, {
+ *   components: {
+ *     callout: ({ segment }) => (
+ *       <View style={styles.callout}>
+ *         <Text>{segment.content}</Text>
+ *       </View>
+ *     ),
+ *     chart: ({ segment }) => (
+ *       <ChartComponent
+ *         type={segment.attributes?.type}
+ *         data={segment.content}
+ *       />
+ *     ),
+ *   },
+ *   textRenderer: ({ segment }) => <Text>{segment.content}</Text>,
+ * });
+ * ```
+ *
+ * @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-native/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/react-native/catalog.ts"],"names":[],"mappings":"AAwFA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;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-native/context.d.ts

@@ -0,0 +1,66 @@
+/**
+ * React Native 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 in React Native.
+ *
+ * @example
+ * ```tsx
+ * import { XmlRenderProvider } from '@aura/xml-render/react-native';
+ * 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-native';
+ *
+ * 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-native/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/react-native/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-native/context.js

@@ -0,0 +1,63 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * React Native 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 in React Native.
+ *
+ * @example
+ * ```tsx
+ * import { XmlRenderProvider } from '@aura/xml-render/react-native';
+ * 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-native';
+ *
+ * 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-native/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/react-native/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-native/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @aura/xml-render/react-native - React Native Renderer
+ *
+ * React Native components for rendering parsed XML segments.
+ * Use this entry point for mobile applications.
+ *
+ * @example
+ * ```tsx
+ * import { XmlRenderProvider, XmlRender, createCatalog } from '@aura/xml-render/react-native';
+ * 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-native/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react-native/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-native/index.js

@@ -0,0 +1,41 @@
+/**
+ * @aura/xml-render/react-native - React Native Renderer
+ *
+ * React Native components for rendering parsed XML segments.
+ * Use this entry point for mobile applications.
+ *
+ * @example
+ * ```tsx
+ * import { XmlRenderProvider, XmlRender, createCatalog } from '@aura/xml-render/react-native';
+ * 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-native/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react-native/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/registry.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Tag Registry for XML Render
+ *
+ * Creates an immutable registry of XML tag definitions with Zod schema validation.
+ * TypeScript infers attribute types directly from the Zod schemas.
+ */
+import type { ZodType, infer as ZodInfer } from "zod";
+/**
+ * Definition for a single XML tag in the registry
+ */
+export interface TagDefinition<TSchema extends ZodType = ZodType> {
+    /** Zod schema for validating and typing tag attributes */
+    schema: TSchema;
+    /** Whether the tag contains inner content (default: true) */
+    hasContent?: boolean;
+    /** Whether the tag is self-closing like <image /> (default: false) */
+    selfClosing?: boolean;
+}
+/**
+ * Input type for createRegistry - a record of tag names to definitions
+ */
+export type TagDefinitions = Record<string, TagDefinition>;
+/**
+ * Infer the attribute type from a TagDefinition's Zod schema
+ */
+export type InferAttributes<T extends TagDefinition> = ZodInfer<T["schema"]>;
+/**
+ * Safe parse result type for validateAttributes
+ */
+export type SafeParseResult<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: unknown;
+};
+/**
+ * The immutable registry type returned by createRegistry
+ */
+export interface Registry<TDefs extends TagDefinitions> {
+    /** Get all registered tag names */
+    readonly tagNames: ReadonlyArray<keyof TDefs & string>;
+    /** Get the definition for a specific tag */
+    getTag<K extends keyof TDefs>(name: K): Readonly<TDefs[K]> | undefined;
+    /** Check if a tag name is registered */
+    hasTag(name: string): name is keyof TDefs & string;
+    /** Get the Zod schema for a tag's attributes */
+    getSchema<K extends keyof TDefs>(name: K): TDefs[K]["schema"] | undefined;
+    /** Validate attributes for a tag using its Zod schema */
+    validateAttributes<K extends keyof TDefs>(name: K, attributes: unknown): SafeParseResult<InferAttributes<TDefs[K]>>;
+    /** Check if a tag is self-closing */
+    isSelfClosing<K extends keyof TDefs>(name: K): boolean;
+    /** Check if a tag has content */
+    hasContent<K extends keyof TDefs>(name: K): boolean;
+    /** The raw definitions (frozen) */
+    readonly definitions: Readonly<TDefs>;
+}
+/**
+ * Create an immutable tag registry from tag definitions.
+ *
+ * The registry provides type-safe access to tag definitions and their
+ * Zod schemas for attribute validation.
+ *
+ * @example
+ * ```ts
+ * import { z } from 'zod';
+ * import { createRegistry } from '@aura/xml-render';
+ *
+ * const registry = createRegistry({
+ *   chart: {
+ *     schema: z.object({
+ *       type: z.enum(['bar', 'line', 'pie']),
+ *       title: z.string().optional(),
+ *     }),
+ *     hasContent: true,
+ *   },
+ *   image: {
+ *     schema: z.object({
+ *       src: z.string(),
+ *       alt: z.string().optional(),
+ *     }),
+ *     selfClosing: true,
+ *     hasContent: false,
+ *   },
+ * });
+ *
+ * // TypeScript knows the exact tag names
+ * registry.tagNames; // ['chart', 'image']
+ *
+ * // Attribute types are inferred from Zod schemas
+ * type ChartAttrs = InferAttributes<typeof registry.definitions.chart>;
+ * // { type: 'bar' | 'line' | 'pie'; title?: string }
+ * ```
+ *
+ * @param definitions - Record of tag names to their definitions
+ * @returns An immutable registry instance
+ */
+export declare function createRegistry<TDefs extends TagDefinitions>(definitions: TDefs): Registry<TDefs>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,QAAQ,EAAsB,MAAM,KAAK,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,OAAO,SAAS,OAAO,GAAG,OAAO;IAC9D,0DAA0D;IAC1D,MAAM,EAAE,OAAO,CAAC;IAChB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,sEAAsE;IACtE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,aAAa,IAAI,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;AAE7E;;GAEG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IACzB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAC1B;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAEvC;;GAEG;AACH,MAAM,WAAW,QAAQ,CAAC,KAAK,SAAS,cAAc;IACpD,mCAAmC;IACnC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC;IAEvD,4CAA4C;IAC5C,MAAM,CAAC,CAAC,SAAS,MAAM,KAAK,EAAE,IAAI,EAAE,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAEvE,wCAAwC;IACxC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,MAAM,KAAK,GAAG,MAAM,CAAC;IAEnD,gDAAgD;IAChD,SAAS,CAAC,CAAC,SAAS,MAAM,KAAK,EAAE,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC;IAE1E,yDAAyD;IACzD,kBAAkB,CAAC,CAAC,SAAS,MAAM,KAAK,EACtC,IAAI,EAAE,CAAC,EACP,UAAU,EAAE,OAAO,GAClB,eAAe,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAE9C,qCAAqC;IACrC,aAAa,CAAC,CAAC,SAAS,MAAM,KAAK,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC;IAEvD,iCAAiC;IACjC,UAAU,CAAC,CAAC,SAAS,MAAM,KAAK,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC;IAEpD,mCAAmC;IACnC,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;CACvC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,cAAc,CAAC,KAAK,SAAS,cAAc,EACzD,WAAW,EAAE,KAAK,GACjB,QAAQ,CAAC,KAAK,CAAC,CAsEjB"}