@pixodesk/svg-animator-web 1.0.39 → 1.0.40

package/dist/index.d.cts

@@ -1,92 +1,21 @@
-import { PxAnimatorAPI as PxAnimatorAPI$1, PxBasicAnimatorAPI as PxBasicAnimatorAPI$1, PxPlaybackOverrideProps, PxComponentCallbacks, PxAnimatedSvgDocument, PxPlatformAdapter, PxTrigger, PxDiagnostics, PxNode, PxDefs, PxAnimatorCallbacksConfig } from '@pixodesk/svg-animator-core';
-export { ApplyResult, BASELINE_PLAYER_VERSION, COLOR_ATTR_NAMES, DEFAULT_DURATION_MS, ExtendPathOpts, ExtendedPath, GlyphCharBox, GlyphCharBoxAlongPath, GlyphMaterializeOpts, KeysMatch, MISSING_GLYPH_CLASS_NAME, MaterializeAllOptions, MotionPathMaterializationOptions, MotionPathSample, PLAYER_WIRE_STEPS, PLAYER_WIRE_VERSION, PX_ANIM_ATTR_NAME, PX_ANIM_SRC_ATTR_NAME, PX_PLAYER_SCHEMA_VERSION, PX_TRANSFORM_PART_KEYS, PX_TRIGGER_DEFAULTS, PathPoint, PathSampler, PlayerConversionResult, PxAlongPathMode, PxAnimatable, PxAnimatedSvgDocument, PxAnimatedSvgDocumentSchema, PxAnimationDefinition, PxAnimationDefinitionSchema, PxAnimatorCallbacksConfig, PxAnimatorConfig, PxAnimatorConfigMergeResult, PxAnimatorConfigPatch, PxAnimatorConfigSchema, PxAnimatorConfigShortcuts, PxAnimatorHandle, PxAnyKeyframe, PxAttrValue, PxAttrValueSchema, PxBezierPath, PxBezierPathSchema, PxBinding, PxBindingSchema, PxClipPathEffectSchema, PxCloneEffect, PxCloneEffectSchema, PxCloneWithout, PxComponentCallbacks, PxControlMode, PxControlProps, PxCreateElement, PxDefs, PxDefsSchema, PxDiagnostic, PxDiagnosticKind, PxDiagnostics, PxDiagnosticsConfig, PxDocumentDiagnosis, PxEasingOrRefSchema, PxEffects, PxEffectsSchema, PxElementAnimation, PxElementAnimationSchema, PxFillGradientEffect, PxFillGradientEffectSchema, PxFillMode, PxFinishAction, PxGlyph, PxGlyphFont, PxGradientSpreadMethod, PxGradientStop, PxGradientStopSchema, PxGradientType, PxInfer, PxKeyframe, PxKeyframeSchema, PxKeyframeValueSchema, PxLengthAdjust, PxLoop, PxLoopDirection, PxLoopRepeatAt, PxLoopSchema, PxMaskType, PxMaskedByEffect, PxMaskedByEffectSchema, PxNode, PxNodeBase, PxNodeSchema, PxNormalizedKeyframe, PxOutAction, PxPathOverflow, PxPinAlign, PxPlatformAdapter, PxPlaybackDirection, PxPlaybackOverrideProps, PxPropertyAnimation, PxPropertyAnimationSchema, PxRepeaterEffect, PxRepeaterEffectSchema, PxResolvedControlMode, PxRetimeEffect, PxRetimeEffectSchema, PxSchema, PxSchemaDesc, PxScrollAxis, PxScrollKind, PxScrollPhase, PxScrollRangePointSchema, PxScrollRangeSchema, PxScrollSchema, PxScrollSource, PxStartOn, PxStrokeGradientEffect, PxStrokeGradientEffectSchema, PxStrokeTrimEffect, PxStrokeTrimEffectSchema, PxStrokeTrimSubPaths, PxSvgNode, PxSvgNodeExtra, PxTextEffectSchema, PxTextPathEffect, PxTextPathEffectSchema, PxTextPathMethod, PxTextPathSpacing, PxTimelineEngine, PxTimelineEngineExtra, PxTimelinePatch, PxTimelinePinSchema, PxTimelineSchema, PxTransformByEffect, PxTransformByEffectSchema, PxTransformPartKey, PxTransformParts, PxTransformPartsSchema, PxTransformValue, PxTransformValueSchema, PxTrigger, PxTriggerSchema, PxUnits, PxValidationContext, PxValidationResult, RemoveIndex, STYLE_ATTR_NAMES, TRANSFORM_FN_NAMES, Vec2, WIRE_VERSION_KEY, WireConversionConfig, WireDowngradeConfig, WireDowngradeResult, WireStepKind, WireVersion, WireVersionRelation, WireVersionStep, applyAnimatorConfig, applyPlayerEffects, calcAnimationValues, camelCaseToKebabWordIfNeeded, collectSampleTimes, compareWireVersion, controlModeTakesOverTrigger, convertPlayerDocument, createBasicFrameLoopAnimator, createDiagnostics, createPathSampler, describeSchema, diagnoseDocument, diffInEffect, downgradePlayerDocument, evaluateMotionPathSegment, extendedPathForBrowser, foldTimelineOverride, formatWireVersion, generateNewIds, getAnimatorConfig, getBindings, getChildren, getDefs, getNormalizedProps, isPxElementFileFormat, isPxElementFileFormatDeep, jsonElementFactory, layoutGlyphTextChars, materializeAllInTree, materializeAnimatedUseInstances, materializeGlyphText, materializeGlyphTextAlongPath, materializeGlyphTextHorizontal, materializeInternalLoopsInPropAnim, materializeInternalLoopsInTree, materializeMotionPathInPropAnim, materializeMotionPathsInTree, mergeAnimatorConfig, getNormalizedBindings as normalizeDocument, parseWireVersion, progressToTimeMs, propAnimIsMotionPath, px, readWireVersion, resolveControlMode, resolveTrigger, schemaKeys, shiftAnimatable, timeToProgress, toRGBA, validateDocument, validateNodeEffects, versionAdvice, visualModelAt } from '@pixodesk/svg-animator-core';
-
-/**
- * DOM specializations of the platform-neutral animator API types.
- * `getRootElement()` returns a DOM `Element` on the web — these aliases keep
- * the historical (pre-core-extraction) signatures for web consumers.
- */
-type PxBasicAnimatorAPI = PxBasicAnimatorAPI$1<Element>;
-type PxAnimatorAPI = PxAnimatorAPI$1<Element>;
-
-/**
- * Wire keys shared by every entry point.
- *
- * These live here rather than in `PxAnimator.ts` on purpose: that module used to end with a
- * top-level `if (typeof window !== 'undefined')` block publishing `createAnimator` /
- * `loadTagAnimators` as globals. A module-level side effect cannot be tree-shaken, so
- * importing ANY symbol from `PxAnimator.ts` pulled the entire full player in with it —
- * which silently made the pre-rendered builds the same size as the full one until this
- * constant was moved out. See PRERENDERED-PLAYER-BUILDS.md.
- *
- * That block is gone (API review §4) and the package now declares `"sideEffects": false`, but
- * keeping these here costs nothing and removes the trap for good.
- */
-/**
- * Key under which `createAnimator` options carry the inline animation document. The editor
- * writes it into every exported SVG+JS — `createAnimator({"doc": …})` — so it is part of the
- * export format, which is why it is a named constant and not a literal.
- */
-declare const PX_ANIMATOR_DOC_KEY = "doc";
-
-/**
- * Everything `createAnimator` takes. The playback override (`timeline`, `resetTimeline` and the
- * four shortcuts) and the callbacks are core's shared shapes — the SAME names, inline, as the
- * React, Vue and React Native components take (review §9) — so only what is web-specific is
- * declared here.
- */
-interface PxAnimatorOptions extends PxPlaybackOverrideProps, PxComponentCallbacks {
-    /** URL to fetch the animation document from. Provide either this or `doc`, not both. */
-    src?: string;
-    /** The animation document, inline (see SCHEMA.md). Provide either this or `src`, not both. */
-    doc?: PxAnimatedSvgDocument;
-    /** ○ A custom render target for the frame-loop engine (`PxPlatformAdapter`); omit for the DOM. */
-    adapter?: PxPlatformAdapter;
-    /** CSS selector or element to render the SVG into. */
-    container?: string | Element;
-}
-/**
- * Creates an animator instance to control SVG animations.
- *
- * @param options.src URL to fetch the animation document from.
- * @param options.doc The animation document, inline.
- * @param options.container CSS selector or element to render the SVG into.
- * @returns A PxAnimatorAPI instance to programmatically control the animation.
- */
-declare function createAnimator(options: PxAnimatorOptions): PxAnimatorAPI;
-/**
- * Scan and load for tags, e.g.
- *  <div data-px-animation-src="animation.json"></div>
- */
-/**
- * Everything `createAnimator` takes except the three the tag supplies (`src`, `container`) or
- * forbids (`data`): callbacks, the diagnostics channel, a playback override and its shortcuts.
- */
-type PxTagAnimatorOptions = Omit<PxAnimatorOptions, 'src' | 'doc' | 'container'>;
-/**
- * Scan the page for `<div data-px-animation-src="animation.json">` and create one player per
- * match, rendered into that element and stored on it. Safe to call repeatedly: elements that
- * already carry a player are skipped.
- *
- * `options` applies to EVERY player this call creates (review §15) — the same callbacks, the
- * same override. Omit it for the zero-config path.
- */
-declare function loadTagAnimators(options?: PxTagAnimatorOptions): void;
+import { P as PxAnimatorAPI } from './internal-BmFv1B6H.cjs';
+export { a as PX_ANIMATOR_DOC_KEY, b as PxAnimatorOptions, c as PxBasicAnimatorAPI, d as PxInternalAnimatorOptions, e as PxTagAnimatorOptions, f as createAnimator, l as loadTagAnimators } from './internal-BmFv1B6H.cjs';
+import { PxAnimatorCallbacks, PxAnimatedSvgDocument, PxTrigger, PxDiagnostics, PxNode, PxDefs } from '@pixodesk/svg-animator-core';
+export { PxAnimatedSvgDocument, PxAnimatorCallbacks, PxAnimatorConfig, PxAnimatorConfigSchema, PxBinding, PxDefs, PxDefsSchema, PxDiagnostic, PxDiagnosticKind, PxDiagnostics, PxDiagnosticsConfig, PxEngineCallbacks, PxFillMode, PxInfer, PxNode, PxNodeBase, PxPlatformAdapter, PxPlaybackDirection, PxPlaybackOverrideProps, PxSchema, PxScrollSchema, PxStartOn, PxSvgNode, PxSvgNodeExtra, PxTimelineEngineExtra, PxTimelinePatch, PxTrigger, PxTriggerSchema, PxValidationContext, createBasicFrameLoopAnimator, generateNewIds, getNormalizedProps, px, validateDocument } from '@pixodesk/svg-animator-core';
 
 /**
  * Options accepted by the pre-rendered entry points — a subset of `PxAnimatorOptions`: the
- * document, an optional adapter, and the callbacks INLINE under the same names every surface
- * uses (review §9).
+ * document and the callbacks INLINE under the same names every surface uses (review §9). No
+ * `adapter`: a pre-rendered SVG is by definition already in the DOM (review §25.14).
+ * @public
  */
