@react-native-motion-kit/text-motion 0.0.0-stage → 0.1.0

package/lib/typescript/src/timeline/parallel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel.d.ts","sourceRoot":"","sources":["../../../../src/timeline/parallel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,mBAAU,CAAC;AAW1E,oEAAoE;AACpE,wBAAgB,QAAQ,CACtB,GAAG,SAAS,EAAE,SAAS,qBAAqB,EAAE,GAC7C,kBAAkB,CAAC,UAAU,CAAC,CAehC"}

package/lib/typescript/src/timeline/sequence.d.ts

@@ -0,0 +1,4 @@
+import type { TextMotionAnyTimeline, TextMotionTimeline } from '../types/index.js';
+/** Combine timelines by adding each timeline delay for a token. */
+export declare function sequence(...timelines: readonly TextMotionAnyTimeline[]): TextMotionTimeline<'sequence'>;
+//# sourceMappingURL=sequence.d.ts.map

package/lib/typescript/src/timeline/sequence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequence.d.ts","sourceRoot":"","sources":["../../../../src/timeline/sequence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,mBAAU,CAAC;AAW1E,mEAAmE;AACnE,wBAAgB,QAAQ,CACtB,GAAG,SAAS,EAAE,SAAS,qBAAqB,EAAE,GAC7C,kBAAkB,CAAC,UAAU,CAAC,CAchC"}

package/lib/typescript/src/timeline/stagger.d.ts

@@ -0,0 +1,11 @@
+import type { TextMotionTimeline } from '../types/index.js';
+/** Origin used when calculating stagger delays. */
+export type TextMotionStaggerFrom = 'start' | 'center' | 'end' | 'edges' | number;
+/** Options for {@link stagger}. */
+export type TextMotionStaggerOptions = {
+    /** Token index origin for the stagger. Defaults to `start`. */
+    from?: TextMotionStaggerFrom;
+};
+/** Delay each token by a fixed step from the chosen origin. */
+export declare function stagger(step: number, options?: TextMotionStaggerOptions): TextMotionTimeline<'stagger'>;
+//# sourceMappingURL=stagger.d.ts.map

package/lib/typescript/src/timeline/stagger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stagger.d.ts","sourceRoot":"","sources":["../../../../src/timeline/stagger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAU,CAAC;AAKnD,mDAAmD;AACnD,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;AAElF,mCAAmC;AACnC,MAAM,MAAM,wBAAwB,GAAG;IACrC,+DAA+D;IAC/D,IAAI,CAAC,EAAE,qBAAqB,CAAC;CAC9B,CAAC;AA2BF,+DAA+D;AAC/D,wBAAgB,OAAO,CACrB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,wBAA6B,GACrC,kBAAkB,CAAC,SAAS,CAAC,CAgB/B"}

package/lib/typescript/src/timeline/validation.d.ts

@@ -0,0 +1,4 @@
+export declare function validateFiniteTimelineNumber(value: number, label: string): number;
+export declare function validateNonNegativeTimelineNumber(value: number, label: string): number;
+export declare function validatePositiveTimelineNumber(value: number, label: string): number;
+//# sourceMappingURL=validation.d.ts.map

package/lib/typescript/src/timeline/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../src/timeline/validation.ts"],"names":[],"mappings":"AAEA,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMjF;AAED,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAQtF;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAQnF"}

package/lib/typescript/src/timeline/wave.d.ts

@@ -0,0 +1,11 @@
+import type { TextMotionTimeline } from '../types/index.js';
+/** Options for {@link wave}. */
+export type TextMotionWaveOptions = {
+    /** Maximum delay in seconds. Defaults to `0.08`. */
+    amplitude?: number;
+    /** Number of tokens per sine-wave cycle. Defaults to `4`. */
+    wavelength?: number;
+};
+/** Create sine-wave token delays for soft rolling text motion. */
+export declare function wave(options?: TextMotionWaveOptions): TextMotionTimeline<'wave'>;
+//# sourceMappingURL=wave.d.ts.map

package/lib/typescript/src/timeline/wave.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wave.d.ts","sourceRoot":"","sources":["../../../../src/timeline/wave.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAU,CAAC;AAKnD,gCAAgC;AAChC,MAAM,MAAM,qBAAqB,GAAG;IAClC,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAOF,kEAAkE;AAClE,wBAAgB,IAAI,CAAC,OAAO,GAAE,qBAA0B,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAcpF"}

