react-native-theme-transition 1.0.7 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (66) hide show
  1. package/README.md +55 -43
  2. package/README.npm.md +55 -43
  3. package/dist/constants.d.ts +1 -2
  4. package/dist/constants.d.ts.map +1 -1
  5. package/dist/constants.js +4 -0
  6. package/dist/constants.js.map +1 -1
  7. package/dist/createThemeTransition.d.ts +6 -18
  8. package/dist/createThemeTransition.d.ts.map +1 -1
  9. package/dist/createThemeTransition.js +37 -35
  10. package/dist/createThemeTransition.js.map +1 -1
  11. package/dist/index.d.ts +9 -9
  12. package/dist/index.d.ts.map +1 -1
  13. package/dist/index.js +8 -8
  14. package/dist/index.js.map +1 -1
  15. package/dist/overlay/SkiaOverlay.d.ts +17 -0
  16. package/dist/overlay/SkiaOverlay.d.ts.map +1 -0
  17. package/dist/overlay/SkiaOverlay.js +297 -0
  18. package/dist/overlay/SkiaOverlay.js.map +1 -0
  19. package/dist/overlay/captureView.d.ts +7 -0
  20. package/dist/overlay/captureView.d.ts.map +1 -0
  21. package/dist/overlay/captureView.js +31 -0
  22. package/dist/overlay/captureView.js.map +1 -0
  23. package/dist/overlay/resolveOrigin.d.ts +8 -0
  24. package/dist/overlay/resolveOrigin.d.ts.map +1 -0
  25. package/dist/overlay/resolveOrigin.js +68 -0
  26. package/dist/overlay/resolveOrigin.js.map +1 -0
  27. package/dist/overlay/types.d.ts +15 -0
  28. package/dist/overlay/types.d.ts.map +1 -0
  29. package/dist/overlay/types.js +61 -0
  30. package/dist/overlay/types.js.map +1 -0
  31. package/dist/setThemeDecision.d.ts +14 -0
  32. package/dist/setThemeDecision.d.ts.map +1 -0
  33. package/dist/setThemeDecision.js +27 -0
  34. package/dist/setThemeDecision.js.map +1 -0
  35. package/dist/transitionEngine.d.ts +48 -17
  36. package/dist/transitionEngine.d.ts.map +1 -1
  37. package/dist/transitionEngine.js +273 -210
  38. package/dist/transitionEngine.js.map +1 -1
  39. package/dist/transitionMeta.d.ts +136 -0
  40. package/dist/transitionMeta.d.ts.map +1 -0
  41. package/dist/transitionMeta.js +131 -0
  42. package/dist/transitionMeta.js.map +1 -0
  43. package/dist/types.d.ts +254 -193
  44. package/dist/types.d.ts.map +1 -1
  45. package/dist/validateSetThemeOptions.d.ts +15 -0
  46. package/dist/validateSetThemeOptions.d.ts.map +1 -0
  47. package/dist/validateSetThemeOptions.js +54 -0
  48. package/dist/validateSetThemeOptions.js.map +1 -0
  49. package/package.json +14 -6
  50. package/src/constants.ts +6 -0
  51. package/src/createThemeTransition.ts +57 -39
  52. package/src/index.ts +12 -9
  53. package/src/overlay/SkiaOverlay.tsx +629 -0
  54. package/src/overlay/captureView.ts +32 -0
  55. package/src/overlay/resolveOrigin.ts +81 -0
  56. package/src/overlay/types.ts +83 -0
  57. package/src/setThemeDecision.ts +48 -0
  58. package/src/transitionEngine.tsx +383 -249
  59. package/src/transitionMeta.ts +176 -0
  60. package/src/types.ts +272 -193
  61. package/src/validateSetThemeOptions.ts +76 -0
  62. package/dist/hooks/useTheme.d.ts +0 -14
  63. package/dist/hooks/useTheme.d.ts.map +0 -1
  64. package/dist/hooks/useTheme.js +0 -46
  65. package/dist/hooks/useTheme.js.map +0 -1
  66. package/src/hooks/useTheme.ts +0 -72
