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

package/CHANGELOG.md

@@ -0,0 +1,14 @@
+# @react-native-motion-kit/text-motion
+
+## 0.1.1
+
+### Patch Changes
+
+- [#9](https://github.com/react-native-motion-kit/react-native-text-motion/pull/9) [`c460a1c`](https://github.com/react-native-motion-kit/react-native-text-motion/commit/c460a1c42b4f7cf77b57b542009043c9f389d038) Thanks [@saseungmin](https://github.com/saseungmin)! - Link the published documentation site from the package homepage and refresh the English and Korean package READMEs with concise examples and AI documentation resources.
+
+## 0.1.0
+
+### Minor Changes
+
+- [#6](https://github.com/react-native-motion-kit/react-native-text-motion/pull/6) [`99ce29a`](https://github.com/react-native-motion-kit/react-native-text-motion/commit/99ce29a602b8a81b5322642fe856b12be30763c4) Thanks [@saseungmin](https://github.com/saseungmin)! - Initial release with composable text-motion recipes, presets, token splitting, timelines, playback controls, app-owned progress, and reduced-motion support.
+Includes fixed-layout Typewriter reveals and measured native-line animation with isolated reveal masks.

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2026 harang
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.ko.md

@@ -0,0 +1,104 @@
+# React Native Text Motion
+
+> [English](https://github.com/react-native-motion-kit/react-native-text-motion/blob/main/packages/text-motion/README.md) | 한국어
+
+<div align="center">
+  <img src="https://raw.githubusercontent.com/react-native-motion-kit/react-native-text-motion/main/docs/docs/public/logo.png" width="300" alt="React Native Motion Kit logo" />
+</div>
+
+## 소개
+
+`@react-native-motion-kit/text-motion`은 Reanimated 기반의 React Native 텍스트 애니메이션 라이브러리입니다. 짧은 제목, 레이블, 온보딩 문구에 맞춰 텍스트 분할 방식, 렌더러, 타임라인, 효과를 조합하고 재사용 가능한 컴포넌트를 만듭니다.
+
+### 주요 기능
+
+- **조합 가능한 레시피** — 분할, 레이아웃, 타이밍, 효과를 TypeScript API로 구성합니다.
+- **단어와 글자 애니메이션** — `nativeText()`로 단어나 그래핌을 움직이고 `typewriter()`로 한 글자씩 표시합니다.
+- **실제 줄 기준 모션** — `overlayText()`와 `lineReveal()`로 React Native가 렌더링한 줄을 드러냅니다.
+- **재생 제어** — 이벤트에서 play/replay/reset/stop을 실행하거나 외부 Reanimated shared value로 진행률을 제어합니다.
+- **접근성** — 기본적으로 전체 문장을 하나의 레이블로 제공하고 장식용 토큰은 스크린 리더에서 숨깁니다. 모션 줄이기 설정도 반영합니다.
+- **기본 프리셋** — 프리셋으로 시작하고 필요에 따라 레시피를 조정합니다.
+
+## 빠르게 시작하기
+
+### 문서
+
+[한국어 문서](https://react-native-text-motion.pages.dev/ko/) · [설치](https://react-native-text-motion.pages.dev/ko/guide/getting-started/installation.html) · [빠른 시작](https://react-native-text-motion.pages.dev/ko/guide/getting-started/quick-start.html)
+
+### 예제
+
+- [예제 모음](https://react-native-text-motion.pages.dev/ko/guide/usage/examples.html) — 동작을 확인하고 예제 코드를 살펴봅니다.
+- [Expo 예제 앱](https://github.com/react-native-motion-kit/react-native-text-motion/tree/main/example) — 레시피, 재생 제어, 네이티브 줄 애니메이션을 실행합니다.
+
+### AI
+
+[AI 도구와 함께 사용하기](https://react-native-text-motion.pages.dev/ko/guide/getting-started/ai.html)에서 문서 활용 방법을 확인하세요.
+
+- [llms.txt](https://react-native-text-motion.pages.dev/ko/llms.txt) — 문서 제목과 링크를 담은 색인입니다.
+- [llms-full.txt](https://react-native-text-motion.pages.dev/ko/llms-full.txt) — 전체 문서를 하나의 텍스트 파일로 제공합니다.
+- [영문 색인](https://react-native-text-motion.pages.dev/llms.txt) · [영문 전체 문서](https://react-native-text-motion.pages.dev/llms-full.txt)
+
+### 설치
+
+```sh
+pnpm add @react-native-motion-kit/text-motion react-native-reanimated react-native-worklets
+```
+
+peer dependency 최소 버전은 Reanimated `4.0.0`, Worklets `0.5.0`입니다. 이 최소값만으로 네이티브 의존성의 호환성이 보장되지는 않습니다. [설치 가이드](https://react-native-text-motion.pages.dev/ko/guide/getting-started/installation.html)와 [Reanimated 공식 설정 안내](https://docs.swmansion.com/react-native-reanimated/docs/fundamentals/getting-started/)에 따라 앱의 React Native 또는 Expo 버전에 맞게 설정하세요. Reanimated 4는 New Architecture가 필요합니다.
+
+### 기본 사용법
+
+프리셋에서 컴포넌트를 만들고 애니메이션을 적용할 텍스트를 전달하세요.
+
+```tsx
+import { editorialRise } from '@react-native-motion-kit/text-motion/presets';
+
+// 재사용할 컴포넌트는 렌더 함수 밖에서 만드세요.
+const HeroReveal = editorialRise().component();
+
+export function HeroTitle() {
+  return <HeroReveal>Design motion that feels native</HeroReveal>;
+}
+```
+
+직접 레시피를 조합할 수도 있습니다. `stagger()`의 시간 단위는 초이며, `.component()`를 호출하기 전에 `.layout(...)`으로 렌더러를 선택해야 합니다.
+
+```tsx
+import {
+  defineTextMotion,
+  fade,
+  nativeText,
+  rise,
+  stagger,
+  words,
+} from '@react-native-motion-kit/text-motion';
+
+const WordReveal = defineTextMotion()
+  .split(words())
+  .layout(nativeText())
+  .timeline(stagger(0.04))
+  .effect(fade().and(rise({ y: 12 })))
+  .component();
+```
+
+자세한 내용은 [레시피 API](https://react-native-text-motion.pages.dev/ko/api/recipe.html), [렌더러](https://react-native-text-motion.pages.dev/ko/api/renderers.html), [재생 제어](https://react-native-text-motion.pages.dev/ko/guide/usage/playback.html)를 참고하세요. `controls`와 외부 `progress`는 함께 사용할 수 없습니다.
+
+## 사용 범위
+
+짧은 UI 텍스트를 위한 라이브러리이며 네이티브 `Text`의 모든 기능을 대체하지 않습니다. `nativeText()`는 소스 토큰을, `overlayText()`는 실제 렌더링된 줄을 애니메이션 단위로 사용합니다. `overlayText()`에는 `.split(...)`을 추가하지 마세요. `lines()`는 명시적인 `\n`만 분리합니다.
+
+긴 문단이나 많은 애니메이션 행은 대상 기기에서 측정하세요. 브라우저 예제는 네이티브 성능 측정 자료가 아닙니다. [성능 안내](https://react-native-text-motion.pages.dev/ko/guide/usage/performance.html)와 [접근성 안내](https://react-native-text-motion.pages.dev/ko/guide/usage/accessibility.html)를 참고하세요.
+
+## 프로젝트 방향
+
+우선순위와 기능 아이디어는 [프로젝트 방향·로드맵 Discussion](https://github.com/react-native-motion-kit/react-native-text-motion/discussions/10)에서 논의합니다.
+
+라이브러리 확장 전 현재 우선순위와 설계 범위는 [프로젝트 맥락과 로드맵](https://github.com/react-native-motion-kit/react-native-text-motion/blob/main/ROADMAP.ko.md)을 참고하세요.
+
+## 개발 참여
+
+[기여 가이드와 개발 환경](https://github.com/react-native-motion-kit/react-native-text-motion/blob/main/CONTRIBUTING.md)
+
+## License
+
+[MIT](./LICENSE)

package/README.md

@@ -1,3 +1,104 @@
-# Temporary Holding Version
+# React Native Text Motion
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> English | [한국어](https://github.com/react-native-motion-kit/react-native-text-motion/blob/main/packages/text-motion/README.ko.md)
+
+<div align="center">
+  <img src="https://raw.githubusercontent.com/react-native-motion-kit/react-native-text-motion/main/docs/docs/public/logo.png" width="300" alt="React Native Motion Kit logo" />
+</div>
+
+## Overview
+
+`@react-native-motion-kit/text-motion` brings composable text animations to React Native with Reanimated. Build reusable animated components for short titles, labels, onboarding copy, and product copy by choosing how text is split, rendered, timed, and animated.
+
+### Key Features
+
+- **Composable recipes** — Combine splitting, layout, timelines, and effects with a typed API.
+- **Word and character motion** — Animate words or graphemes with `nativeText()`, including character-by-character `typewriter()` reveals.
+- **Rendered-line reveals** — Use `overlayText()` and `lineReveal()` to animate the lines React Native actually rendered.
+- **Playback control** — Trigger play/replay/reset/stop from events or drive progress with an external Reanimated shared value.
+- **Accessibility** — Read the whole phrase as one label, hide decorative tokens from screen readers, and respect reduced motion by default.
+- **Ready-to-use presets** — Start with a preset, then customize its recipe when needed.
+
+## Quick Start
+
+### Documentation
+
+[Full documentation](https://react-native-text-motion.pages.dev/) · [Installation](https://react-native-text-motion.pages.dev/guide/getting-started/installation.html) · [Quick start](https://react-native-text-motion.pages.dev/guide/getting-started/quick-start.html)
+
+### Examples
+
+- [Examples gallery](https://react-native-text-motion.pages.dev/guide/usage/examples.html) — Explore demos and their source code.
+- [Expo example app](https://github.com/react-native-motion-kit/react-native-text-motion/tree/main/example) — Run recipes, playback controls, and native rendered-line examples.
+
+### AI
+
+See [Use with AI tools](https://react-native-text-motion.pages.dev/guide/getting-started/ai.html) for documentation workflows.
+
+- [llms.txt](https://react-native-text-motion.pages.dev/llms.txt) — A structured index of documentation pages.
+- [llms-full.txt](https://react-native-text-motion.pages.dev/llms-full.txt) — The complete documentation in one text file.
+- [Korean index](https://react-native-text-motion.pages.dev/ko/llms.txt) · [Korean full documentation](https://react-native-text-motion.pages.dev/ko/llms-full.txt)
+
+### Installation
+
+```sh
+pnpm add @react-native-motion-kit/text-motion react-native-reanimated react-native-worklets
+```
+
+The peer minimums are Reanimated `4.0.0` and Worklets `0.5.0`. These minimums are not a complete native compatibility matrix. Follow the [installation guide](https://react-native-text-motion.pages.dev/guide/getting-started/installation.html) and [official Reanimated setup](https://docs.swmansion.com/react-native-reanimated/docs/fundamentals/getting-started/) for your React Native or Expo version. Reanimated 4 requires the New Architecture.
+
+### Basic Usage
+
+Create a component from a preset and pass the text you want to animate:
+
+```tsx
+import { editorialRise } from '@react-native-motion-kit/text-motion/presets';
+
+// Create the reusable component outside render.
+const HeroReveal = editorialRise().component();
+
+export function HeroTitle() {
+  return <HeroReveal>Design motion that feels native</HeroReveal>;
+}
+```
+
+For custom motion, compose a recipe. `stagger()` uses seconds, and `.component()` requires a renderer selected with `.layout(...)`.
+
+```tsx
+import {
+  defineTextMotion,
+  fade,
+  nativeText,
+  rise,
+  stagger,
+  words,
+} from '@react-native-motion-kit/text-motion';
+
+const WordReveal = defineTextMotion()
+  .split(words())
+  .layout(nativeText())
+  .timeline(stagger(0.04))
+  .effect(fade().and(rise({ y: 12 })))
+  .component();
+```
+
+Continue with the [recipe API](https://react-native-text-motion.pages.dev/api/recipe.html), [renderers](https://react-native-text-motion.pages.dev/api/renderers.html), and [playback guide](https://react-native-text-motion.pages.dev/guide/usage/playback.html). Use either `controls` or external `progress` on an instance; they cannot be combined.
+
+## Scope
+
+Designed for short UI text, this library does not replace every native `Text` feature. `nativeText()` animates source tokens; `overlayText()` animates actual rendered lines and must not use `.split(...)`. The `lines()` splitter handles explicit `\n` characters only.
+
+Measure long paragraphs and many animated rows on target devices. Browser demos are not native performance evidence. See [performance guidance](https://react-native-text-motion.pages.dev/guide/usage/performance.html) and [accessibility](https://react-native-text-motion.pages.dev/guide/usage/accessibility.html).
+
+## Project direction
+
+Discuss priorities and feature ideas in [Project direction & roadmap](https://github.com/react-native-motion-kit/react-native-text-motion/discussions/10).
+
+Read the [project context and roadmap](https://github.com/react-native-motion-kit/react-native-text-motion/blob/main/ROADMAP.md) for priorities and design boundaries before extending the library.
+
+## Contributing
+
+[Contributing guide and development setup](https://github.com/react-native-motion-kit/react-native-text-motion/blob/main/CONTRIBUTING.md)
+
+## License
+
+[MIT](./LICENSE)

package/lib/module/accessibility/index.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export { createHiddenTokenAccessibilityProps, createParentAccessibilityProps, parentLabelPolicy, resolveAccessibleText } from "./policies.js";
+//# sourceMappingURL=index.js.map

package/lib/module/accessibility/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createHiddenTokenAccessibilityProps","createParentAccessibilityProps","parentLabelPolicy","resolveAccessibleText"],"sourceRoot":"../../../src","sources":["accessibility/index.ts"],"mappings":";;AAAA,SACEA,mCAAmC,EACnCC,8BAA8B,EAC9BC,iBAAiB,EACjBC,qBAAqB,QAEhB,eAAY","ignoreList":[]}

package/lib/module/accessibility/policies.js

@@ -0,0 +1,39 @@
+"use strict";
+
+/** Options for {@link parentLabelPolicy}. */
+
+/** Make the parent text node accessible and hide decorative animated token nodes. */
+export function parentLabelPolicy(options = {}) {
+  return {
+    kind: 'parent-label',
+    parentLabel: true,
+    hideTokensFromAccessibility: true,
+    reducedMotion: options.reducedMotion ?? 'system'
+  };
+}
+export function resolveAccessibleText(children, tokens) {
+  if (children.length > 0) {
+    return children;
+  }
+  return tokens.map(token => token.text).join('');
+}
+export function createParentAccessibilityProps(policy, label) {
+  if (!policy.parentLabel) {
+    return {};
+  }
+  return {
+    accessibilityLabel: label,
+    accessible: true
+  };
+}
+export function createHiddenTokenAccessibilityProps(policy) {
+  if (!policy.hideTokensFromAccessibility) {
+    return {};
+  }
+  return {
+    accessibilityElementsHidden: true,
+    accessible: false,
+    importantForAccessibility: 'no-hide-descendants'
+  };
+}
+//# sourceMappingURL=policies.js.map

package/lib/module/accessibility/policies.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["parentLabelPolicy","options","kind","parentLabel","hideTokensFromAccessibility","reducedMotion","resolveAccessibleText","children","tokens","length","map","token","text","join","createParentAccessibilityProps","policy","label","accessibilityLabel","accessible","createHiddenTokenAccessibilityProps","accessibilityElementsHidden","importantForAccessibility"],"sourceRoot":"../../../src","sources":["accessibility/policies.ts"],"mappings":";;AAIA;;AAMA;AACA,OAAO,SAASA,iBAAiBA,CAC/BC,OAAiC,GAAG,CAAC,CAAC,EACP;EAC/B,OAAO;IACLC,IAAI,EAAE,cAAc;IACpBC,WAAW,EAAE,IAAI;IACjBC,2BAA2B,EAAE,IAAI;IACjCC,aAAa,EAAEJ,OAAO,CAACI,aAAa,IAAI;EAC1C,CAAC;AACH;AAEA,OAAO,SAASC,qBAAqBA,CACnCC,QAAgB,EAChBC,MAAkC,EAC1B;EACR,IAAID,QAAQ,CAACE,MAAM,GAAG,CAAC,EAAE;IACvB,OAAOF,QAAQ;EACjB;EAEA,OAAOC,MAAM,CAACE,GAAG,CAAEC,KAAK,IAAKA,KAAK,CAACC,IAAI,CAAC,CAACC,IAAI,CAAC,EAAE,CAAC;AACnD;AAEA,OAAO,SAASC,8BAA8BA,CAC5CC,MAAqC,EACrCC,KAAa,EACyC;EACtD,IAAI,CAACD,MAAM,CAACZ,WAAW,EAAE;IACvB,OAAO,CAAC,CAAC;EACX;EAEA,OAAO;IACLc,kBAAkB,EAAED,KAAK;IACzBE,UAAU,EAAE;EACd,CAAC;AACH;AAEA,OAAO,SAASC,mCAAmCA,CACjDJ,MAAqC,EACwD;EAC7F,IAAI,CAACA,MAAM,CAACX,2BAA2B,EAAE;IACvC,OAAO,CAAC,CAAC;EACX;EAEA,OAAO;IACLgB,2BAA2B,EAAE,IAAI;IACjCF,UAAU,EAAE,KAAK;IACjBG,yBAAyB,EAAE;EAC7B,CAAC;AACH","ignoreList":[]}

package/lib/module/controls/brand.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export const textMotionControlsBrand = Symbol('@react-native-motion-kit/text-motion.controls');
+//# sourceMappingURL=brand.js.map

package/lib/module/controls/brand.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["textMotionControlsBrand","Symbol"],"sourceRoot":"../../../src","sources":["controls/brand.ts"],"mappings":";;AAAA,OAAO,MAAMA,uBAAsC,GAAGC,MAAM,CAC1D,+CACF,CAAC","ignoreList":[]}

package/lib/module/controls/controls.js

@@ -0,0 +1,28 @@
+"use strict";
+
+import { useRef } from 'react';
+import { createTextMotionControlsHandle } from "./descriptors.js";
+
+/**
+ * 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.
+ */
+
+/**
+ * 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() {
+  const controls = useRef(undefined);
+  if (!controls.current) {
+    controls.current = createTextMotionControlsHandle();
+  }
+  return controls.current;
+}
+//# sourceMappingURL=controls.js.map

package/lib/module/controls/controls.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useRef","createTextMotionControlsHandle","useTextMotionControls","controls","undefined","current"],"sourceRoot":"../../../src","sources":["controls/controls.ts"],"mappings":";;AAAA,SAASA,MAAM,QAAQ,OAAO;AAI9B,SAASC,8BAA8B,QAAQ,kBAAe;;AAE9D;AACA;AACA;AACA;AACA;AACA;AACA;;AAaA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,qBAAqBA,CAAA,EAAuB;EAC1D,MAAMC,QAAQ,GAAGH,MAAM,CAAiCI,SAAS,CAAC;EAElE,IAAI,CAACD,QAAQ,CAACE,OAAO,EAAE;IACrBF,QAAQ,CAACE,OAAO,GAAGJ,8BAA8B,CAAC,CAAC;EACrD;EAEA,OAAOE,QAAQ,CAACE,OAAO;AACzB","ignoreList":[]}

package/lib/module/controls/descriptors.js

@@ -0,0 +1,55 @@
+"use strict";
+
+import { textMotionControlsBrand } from "./brand.js";
+const controlsDescriptors = new WeakMap();
+export function createTextMotionControlsHandle() {
+  const listeners = new Set();
+  const descriptor = {
+    getListenerCount() {
+      return listeners.size;
+    },
+    subscribe(listener) {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    }
+  };
+  const emit = createTextMotionControlEmitter(listeners);
+  const controls = {
+    [textMotionControlsBrand]: true,
+    play() {
+      emit('play');
+    },
+    replay() {
+      emit('replay');
+    },
+    reset() {
+      emit('reset');
+    },
+    stop() {
+      emit('stop');
+    }
+  };
+  controlsDescriptors.set(controls, descriptor);
+  return controls;
+}
+export function readTextMotionControlsDescriptor(controls) {
+  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) {
+  let nextCommandId = 0;
+  return kind => {
+    const command = {
+      id: nextCommandId + 1,
+      kind
+    };
+    nextCommandId = command.id;
+    listeners.forEach(listener => listener(command));
+  };
+}
+//# sourceMappingURL=descriptors.js.map

package/lib/module/controls/descriptors.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["textMotionControlsBrand","controlsDescriptors","WeakMap","createTextMotionControlsHandle","listeners","Set","descriptor","getListenerCount","size","subscribe","listener","add","delete","emit","createTextMotionControlEmitter","controls","play","replay","reset","stop","set","readTextMotionControlsDescriptor","get","Error","nextCommandId","kind","command","id","forEach"],"sourceRoot":"../../../src","sources":["controls/descriptors.ts"],"mappings":";;AAEA,SAASA,uBAAuB,QAAQ,YAAS;AAgBjD,MAAMC,mBAAmB,GAAG,IAAIC,OAAO,CAAmD,CAAC;AAE3F,OAAO,SAASC,8BAA8BA,CAAA,EAAuB;EACnE,MAAMC,SAAS,GAAG,IAAIC,GAAG,CAAmC,CAAC;EAC7D,MAAMC,UAAwC,GAAG;IAC/CC,gBAAgBA,CAAA,EAAG;MACjB,OAAOH,SAAS,CAACI,IAAI;IACvB,CAAC;IACDC,SAASA,CAACC,QAAQ,EAAE;MAClBN,SAAS,CAACO,GAAG,CAACD,QAAQ,CAAC;MAEvB,OAAO,MAAM;QACXN,SAAS,CAACQ,MAAM,CAACF,QAAQ,CAAC;MAC5B,CAAC;IACH;EACF,CAAC;EACD,MAAMG,IAAI,GAAGC,8BAA8B,CAACV,SAAS,CAAC;EACtD,MAAMW,QAA4B,GAAG;IACnC,CAACf,uBAAuB,GAAG,IAAI;IAC/BgB,IAAIA,CAAA,EAAG;MACLH,IAAI,CAAC,MAAM,CAAC;IACd,CAAC;IACDI,MAAMA,CAAA,EAAG;MACPJ,IAAI,CAAC,QAAQ,CAAC;IAChB,CAAC;IACDK,KAAKA,CAAA,EAAG;MACNL,IAAI,CAAC,OAAO,CAAC;IACf,CAAC;IACDM,IAAIA,CAAA,EAAG;MACLN,IAAI,CAAC,MAAM,CAAC;IACd;EACF,CAAC;EAEDZ,mBAAmB,CAACmB,GAAG,CAACL,QAAQ,EAAET,UAAU,CAAC;EAE7C,OAAOS,QAAQ;AACjB;AAEA,OAAO,SAASM,gCAAgCA,CAC9CN,QAA4B,EACE;EAC9B,MAAMT,UAAU,GAAGL,mBAAmB,CAACqB,GAAG,CAACP,QAAQ,CAAC;EAEpD,IAAIT,UAAU,EAAE;IACd,OAAOA,UAAU;EACnB;EAEA,MAAM,IAAIiB,KAAK,CAAC,2EAA2E,CAAC;AAC9F;AAEA,SAAST,8BAA8BA,CACrCV,SAAgD,EACF;EAC9C,IAAIoB,aAAa,GAAG,CAAC;EAErB,OAAQC,IAAI,IAAK;IACf,MAAMC,OAAO,GAAG;MACdC,EAAE,EAAEH,aAAa,GAAG,CAAC;MACrBC;IACF,CAAC;IAEDD,aAAa,GAAGE,OAAO,CAACC,EAAE;IAC1BvB,SAAS,CAACwB,OAAO,CAAElB,QAAQ,IAAKA,QAAQ,CAACgB,OAAO,CAAC,CAAC;EACpD,CAAC;AACH","ignoreList":[]}

package/lib/module/controls/index.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export { useTextMotionControls } from "./controls.js";
+//# sourceMappingURL=index.js.map

package/lib/module/controls/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useTextMotionControls"],"sourceRoot":"../../../src","sources":["controls/index.ts"],"mappings":";;AAAA,SAASA,qBAAqB,QAAQ,eAAY","ignoreList":[]}

package/lib/module/effects/compose.js

@@ -0,0 +1,48 @@
+"use strict";
+
+import { attachTextMotionEffectDescriptor, readTextMotionEffectDescriptor } from "../recipe/descriptors.js";
+const DEFAULT_EFFECT_OPTIONS = {};
+const NATIVE_TEXT_CAPABILITIES = ['native-text'];
+function uniqueCapabilities(capabilities) {
+  return Array.from(new Set(capabilities));
+}
+
+/** Compose multiple effects into one ordered effect. */
+export function composeTextMotionEffects(effects) {
+  const descriptors = effects.map(readTextMotionEffectDescriptor);
+  const requiredCapabilities = uniqueCapabilities(descriptors.flatMap(descriptor => descriptor.requiredCapabilities));
+  const composed = {
+    and(effect) {
+      return composeTextMotionEffects([...effects, effect]);
+    }
+  };
+  return attachTextMotionEffectDescriptor(composed, {
+    kind: 'effect',
+    name: descriptors.map(descriptor => descriptor.name).join('+'),
+    requiredCapabilities,
+    effects
+  });
+}
+
+/** Create a custom native-text effect without descriptor options. */
+
+/** Create a custom native-text effect with typed descriptor options. */
+
+/** Create a custom effect with typed descriptor options and renderer capabilities. */
+
+/** Create a custom text-motion effect for built-in or custom renderers. */
+export function createTextMotionEffect(name, options = DEFAULT_EFFECT_OPTIONS, requiredCapabilities = NATIVE_TEXT_CAPABILITIES) {
+  const effect = {
+    and(nextEffect) {
+      return composeTextMotionEffects([effect, nextEffect]);
+    }
+  };
+  const descriptor = {
+    kind: 'effect',
+    name,
+    options,
+    requiredCapabilities
+  };
+  return attachTextMotionEffectDescriptor(effect, descriptor);
+}
+//# sourceMappingURL=compose.js.map

package/lib/module/effects/compose.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["attachTextMotionEffectDescriptor","readTextMotionEffectDescriptor","DEFAULT_EFFECT_OPTIONS","NATIVE_TEXT_CAPABILITIES","uniqueCapabilities","capabilities","Array","from","Set","composeTextMotionEffects","effects","descriptors","map","requiredCapabilities","flatMap","descriptor","composed","and","effect","kind","name","join","createTextMotionEffect","options","nextEffect"],"sourceRoot":"../../../src","sources":["effects/compose.ts"],"mappings":";;AAQA,SACEA,gCAAgC,EAChCC,8BAA8B,QACzB,0BAAuB;AAE9B,MAAMC,sBAAyD,GAAG,CAAC,CAAC;AACpE,MAAMC,wBAAkD,GAAG,CAAC,aAAa,CAAC;AAE1E,SAASC,kBAAkBA,CACzBC,YAAqC,EACZ;EACzB,OAAOC,KAAK,CAACC,IAAI,CAAC,IAAIC,GAAG,CAACH,YAAY,CAAC,CAAC;AAC1C;;AAEA;AACA,OAAO,SAASI,wBAAwBA,CACtCC,OAAkD,EAClB;EAChC,MAAMC,WAAW,GAAGD,OAAO,CAACE,GAAG,CAACX,8BAA8B,CAAC;EAC/D,MAAMY,oBAAoB,GAAGT,kBAAkB,CAC7CO,WAAW,CAACG,OAAO,CAAEC,UAAU,IAAKA,UAAU,CAACF,oBAAoB,CACrE,CAAC;EAED,MAAMG,QAAQ,GAAG;IACfC,GAAGA,CACDC,MAAoD,EACpD;MACA,OAAOT,wBAAwB,CAAkC,CAAC,GAAGC,OAAO,EAAEQ,MAAM,CAAC,CAAC;IACxF;EACF,CAAmC;EAEnC,OAAOlB,gCAAgC,CACrCgB,QAAQ,EACR;IACEG,IAAI,EAAE,QAAQ;IACdC,IAAI,EAAET,WAAW,CAACC,GAAG,CAAEG,UAAU,IAAKA,UAAU,CAACK,IAAI,CAAC,CAACC,IAAI,CAAC,GAAG,CAAC;IAChER,oBAAoB;IACpBH;EACF,CACF,CAAC;AACH;;AAEA;;AAKA;;AAMA;;AAWA;AACA,OAAO,SAASY,sBAAsBA,CACpCF,IAAY,EACZG,OAA0C,GAAGrB,sBAAsB,EACnEW,oBAA6D,GAAGV,wBAAwB,EACnE;EACrB,MAAMe,MAAM,GAAG;IACbD,GAAGA,CACDO,UAAwD,EACxD;MACA,OAAOf,wBAAwB,CAAkD,CAC/ES,MAAM,EACNM,UAAU,CACX,CAAC;IACJ;EACF,CAAwB;EAExB,MAAMT,UAAyC,GAAG;IAChDI,IAAI,EAAE,QAAQ;IACdC,IAAI;IACJG,OAAO;IACPV;EACF,CAAC;EAED,OAAOb,gCAAgC,CAACkB,MAAM,EAAEH,UAAU,CAAC;AAC7D","ignoreList":[]}

package/lib/module/effects/fade.js

@@ -0,0 +1,15 @@
+"use strict";
+
+import { createTextMotionEffect } from "./compose.js";
+import { validateFiniteEffectNumber } from "./validation.js";
+
+/** Options for {@link fade}. */
+
+/** Fade each token between opacity values. */
+export function fade(options = {}) {
+  return createTextMotionEffect('fade', {
+    from: validateFiniteEffectNumber(options.from ?? 0, 'fade from'),
+    to: validateFiniteEffectNumber(options.to ?? 1, 'fade to')
+  }, ['style-transform']);
+}
+//# sourceMappingURL=fade.js.map

package/lib/module/effects/fade.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createTextMotionEffect","validateFiniteEffectNumber","fade","options","from","to"],"sourceRoot":"../../../src","sources":["effects/fade.ts"],"mappings":";;AAAA,SAASA,sBAAsB,QAAQ,cAAW;AAClD,SAASC,0BAA0B,QAAQ,iBAAc;;AAEzD;;AAQA;AACA,OAAO,SAASC,IAAIA,CAACC,OAAoB,GAAG,CAAC,CAAC,EAAE;EAC9C,OAAOH,sBAAsB,CAC3B,MAAM,EACN;IACEI,IAAI,EAAEH,0BAA0B,CAACE,OAAO,CAACC,IAAI,IAAI,CAAC,EAAE,WAAW,CAAC;IAChEC,EAAE,EAAEJ,0BAA0B,CAACE,OAAO,CAACE,EAAE,IAAI,CAAC,EAAE,SAAS;EAC3D,CAAC,EACD,CAAC,iBAAiB,CACpB,CAAC;AACH","ignoreList":[]}

package/lib/module/effects/index.js

@@ -0,0 +1,12 @@
+"use strict";
+
+export { composeTextMotionEffects, createTextMotionEffect } from "./compose.js";
+export { fade } from "./fade.js";
+export { lineReveal } from "./lineReveal.js";
+export { pulse } from "./pulse.js";
+export { rise } from "./rise.js";
+export { scale } from "./scale.js";
+export { shake } from "./shake.js";
+export { slide } from "./slide.js";
+export { typewriter } from "./typewriter.js";
+//# sourceMappingURL=index.js.map

package/lib/module/effects/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["composeTextMotionEffects","createTextMotionEffect","fade","lineReveal","pulse","rise","scale","shake","slide","typewriter"],"sourceRoot":"../../../src","sources":["effects/index.ts"],"mappings":";;AAAA,SAASA,wBAAwB,EAAEC,sBAAsB,QAAQ,cAAW;AAC5E,SAASC,IAAI,QAA0B,WAAQ;AAC/C,SAASC,UAAU,QAAgC,iBAAc;AACjE,SAASC,KAAK,QAA2B,YAAS;AAClD,SAASC,IAAI,QAA0B,WAAQ;AAC/C,SAASC,KAAK,QAA2B,YAAS;AAClD,SAASC,KAAK,QAA2B,YAAS;AAClD,SAASC,KAAK,QAA2B,YAAS;AAClD,SAASC,UAAU,QAAQ,iBAAc","ignoreList":[]}

package/lib/module/effects/lineReveal.js

@@ -0,0 +1,17 @@
+"use strict";
+
+import { createTextMotionRendererCapability } from "../types/renderer.js";
+import { createTextMotionEffect } from "./compose.js";
+import { validateFiniteEffectNumber } from "./validation.js";
+const LINE_MASK_CAPABILITY = createTextMotionRendererCapability('line-mask');
+
+/** Options for {@link lineReveal}. */
+
+/** Reveal each React Native rendered line through an `overlayText()` line mask. */
+export function lineReveal(options = {}) {
+  return createTextMotionEffect('lineReveal', {
+    fromOpacity: validateFiniteEffectNumber(options.fromOpacity ?? 0, 'lineReveal fromOpacity'),
+    y: validateFiniteEffectNumber(options.y ?? 16, 'lineReveal y')
+  }, [LINE_MASK_CAPABILITY, 'style-transform']);
+}
+//# sourceMappingURL=lineReveal.js.map

package/lib/module/effects/lineReveal.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createTextMotionRendererCapability","createTextMotionEffect","validateFiniteEffectNumber","LINE_MASK_CAPABILITY","lineReveal","options","fromOpacity","y"],"sourceRoot":"../../../src","sources":["effects/lineReveal.ts"],"mappings":";;AAEA,SAASA,kCAAkC,QAAQ,sBAAmB;AACtE,SAASC,sBAAsB,QAAQ,cAAW;AAClD,SAASC,0BAA0B,QAAQ,iBAAc;AAEzD,MAAMC,oBAAkD,GACtDH,kCAAkC,CAAC,WAAW,CAAC;;AAEjD;;AAQA;AACA,OAAO,SAASI,UAAUA,CAACC,OAA0B,GAAG,CAAC,CAAC,EAAE;EAC1D,OAAOJ,sBAAsB,CAC3B,YAAY,EACZ;IACEK,WAAW,EAAEJ,0BAA0B,CAACG,OAAO,CAACC,WAAW,IAAI,CAAC,EAAE,wBAAwB,CAAC;IAC3FC,CAAC,EAAEL,0BAA0B,CAACG,OAAO,CAACE,CAAC,IAAI,EAAE,EAAE,cAAc;EAC/D,CAAC,EACD,CAACJ,oBAAoB,EAAE,iBAAiB,CAC1C,CAAC;AACH","ignoreList":[]}

package/lib/module/effects/pulse.js

@@ -0,0 +1,14 @@
+"use strict";
+
+import { createTextMotionEffect } from "./compose.js";
+import { validateFiniteEffectNumber } from "./validation.js";
+
+/** Options for {@link pulse}. */
+
+/** Briefly emphasize each token by scaling it up and returning to its final scale. */
+export function pulse(options = {}) {
+  return createTextMotionEffect('pulse', {
+    scale: validateFiniteEffectNumber(options.scale ?? 1.04, 'pulse scale')
+  }, ['style-transform']);
+}
+//# sourceMappingURL=pulse.js.map

package/lib/module/effects/pulse.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createTextMotionEffect","validateFiniteEffectNumber","pulse","options","scale"],"sourceRoot":"../../../src","sources":["effects/pulse.ts"],"mappings":";;AAAA,SAASA,sBAAsB,QAAQ,cAAW;AAClD,SAASC,0BAA0B,QAAQ,iBAAc;;AAEzD;;AAMA;AACA,OAAO,SAASC,KAAKA,CAACC,OAAqB,GAAG,CAAC,CAAC,EAAE;EAChD,OAAOH,sBAAsB,CAC3B,OAAO,EACP;IACEI,KAAK,EAAEH,0BAA0B,CAACE,OAAO,CAACC,KAAK,IAAI,IAAI,EAAE,aAAa;EACxE,CAAC,EACD,CAAC,iBAAiB,CACpB,CAAC;AACH","ignoreList":[]}

package/lib/module/effects/rise.js

@@ -0,0 +1,14 @@
+"use strict";
+
+import { createTextMotionEffect } from "./compose.js";
+import { validateFiniteEffectNumber } from "./validation.js";
+
+/** Options for {@link rise}. */
+
+/** Move each token upward from a vertical offset. */
+export function rise(options = {}) {
+  return createTextMotionEffect('rise', {
+    y: validateFiniteEffectNumber(options.y ?? 12, 'rise y')
+  }, ['style-transform']);
+}
+//# sourceMappingURL=rise.js.map

package/lib/module/effects/rise.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createTextMotionEffect","validateFiniteEffectNumber","rise","options","y"],"sourceRoot":"../../../src","sources":["effects/rise.ts"],"mappings":";;AAAA,SAASA,sBAAsB,QAAQ,cAAW;AAClD,SAASC,0BAA0B,QAAQ,iBAAc;;AAEzD;;AAMA;AACA,OAAO,SAASC,IAAIA,CAACC,OAAoB,GAAG,CAAC,CAAC,EAAE;EAC9C,OAAOH,sBAAsB,CAC3B,MAAM,EACN;IACEI,CAAC,EAAEH,0BAA0B,CAACE,OAAO,CAACC,CAAC,IAAI,EAAE,EAAE,QAAQ;EACzD,CAAC,EACD,CAAC,iBAAiB,CACpB,CAAC;AACH","ignoreList":[]}

package/lib/module/effects/scale.js

@@ -0,0 +1,15 @@
+"use strict";
+
+import { createTextMotionEffect } from "./compose.js";
+import { validateFiniteEffectNumber } from "./validation.js";
+
+/** Options for {@link scale}. */
+
+/** Scale each token between two scale values. */
+export function scale(options = {}) {
+  return createTextMotionEffect('scale', {
+    from: validateFiniteEffectNumber(options.from ?? 0.96, 'scale from'),
+    to: validateFiniteEffectNumber(options.to ?? 1, 'scale to')
+  }, ['style-transform']);
+}
+//# sourceMappingURL=scale.js.map

package/lib/module/effects/scale.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createTextMotionEffect","validateFiniteEffectNumber","scale","options","from","to"],"sourceRoot":"../../../src","sources":["effects/scale.ts"],"mappings":";;AAAA,SAASA,sBAAsB,QAAQ,cAAW;AAClD,SAASC,0BAA0B,QAAQ,iBAAc;;AAEzD;;AAQA;AACA,OAAO,SAASC,KAAKA,CAACC,OAAqB,GAAG,CAAC,CAAC,EAAE;EAChD,OAAOH,sBAAsB,CAC3B,OAAO,EACP;IACEI,IAAI,EAAEH,0BAA0B,CAACE,OAAO,CAACC,IAAI,IAAI,IAAI,EAAE,YAAY,CAAC;IACpEC,EAAE,EAAEJ,0BAA0B,CAACE,OAAO,CAACE,EAAE,IAAI,CAAC,EAAE,UAAU;EAC5D,CAAC,EACD,CAAC,iBAAiB,CACpB,CAAC;AACH","ignoreList":[]}

package/lib/module/effects/shake.js

@@ -0,0 +1,14 @@
+"use strict";
+
+import { createTextMotionEffect } from "./compose.js";
+import { validateFiniteEffectNumber } from "./validation.js";
+
+/** Options for {@link shake}. */
+
+/** Offset each token horizontally for a shake-like entrance. */
+export function shake(options = {}) {
+  return createTextMotionEffect('shake', {
+    x: validateFiniteEffectNumber(options.x ?? 4, 'shake x')
+  }, ['style-transform']);
+}
+//# sourceMappingURL=shake.js.map

package/lib/module/effects/shake.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createTextMotionEffect","validateFiniteEffectNumber","shake","options","x"],"sourceRoot":"../../../src","sources":["effects/shake.ts"],"mappings":";;AAAA,SAASA,sBAAsB,QAAQ,cAAW;AAClD,SAASC,0BAA0B,QAAQ,iBAAc;;AAEzD;;AAMA;AACA,OAAO,SAASC,KAAKA,CAACC,OAAqB,GAAG,CAAC,CAAC,EAAE;EAChD,OAAOH,sBAAsB,CAC3B,OAAO,EACP;IACEI,CAAC,EAAEH,0BAA0B,CAACE,OAAO,CAACC,CAAC,IAAI,CAAC,EAAE,SAAS;EACzD,CAAC,EACD,CAAC,iBAAiB,CACpB,CAAC;AACH","ignoreList":[]}

package/lib/module/effects/slide.js

@@ -0,0 +1,15 @@
+"use strict";
+
+import { createTextMotionEffect } from "./compose.js";
+import { validateFiniteEffectNumber } from "./validation.js";
+
+/** Options for {@link slide}. */
+
+/** Move each token from an x/y offset into place. */
+export function slide(options = {}) {
+  return createTextMotionEffect('slide', {
+    x: validateFiniteEffectNumber(options.x ?? 0, 'slide x'),
+    y: validateFiniteEffectNumber(options.y ?? 12, 'slide y')
+  }, ['style-transform']);
+}
+//# sourceMappingURL=slide.js.map

package/lib/module/effects/slide.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createTextMotionEffect","validateFiniteEffectNumber","slide","options","x","y"],"sourceRoot":"../../../src","sources":["effects/slide.ts"],"mappings":";;AAAA,SAASA,sBAAsB,QAAQ,cAAW;AAClD,SAASC,0BAA0B,QAAQ,iBAAc;;AAEzD;;AAQA;AACA,OAAO,SAASC,KAAKA,CAACC,OAAqB,GAAG,CAAC,CAAC,EAAE;EAChD,OAAOH,sBAAsB,CAC3B,OAAO,EACP;IACEI,CAAC,EAAEH,0BAA0B,CAACE,OAAO,CAACC,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IACxDC,CAAC,EAAEJ,0BAA0B,CAACE,OAAO,CAACE,CAAC,IAAI,EAAE,EAAE,SAAS;EAC1D,CAAC,EACD,CAAC,iBAAiB,CACpB,CAAC;AACH","ignoreList":[]}