package/lib/typescript/src/types/index.d.ts

@@ -0,0 +1,6 @@
+export type { TextMotionAccessibilityPolicy, TextMotionAnyEffect, TextMotionAnyTimeline, TextMotionComponent, TextMotionComponentAccessibilityProps, TextMotionComponentProps, TextMotionComponentTextProps, TextMotionEffect, TextMotionEffectForRenderer, TextMotionInternalRecipeConfig, TextMotionMotionConfig, TextMotionRecipeConfig, TextMotionSpringOptions, TextMotionTimeline, TextMotionTimingOptions, } from './recipe.js';
+export type { TextMotionControls } from '../controls/index.js';
+export type { TextMotionCompatibleEffect, TextMotionMissingCapabilities, TextMotionRenderer, TextMotionRendererCapability, TextMotionRendererCapabilityExtension, TextMotionRendererProps, } from './renderer.js';
+export { createTextMotionRendererCapability } from './renderer.js';
+export type { TextMotionSourceRange, TextMotionSplitContext, TextMotionSplitter, TextMotionToken, TextMotionTokenUnit, } from './token.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,6BAA6B,EAC7B,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,qCAAqC,EACrC,wBAAwB,EACxB,4BAA4B,EAC5B,gBAAgB,EAChB,2BAA2B,EAC3B,8BAA8B,EAC9B,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,aAAU,CAAC;AAClB,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAa,CAAC;AACtD,YAAY,EACV,0BAA0B,EAC1B,6BAA6B,EAC7B,kBAAkB,EAClB,4BAA4B,EAC5B,qCAAqC,EACrC,uBAAuB,GACxB,MAAM,eAAY,CAAC;AACpB,OAAO,EAAE,kCAAkC,EAAE,MAAM,eAAY,CAAC;AAChE,YAAY,EACV,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,GACpB,MAAM,YAAS,CAAC"}

package/lib/typescript/src/types/recipe.d.ts

