@cntrl-site/sdk-nextjs 1.9.52 → 1.9.53

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 (134) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +4 -4
  3. package/TODO.md +1 -1
  4. package/eslint.config.mjs +35 -35
  5. package/jest.config.js +6 -6
  6. package/lib/common/useItemFXData.js +7 -7
  7. package/lib/components/Article.js +5 -5
  8. package/lib/components/LayoutStyle.js +4 -4
  9. package/lib/components/ScrollPlaybackVideo.js +5 -3
  10. package/lib/components/Section/Section.js +27 -27
  11. package/lib/components/items/CodeEmbedItem/CodeEmbedItem.js +36 -36
  12. package/lib/components/items/ComponentItem/ComponentItem.js +13 -13
  13. package/lib/components/items/CompoundItem/CompoundChild.js +20 -20
  14. package/lib/components/items/CompoundItem/CompoundItem.js +14 -14
  15. package/lib/components/items/CustomItem/CustomItem.js +9 -9
  16. package/lib/components/items/EmbedVideoItem/VimeoEmbed.js +24 -24
  17. package/lib/components/items/EmbedVideoItem/YoutubeEmbed.js +27 -27
  18. package/lib/components/items/FileItem/ImageItem.js +40 -40
  19. package/lib/components/items/FileItem/VideoItem.js +77 -76
  20. package/lib/components/items/GroupItem/GroupItem.js +14 -14
  21. package/lib/components/items/Item.js +30 -30
  22. package/lib/components/items/RectangleItem/RectangleItem.js +27 -27
  23. package/lib/components/items/RichTextItem/RichTextItem.js +22 -22
  24. package/lib/utils/RichTextConverter/RichTextConverter.js +21 -21
  25. package/package.json +61 -60
  26. package/src/ItemGeometry/CSSPropertyNameMap.ts +37 -37
  27. package/src/ItemGeometry/GenericGeometryController.ts +59 -59
  28. package/src/ItemGeometry/ItemGeometryContext.ts +4 -4
  29. package/src/ItemGeometry/ItemGeometryController.ts +22 -22
  30. package/src/ItemGeometry/ItemGeometryService.ts +34 -34
  31. package/src/ItemGeometry/RichTextGeometryController.ts +166 -166
  32. package/src/ItemGeometry/useItemGeometry.ts +25 -25
  33. package/src/common/useCurrentLayout.ts +52 -52
  34. package/src/common/useExemplary.ts +9 -9
  35. package/src/common/useItemFXData.ts +47 -47
  36. package/src/common/useKeyframeValue.ts +85 -85
  37. package/src/common/useRegisterResize.ts +16 -16
  38. package/src/components/Article.tsx +75 -75
  39. package/src/components/ArticleWrapper.tsx +21 -21
  40. package/src/components/Head.tsx +57 -57
  41. package/src/components/LayoutStyle.tsx +21 -21
  42. package/src/components/Page.tsx +38 -38
  43. package/src/components/ScrollPlaybackVideo.tsx +58 -56
  44. package/src/components/Section/Section.tsx +129 -129
  45. package/src/components/Section/SectionImage.tsx +48 -48
  46. package/src/components/Section/SectionVideo.tsx +144 -144
  47. package/src/components/Section/useSectionColor.ts +19 -19
  48. package/src/components/Section/useSectionHeightMap.ts +19 -19
  49. package/src/components/items/CodeEmbedItem/CodeEmbedItem.tsx +147 -147
  50. package/src/components/items/CodeEmbedItem/useCodeEmbedItem.ts +36 -36
  51. package/src/components/items/ComponentItem/ComponentItem.tsx +72 -72
  52. package/src/components/items/ComponentItem/useComponentItem.ts +35 -35
  53. package/src/components/items/CompoundItem/CompoundChild.tsx +150 -150
  54. package/src/components/items/CompoundItem/CompoundItem.tsx +87 -87
  55. package/src/components/items/CompoundItem/useCompoundItem.ts +21 -21
  56. package/src/components/items/CustomItem/CustomItem.tsx +50 -50
  57. package/src/components/items/EmbedVideoItem/VimeoEmbed.tsx +216 -216
  58. package/src/components/items/EmbedVideoItem/YoutubeEmbed.tsx +200 -200
  59. package/src/components/items/EmbedVideoItem/useEmbedVideoItem.ts +46 -46
  60. package/src/components/items/FileItem/ImageItem.tsx +165 -165
  61. package/src/components/items/FileItem/VideoItem.tsx +283 -282
  62. package/src/components/items/FileItem/useFileItem.ts +81 -81
  63. package/src/components/items/GroupItem/GroupItem.tsx +98 -98
  64. package/src/components/items/GroupItem/useGroupItem.ts +34 -34
  65. package/src/components/items/Item.tsx +267 -267
  66. package/src/components/items/LinkWrapper.tsx +39 -39
  67. package/src/components/items/RectangleItem/RectangleItem.tsx +176 -176
  68. package/src/components/items/RectangleItem/useRectangleItem.ts +89 -89
  69. package/src/components/items/RichTextItem/RichTextItem.tsx +112 -112
  70. package/src/components/items/RichTextItem/useRichTextItem.ts +12 -12
  71. package/src/components/items/RichTextWrapper.tsx +15 -15
  72. package/src/components/items/itemsMap.ts +28 -28
  73. package/src/components/items/useDraggable.ts +252 -252
  74. package/src/components/items/useItemAngle.ts +13 -13
  75. package/src/components/items/useItemArea.ts +35 -35
  76. package/src/components/items/useItemPointerEvents.ts +23 -23
  77. package/src/components/items/useItemScale.ts +17 -17
  78. package/src/components/items/useItemTriggers.ts +15 -15
  79. package/src/components/items/useRichTextItemValues.ts +66 -66
  80. package/src/components/items/useSizing.ts +25 -25
  81. package/src/components/items/useStickyItemTop.ts +21 -21
  82. package/src/components/useLayoutContext.ts +7 -7
  83. package/src/index.ts +24 -24
  84. package/src/interactions/InteractionsRegistry.ts +512 -512
  85. package/src/interactions/ItemInteractionCtrl.ts +78 -78
  86. package/src/interactions/getTransition.ts +27 -27
  87. package/src/interactions/types.ts +36 -36
  88. package/src/interactions/useItemInteractionCtrl.ts +18 -18
  89. package/src/provider/ArticleRectContext.ts +4 -4
  90. package/src/provider/CntrlContext.ts +5 -5
  91. package/src/provider/CntrlProvider.tsx +11 -11
  92. package/src/provider/CntrlSdkContext.ts +84 -84
  93. package/src/provider/CustomItemRegistry.ts +14 -14
  94. package/src/provider/CustomItemTypes.ts +3 -3
  95. package/src/provider/CustomSectionRegistry.ts +25 -25
  96. package/src/provider/InteractionsContext.tsx +73 -73
  97. package/src/provider/Keyframes.ts +11 -11
  98. package/src/provider/KeyframesContext.ts +5 -5
  99. package/src/provider/LayoutContext.ts +3 -3
  100. package/src/provider/WebGLContextManagerContext.tsx +4 -4
  101. package/src/provider/defaultContext.ts +8 -8
  102. package/src/provider/useCntrlContext.ts +8 -8
  103. package/src/styled-jsx.d.ts +1 -1
  104. package/src/utils/Animator/Animator.ts +570 -570
  105. package/src/utils/ArticleRectManager/ArticleRectObserver.ts +93 -93
  106. package/src/utils/ArticleRectManager/useArticleRectObserver.ts +17 -17
  107. package/src/utils/ArticleRectManager/useSectionRegistry.ts +11 -11
  108. package/src/utils/CSSNumeric.ts +19 -19
  109. package/src/utils/EventEmitter.ts +41 -41
  110. package/src/utils/RichTextConverter/RichTextConverter.tsx +342 -342
  111. package/src/utils/ScaleAnchorMap.ts +13 -13
  112. package/src/utils/StickyManager/StickyManager.ts +23 -23
  113. package/src/utils/Youtube/YouTubeIframeApiLoader.ts +58 -58
  114. package/src/utils/Youtube/YoutubeIframeApi.ts +101 -101
  115. package/src/utils/Youtube/useYouTubeIframeApi.ts +12 -12
  116. package/src/utils/areFillsVisible/areFillsVisible.test.ts +63 -63
  117. package/src/utils/areFillsVisible/areFillsVisible.ts +37 -37
  118. package/src/utils/binSearchInsertAt.ts +33 -33
  119. package/src/utils/castObject.ts +10 -10
  120. package/src/utils/checkOverflowClipSupport.ts +13 -13
  121. package/src/utils/domDfs.ts +11 -11
  122. package/src/utils/effects/useImageFx.ts +156 -156
  123. package/src/utils/effects/useVideoFx.ts +158 -158
  124. package/src/utils/getAnchoredItemTop.ts +12 -12
  125. package/src/utils/getCompoundBoundaryStyles.ts +60 -60
  126. package/src/utils/getFill.ts +46 -46
  127. package/src/utils/getFontFamilyValue.ts +3 -3
  128. package/src/utils/getInvertedRanges.ts +43 -43
  129. package/src/utils/getItemTopStyle.ts +39 -39
  130. package/src/utils/getStyleFromItemStateAndParams.ts +8 -8
  131. package/src/utils/getValidYoutubeUrl.ts +29 -29
  132. package/src/utils/isItemType.ts +5 -5
  133. package/src/utils/rangeMap.ts +13 -13
  134. package/src/utils/useElementRect.ts +23 -23