-interface PxPrerenderedOptions extends PxComponentCallbacks {
+interface PxPrerenderedOptions extends PxAnimatorCallbacks {
     /**
      * The animation document. For a pre-rendered SVG this carries `animator.definitions`
-     * and `animator.animateById` only — no `children`, because the elements are already
+     * and `animator.bindings` only — no `children`, because the elements are already
      * in the DOM.
      */
     doc: PxAnimatedSvgDocument;
-    /** ○ A custom render target for the frame-loop engine; omit for the DOM. */
-    adapter?: PxPlatformAdapter;
 }
 
 /**
@@ -117,43 +46,14 @@ interface PxPrerenderedOptions extends PxComponentCallbacks {
  * @returns A disposer that detaches every listener and observer this call attached (review §14).
  *   `createAnimator` ties it to `destroy()`. Call it yourself before re-arming an element you
  *   wired by hand — otherwise the old listeners stay live next to the new ones.
+ * @public
  */
 declare function setupAnimationTriggers(api: PxAnimatorAPI, config: PxTrigger, diag?: PxDiagnostics): () => void;
 
 /**
  * Renders a PxNode tree to DOM elements.
+ * @public @advanced
  */
 declare function renderNode(node: PxNode, defs?: PxDefs, diag?: PxDiagnostics): Element | null;
 
-/**
- * Creates an animator instance that uses a requestAnimationFrame loop for animations.
- * This is the browser DOM-specific version.
- *
- * @param {PxAnimatorCallbacksConfig=} callbacks Optional lifecycle callbacks.
- * @param {Element=} rootElement Optional pre-rendered root element.
- * @returns {PxAnimatorAPI} A PxAnimatorAPI instance.
- */
-declare function createFrameLoopAnimator(doc: PxAnimatedSvgDocument, adapter?: PxPlatformAdapter, callbacks?: PxAnimatorCallbacksConfig, rootElement?: Element | null): PxAnimatorAPI;
-
-/**
- * Creates an animator instance that uses the native Web Animations API.
- *
- * This is the preferred, more performant animator. It will return null if the
- * animation configuration contains properties not supported by the browser's
- * Web Animations API implementation, unless forceEvenIfHasUnsupportedAttrs is true.
- *
- * @param callbacks Optional lifecycle callbacks.
- * @param rootElement Root element.
- * @param forceEvenIfHasUnsupportedAttrs If true, an animator will be created even if some CSS properties are not supported.
- * @returns An PxAnimatorAPI instance, or null if unsupported features are used and not forced.
- */
-/** Native scroll-timeline payload (`timeline.engine: 'native'` / `auto`; see PxScrollDriver.createNativeScrollTimeline): the
- *  browser-native timeline every Animation attaches to, plus optional range offsets. */
-interface PxWebApiScrollTimeline {
-    timeline: AnimationTimeline;
-    rangeStart?: Record<string, unknown>;
-    rangeEnd?: Record<string, unknown>;
-}
-declare function createWebApiAnimator(doc: PxAnimatedSvgDocument, callbacks?: PxAnimatorCallbacksConfig, rootElement?: Element | null, forceEvenIfHasUnsupportedAttrs?: boolean, scrollTimeline?: PxWebApiScrollTimeline): PxAnimatorAPI | null;
-
-export { PX_ANIMATOR_DOC_KEY, type PxAnimatorAPI, type PxAnimatorOptions, type PxBasicAnimatorAPI, type PxPrerenderedOptions, type PxTagAnimatorOptions, createAnimator, createFrameLoopAnimator, createWebApiAnimator, loadTagAnimators, renderNode, setupAnimationTriggers };
+export { PxAnimatorAPI, type PxPrerenderedOptions, renderNode, setupAnimationTriggers };

package/dist/index.d.ts

@@ -1,92 +1,21 @@
-import { PxAnimatorAPI as PxAnimatorAPI$1, PxBasicAnimatorAPI as PxBasicAnimatorAPI$1, PxPlaybackOverrideProps, PxComponentCallbacks, PxAnimatedSvgDocument, PxPlatformAdapter, PxTrigger, PxDiagnostics, PxNode, PxDefs, PxAnimatorCallbacksConfig } from '@pixodesk/svg-animator-core';
-export { ApplyResult, BASELINE_PLAYER_VERSION, COLOR_ATTR_NAMES, DEFAULT_DURATION_MS, ExtendPathOpts, ExtendedPath, GlyphCharBox, GlyphCharBoxAlongPath, GlyphMaterializeOpts, KeysMatch, MISSING_GLYPH_CLASS_NAME, MaterializeAllOptions, MotionPathMaterializationOptions, MotionPathSample, PLAYER_WIRE_STEPS, PLAYER_WIRE_VERSION, PX_ANIM_ATTR_NAME, PX_ANIM_SRC_ATTR_NAME, PX_PLAYER_SCHEMA_VERSION, PX_TRANSFORM_PART_KEYS, PX_TRIGGER_DEFAULTS, PathPoint, PathSampler, PlayerConversionResult, PxAlongPathMode, PxAnimatable, PxAnimatedSvgDocument, PxAnimatedSvgDocumentSchema, PxAnimationDefinition, PxAnimationDefinitionSchema, PxAnimatorCallbacksConfig, PxAnimatorConfig, PxAnimatorConfigMergeResult, PxAnimatorConfigPatch, PxAnimatorConfigSchema, PxAnimatorConfigShortcuts, PxAnimatorHandle, PxAnyKeyframe, PxAttrValue, PxAttrValueSchema, PxBezierPath, PxBezierPathSchema, PxBinding, PxBindingSchema, PxClipPathEffectSchema, PxCloneEffect, PxCloneEffectSchema, PxCloneWithout, PxComponentCallbacks, PxControlMode, PxControlProps, PxCreateElement, PxDefs, PxDefsSchema, PxDiagnostic, PxDiagnosticKind, PxDiagnostics, PxDiagnosticsConfig, PxDocumentDiagnosis, PxEasingOrRefSchema, PxEffects, PxEffectsSchema, PxElementAnimation, PxElementAnimationSchema, PxFillGradientEffect, PxFillGradientEffectSchema, PxFillMode, PxFinishAction, PxGlyph, PxGlyphFont, PxGradientSpreadMethod, PxGradientStop, PxGradientStopSchema, PxGradientType, PxInfer, PxKeyframe, PxKeyframeSchema, PxKeyframeValueSchema, PxLengthAdjust, PxLoop, PxLoopDirection, PxLoopRepeatAt, PxLoopSchema, PxMaskType, PxMaskedByEffect, PxMaskedByEffectSchema, PxNode, PxNodeBase, PxNodeSchema, PxNormalizedKeyframe, PxOutAction, PxPathOverflow, PxPinAlign, PxPlatformAdapter, PxPlaybackDirection, PxPlaybackOverrideProps, PxPropertyAnimation, PxPropertyAnimationSchema, PxRepeaterEffect, PxRepeaterEffectSchema, PxResolvedControlMode, PxRetimeEffect, PxRetimeEffectSchema, PxSchema, PxSchemaDesc, PxScrollAxis, PxScrollKind, PxScrollPhase, PxScrollRangePointSchema, PxScrollRangeSchema, PxScrollSchema, PxScrollSource, PxStartOn, PxStrokeGradientEffect, PxStrokeGradientEffectSchema, PxStrokeTrimEffect, PxStrokeTrimEffectSchema, PxStrokeTrimSubPaths, PxSvgNode, PxSvgNodeExtra, PxTextEffectSchema, PxTextPathEffect, PxTextPathEffectSchema, PxTextPathMethod, PxTextPathSpacing, PxTimelineEngine, PxTimelineEngineExtra, PxTimelinePatch, PxTimelinePinSchema, PxTimelineSchema, PxTransformByEffect, PxTransformByEffectSchema, PxTransformPartKey, PxTransformParts, PxTransformPartsSchema, PxTransformValue, PxTransformValueSchema, PxTrigger, PxTriggerSchema, PxUnits, PxValidationContext, PxValidationResult, RemoveIndex, STYLE_ATTR_NAMES, TRANSFORM_FN_NAMES, Vec2, WIRE_VERSION_KEY, WireConversionConfig, WireDowngradeConfig, WireDowngradeResult, WireStepKind, WireVersion, WireVersionRelation, WireVersionStep, applyAnimatorConfig, applyPlayerEffects, calcAnimationValues, camelCaseToKebabWordIfNeeded, collectSampleTimes, compareWireVersion, controlModeTakesOverTrigger, convertPlayerDocument, createBasicFrameLoopAnimator, createDiagnostics, createPathSampler, describeSchema, diagnoseDocument, diffInEffect, downgradePlayerDocument, evaluateMotionPathSegment, extendedPathForBrowser, foldTimelineOverride, formatWireVersion, generateNewIds, getAnimatorConfig, getBindings, getChildren, getDefs, getNormalizedProps, isPxElementFileFormat, isPxElementFileFormatDeep, jsonElementFactory, layoutGlyphTextChars, materializeAllInTree, materializeAnimatedUseInstances, materializeGlyphText, materializeGlyphTextAlongPath, materializeGlyphTextHorizontal, materializeInternalLoopsInPropAnim, materializeInternalLoopsInTree, materializeMotionPathInPropAnim, materializeMotionPathsInTree, mergeAnimatorConfig, getNormalizedBindings as normalizeDocument, parseWireVersion, progressToTimeMs, propAnimIsMotionPath, px, readWireVersion, resolveControlMode, resolveTrigger, schemaKeys, shiftAnimatable, timeToProgress, toRGBA, validateDocument, validateNodeEffects, versionAdvice, visualModelAt } from '@pixodesk/svg-animator-core';
-
-/**
- * DOM specializations of the platform-neutral animator API types.
- * `getRootElement()` returns a DOM `Element` on the web — these aliases keep
- * the historical (pre-core-extraction) signatures for web consumers.
- */
-type PxBasicAnimatorAPI = PxBasicAnimatorAPI$1<Element>;
-type PxAnimatorAPI = PxAnimatorAPI$1<Element>;
-
-/**
- * Wire keys shared by every entry point.
- *
- * These live here rather than in `PxAnimator.ts` on purpose: that module used to end with a
- * top-level `if (typeof window !== 'undefined')` block publishing `createAnimator` /
- * `loadTagAnimators` as globals. A module-level side effect cannot be tree-shaken, so
- * importing ANY symbol from `PxAnimator.ts` pulled the entire full player in with it —
- * which silently made the pre-rendered builds the same size as the full one until this
- * constant was moved out. See PRERENDERED-PLAYER-BUILDS.md.
- *
- * That block is gone (API review §4) and the package now declares `"sideEffects": false`, but
- * keeping these here costs nothing and removes the trap for good.
- */
-/**
- * Key under which `createAnimator` options carry the inline animation document. The editor
- * writes it into every exported SVG+JS — `createAnimator({"doc": …})` — so it is part of the
- * export format, which is why it is a named constant and not a literal.
- */
-declare const PX_ANIMATOR_DOC_KEY = "doc";
-
-/**
- * Everything `createAnimator` takes. The playback override (`timeline`, `resetTimeline` and the
- * four shortcuts) and the callbacks are core's shared shapes — the SAME names, inline, as the
- * React, Vue and React Native components take (review §9) — so only what is web-specific is
- * declared here.
- */
-interface PxAnimatorOptions extends PxPlaybackOverrideProps, PxComponentCallbacks {
-    /** URL to fetch the animation document from. Provide either this or `doc`, not both. */
-    src?: string;
-    /** The animation document, inline (see SCHEMA.md). Provide either this or `src`, not both. */
-    doc?: PxAnimatedSvgDocument;
-    /** ○ A custom render target for the frame-loop engine (`PxPlatformAdapter`); omit for the DOM. */
-    adapter?: PxPlatformAdapter;
-    /** CSS selector or element to render the SVG into. */
-    container?: string | Element;
-}
-/**
- * Creates an animator instance to control SVG animations.
- *
- * @param options.src URL to fetch the animation document from.
- * @param options.doc The animation document, inline.
- * @param options.container CSS selector or element to render the SVG into.
- * @returns A PxAnimatorAPI instance to programmatically control the animation.
- */
-declare function createAnimator(options: PxAnimatorOptions): PxAnimatorAPI;
-/**
- * Scan and load for tags, e.g.
- *  <div data-px-animation-src="animation.json"></div>
- */
-/**
- * Everything `createAnimator` takes except the three the tag supplies (`src`, `container`) or
- * forbids (`data`): callbacks, the diagnostics channel, a playback override and its shortcuts.
- */
-type PxTagAnimatorOptions = Omit<PxAnimatorOptions, 'src' | 'doc' | 'container'>;
-/**
- * Scan the page for `<div data-px-animation-src="animation.json">` and create one player per
- * match, rendered into that element and stored on it. Safe to call repeatedly: elements that
- * already carry a player are skipped.
- *
- * `options` applies to EVERY player this call creates (review §15) — the same callbacks, the
- * same override. Omit it for the zero-config path.
- */
-declare function loadTagAnimators(options?: PxTagAnimatorOptions): void;
+import { P as PxAnimatorAPI } from './internal-BmFv1B6H.js';
+export { a as PX_ANIMATOR_DOC_KEY, b as PxAnimatorOptions, c as PxBasicAnimatorAPI, d as PxInternalAnimatorOptions, e as PxTagAnimatorOptions, f as createAnimator, l as loadTagAnimators } from './internal-BmFv1B6H.js';
+import { PxAnimatorCallbacks, PxAnimatedSvgDocument, PxTrigger, PxDiagnostics, PxNode, PxDefs } from '@pixodesk/svg-animator-core';
+export { PxAnimatedSvgDocument, PxAnimatorCallbacks, PxAnimatorConfig, PxAnimatorConfigSchema, PxBinding, PxDefs, PxDefsSchema, PxDiagnostic, PxDiagnosticKind, PxDiagnostics, PxDiagnosticsConfig, PxEngineCallbacks, PxFillMode, PxInfer, PxNode, PxNodeBase, PxPlatformAdapter, PxPlaybackDirection, PxPlaybackOverrideProps, PxSchema, PxScrollSchema, PxStartOn, PxSvgNode, PxSvgNodeExtra, PxTimelineEngineExtra, PxTimelinePatch, PxTrigger, PxTriggerSchema, PxValidationContext, createBasicFrameLoopAnimator, generateNewIds, getNormalizedProps, px, validateDocument } from '@pixodesk/svg-animator-core';
 
 /**
  * Options accepted by the pre-rendered entry points — a subset of `PxAnimatorOptions`: the
- * document, an optional adapter, and the callbacks INLINE under the same names every surface
- * uses (review §9).
+ * document and the callbacks INLINE under the same names every surface uses (review §9). No
+ * `adapter`: a pre-rendered SVG is by definition already in the DOM (review §25.14).
+ * @public
  */
-interface PxPrerenderedOptions extends PxComponentCallbacks {
+interface PxPrerenderedOptions extends PxAnimatorCallbacks {
     /**
      * The animation document. For a pre-rendered SVG this carries `animator.definitions`
-     * and `animator.animateById` only — no `children`, because the elements are already
+     * and `animator.bindings` only — no `children`, because the elements are already
      * in the DOM.
      */
     doc: PxAnimatedSvgDocument;
-    /** ○ A custom render target for the frame-loop engine; omit for the DOM. */
-    adapter?: PxPlatformAdapter;
 }
 
 /**
@@ -117,43 +46,14 @@ interface PxPrerenderedOptions extends PxComponentCallbacks {
  * @returns A disposer that detaches every listener and observer this call attached (review §14).
  *   `createAnimator` ties it to `destroy()`. Call it yourself before re-arming an element you
  *   wired by hand — otherwise the old listeners stay live next to the new ones.
+ * @public
  */
 declare function setupAnimationTriggers(api: PxAnimatorAPI, config: PxTrigger, diag?: PxDiagnostics): () => void;
 
 /**
  * Renders a PxNode tree to DOM elements.
+ * @public @advanced
  */
 declare function renderNode(node: PxNode, defs?: PxDefs, diag?: PxDiagnostics): Element | null;
 
-/**
- * Creates an animator instance that uses a requestAnimationFrame loop for animations.
- * This is the browser DOM-specific version.
- *
- * @param {PxAnimatorCallbacksConfig=} callbacks Optional lifecycle callbacks.
- * @param {Element=} rootElement Optional pre-rendered root element.
- * @returns {PxAnimatorAPI} A PxAnimatorAPI instance.
- */
-declare function createFrameLoopAnimator(doc: PxAnimatedSvgDocument, adapter?: PxPlatformAdapter, callbacks?: PxAnimatorCallbacksConfig, rootElement?: Element | null): PxAnimatorAPI;
-
-/**
- * Creates an animator instance that uses the native Web Animations API.
- *
- * This is the preferred, more performant animator. It will return null if the
- * animation configuration contains properties not supported by the browser's
- * Web Animations API implementation, unless forceEvenIfHasUnsupportedAttrs is true.
- *
- * @param callbacks Optional lifecycle callbacks.
- * @param rootElement Root element.
- * @param forceEvenIfHasUnsupportedAttrs If true, an animator will be created even if some CSS properties are not supported.
- * @returns An PxAnimatorAPI instance, or null if unsupported features are used and not forced.
- */
-/** Native scroll-timeline payload (`timeline.engine: 'native'` / `auto`; see PxScrollDriver.createNativeScrollTimeline): the
- *  browser-native timeline every Animation attaches to, plus optional range offsets. */
-interface PxWebApiScrollTimeline {
-    timeline: AnimationTimeline;
-    rangeStart?: Record<string, unknown>;
-    rangeEnd?: Record<string, unknown>;
-}
-declare function createWebApiAnimator(doc: PxAnimatedSvgDocument, callbacks?: PxAnimatorCallbacksConfig, rootElement?: Element | null, forceEvenIfHasUnsupportedAttrs?: boolean, scrollTimeline?: PxWebApiScrollTimeline): PxAnimatorAPI | null;
-
-export { PX_ANIMATOR_DOC_KEY, type PxAnimatorAPI, type PxAnimatorOptions, type PxBasicAnimatorAPI, type PxPrerenderedOptions, type PxTagAnimatorOptions, createAnimator, createFrameLoopAnimator, createWebApiAnimator, loadTagAnimators, renderNode, setupAnimationTriggers };
+export { PxAnimatorAPI, type PxPrerenderedOptions, renderNode, setupAnimationTriggers };