@@ -0,0 +1,123 @@
+import type { ComponentType } from 'react';
+import type { StyleProp, TextProps, TextStyle } from 'react-native';
+import type { SharedValue, WithSpringConfig, WithTimingConfig } from 'react-native-reanimated';
+import type { TextMotionControls } from '../controls/index.js';
+import type { TextMotionCompatibleEffect, TextMotionRenderer, TextMotionRendererCapability } from './renderer.js';
+import type { TextMotionSplitter } from './token.js';
+type DistributiveOmit<T, Keys extends PropertyKey> = T extends unknown ? Omit<T, Keys> : never;
+declare const textMotionEffectBrand: unique symbol;
+declare const textMotionTimelineBrand: unique symbol;
+/** @internal Serializable metadata attached to effect descriptors. */
+export type TextMotionEffectDescriptorOptions = Readonly<Record<string, unknown>>;
+/** @internal Serializable metadata attached to timeline descriptors. */
+export type TextMotionTimelineDescriptorOptions = Readonly<Record<string, unknown>>;
+/** @internal Timeline descriptor consumed by recipe and renderer internals. */
+export type TextMotionTimelineDescriptor<Options extends TextMotionTimelineDescriptorOptions = TextMotionTimelineDescriptorOptions, Name extends string = string> = {
+    kind: 'timeline';
+    name: Name;
+    options?: Options;
+    delayFor(index: number, count: number): number;
+};
+/** @internal Timeline descriptor with extension-level options for recipe internals. */
+export type TextMotionAnyTimelineDescriptor = TextMotionTimelineDescriptor;
+/** Opaque timeline handle accepted by `.timeline(...)`. */
+export type TextMotionTimeline<Name extends string = string> = {
+    readonly [textMotionTimelineBrand]: {
+        readonly name: Name;
+    };
+};
+/** Opaque timeline handle with any timeline name. */
+export type TextMotionAnyTimeline = TextMotionTimeline;
+/** @internal Effect descriptor consumed by renderers. */
+export type TextMotionEffectDescriptor<RequiredCapabilities extends TextMotionRendererCapability = TextMotionRendererCapability, Options extends TextMotionEffectDescriptorOptions = TextMotionEffectDescriptorOptions, Name extends string = string> = {
+    kind: 'effect';
+    name: Name;
+    options?: Options;
+    requiredCapabilities: readonly RequiredCapabilities[];
+    effects?: readonly TextMotionAnyEffect[];
+};
+/** @internal Effect descriptor with extension-level options for renderer internals. */
+export type TextMotionAnyEffectDescriptor = TextMotionEffectDescriptor;
+/** Opaque effect handle accepted by `.effect(...)`. */
+export type TextMotionEffect<RequiredCapabilities extends TextMotionRendererCapability = 'native-text', Name extends string = string> = {
+    readonly [textMotionEffectBrand]: {
+        readonly requiredCapabilities: RequiredCapabilities;
+        readonly name: Name;
+    };
+    and<NextCapabilities extends TextMotionRendererCapability, NextName extends string>(effect: TextMotionEffect<NextCapabilities, NextName>): TextMotionEffect<RequiredCapabilities | NextCapabilities>;
+};
+/** Opaque effect handle with any required capability. */
+export type TextMotionAnyEffect = TextMotionEffect<TextMotionRendererCapability>;
+/** Timing options accepted by text motion renderers. Reduced motion is controlled by accessibility policy. */
+export type TextMotionTimingOptions = DistributiveOmit<WithTimingConfig, 'reduceMotion'>;
+/** Spring options accepted by text motion renderers. Reduced motion is controlled by accessibility policy. */
+export type TextMotionSpringOptions = DistributiveOmit<WithSpringConfig, 'reduceMotion'>;
+/** Motion primitive used by Reanimated renderers. */
+export type TextMotionMotionConfig = {
+    kind: 'timing';
+    options?: TextMotionTimingOptions;
+} | {
+    kind: 'spring';
+    options?: TextMotionSpringOptions;
+};
+/** Accessibility behavior for a text motion recipe. */
+export type TextMotionAccessibilityPolicy = {
+    kind: string;
+    parentLabel: boolean;
+    hideTokensFromAccessibility: boolean;
+    reducedMotion: 'final-state' | 'system';
+};
+/** Immutable recipe config produced by {@link TextMotionRecipeBuilder}. */
+export type TextMotionRecipeConfig<_RendererCapabilities extends TextMotionRendererCapability = TextMotionRendererCapability, Timeline extends TextMotionAnyTimeline = TextMotionTimeline, Effects extends readonly TextMotionAnyEffect[] = readonly TextMotionAnyEffect[]> = {
+    splitter?: TextMotionSplitter;
+    renderer?: TextMotionRenderer;
+    timeline?: Timeline;
+    effects: Effects;
+    motion?: TextMotionMotionConfig;
+    accessibility?: TextMotionAccessibilityPolicy;
+};
+/** Internal recipe shape used by runtime renderers after recipe composition. */
+export type TextMotionInternalRecipeConfig<RendererCapabilities extends TextMotionRendererCapability = TextMotionRendererCapability> = TextMotionRecipeConfig<RendererCapabilities, TextMotionAnyTimeline, readonly TextMotionAnyEffect[]>;
+/** Accessibility props intentionally supported by text motion components. */
+export type TextMotionComponentAccessibilityProps = Pick<TextProps, 'accessibilityActions' | 'accessibilityHint' | 'accessibilityLabel' | 'accessibilityLanguage' | 'accessibilityRole' | 'accessibilityState' | 'accessibilityValue' | 'onAccessibilityAction'>;
+/** Non-child props intentionally supported by text motion components. */
+export type TextMotionComponentTextProps = TextMotionComponentAccessibilityProps & Pick<TextProps, 'allowFontScaling' | 'maxFontSizeMultiplier' | 'nativeID' | 'testID'> & {
+    /** Text style applied to each rendered token. Layout-only text props are not supported. */
+    style?: StyleProp<TextStyle>;
+};
+type TextMotionRawProgressPlaybackProps = {
+    /**
+     * Raw app-owned normalized progress for externally driven playback.
+     *
+     * `0` renders the initial text motion state and `1` renders the final state. Finite values
+     * outside `0..1` are clamped by the renderer; non-finite values are treated as `0`. When
+     * provided, `.motion()` does not drive playback. Use this for scroll, gesture, or synchronized
+     * shared values where the app owns the exact progress.
+     */
+    progress?: SharedValue<number>;
+    controls?: never;
+};
+type TextMotionControlsPlaybackProps = {
+    progress?: never;
+    /**
+     * Command channel for event-driven playback.
+     *
+     * The component owns playback execution and uses its recipe `.motion()` config. Use this for
+     * buttons, screen focus, onboarding steps, and replay/reset/stop interactions.
+     */
+    controls?: TextMotionControls;
+};
+type TextMotionComponentPlaybackProps = TextMotionRawProgressPlaybackProps | TextMotionControlsPlaybackProps;
+/** Props forwarded from a text motion component to its renderer. */
+export type TextMotionComponentRendererProps = TextMotionComponentTextProps & TextMotionComponentPlaybackProps;
+/** Props accepted by components created from text motion recipes. */
+export type TextMotionComponentProps = TextMotionComponentRendererProps & {
+    /** Plain string rendered and split by the recipe splitter. */
+    children: string;
+};
+/** React component produced by a text motion recipe. */
+export type TextMotionComponent = ComponentType<TextMotionComponentProps>;
+/** Type helper used by `.effect(...)` to enforce renderer capability compatibility. */
+export type TextMotionEffectForRenderer<RendererCapabilities extends TextMotionRendererCapability, RequiredCapabilities extends TextMotionRendererCapability, Effect extends TextMotionEffect<RequiredCapabilities> = TextMotionEffect<RequiredCapabilities>> = TextMotionCompatibleEffect<RendererCapabilities, RequiredCapabilities, Effect>;
+export {};
+//# sourceMappingURL=recipe.d.ts.map

