@pixodesk/svg-animator-rn 1.0.39 → 1.0.40

package/src/PxRnErrorBoundary.tsx

@@ -4,14 +4,19 @@
  *---------------------------------------------------------------------------------------*/
 
 import { Component, type ErrorInfo, type ReactNode } from 'react';
-import { createDiagnostics, PxDiagnosticKind, type PxDiagnostics } from '@pixodesk/svg-animator-core';
+import { PxDiagnosticKind, type PxDiagnostics } from '@pixodesk/svg-animator-core';
+import { createDiagnostics } from '@pixodesk/svg-animator-core/internal';
 
+/** @public @advanced */
 export interface PxRnErrorBoundaryProps {
     children: ReactNode;
     /** Rendered instead of the children once something has thrown. */
     fallback?: (error: Error) => ReactNode;
-    onError?: (error: Error, info?: string) => void;
-    /** Where to report the failure (API review §5). Defaults to the console. */
+    /**
+     * Where the failure is reported (API review §5, §25.1): `error(internal, …)` with
+     * `{ componentStack }` as the detail — so it reaches `onError` like every other failure.
+     * Defaults to the console.
+     */
     diag?: PxDiagnostics;
 }
 
@@ -25,12 +30,13 @@ interface State {
  * A throw anywhere in the rendered SVG tree — an unsupported prop shape, a
  * react-native-svg internal, a reanimated attachment failure — otherwise
  * unmounts the whole React tree above it. Here it is contained to this one
- * animation, reported through `onError`, and replaced by `fallback`.
+ * animation, reported through the diagnostics channel, and replaced by `fallback`.
  *
  * NOTE the limit: this catches JavaScript errors only. A crash INSIDE the
  * native renderer (see `openClosedTextPathTargets` for a real example) never
  * reaches JavaScript and cannot be caught here — those have to be avoided
  * rather than handled.
+ * @public @advanced
  */
 export class PxRnErrorBoundary extends Component<PxRnErrorBoundaryProps, State> {
     override state: State = { error: null };
@@ -40,9 +46,8 @@ export class PxRnErrorBoundary extends Component<PxRnErrorBoundaryProps, State>
     }
 
     override componentDidCatch(error: Error, info: ErrorInfo): void {
-        this.props.onError?.(error, info?.componentStack ?? undefined);
         (this.props.diag ?? createDiagnostics(undefined, '[PixodeskSvgAnimator]'))
-            .warn(PxDiagnosticKind.internal, 'render failed: ' + (error?.message ?? String(error)));
+            .error(PxDiagnosticKind.internal, error, { componentStack: info?.componentStack ?? undefined });
     }
 
     override componentDidUpdate(prev: PxRnErrorBoundaryProps): void {

package/src/PxRnPropNames.ts

@@ -3,7 +3,7 @@
  * Licensed under the MIT License. See the LICENSE file in the project root for details.
  *---------------------------------------------------------------------------------------*/
 
-import { kebabToCamelCaseWord } from '@pixodesk/svg-animator-core';
+import { kebabToCamelCaseWord } from '@pixodesk/svg-animator-core/internal';
 import { svgTransformToMatrix } from './PxRnMatrix';
 
 /** Attribute names with a react-native-svg prop equivalent under a
@@ -22,6 +22,7 @@ const DROPPED_ATTRS = new Set(['class', 'className', 'style', 'xmlns', 'xmlns:xl
  *
  * Pure (no react-native-svg import) so the track compiler and its tests
  * don't need a React Native environment.
+ * @internal
  */
 export function toRnPropName(attrName: string): string | undefined {
     if (DROPPED_ATTRS.has(attrName)) return undefined;

package/src/PxRnRender.tsx

@@ -3,19 +3,13 @@
  * Licensed under the MIT License. See the LICENSE file in the project root for details.
  *---------------------------------------------------------------------------------------*/
 
-import {
-    getNormalizedProps,
-    resolveStyle,
-    sanitizeAttributeValue,
-    DISALLOWED_SVG_TAGS_LOWER,
-    TEXT_CONTENT_ATTR,
-    type PxDefs,
-    type PxNode,
-} from '@pixodesk/svg-animator-core';
+import { getNormalizedProps, type PxDefs, type PxNode } from '@pixodesk/svg-animator-core';
+import { sanitizeAttributeValue, DISALLOWED_SVG_TAGS_LOWER, TEXT_CONTENT_ATTR } from '@pixodesk/svg-animator-core/internal';
 import { createElement, type ComponentType, type ReactElement, type ReactNode } from 'react';
 import { RN_SVG_COMPONENTS } from './PxRnTypeMap';
 import { toRnPropName, toRnPropValue } from './PxRnPropNames';
 
+/** @internal */
 export interface RenderRnNodeOptions {
     /** Collects non-fatal issues (unsupported tags, dropped attrs). */
     warnings?: Array<string>;
@@ -44,6 +38,7 @@ export interface RenderRnNodeOptions {
  * Converts core-normalized wire props into react-native-svg props: RN prop
  * naming, sanitization (same security rules as the web renderer), numeric
  * coercion where possible.
+ * @internal
  */
 export function toRnProps(props: Record<string, any>, warnings?: Array<string>, tag?: string): Record<string, any> {
     const normalized = getNormalizedProps(props);
@@ -62,6 +57,7 @@ export function toRnProps(props: Record<string, any>, warnings?: Array<string>,
  * Renders a (materialized) PxNode tree to react-native-svg elements.
  * Mirrors the web `renderNode` contract: unsupported/dangerous tags are
  * skipped with a warning, never a crash.
+ * @internal
  */
 export function renderRnNode(node: PxNode, opts: RenderRnNodeOptions = {}, key?: string | number): ReactElement | null {
     if (!node) return null;
@@ -91,11 +87,10 @@ export function renderRnNode(node: PxNode, opts: RenderRnNodeOptions = {}, key?:
     const rnProps = toRnProps(props, opts.warnings, tag);
     if (domType !== undefined) rnProps.type = domType;
 
-    // `node.style` — a named preset from `definitions.styles`, or an inline
-    // record. react-native-svg has no CSS, so the resolved declarations are
-    // applied as ordinary props (the same names, e.g. `fill`, `strokeWidth`).
+    // `node.style` — an inline record of declarations. react-native-svg has no CSS, so
+    // they are applied as ordinary props (the same names, e.g. `fill`, `strokeWidth`).
     // Explicit attributes on the node win over the style block.
-    const resolved = resolveStyle(style, opts.defs);
+    const resolved = style;
     if (resolved) {
         for (const [k, v] of Object.entries(resolved)) {
             const rnKey = toRnPropName(k);

package/src/PxRnSafety.ts

@@ -3,7 +3,8 @@
  * Licensed under the MIT License. See the LICENSE file in the project root for details.
  *---------------------------------------------------------------------------------------*/
 
-import { deepClone, generateUniqueId, type PxNode } from '@pixodesk/svg-animator-core';
+import { type PxNode } from '@pixodesk/svg-animator-core';
+import { deepClone, generateUniqueId } from '@pixodesk/svg-animator-core/internal';
 
 /**
  * Workarounds for defects in react-native-svg's NATIVE renderer that would
@@ -57,6 +58,7 @@ function forEachNode(node: PxNode | undefined, visit: (n: PxNode, parent?: PxNod
  * has zero length and nothing changes visually at all.
  *
  * Returns the document unchanged — the same object — when nothing matches.
+ * @internal
  */
 export function openClosedTextPathTargets(doc: PxNode, warnings?: Array<string>): PxNode {
     // Cheap pre-check: the overwhelming majority of documents have no textPath.

package/src/PxRnTracks.ts

@@ -3,15 +3,8 @@
  * Licensed under the MIT License. See the LICENSE file in the project root for details.
  *---------------------------------------------------------------------------------------*/
 
-import {
-    calcAnimationValues,
-    getAnimatorConfig,
-    getNormalizedBindings,
-    DEFAULT_DURATION_MS,
-    PxTimelineEngine,
-    type PxAnimatedSvgDocument,
-    type PxAnimationDefinition,
-} from '@pixodesk/svg-animator-core';
+import { calcAnimationValues, getAnimatorConfig, getNormalizedBindings, PxTimelineEngine, type PxAnimatedSvgDocument, type PxAnimationDefinition } from '@pixodesk/svg-animator-core';
+import { DEFAULT_DURATION_MS } from '@pixodesk/svg-animator-core/internal';
 import { toRnPropName, toRnPropValue } from './PxRnPropNames';
 
 /**
@@ -22,6 +15,7 @@ import { toRnPropName, toRnPropValue } from './PxRnPropNames';
  * with — so RN playback is value-identical to the web player. Easing, loops,
  * transform composition, color interpolation and path morphing are all baked
  * into the samples at compile time; the UI-thread worklet only indexes arrays.
+ * @internal
  */
 export interface PxElementTracks {
     /** Element id (after id regeneration). */
@@ -30,6 +24,7 @@ export interface PxElementTracks {
     props: Record<string, Array<string | number | Array<number>>>;
 }
 
+/** @internal */
 export interface PxCompiledTracks {
     /** Per-iteration duration, ms. */
     duration: number;
@@ -51,6 +46,7 @@ export interface PxCompiledTracks {
     elements: Array<PxElementTracks>;
 }
 
+/** @internal */
 export interface CompileTracksOptions {
     /** Target sample rate, samples/second. Default 60 (one per frame). */
     sampleRate?: number;
@@ -72,6 +68,7 @@ export interface CompileTracksOptions {
 /**
  * Compiles a MATERIALIZED document (run `materializeAllInTree(doc, 'frames')`
  * + `generateNewIds` first) into densely sampled per-element tracks.
+ * @internal
  */
 export function compileTracks(doc: PxAnimatedSvgDocument, opts?: CompileTracksOptions): PxCompiledTracks {
     const config = getAnimatorConfig(doc) || {};
@@ -173,6 +170,7 @@ export const NATIVE_PROP_NAME: Record<string, string> = {
  * reanimated animated-props path of a real device. Props that are applied by
  * re-rendering through React (and therefore still pass through react-native-svg's
  * JS layer), and every value on the web, must keep the wire name.
+ * @internal
  */
 export function sampleProps(
     tracks: PxElementTracks,

package/src/PxRnTypeMap.ts

@@ -63,6 +63,7 @@ import type { ComponentType } from 'react';
  *
  * Keys are the wire-format `node.type` values, which follow SVG's own casing
  * (`clipPath`, `feGaussianBlur`, `linearGradient`, …).
+ * @internal
  */
 export const RN_SVG_COMPONENTS: Record<string, ComponentType<any>> = {
     // Root & containers

package/src/index.ts

@@ -6,12 +6,3 @@
 export { PixodeskSvgAnimator, default } from './PixodeskSvgAnimator';
 export type { PixodeskSvgAnimatorProps, RnAnimatorApi } from './PixodeskSvgAnimator';
 
-export { renderRnNode, toRnProps } from './PxRnRender';
-export { PxRnErrorBoundary, type PxRnErrorBoundaryProps } from './PxRnErrorBoundary';
-export { openClosedTextPathTargets } from './PxRnSafety';
-export type { RenderRnNodeOptions } from './PxRnRender';
-
-export { compileTracks, sampleProps } from './PxRnTracks';
-export type { CompileTracksOptions, PxCompiledTracks, PxElementTracks } from './PxRnTracks';
-
-export { RN_SVG_COMPONENTS, toRnPropName } from './PxRnTypeMap';