@@ -1,39 +1,39 @@
1
- import { AnchorSide } from '@cntrl-site/sdk';
2
-
3
- function getAnchorSideShift(anchorSide: AnchorSide, height?: number) {
4
- if (!height) return 0;
5
- switch (anchorSide) {
6
- case AnchorSide.Center:
7
- return height / 2;
8
- case AnchorSide.Bottom:
9
- return height;
10
- default:
11
- return 0;
12
- }
13
- }
14
-
15
- export function getPercentageBasedTopStyle(top: number, height?: number, anchorSide?: AnchorSide) {
16
- const defaultValue = `${top * 100}vw`;
17
- if (!anchorSide) return defaultValue;
18
- switch (anchorSide) {
19
- case AnchorSide.Top:
20
- return defaultValue;
21
- case AnchorSide.Center:
22
- return `calc(50% + ${top * 100}vw - ${getAnchorSideShift(anchorSide, height)}vh)`;
23
- case AnchorSide.Bottom:
24
- return `calc(100% + ${top * 100}vw - ${getAnchorSideShift(anchorSide, height)}vh)`;
25
- }
26
- }
27
-
28
- export function getItemTopStyle(top: number, anchorSide?: AnchorSide) {
29
- const defaultValue = `${top * 100}vw`;
30
- if (!anchorSide) return defaultValue;
31
- switch (anchorSide) {
32
- case AnchorSide.Top:
33
- return defaultValue;
34
- case AnchorSide.Center:
35
- return `calc(50% + ${top * 100}vw)`;
36
- case AnchorSide.Bottom:
37
- return `calc(100% + ${top * 100}vw)`;
38
- }
39
- }
1
+ import { AnchorSide } from '@cntrl-site/sdk';
2
+
3
+ function getAnchorSideShift(anchorSide: AnchorSide, height?: number) {
4
+ if (!height) return 0;
5
+ switch (anchorSide) {
6
+ case AnchorSide.Center:
7
+ return height / 2;
8
+ case AnchorSide.Bottom:
9
+ return height;
10
+ default:
11
+ return 0;
12
+ }
13
+ }
14
+
15
+ export function getPercentageBasedTopStyle(top: number, height?: number, anchorSide?: AnchorSide) {
16
+ const defaultValue = `${top * 100}vw`;
17
+ if (!anchorSide) return defaultValue;
18
+ switch (anchorSide) {
19
+ case AnchorSide.Top:
20
+ return defaultValue;
21
+ case AnchorSide.Center:
22
+ return `calc(50% + ${top * 100}vw - ${getAnchorSideShift(anchorSide, height)}vh)`;
23
+ case AnchorSide.Bottom:
24
+ return `calc(100% + ${top * 100}vw - ${getAnchorSideShift(anchorSide, height)}vh)`;
25
+ }
26
+ }
27
+
28
+ export function getItemTopStyle(top: number, anchorSide?: AnchorSide) {
29
+ const defaultValue = `${top * 100}vw`;
30
+ if (!anchorSide) return defaultValue;
31
+ switch (anchorSide) {
32
+ case AnchorSide.Top:
33
+ return defaultValue;
34
+ case AnchorSide.Center:
35
+ return `calc(50% + ${top * 100}vw)`;
36
+ case AnchorSide.Bottom:
37
+ return `calc(100% + ${top * 100}vw)`;
38
+ }
39
+ }
@@ -1,8 +1,8 @@
1
- export function getStyleFromItemStateAndParams<T>(
2
- stateValue: T | undefined,
3
- paramsValue: T | undefined
4
- ): T | undefined {
5
- return (stateValue as T) !== undefined
6
- ? stateValue as T
7
- : paramsValue;
8
- }
1
+ export function getStyleFromItemStateAndParams<T>(
2
+ stateValue: T | undefined,
3
+ paramsValue: T | undefined
4
+ ): T | undefined {
5
+ return (stateValue as T) !== undefined
6
+ ? stateValue as T
7
+ : paramsValue;
8
+ }
@@ -1,29 +1,29 @@
1
- enum Allowed {
2
- Tiny = 'youtu.be',
3
- Full = 'www.youtube.com'
4
- }
5
-
6
- export function getYoutubeId({ hostname, pathname, search }: URL): string {
7
- if (hostname !== Allowed.Full && hostname !== Allowed.Tiny) {
8
- throw new Error(`Cannot get valid YouTube ID from "${hostname}" - address is not whitelisted`);
9
- }
10
- switch (hostname) {
11
- case Allowed.Tiny:
12
- return pathname.replace('/', '');
13
- case Allowed.Full:
14
- if (pathname.startsWith('/shorts/')) {
15
- const shortsId = pathname.split('/shorts/')[1];
16
- if (!shortsId) {
17
- throw new Error('Cannot get valid YouTube Shorts ID from the pathname.');
18
- }
19
- return shortsId;
20
- } else {
21
- const searchParams = new URLSearchParams(search);
22
- const id = searchParams.get('v');
23
- if (!id) {
24
- throw new Error('Cannot get valid YouTube ID from search params.');
25
- }
26
- return id;
27
- }
28
- }
29
- }
1
+ enum Allowed {
2
+ Tiny = 'youtu.be',
3
+ Full = 'www.youtube.com'
4
+ }
5
+
6
+ export function getYoutubeId({ hostname, pathname, search }: URL): string {
7
+ if (hostname !== Allowed.Full && hostname !== Allowed.Tiny) {
8
+ throw new Error(`Cannot get valid YouTube ID from "${hostname}" - address is not whitelisted`);
9
+ }
10
+ switch (hostname) {
11
+ case Allowed.Tiny:
12
+ return pathname.replace('/', '');
13
+ case Allowed.Full:
14
+ if (pathname.startsWith('/shorts/')) {
15
+ const shortsId = pathname.split('/shorts/')[1];
16
+ if (!shortsId) {
17
+ throw new Error('Cannot get valid YouTube Shorts ID from the pathname.');
18
+ }
19
+ return shortsId;
20
+ } else {
21
+ const searchParams = new URLSearchParams(search);
22
+ const id = searchParams.get('v');
23
+ if (!id) {
24
+ throw new Error('Cannot get valid YouTube ID from search params.');
25
+ }
26
+ return id;
27
+ }
28
+ }
29
+ }
@@ -1,5 +1,5 @@
1
- import { ArticleItemType, ItemAny, Item as TItem } from '@cntrl-site/sdk';
2
-
3
- export function isItemType<T extends ArticleItemType>(item: ItemAny, itemType: T): item is TItem<T> {
4
- return item.type === itemType;
5
- }
1
+ import { ArticleItemType, ItemAny, Item as TItem } from '@cntrl-site/sdk';
2
+
3
+ export function isItemType<T extends ArticleItemType>(item: ItemAny, itemType: T): item is TItem<T> {
4
+ return item.type === itemType;
5
+ }
@@ -1,13 +1,13 @@
1
- export function rangeMap(
2
- n: number,
3
- start1: number,
4
- stop1: number,
5
- start2: number,
6
- stop2: number,
7
- withinBounds: boolean = false
8
- ): number {
9
- const mapped = (n - start1) / (stop1 - start1) * (stop2 - start2) + start2;
10
- if (withinBounds && n < start1) return start2;
11
- if (withinBounds && n > stop1) return stop2;
12
- return mapped;
13
- }
1
+ export function rangeMap(
2
+ n: number,
3
+ start1: number,
4
+ stop1: number,
5
+ start2: number,
6
+ stop2: number,
7
+ withinBounds: boolean = false
8
+ ): number {
9
+ const mapped = (n - start1) / (stop1 - start1) * (stop2 - start2) + start2;
10
+ if (withinBounds && n < start1) return start2;
11
+ if (withinBounds && n > stop1) return stop2;
12
+ return mapped;
13
+ }
@@ -1,23 +1,23 @@
1
- import { useEffect, useState } from 'react';
2
-
3
- export function useElementRect(element: HTMLElement | null): DOMRect | undefined {
4
- const [rect, setRect] = useState<DOMRect | undefined>(() => element?.getBoundingClientRect());
5
-
6
- useEffect(() => {
7
- if (!element) return;
8
- const observer = new ResizeObserver(entries => {
9
- const el = entries.find(entry => entry.target === element);
10
- if (!el) {
11
- throw new Error('Element is not found in observed entries');
12
- }
13
- setRect(el.target.getBoundingClientRect());
14
- });
15
- observer.observe(element);
16
- return () => {
17
- observer.unobserve(element);
18
- observer.disconnect();
19
- };
20
- }, [element]);
21
-
22
- return rect;
23
- }
1
+ import { useEffect, useState } from 'react';
2
+
3
+ export function useElementRect(element: HTMLElement | null): DOMRect | undefined {
4
+ const [rect, setRect] = useState<DOMRect | undefined>(() => element?.getBoundingClientRect());
5
+
6
+ useEffect(() => {
7
+ if (!element) return;
8
+ const observer = new ResizeObserver(entries => {
9
+ const el = entries.find(entry => entry.target === element);
10
+ if (!el) {
11
+ throw new Error('Element is not found in observed entries');
12
+ }
13
+ setRect(el.target.getBoundingClientRect());
14
+ });
15
+ observer.observe(element);
16
+ return () => {
17
+ observer.unobserve(element);
18
+ observer.disconnect();
19
+ };
20
+ }, [element]);
21
+
22
+ return rect;
23
+ }