package/lib/typescript/src/types/recipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe.d.ts","sourceRoot":"","sources":["../../../../src/types/recipe.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/types/renderer.d.ts

@@ -0,0 +1,51 @@
+import type { ComponentType, ReactNode } from 'react';
+import type { TextMotionComponentRendererProps, TextMotionRecipeConfig } from './recipe.js';
+import type { TextMotionToken } from './token.js';
+declare const textMotionRendererCapabilityBrand: unique symbol;
+declare const textMotionRendererBrand: unique symbol;
+declare const textMotionRenderedLineRendererBrand: unique symbol;
+/** Branded renderer capability name for custom renderer packages. */
+export type TextMotionRendererCapabilityExtension<Name extends string = string> = Name & {
+    readonly [textMotionRendererCapabilityBrand]: 'TextMotionRendererCapabilityExtension';
+};
+/** Capability supported by a renderer and required by effects. */
+export type TextMotionRendererCapability = 'native-text' | 'style-transform' | TextMotionRendererCapabilityExtension;
+/** @internal Built-in capability used by overlayText line-mask effects. */
+export type TextMotionLineMaskCapability = TextMotionRendererCapabilityExtension<'line-mask'>;
+/** Create a branded capability name for a custom renderer. */
+export declare function createTextMotionRendererCapability<Name extends string>(name: Name): TextMotionRendererCapabilityExtension<Name>;
+/** Props passed from the recipe component into a renderer component. */
+export type TextMotionRendererProps<Recipe = TextMotionRecipeConfig> = {
+    children: ReactNode;
+    tokens: readonly TextMotionToken[];
+    recipe: Recipe;
+    textProps?: TextMotionComponentRendererProps;
+};
+/** @internal Renderer descriptor consumed by recipe internals. */
+export type TextMotionRendererDescriptor<Capabilities extends TextMotionRendererCapability = TextMotionRendererCapability, Recipe = TextMotionRecipeConfig, MotionUnit extends 'source-token' | 'rendered-line' = 'source-token' | 'rendered-line'> = {
+    kind: string;
+    capabilities: readonly Capabilities[];
+    motionUnit?: MotionUnit;
+    Component: ComponentType<TextMotionRendererProps<Recipe>>;
+};
+/** Renderer handle used by `.layout(...)`. */
+export type TextMotionRenderer<Capabilities extends TextMotionRendererCapability = TextMotionRendererCapability, Recipe = unknown> = {
+    readonly [textMotionRendererBrand]: {
+        readonly capabilities: Capabilities;
+        readonly recipe: Recipe;
+    };
+};
+/** @internal Renderer handle for source-token renderers accepted after `.split(...)`. */
+export type TextMotionSourceTokenRenderer<Capabilities extends TextMotionRendererCapability = TextMotionRendererCapability, Recipe = unknown> = TextMotionRenderer<Capabilities, Recipe> & {
+    readonly [textMotionRenderedLineRendererBrand]?: never;
+};
+/** @internal Renderer handle for renderers that own rendered-line layout. */
+export type TextMotionRenderedLineRenderer<Capabilities extends TextMotionRendererCapability = TextMotionRendererCapability, Recipe = unknown> = TextMotionRenderer<Capabilities, Recipe> & {
+    readonly [textMotionRenderedLineRendererBrand]: 'rendered-line';
+};
+/** Capabilities required by an effect but missing from a renderer. */
+export type TextMotionMissingCapabilities<RendererCapabilities extends TextMotionRendererCapability, RequiredCapabilities extends TextMotionRendererCapability> = Exclude<RequiredCapabilities, RendererCapabilities>;
+/** Effect type gate that rejects effects incompatible with the selected renderer. */
+export type TextMotionCompatibleEffect<RendererCapabilities extends TextMotionRendererCapability, RequiredCapabilities extends TextMotionRendererCapability, Effect> = [TextMotionMissingCapabilities<RendererCapabilities, RequiredCapabilities>] extends [never] ? Effect : never;
+export {};
+//# sourceMappingURL=renderer.d.ts.map