@@ -1 +0,0 @@
1
- {"version":3,"file":"useTheme.d.ts","sourceRoot":"","sources":["../../src/hooks/useTheme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAGpC,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EACV,oBAAoB,EACpB,UAAU,EACV,cAAc,EACf,MAAM,UAAU,CAAA;AAEjB;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EACtE,GAAG,EAAE,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;;cAQtC;QAAE,gBAAgB,CAAC,EAAE,gBAAQ,QAAQ,CAAA;KAAE;EA8CnE"}
@@ -1,46 +0,0 @@
1
- import { useCallback, useContext, useEffect, useMemo, useRef, useState } from 'react';
2
- import { TAG } from '../constants';
3
- /**
4
- * Factory that produces the `useTheme` hook bound to a specific context.
5
- *
6
- * @internal Used by {@link createThemeTransition}; not part of the public API.
7
- */
8
- export function createUseTheme(Ctx) {
9
- function useTheme(options) {
10
- const ctx = useContext(Ctx);
11
- if (!ctx) {
12
- throw new Error(`${TAG} \`useTheme\` must be used inside a \`ThemeTransitionProvider\`.`);
13
- }
14
- const { setTheme, isTransitioning } = ctx;
15
- // Always called (rules of hooks) — only exposed when options are provided.
16
- const [selected, setSelected] = useState(() => options?.initialSelection ?? ctx.name);
17
- const pressLockRef = useRef(false);
18
- // Ref avoids `selected` as a dependency — keeps `select` stable across renders.
19
- const selectedRef = useRef(selected);
20
- selectedRef.current = selected;
21
- useEffect(() => {
22
- if (!isTransitioning)
23
- pressLockRef.current = false;
24
- }, [isTransitioning]);
25
- const select = useCallback((option) => {
26
- if (pressLockRef.current)
27
- return;
28
- pressLockRef.current = true;
29
- const previousSelected = selectedRef.current;
30
- // Paint highlight first — deferred setTheme lets React commit before capture.
31
- setSelected(option);
32
- requestAnimationFrame(() => {
33
- if (!setTheme(option))
34
- setSelected(previousSelected);
35
- pressLockRef.current = false;
36
- });
37
- }, [setTheme]);
38
- const selectionResult = useMemo(() => ({ ...ctx, selected, select }), [ctx, selected, select]);
39
- if (options != null) {
40
- return selectionResult;
41
- }
42
- return ctx;
43
- }
44
- return useTheme;
45
- }
46
- //# sourceMappingURL=useTheme.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"useTheme.js","sourceRoot":"","sources":["../../src/hooks/useTheme.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AACrF,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AASlC;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,GAAiE;IASjE,SAAS,QAAQ,CAAC,OAAiD;QACjE,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,CAAA;QAC3B,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,kEAAkE,CAAC,CAAA;QAC3F,CAAC;QAED,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,GAAG,GAAG,CAAA;QAEzC,2EAA2E;QAC3E,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CACtC,GAAG,EAAE,CAAC,OAAO,EAAE,gBAAgB,IAAI,GAAG,CAAC,IAAI,CAC5C,CAAA;QACD,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;QAClC,gFAAgF;QAChF,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;QACpC,WAAW,CAAC,OAAO,GAAG,QAAQ,CAAA;QAE9B,SAAS,CAAC,GAAG,EAAE;YACb,IAAI,CAAC,eAAe;gBAAE,YAAY,CAAC,OAAO,GAAG,KAAK,CAAA;QACpD,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC,CAAA;QAErB,MAAM,MAAM,GAAG,WAAW,CACxB,CAAC,MAAwB,EAAE,EAAE;YAC3B,IAAI,YAAY,CAAC,OAAO;gBAAE,OAAM;YAChC,YAAY,CAAC,OAAO,GAAG,IAAI,CAAA;YAC3B,MAAM,gBAAgB,GAAG,WAAW,CAAC,OAAO,CAAA;YAC5C,8EAA8E;YAC9E,WAAW,CAAC,MAAM,CAAC,CAAA;YACnB,qBAAqB,CAAC,GAAG,EAAE;gBACzB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;oBAAE,WAAW,CAAC,gBAAgB,CAAC,CAAA;gBACpD,YAAY,CAAC,OAAO,GAAG,KAAK,CAAA;YAC9B,CAAC,CAAC,CAAA;QACJ,CAAC,EACD,CAAC,QAAQ,CAAC,CACX,CAAA;QAED,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAA;QAE9F,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;YACpB,OAAO,eAAe,CAAA;QACxB,CAAC;QACD,OAAO,GAAG,CAAA;IACZ,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC"}
@@ -1,72 +0,0 @@
1
- import type { Context } from 'react'
2
- import { useCallback, useContext, useEffect, useMemo, useRef, useState } from 'react'
3
- import { TAG } from '../constants'
4
- import type {
5
- ThemeDefinition,
6
- ThemeNames,
7
- ThemeSelectionResult,
8
- TokenNames,
9
- UseThemeResult,
10
- } from '../types'
11
-
12
- /**
13
- * Factory that produces the `useTheme` hook bound to a specific context.
14
- *
15
- * @internal Used by {@link createThemeTransition}; not part of the public API.
16
- */
17
- export function createUseTheme<T extends Record<string, ThemeDefinition>>(
18
- Ctx: Context<UseThemeResult<TokenNames<T>, ThemeNames<T>> | null>,
19
- ) {
20
- type Tokens = TokenNames<T>
21
- type Names = ThemeNames<T>
22
- type BaseResult = UseThemeResult<Tokens, Names>
23
- type FullResult = BaseResult & ThemeSelectionResult<Names>
24
-
25
- function useTheme(): BaseResult
26
- function useTheme(options: { initialSelection?: Names | 'system' }): FullResult
27
- function useTheme(options?: { initialSelection?: Names | 'system' }): BaseResult | FullResult {
28
- const ctx = useContext(Ctx)
29
- if (!ctx) {
30
- throw new Error(`${TAG} \`useTheme\` must be used inside a \`ThemeTransitionProvider\`.`)
31
- }
32
-
33
- const { setTheme, isTransitioning } = ctx
34
-
35
- // Always called (rules of hooks) — only exposed when options are provided.
36
- const [selected, setSelected] = useState<Names | 'system'>(
37
- () => options?.initialSelection ?? ctx.name,
38
- )
39
- const pressLockRef = useRef(false)
40
- // Ref avoids `selected` as a dependency — keeps `select` stable across renders.
41
- const selectedRef = useRef(selected)
42
- selectedRef.current = selected
43
-
44
- useEffect(() => {
45
- if (!isTransitioning) pressLockRef.current = false
46
- }, [isTransitioning])
47
-
48
- const select = useCallback(
49
- (option: Names | 'system') => {
50
- if (pressLockRef.current) return
51
- pressLockRef.current = true
52
- const previousSelected = selectedRef.current
53
- // Paint highlight first — deferred setTheme lets React commit before capture.
54
- setSelected(option)
55
- requestAnimationFrame(() => {
56
- if (!setTheme(option)) setSelected(previousSelected)
57
- pressLockRef.current = false
58
- })
59
- },
60
- [setTheme],
61
- )
62
-
63
- const selectionResult = useMemo(() => ({ ...ctx, selected, select }), [ctx, selected, select])
64
-
65
- if (options != null) {
66
- return selectionResult
67
- }
68
- return ctx
69
- }
70
-
71
- return useTheme
72
- }