package/lib/typescript/src/types/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../../../src/types/renderer.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/types/token.d.ts

@@ -0,0 +1,35 @@
+/** Unit of text produced by a splitter. */
+export type TextMotionTokenUnit = 'grapheme' | 'word' | 'line' | 'custom';
+/** Source character range for a token in the original string. */
+export type TextMotionSourceRange = {
+    start: number;
+    end: number;
+};
+/** Token emitted by splitters and consumed by renderers. */
+export type TextMotionToken<Unit extends TextMotionTokenUnit = TextMotionTokenUnit> = {
+    id: string;
+    text: string;
+    index: number;
+    unit: Unit;
+    sourceRange: TextMotionSourceRange;
+    metadata?: Record<string, unknown>;
+};
+/** Optional context passed to splitters. */
+export type TextMotionSplitContext = {
+    /** Locale forwarded to native `Intl.Segmenter` when the runtime provides it. */
+    locale?: string | string[];
+};
+declare const textMotionSplitterBrand: unique symbol;
+/** @internal Splitter descriptor consumed by recipe internals. */
+export type TextMotionSplitterDescriptor<Unit extends TextMotionTokenUnit = TextMotionTokenUnit> = {
+    kind: Unit;
+    split(input: string, context?: TextMotionSplitContext): readonly TextMotionToken<Unit>[];
+};
+/** Opaque splitter handle accepted by `.split(...)`. */
+export type TextMotionSplitter<Unit extends TextMotionTokenUnit = TextMotionTokenUnit> = {
+    readonly [textMotionSplitterBrand]: {
+        readonly unit: Unit;
+    };
+};
+export {};
+//# sourceMappingURL=token.d.ts.map

package/lib/typescript/src/types/token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../../../src/types/token.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE1E,iEAAiE;AACjE,MAAM,MAAM,qBAAqB,GAAG;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,4DAA4D;AAC5D,MAAM,MAAM,eAAe,CAAC,IAAI,SAAS,mBAAmB,GAAG,mBAAmB,IAAI;IACpF,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,IAAI,CAAC;IACX,WAAW,EAAE,qBAAqB,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC;AAEF,4CAA4C;AAC5C,MAAM,MAAM,sBAAsB,GAAG;IACnC,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC5B,CAAC;AAEF,OAAO,CAAC,MAAM,uBAAuB,EAAE,OAAO,MAAM,CAAC;AAErD,kEAAkE;AAClE,MAAM,MAAM,4BAA4B,CAAC,IAAI,SAAS,mBAAmB,GAAG,mBAAmB,IAAI;IACjG,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,SAAS,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;CAC1F,CAAC;AAEF,wDAAwD;AACxD,MAAM,MAAM,kBAAkB,CAAC,IAAI,SAAS,mBAAmB,GAAG,mBAAmB,IAAI;IACvF,QAAQ,CAAC,CAAC,uBAAuB,CAAC,EAAE;QAClC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;KACrB,CAAC;CACH,CAAC"}

package/package.json

@@ -1,6 +1,119 @@
 {
   "name": "@react-native-motion-kit/text-motion",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "High-performance split text animations for React Native, powered by Reanimated and extensible renderers.",
+  "keywords": [
+    "android",
+    "ios",
+    "react-native"
+  ],
+  "homepage": "https://github.com/react-native-motion-kit/react-native-text-motion#readme",
+  "bugs": {
+    "url": "https://github.com/react-native-motion-kit/react-native-text-motion/issues"
+  },
+  "license": "MIT",
+  "author": "harang <dbd02169@naver.com> (https://github.com/saseungmin)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/react-native-motion-kit/react-native-text-motion.git"
+  },
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "cpp",
+    "*.podspec",
+    "react-native.config.js",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "main": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "exports": {
+    ".": {
+      "react-native-motion-kit-text-motion-source": "./src/index.tsx",
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./presets": {
+      "react-native-motion-kit-text-motion-source": "./src/presets/index.ts",
+      "types": "./lib/typescript/src/presets/index.d.ts",
+      "default": "./lib/module/presets/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.28.5",
+    "@react-native/babel-preset": "0.85.3",
+    "@react-native/jest-preset": "0.85.3",
+    "@react-native/metro-config": "0.85.3",
+    "@testing-library/react-native": "^14.0.1",
+    "@types/jest": "^29.5.14",
+    "@types/react": "^19.2.0",
+    "babel-jest": "^29.7.0",
+    "del-cli": "^7.0.0",
+    "jest": "^29.7.0",
+    "react": "19.2.3",
+    "react-native": "0.85.3",
+    "react-native-builder-bob": "^0.43.0",
+    "react-native-reanimated": "4.3.1",
+    "react-native-worklets": "0.8.3",
+    "test-renderer": "^1.2.0",
+    "typescript": "~6.0.3"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-native": ">=0.76.0",
+    "react-native-reanimated": ">=4.0.0",
+    "react-native-worklets": ">=0.5.0"
+  },
+  "create-react-native-library": {
+    "type": "library",
+    "languages": "js",
+    "tools": [
+      "jest",
+      "lefthook"
+    ],
+    "version": "0.63.0"
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "scripts": {
+    "build": "bob build && node scripts/check-declarations.mjs",
+    "clean": "del-cli lib",
+    "test": "jest",
+    "typecheck": "tsc --noEmit"
+  }
 }

package/src/accessibility/index.ts

@@ -0,0 +1,7 @@
+export {
+  createHiddenTokenAccessibilityProps,
+  createParentAccessibilityProps,
+  parentLabelPolicy,
+  resolveAccessibleText,
+  type ParentLabelPolicyOptions,
+} from './policies';

package/src/accessibility/policies.ts

@@ -0,0 +1,60 @@
+import type { TextProps } from 'react-native';
+
+import type { TextMotionAccessibilityPolicy, TextMotionToken } from '../types';
+
+/** Options for {@link parentLabelPolicy}. */
+export type ParentLabelPolicyOptions = {
+  /** Reduced-motion behavior. Defaults to `system`. */
+  reducedMotion?: TextMotionAccessibilityPolicy['reducedMotion'];
+};
+
+/** Make the parent text node accessible and hide decorative animated token nodes. */
+export function parentLabelPolicy(
+  options: ParentLabelPolicyOptions = {},
+): TextMotionAccessibilityPolicy {
+  return {
+    kind: 'parent-label',
+    parentLabel: true,
+    hideTokensFromAccessibility: true,
+    reducedMotion: options.reducedMotion ?? 'system',
+  };
+}
+
+export function resolveAccessibleText(
+  children: string,
+  tokens: readonly TextMotionToken[],
+): string {
+  if (children.length > 0) {
+    return children;
+  }
+
+  return tokens.map((token) => token.text).join('');
+}
+
+export function createParentAccessibilityProps(
+  policy: TextMotionAccessibilityPolicy,
+  label: string,
+): Pick<TextProps, 'accessibilityLabel' | 'accessible'> {
+  if (!policy.parentLabel) {
+    return {};
+  }
+
+  return {
+    accessibilityLabel: label,
+    accessible: true,
+  };
+}
+
+export function createHiddenTokenAccessibilityProps(
+  policy: TextMotionAccessibilityPolicy,
+): Pick<TextProps, 'accessibilityElementsHidden' | 'accessible' | 'importantForAccessibility'> {
+  if (!policy.hideTokensFromAccessibility) {
+    return {};
+  }
+
+  return {
+    accessibilityElementsHidden: true,
+    accessible: false,
+    importantForAccessibility: 'no-hide-descendants',
+  };
+}

package/src/controls/brand.ts

@@ -0,0 +1,3 @@
+export const textMotionControlsBrand: unique symbol = Symbol(
+  '@react-native-motion-kit/text-motion.controls',
+);

package/src/controls/controls.ts

@@ -0,0 +1,41 @@
+import { useRef } from 'react';
+
+import type { textMotionControlsBrand } from './brand';
+
+import { createTextMotionControlsHandle } from './descriptors';
+
+/**
+ * Command channel for event-driven text playback.
+ *
+ * Pass the returned controls object to a text motion component with
+ * `controls={controls}`. The controls object emits playback commands; the component still owns
+ * its recipe, timeline, effects, and `.motion()` transition.
+ */
+export type TextMotionControls = {
+  readonly [textMotionControlsBrand]: true;
+  /** Play the current text motion from its current progress toward the final state. */
+  play(): void;
+  /** Reset to the initial state and play again with the recipe timeline and `.motion()` config. */
+  replay(): void;
+  /** Stop any in-flight playback and return to the initial state. */
+  reset(): void;
+  /** Stop any in-flight playback while preserving the current visual progress. */
+  stop(): void;
+};
+
+/**
+ * Create a stable text motion command channel for event-driven playback.
+ *
+ * Use controls for button presses, screen focus, onboarding steps, and other discrete events.
+ * Use the `progress` prop instead when text should follow a raw scroll, gesture, or synchronized
+ * Reanimated shared value.
+ */
+export function useTextMotionControls(): TextMotionControls {
+  const controls = useRef<TextMotionControls | undefined>(undefined);
+
+  if (!controls.current) {
+    controls.current = createTextMotionControlsHandle();
+  }
+
+  return controls.current;
+}

package/src/controls/descriptors.ts

@@ -0,0 +1,83 @@
+import type { TextMotionControls } from './controls';
+
+import { textMotionControlsBrand } from './brand';
+
+export type TextMotionControlCommandKind = 'play' | 'replay' | 'reset' | 'stop';
+
+export type TextMotionControlCommand = {
+  id: number;
+  kind: TextMotionControlCommandKind;
+};
+
+export type TextMotionControlCommandListener = (command: TextMotionControlCommand) => void;
+
+export type TextMotionControlsDescriptor = {
+  getListenerCount(): number;
+  subscribe(listener: TextMotionControlCommandListener): () => void;
+};
+
+const controlsDescriptors = new WeakMap<TextMotionControls, TextMotionControlsDescriptor>();
+
+export function createTextMotionControlsHandle(): TextMotionControls {
+  const listeners = new Set<TextMotionControlCommandListener>();
+  const descriptor: TextMotionControlsDescriptor = {
+    getListenerCount() {
+      return listeners.size;
+    },
+    subscribe(listener) {
+      listeners.add(listener);
+
+      return () => {
+        listeners.delete(listener);
+      };
+    },
+  };
+  const emit = createTextMotionControlEmitter(listeners);
+  const controls: TextMotionControls = {
+    [textMotionControlsBrand]: true,
+    play() {
+      emit('play');
+    },
+    replay() {
+      emit('replay');
+    },
+    reset() {
+      emit('reset');
+    },
+    stop() {
+      emit('stop');
+    },
+  };
+
+  controlsDescriptors.set(controls, descriptor);
+
+  return controls;
+}
+
+export function readTextMotionControlsDescriptor(
+  controls: TextMotionControls,
+): TextMotionControlsDescriptor {
+  const descriptor = controlsDescriptors.get(controls);
+
+  if (descriptor) {
+    return descriptor;
+  }
+
+  throw new Error('@react-native-motion-kit/text-motion received an unknown controls handle.');
+}
+
+function createTextMotionControlEmitter(
+  listeners: Set<TextMotionControlCommandListener>,
+): (kind: TextMotionControlCommandKind) => void {
+  let nextCommandId = 0;
+
+  return (kind) => {
+    const command = {
+      id: nextCommandId + 1,
+      kind,
+    };
+
+    nextCommandId = command.id;
+    listeners.forEach((listener) => listener(command));
+  };
+}

package/src/controls/index.ts

@@ -0,0 +1,2 @@
+export { useTextMotionControls } from './controls';
+export type { TextMotionControls } from './controls';