@kanorio/elements 0.0.0-stage → 1.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 (274) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +57 -2
  3. package/dist/MediaPlayer-MWIDJORE.js +2 -0
  4. package/dist/MediaPlayer-STITRANS.js +13 -0
  5. package/dist/PDFViewerFull-HIUSAO57.js +13 -0
  6. package/dist/PDFViewerFull-L7VMOAMU.js +28062 -0
  7. package/dist/altcha-DSOKKAAV.js +3153 -0
  8. package/dist/altcha-FLBUR2LJ.js +4 -0
  9. package/dist/ar-4CBE4BWH.js +1233 -0
  10. package/dist/ar-6G7ZVSQ3.js +2 -0
  11. package/dist/ar-XCPH4WO5.js +98 -0
  12. package/dist/ar-ZVJL6XGE.js +2 -0
  13. package/dist/bg-4WPFSAMC.js +2 -0
  14. package/dist/bg-BKFL64I6.js +98 -0
  15. package/dist/bg-CB273F4D.js +1233 -0
  16. package/dist/bg-HCH4LMEX.js +2 -0
  17. package/dist/bn-HLYDEXHQ.js +1233 -0
  18. package/dist/bn-HVEVBAGM.js +98 -0
  19. package/dist/bn-OY7YGJIT.js +2 -0
  20. package/dist/bn-XX3O4VQB.js +2 -0
  21. package/dist/chunk-2UBPQBQI.js +1848 -0
  22. package/dist/chunk-5OB57Z46.js +23620 -0
  23. package/dist/chunk-6LJZ4HRF.js +1350 -0
  24. package/dist/chunk-6TUB24LJ.js +415 -0
  25. package/dist/chunk-74RRJOB4.js +15 -0
  26. package/dist/chunk-7TNRMVML.js +2 -0
  27. package/dist/chunk-BH27SBYG.js +2 -0
  28. package/dist/chunk-BQU7QZGC.js +4 -0
  29. package/dist/chunk-CHSZMJ5D.js +15103 -0
  30. package/dist/chunk-DDKQOHPW.js +930 -0
  31. package/dist/chunk-E5ZVE4VL.js +5 -0
  32. package/dist/chunk-FGBB7FT5.js +4 -0
  33. package/dist/chunk-FSH5K5FU.js +57 -0
  34. package/dist/chunk-G3PMV62Z.js +36 -0
  35. package/dist/chunk-IUB5YLUU.js +1538 -0
  36. package/dist/chunk-J7AP6FJF.js +8616 -0
  37. package/dist/chunk-LKOMEUNH.js +72 -0
  38. package/dist/chunk-NB57OIQA.js +2 -0
  39. package/dist/chunk-NLJE74VA.js +2 -0
  40. package/dist/chunk-NQBPWU5Z.js +15 -0
  41. package/dist/chunk-OJQYDPRD.js +39 -0
  42. package/dist/chunk-PDKFEXLU.js +59 -0
  43. package/dist/chunk-POG53MIA.js +2 -0
  44. package/dist/chunk-PXABHOW4.js +10871 -0
  45. package/dist/chunk-QDUG7UMV.js +363 -0
  46. package/dist/chunk-RFBBAUMM.js +2 -0
  47. package/dist/chunk-RJTKNOYT.js +67 -0
  48. package/dist/chunk-VH4656UY.js +2 -0
  49. package/dist/chunk-XAORGJWX.js +2 -0
  50. package/dist/chunk-Y77XXKLY.js +1858 -0
  51. package/dist/cs-EDLILQAV.js +1233 -0
  52. package/dist/cs-EOBDWVFI.js +2 -0
  53. package/dist/cs-Q732FDDB.js +98 -0
  54. package/dist/cs-UO3FC3H4.js +2 -0
  55. package/dist/da-43RMOYSN.js +98 -0
  56. package/dist/da-ANHSL3GD.js +2 -0
  57. package/dist/da-RBW34GCF.js +2 -0
  58. package/dist/da-SJ7YQT4L.js +1233 -0
  59. package/dist/de-2D2GW24Z.js +2 -0
  60. package/dist/de-5WGC4CMF.js +1233 -0
  61. package/dist/de-CPU2ARG7.js +98 -0
  62. package/dist/de-GVWNGUWZ.js +2 -0
  63. package/dist/deliverables-QUJISOBO.js +98 -0
  64. package/dist/deliverables-Z6ZBT6D3.js +2046 -0
  65. package/dist/el-FRNBHLQF.js +98 -0
  66. package/dist/el-HCBWOOCJ.js +1233 -0
  67. package/dist/el-KK7DBDUW.js +2 -0
  68. package/dist/el-SK362ZEN.js +2 -0
  69. package/dist/elements.css +2 -0
  70. package/dist/en-AU-BQA3DX35.js +1233 -0
  71. package/dist/en-AU-VZAXNXRA.js +2 -0
  72. package/dist/en-CA-T2VRZJVQ.js +2 -0
  73. package/dist/en-CA-ZWY5HD2Z.js +1233 -0
  74. package/dist/en-GB-CH3IGZSE.js +1233 -0
  75. package/dist/en-GB-MZQ2MGOR.js +2 -0
  76. package/dist/en-M24TV37U.js +2 -0
  77. package/dist/en-OURP64TI.js +2 -0
  78. package/dist/en-US-VWMNQOMN.js +2 -0
  79. package/dist/en-US-WJZ2OBFI.js +1233 -0
  80. package/dist/en-USCPKTM6.js +1233 -0
  81. package/dist/en-YND44PUO.js +98 -0
  82. package/dist/errors-7SQHRWKX.js +77 -0
  83. package/dist/errors-S6NFCUG2.js +2 -0
  84. package/dist/es-419-EMD4NA5M.js +2 -0
  85. package/dist/es-419-GPBJSXLV.js +2 -0
  86. package/dist/es-419-S6IHEZ4E.js +1233 -0
  87. package/dist/es-419-XPZOWYCA.js +98 -0
  88. package/dist/es-ES-EGMSPSY2.js +1233 -0
  89. package/dist/es-ES-U6NF6JHU.js +2 -0
  90. package/dist/es-es-ILD7QLKC.js +98 -0
  91. package/dist/es-es-MPX25JA6.js +2 -0
  92. package/dist/fa-5J3M6LW4.js +2 -0
  93. package/dist/fa-OC7ZPRF2.js +98 -0
  94. package/dist/fa-OFIO7IXD.js +1233 -0
  95. package/dist/fa-ZTPM4LEB.js +2 -0
  96. package/dist/fi-2V2STXSQ.js +2 -0
  97. package/dist/fi-7J4LPMG2.js +98 -0
  98. package/dist/fi-FMEAITYP.js +1233 -0
  99. package/dist/fi-N3BC4FYB.js +2 -0
  100. package/dist/fr-CA-IKSBTBHG.js +2 -0
  101. package/dist/fr-CA-S23ERMPM.js +1233 -0
  102. package/dist/fr-FR-RRTMSQWD.js +2 -0
  103. package/dist/fr-FR-SOIXFVK2.js +1233 -0
  104. package/dist/fr-ca-SUWTTOEW.js +2 -0
  105. package/dist/fr-ca-UUHAWMHI.js +98 -0
  106. package/dist/fr-fr-SGQ77PBC.js +98 -0
  107. package/dist/fr-fr-XE2V7MKM.js +2 -0
  108. package/dist/gu-RT7GQT5B.js +2 -0
  109. package/dist/gu-Z2QX2VCX.js +1233 -0
  110. package/dist/he-27MBDHSP.js +2 -0
  111. package/dist/he-E7RIZOIT.js +1233 -0
  112. package/dist/he-QGD477CH.js +98 -0
  113. package/dist/he-R3UJFF46.js +2 -0
  114. package/dist/hi-2AVAXR7K.js +1233 -0
  115. package/dist/hi-6ZBMVMGH.js +2 -0
  116. package/dist/hi-SGQH4OWG.js +98 -0
  117. package/dist/hi-XJHFN25N.js +2 -0
  118. package/dist/hls-C5FWCMHH.js +37426 -0
  119. package/dist/hls-ZQNRY2TQ.js +45 -0
  120. package/dist/hu-IOGZTF7L.js +2 -0
  121. package/dist/hu-KNZXJ7ZI.js +98 -0
  122. package/dist/hu-ORVGO3ZY.js +1233 -0
  123. package/dist/hu-PKL3T3JT.js +2 -0
  124. package/dist/id-FKFVQIN6.js +2 -0
  125. package/dist/id-JH2DLDBA.js +98 -0
  126. package/dist/id-TMOJUCBD.js +1233 -0
  127. package/dist/id-WLBO2VOW.js +2 -0
  128. package/dist/index.d.ts +2955 -0
  129. package/dist/index.js +67 -0
  130. package/dist/it-AGUEDSVA.js +2 -0
  131. package/dist/it-PJAB5BQB.js +98 -0
  132. package/dist/it-WF5BTFFJ.js +2 -0
  133. package/dist/it-YMZRYSIJ.js +1233 -0
  134. package/dist/ja-2ZVND7MB.js +2 -0
  135. package/dist/ja-555SY4AF.js +1233 -0
  136. package/dist/ja-RMBJ7E5Z.js +2 -0
  137. package/dist/ja-ZKBUQDUT.js +98 -0
  138. package/dist/kanorio-elements.js +97 -0
  139. package/dist/km-DF366BBP.js +1233 -0
  140. package/dist/km-JIUQ7MSM.js +2 -0
  141. package/dist/kn-KTJPREMQ.js +2 -0
  142. package/dist/kn-MJKASLJD.js +1233 -0
  143. package/dist/ko-CGY75OW4.js +2 -0
  144. package/dist/ko-KECCYX66.js +2 -0
  145. package/dist/ko-L5735TRU.js +98 -0
  146. package/dist/ko-S3OTZKIG.js +1233 -0
  147. package/dist/lo-7R55FKUB.js +1233 -0
  148. package/dist/lo-DNWTAFYF.js +2 -0
  149. package/dist/ml-B4BJPFVQ.js +2 -0
  150. package/dist/ml-FCTNQ4SP.js +1233 -0
  151. package/dist/mr-FJ4EDO7F.js +2 -0
  152. package/dist/mr-TZTFABWX.js +2 -0
  153. package/dist/mr-VZ5Y74YA.js +1233 -0
  154. package/dist/mr-Y464JCKX.js +98 -0
  155. package/dist/ms-VCX47GHB.js +2 -0
  156. package/dist/ms-WAJKD7ZV.js +1233 -0
  157. package/dist/my-S5L32WDK.js +2 -0
  158. package/dist/my-T7Y3Y64H.js +1233 -0
  159. package/dist/nb-53GCFBHF.js +2 -0
  160. package/dist/nb-IJDALVGX.js +99 -0
  161. package/dist/nb-LXBBUZUD.js +1233 -0
  162. package/dist/nb-PWWLEFUC.js +2 -0
  163. package/dist/ne-F7EEIDMA.js +2 -0
  164. package/dist/ne-NDLRKG6T.js +1233 -0
  165. package/dist/nl-262SKC6R.js +98 -0
  166. package/dist/nl-BE-3KOYUD6Y.js +1233 -0
  167. package/dist/nl-BE-VZJDK6CH.js +2 -0
  168. package/dist/nl-NL-3OIKN2DQ.js +2 -0
  169. package/dist/nl-NL-T7SQOLLA.js +1233 -0
  170. package/dist/nl-XKCUNU3P.js +2 -0
  171. package/dist/nn-AHWRAFXZ.js +1233 -0
  172. package/dist/nn-YH7F7UK3.js +2 -0
  173. package/dist/pa-HC24FOUI.js +2 -0
  174. package/dist/pa-J26C5J7M.js +1233 -0
  175. package/dist/pl-QSTOYTPG.js +1233 -0
  176. package/dist/pl-T7J6A26Y.js +2 -0
  177. package/dist/pl-TYHET6JJ.js +2 -0
  178. package/dist/pl-XDJJ6AUG.js +98 -0
  179. package/dist/prod-MRWX5W24.js +38 -0
  180. package/dist/prod-YHXWTKNF.js +2 -0
  181. package/dist/pt-BR-4QRR4PXU.js +2 -0
  182. package/dist/pt-BR-7JM75AGX.js +1233 -0
  183. package/dist/pt-PT-W3WZEROD.js +1233 -0
  184. package/dist/pt-PT-Z5FI4CLF.js +2 -0
  185. package/dist/pt-br-2W4P4ZAJ.js +2 -0
  186. package/dist/pt-br-JP6VI5C5.js +98 -0
  187. package/dist/pt-pt-22LJFZT5.js +98 -0
  188. package/dist/pt-pt-HOBFIPWZ.js +2 -0
  189. package/dist/ro-3KXIEYVK.js +98 -0
  190. package/dist/ro-3YUPB2TJ.js +1233 -0
  191. package/dist/ro-JXHNIBOA.js +2 -0
  192. package/dist/ro-KHPOLQC6.js +2 -0
  193. package/dist/ru-5ZVLKPFN.js +2 -0
  194. package/dist/ru-ASND25AB.js +2 -0
  195. package/dist/ru-ATGZC5LB.js +1233 -0
  196. package/dist/ru-W44AHOIC.js +98 -0
  197. package/dist/si-RHXLIDQI.js +1233 -0
  198. package/dist/si-U3O6NRHE.js +2 -0
  199. package/dist/srt-parser-6DEDUV5P.js +43 -0
  200. package/dist/srt-parser-E666S3YO.js +3 -0
  201. package/dist/ssa-parser-5GJ737XF.js +309 -0
  202. package/dist/ssa-parser-BR3CTDHR.js +5 -0
  203. package/dist/sv-5LOOKXJA.js +98 -0
  204. package/dist/sv-6GKNCPMS.js +2 -0
  205. package/dist/sv-LL3HMUIA.js +1233 -0
  206. package/dist/sv-RRJ6LYFT.js +2 -0
  207. package/dist/sw-HBNHIHPG.js +2 -0
  208. package/dist/sw-HP7MYGQ5.js +1233 -0
  209. package/dist/sw-NTSCFQXY.js +2 -0
  210. package/dist/sw-YIUB7QN3.js +98 -0
  211. package/dist/ta-4RG3PWN5.js +98 -0
  212. package/dist/ta-ARSNSDK5.js +2 -0
  213. package/dist/ta-Q2LBTDH6.js +2 -0
  214. package/dist/ta-Z5EVUBYF.js +1233 -0
  215. package/dist/te-FAWIFHVW.js +2 -0
  216. package/dist/te-FXJYUGGL.js +98 -0
  217. package/dist/te-GDV3DJFJ.js +1233 -0
  218. package/dist/te-TIMB7HBY.js +2 -0
  219. package/dist/th-7CEFYE5H.js +2 -0
  220. package/dist/th-CFAEFK3E.js +1233 -0
  221. package/dist/th-KGPTXFIF.js +2 -0
  222. package/dist/th-TC6J25FB.js +98 -0
  223. package/dist/tl-2JDK2CBL.js +2 -0
  224. package/dist/tl-SGZM4XSX.js +1233 -0
  225. package/dist/tr-27OEWIPE.js +1233 -0
  226. package/dist/tr-2MEHQO75.js +98 -0
  227. package/dist/tr-7P2UAX7U.js +2 -0
  228. package/dist/tr-NKD6C4RY.js +2 -0
  229. package/dist/uk-CXQISVJP.js +2 -0
  230. package/dist/uk-EJIGGLKY.js +1233 -0
  231. package/dist/uk-JCI3UE6Q.js +98 -0
  232. package/dist/uk-QM5BBWP7.js +2 -0
  233. package/dist/ur-5EWYHPME.js +1233 -0
  234. package/dist/ur-IIOUQYSA.js +98 -0
  235. package/dist/ur-M3QWGAPF.js +2 -0
  236. package/dist/ur-TLLPXSTM.js +2 -0
  237. package/dist/vi-AXQYYRD3.js +2 -0
  238. package/dist/vi-JALLXYS7.js +1233 -0
  239. package/dist/vi-SS65KZTI.js +2 -0
  240. package/dist/vi-YQVNQEVG.js +98 -0
  241. package/dist/vidstack-B9fTkxQO-LJP5ADOO.js +215 -0
  242. package/dist/vidstack-B9fTkxQO-OCT23G55.js +2 -0
  243. package/dist/vidstack-BmcqUMKx-A2W3TQB6.js +2 -0
  244. package/dist/vidstack-BmcqUMKx-G6TB22IC.js +286 -0
  245. package/dist/vidstack-C0fPJIzs-7AH6MOHO.js +2 -0
  246. package/dist/vidstack-C0fPJIzs-PNQOR4TK.js +11 -0
  247. package/dist/vidstack-CHcsWfRV-UAVLHO6N.js +40 -0
  248. package/dist/vidstack-CHcsWfRV-V52LFHYG.js +2 -0
  249. package/dist/vidstack-CvezEmSQ-JXKCQ4VQ.js +2 -0
  250. package/dist/vidstack-CvezEmSQ-R32NZKJ2.js +130 -0
  251. package/dist/vidstack-D2vrrUMs-7XAY5IBS.js +2 -0
  252. package/dist/vidstack-D2vrrUMs-FNQR2A5M.js +467 -0
  253. package/dist/vidstack-Di0HObvT-6ND3AXWZ.js +112 -0
  254. package/dist/vidstack-Di0HObvT-ZV7XK2OT.js +2 -0
  255. package/dist/vidstack-DiaLSJYx-H762DXYG.js +2 -0
  256. package/dist/vidstack-DiaLSJYx-S7DDW2H3.js +380 -0
  257. package/dist/vidstack-Dy74GavT-EYLL6MEF.js +2 -0
  258. package/dist/vidstack-Dy74GavT-XNIJ7PF4.js +11 -0
  259. package/dist/vidstack-GkTzay8D-C7EJKMV4.js +2 -0
  260. package/dist/vidstack-GkTzay8D-SQU5IF3P.js +482 -0
  261. package/dist/web-components.d.ts +12 -0
  262. package/dist/web-components.js +123 -0
  263. package/dist/worker.js +1 -0
  264. package/dist/zh-CN-PVVDP25S.js +2 -0
  265. package/dist/zh-CN-TLPNCXUN.js +1233 -0
  266. package/dist/zh-HK-GOKVZUJZ.js +1233 -0
  267. package/dist/zh-HK-Z5B2ANLW.js +2 -0
  268. package/dist/zh-Hant-2R7T4HJT.js +1233 -0
  269. package/dist/zh-Hant-MWAFLLDD.js +2 -0
  270. package/dist/zh-cn-D36OS2SI.js +2 -0
  271. package/dist/zh-cn-Z5YVUN62.js +98 -0
  272. package/dist/zh-tw-JWILJCBD.js +2 -0
  273. package/dist/zh-tw-X7JGMR4G.js +98 -0
  274. package/package.json +84 -3
@@ -0,0 +1,2955 @@
1
+ import * as react_jsx_runtime from 'react/jsx-runtime';
2
+ import * as react from 'react';
3
+ import { ReactNode } from 'react';
4
+ import { CustomerContentClientLike, DeliveryPaths } from '@kanorio/sdk';
5
+ import { z } from 'zod';
6
+
7
+ /**
8
+ * Customer API 的回應形狀(`{site}/api/v1/customer/*`;對外契約,ADR-0003)。
9
+ * main 的 lib/access 產生這些物件;Elements、託管 /account、SDK 三方共用型別。只加欄位不改語意。
10
+ */
11
+ /** `prerequisite`:被依序完成或關卡單元擋住,`access.lockedByUnitId` 是擋住它的單元 */
12
+ type UnitAccessReason = "entitlement" | "preview" | "none" | "not_released" | "expired" | "hidden" | "prerequisite";
13
+ type UnitProgressStatus = "not_started" | "in-progress" | "completed";
14
+ /** 測驗單元給學員的摘要(題目在 `body`,是 `PublicQuizBody`,永不含正確答案) */
15
+ interface CustomerQuizSummary {
16
+ /** `graded` 及格才完成;`practice` 送出即完成、不計及格、不限次數。舊版 server 沒有這個欄位(視同 graded) */
17
+ mode?: "graded" | "practice";
18
+ passingPercent: number;
19
+ /** 可作答次數(含站主加給的);null=不限 */
20
+ maxAttempts: number | null;
21
+ attemptsUsed: number;
22
+ bestScore: number | null;
23
+ /** 計分:曾經及格;練習:曾經送出 */
24
+ passed: boolean;
25
+ canRetry: boolean;
26
+ }
27
+ /** 交付內容的封面圖(本站圖片;沒有或已移到回收桶時為 null) */
28
+ interface DeliverableCover {
29
+ url: string;
30
+ width: number | null;
31
+ height: number | null;
32
+ /** 圖片的預設替代文字 */
33
+ alt: string | null;
34
+ /** 低解析佔位圖 data URL(16px WebP) */
35
+ placeholder: string | null;
36
+ }
37
+ /** 單元的附件(講義、範本、練習檔):只有檔名與大小;下載網址用 `openUnit(unitId, "download", { attachmentId })` 取 */
38
+ interface UnitAttachmentView {
39
+ /** 附件的檔案 id,傳給 `openUnit` 的 `attachmentId` */
40
+ id: string;
41
+ fileName: string;
42
+ mimeType: string | null;
43
+ /** 位元組;未知為 null */
44
+ bytes: number | null;
45
+ }
46
+ interface CustomerUnitView {
47
+ id: string;
48
+ parentId: string | null;
49
+ order: number;
50
+ kind: string;
51
+ title: string | null;
52
+ description: string | null;
53
+ isPreview: boolean;
54
+ allowDownload: boolean;
55
+ /** 計入完課(false=選修:不算進完成比例、不被依序擋、也不擋人);舊版 server 沒有這個欄位 */
56
+ countsTowardCompletion?: boolean;
57
+ /** 關卡:沒完成就不能看它後面的內容;舊版 server 沒有這個欄位 */
58
+ isPrerequisite?: boolean;
59
+ hasFile: boolean;
60
+ /** 附件(依站主排的順序);沒有存取權時是空陣列。舊版 server 沒有這個欄位 */
61
+ attachments?: UnitAttachmentView[];
62
+ embed: {
63
+ provider: string;
64
+ id: string;
65
+ } | null;
66
+ /** text 單元的 `{ markdown }`;quiz 單元是 `PublicQuizBody`(沒有正確答案);鎖定時為 null */
67
+ body: unknown;
68
+ /** 測驗單元才有;題目還沒出好時為 null。舊版 server 沒有這個欄位 */
69
+ quiz?: CustomerQuizSummary | null;
70
+ duration: number | null;
71
+ pageCount: number | null;
72
+ mimeType: string | null;
73
+ /** `lockedByUnitId`:reason 為 `prerequisite` 時擋住它的單元;舊版 server 沒有這個欄位 */
74
+ access: {
75
+ granted: boolean;
76
+ reason: UnitAccessReason;
77
+ availableAt: string | null;
78
+ lockedByUnitId?: string | null;
79
+ };
80
+ progress: UnitProgressStatus;
81
+ /** 看到最遠的秒數(只進不退;算進度用) */
82
+ positionSeconds: number;
83
+ /** 上次停在哪(秒;續看從這裡接);舊版 server 沒有這個欄位 */
84
+ lastPosition?: number;
85
+ /** 看過的比例 0–100(段落聯集 ÷ 片長);沒有片長或還沒看為 null;舊版 server 沒有這個欄位 */
86
+ coveredPercent?: number | null;
87
+ }
88
+ /** 作者/講師(全站共用名單,與文章作者同一份);`avatar` 是可直接顯示的網址 */
89
+ interface DeliverableAuthorView {
90
+ id: string;
91
+ name: string;
92
+ /** 頭銜(「資深主廚」) */
93
+ title: string | null;
94
+ avatar: string | null;
95
+ bio: string | null;
96
+ url: string | null;
97
+ }
98
+ interface CustomerDeliverableTree {
99
+ id: string;
100
+ title: string;
101
+ description: string | null;
102
+ structure: "COURSE" | "DOWNLOAD";
103
+ coverAssetId: string | null;
104
+ cover: DeliverableCover | null;
105
+ /** 依站主排的順序;舊版 server 沒有這個欄位 */
106
+ authors?: DeliverableAuthorView[];
107
+ settings: {
108
+ completionRule: {
109
+ type: "all_units";
110
+ } | {
111
+ type: "percent";
112
+ percent: number;
113
+ } | {
114
+ type: "quiz_passed";
115
+ unitId: string;
116
+ };
117
+ certificate: {
118
+ enabled: boolean;
119
+ title: string | null;
120
+ signatureName: string | null;
121
+ signatureTitle?: string | null;
122
+ signatureAssetId?: string | null;
123
+ showLogo?: boolean;
124
+ note?: string | null;
125
+ /** 舊版 server 沒有這兩個欄位 */
126
+ backgroundAssetId?: string | null;
127
+ backgroundOverlay?: boolean;
128
+ };
129
+ comments: {
130
+ enabled: boolean;
131
+ threaded: boolean;
132
+ requireReview: boolean;
133
+ reactions: boolean;
134
+ };
135
+ requireSequential: boolean;
136
+ /** 影音單元看過幾成算完成(50–100,預設 90);舊版 server 沒有這個欄位 */
137
+ mediaCompletionPercent?: number;
138
+ };
139
+ units: CustomerUnitView[];
140
+ progress: {
141
+ percent: number;
142
+ completed: boolean;
143
+ completedAt?: string | null;
144
+ } | null;
145
+ /** 結業證書:課程有開才有 `enabled`;完課後 `serial`/`issuedAt` 有值,用 `getCertificate` 取下載網址。舊版 server 沒有這個欄位 */
146
+ certificate?: {
147
+ enabled: boolean;
148
+ serial: string | null;
149
+ issuedAt: string | null;
150
+ } | null;
151
+ }
152
+ /** Delivery 公開大綱(匿名;不含私有網址、不含 body):商品頁 `content-curriculum` 模組與 `/api/v1/products` 用 */
153
+ interface PublicDeliverableOutline {
154
+ id: string;
155
+ title: string;
156
+ description: string | null;
157
+ structure: "COURSE" | "DOWNLOAD";
158
+ coverAssetId: string | null;
159
+ cover: DeliverableCover | null;
160
+ /** 作者/講師,依站主排的順序;舊版 server 沒有這個欄位 */
161
+ authors?: DeliverableAuthorView[];
162
+ unitCount: number;
163
+ /** 單元時長加總(秒;只算有時長的影音);沒有時長為 null */
164
+ totalDurationSeconds: number | null;
165
+ units: Array<{
166
+ id: string;
167
+ parentId: string | null;
168
+ order: number;
169
+ kind: string;
170
+ title: string | null;
171
+ description: string | null;
172
+ isPreview: boolean;
173
+ /** 計入完課(false=選修);舊版 server 沒有這個欄位 */
174
+ countsTowardCompletion?: boolean;
175
+ /** 定時開放(ISO 8601);試看單元未到時間前不可播放,大綱應顯示開放時間而非試看按鈕 */
176
+ releaseAt: string | null;
177
+ duration: number | null;
178
+ pageCount: number | null;
179
+ }>;
180
+ }
181
+
182
+ /** 最大欄數選項:1–5 欄(無 auto;各模組 UI 可再限制上限) */
183
+ type MaxColumnsValue = 1 | 2 | 3 | 4 | 5 | 6;
184
+ /** 依裝置設定最大欄數(手機 / 平板 / 電腦) */
185
+ type MaxColumnsConfig = {
186
+ mobile?: MaxColumnsValue;
187
+ tablet?: MaxColumnsValue;
188
+ desktop?: MaxColumnsValue;
189
+ };
190
+
191
+ /**
192
+ * 線上表單(名單搜集模組)的 schema SSOT。
193
+ *
194
+ * - `formFieldSchema`/`formSettingsSchema`:站主在 /customers 設定的表單定義(存 WebsiteForm.fields / settings)
195
+ * - 訪客答案的驗證與正規化在 `forms-answers.ts` 的 `validateFormAnswers`,main 提交端與公開站 widget 共用同一份規則
196
+ *
197
+ * 純函式、無 DOM/Prisma 依賴,editor、public-sites、main 皆可 import。
198
+ * 規範見 docs/platform/marketing/forms.md、docs/platform/customers/contacts.md
199
+ */
200
+
201
+ declare const formFieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
202
+ type: z.ZodLiteral<"short_text">;
203
+ minLength: z.ZodOptional<z.ZodNumber>;
204
+ maxLength: z.ZodOptional<z.ZodNumber>;
205
+ pattern: z.ZodOptional<z.ZodString>;
206
+ patternMessage: z.ZodOptional<z.ZodString>;
207
+ id: z.ZodString;
208
+ label: z.ZodString;
209
+ description: z.ZodOptional<z.ZodString>;
210
+ required: z.ZodDefault<z.ZodBoolean>;
211
+ contactMapping: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"name">, z.ZodLiteral<"email">, z.ZodLiteral<"phone">, z.ZodString]>>;
212
+ visibleWhen: z.ZodOptional<z.ZodObject<{
213
+ match: z.ZodDefault<z.ZodEnum<{
214
+ all: "all";
215
+ any: "any";
216
+ }>>;
217
+ conditions: z.ZodArray<z.ZodObject<{
218
+ kind: z.ZodDefault<z.ZodEnum<{
219
+ field: "field";
220
+ hidden: "hidden";
221
+ }>>;
222
+ ref: z.ZodString;
223
+ op: z.ZodEnum<{
224
+ includes: "includes";
225
+ answered: "answered";
226
+ not_answered: "not_answered";
227
+ not_includes: "not_includes";
228
+ equals: "equals";
229
+ not_equals: "not_equals";
230
+ contains: "contains";
231
+ gt: "gt";
232
+ gte: "gte";
233
+ lt: "lt";
234
+ lte: "lte";
235
+ }>;
236
+ value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
237
+ }, z.core.$strip>>;
238
+ }, z.core.$strip>>;
239
+ }, z.core.$strip>, z.ZodObject<{
240
+ type: z.ZodLiteral<"long_text">;
241
+ minLength: z.ZodOptional<z.ZodNumber>;
242
+ maxLength: z.ZodOptional<z.ZodNumber>;
243
+ id: z.ZodString;
244
+ label: z.ZodString;
245
+ description: z.ZodOptional<z.ZodString>;
246
+ required: z.ZodDefault<z.ZodBoolean>;
247
+ contactMapping: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"name">, z.ZodLiteral<"email">, z.ZodLiteral<"phone">, z.ZodString]>>;
248
+ visibleWhen: z.ZodOptional<z.ZodObject<{
249
+ match: z.ZodDefault<z.ZodEnum<{
250
+ all: "all";
251
+ any: "any";
252
+ }>>;
253
+ conditions: z.ZodArray<z.ZodObject<{
254
+ kind: z.ZodDefault<z.ZodEnum<{
255
+ field: "field";
256
+ hidden: "hidden";
257
+ }>>;
258
+ ref: z.ZodString;
259
+ op: z.ZodEnum<{
260
+ includes: "includes";
261
+ answered: "answered";
262
+ not_answered: "not_answered";
263
+ not_includes: "not_includes";
264
+ equals: "equals";
265
+ not_equals: "not_equals";
266
+ contains: "contains";
267
+ gt: "gt";
268
+ gte: "gte";
269
+ lt: "lt";
270
+ lte: "lte";
271
+ }>;
272
+ value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
273
+ }, z.core.$strip>>;
274
+ }, z.core.$strip>>;
275
+ }, z.core.$strip>, z.ZodObject<{
276
+ type: z.ZodLiteral<"email">;
277
+ required: z.ZodPipe<z.ZodDefault<z.ZodBoolean>, z.ZodTransform<boolean, boolean>>;
278
+ contactMapping: z.ZodDefault<z.ZodLiteral<"email">>;
279
+ id: z.ZodString;
280
+ label: z.ZodString;
281
+ description: z.ZodOptional<z.ZodString>;
282
+ visibleWhen: z.ZodOptional<z.ZodObject<{
283
+ match: z.ZodDefault<z.ZodEnum<{
284
+ all: "all";
285
+ any: "any";
286
+ }>>;
287
+ conditions: z.ZodArray<z.ZodObject<{
288
+ kind: z.ZodDefault<z.ZodEnum<{
289
+ field: "field";
290
+ hidden: "hidden";
291
+ }>>;
292
+ ref: z.ZodString;
293
+ op: z.ZodEnum<{
294
+ includes: "includes";
295
+ answered: "answered";
296
+ not_answered: "not_answered";
297
+ not_includes: "not_includes";
298
+ equals: "equals";
299
+ not_equals: "not_equals";
300
+ contains: "contains";
301
+ gt: "gt";
302
+ gte: "gte";
303
+ lt: "lt";
304
+ lte: "lte";
305
+ }>;
306
+ value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
307
+ }, z.core.$strip>>;
308
+ }, z.core.$strip>>;
309
+ }, z.core.$strip>, z.ZodObject<{
310
+ type: z.ZodLiteral<"phone">;
311
+ contactMapping: z.ZodDefault<z.ZodLiteral<"phone">>;
312
+ defaultCountry: z.ZodOptional<z.ZodString>;
313
+ id: z.ZodString;
314
+ label: z.ZodString;
315
+ description: z.ZodOptional<z.ZodString>;
316
+ required: z.ZodDefault<z.ZodBoolean>;
317
+ visibleWhen: z.ZodOptional<z.ZodObject<{
318
+ match: z.ZodDefault<z.ZodEnum<{
319
+ all: "all";
320
+ any: "any";
321
+ }>>;
322
+ conditions: z.ZodArray<z.ZodObject<{
323
+ kind: z.ZodDefault<z.ZodEnum<{
324
+ field: "field";
325
+ hidden: "hidden";
326
+ }>>;
327
+ ref: z.ZodString;
328
+ op: z.ZodEnum<{
329
+ includes: "includes";
330
+ answered: "answered";
331
+ not_answered: "not_answered";
332
+ not_includes: "not_includes";
333
+ equals: "equals";
334
+ not_equals: "not_equals";
335
+ contains: "contains";
336
+ gt: "gt";
337
+ gte: "gte";
338
+ lt: "lt";
339
+ lte: "lte";
340
+ }>;
341
+ value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
342
+ }, z.core.$strip>>;
343
+ }, z.core.$strip>>;
344
+ }, z.core.$strip>, z.ZodObject<{
345
+ type: z.ZodLiteral<"choice">;
346
+ options: z.ZodArray<z.ZodObject<{
347
+ id: z.ZodString;
348
+ label: z.ZodString;
349
+ }, z.core.$strip>>;
350
+ allowMultiple: z.ZodDefault<z.ZodBoolean>;
351
+ allowOther: z.ZodDefault<z.ZodBoolean>;
352
+ display: z.ZodDefault<z.ZodEnum<{
353
+ list: "list";
354
+ dropdown: "dropdown";
355
+ }>>;
356
+ minSelections: z.ZodOptional<z.ZodNumber>;
357
+ maxSelections: z.ZodOptional<z.ZodNumber>;
358
+ id: z.ZodString;
359
+ label: z.ZodString;
360
+ description: z.ZodOptional<z.ZodString>;
361
+ required: z.ZodDefault<z.ZodBoolean>;
362
+ contactMapping: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"name">, z.ZodLiteral<"email">, z.ZodLiteral<"phone">, z.ZodString]>>;
363
+ visibleWhen: z.ZodOptional<z.ZodObject<{
364
+ match: z.ZodDefault<z.ZodEnum<{
365
+ all: "all";
366
+ any: "any";
367
+ }>>;
368
+ conditions: z.ZodArray<z.ZodObject<{
369
+ kind: z.ZodDefault<z.ZodEnum<{
370
+ field: "field";
371
+ hidden: "hidden";
372
+ }>>;
373
+ ref: z.ZodString;
374
+ op: z.ZodEnum<{
375
+ includes: "includes";
376
+ answered: "answered";
377
+ not_answered: "not_answered";
378
+ not_includes: "not_includes";
379
+ equals: "equals";
380
+ not_equals: "not_equals";
381
+ contains: "contains";
382
+ gt: "gt";
383
+ gte: "gte";
384
+ lt: "lt";
385
+ lte: "lte";
386
+ }>;
387
+ value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
388
+ }, z.core.$strip>>;
389
+ }, z.core.$strip>>;
390
+ }, z.core.$strip>, z.ZodObject<{
391
+ type: z.ZodLiteral<"date">;
392
+ range: z.ZodOptional<z.ZodObject<{
393
+ min: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
394
+ type: z.ZodLiteral<"today">;
395
+ offsetDays: z.ZodDefault<z.ZodNumber>;
396
+ }, z.core.$strip>, z.ZodObject<{
397
+ type: z.ZodLiteral<"date">;
398
+ value: z.ZodString;
399
+ }, z.core.$strip>], "type">>;
400
+ max: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
401
+ type: z.ZodLiteral<"today">;
402
+ offsetDays: z.ZodDefault<z.ZodNumber>;
403
+ }, z.core.$strip>, z.ZodObject<{
404
+ type: z.ZodLiteral<"date">;
405
+ value: z.ZodString;
406
+ }, z.core.$strip>], "type">>;
407
+ }, z.core.$strip>>;
408
+ id: z.ZodString;
409
+ label: z.ZodString;
410
+ description: z.ZodOptional<z.ZodString>;
411
+ required: z.ZodDefault<z.ZodBoolean>;
412
+ contactMapping: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"name">, z.ZodLiteral<"email">, z.ZodLiteral<"phone">, z.ZodString]>>;
413
+ visibleWhen: z.ZodOptional<z.ZodObject<{
414
+ match: z.ZodDefault<z.ZodEnum<{
415
+ all: "all";
416
+ any: "any";
417
+ }>>;
418
+ conditions: z.ZodArray<z.ZodObject<{
419
+ kind: z.ZodDefault<z.ZodEnum<{
420
+ field: "field";
421
+ hidden: "hidden";
422
+ }>>;
423
+ ref: z.ZodString;
424
+ op: z.ZodEnum<{
425
+ includes: "includes";
426
+ answered: "answered";
427
+ not_answered: "not_answered";
428
+ not_includes: "not_includes";
429
+ equals: "equals";
430
+ not_equals: "not_equals";
431
+ contains: "contains";
432
+ gt: "gt";
433
+ gte: "gte";
434
+ lt: "lt";
435
+ lte: "lte";
436
+ }>;
437
+ value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
438
+ }, z.core.$strip>>;
439
+ }, z.core.$strip>>;
440
+ }, z.core.$strip>, z.ZodObject<{
441
+ type: z.ZodLiteral<"time">;
442
+ id: z.ZodString;
443
+ label: z.ZodString;
444
+ description: z.ZodOptional<z.ZodString>;
445
+ required: z.ZodDefault<z.ZodBoolean>;
446
+ contactMapping: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"name">, z.ZodLiteral<"email">, z.ZodLiteral<"phone">, z.ZodString]>>;
447
+ visibleWhen: z.ZodOptional<z.ZodObject<{
448
+ match: z.ZodDefault<z.ZodEnum<{
449
+ all: "all";
450
+ any: "any";
451
+ }>>;
452
+ conditions: z.ZodArray<z.ZodObject<{
453
+ kind: z.ZodDefault<z.ZodEnum<{
454
+ field: "field";
455
+ hidden: "hidden";
456
+ }>>;
457
+ ref: z.ZodString;
458
+ op: z.ZodEnum<{
459
+ includes: "includes";
460
+ answered: "answered";
461
+ not_answered: "not_answered";
462
+ not_includes: "not_includes";
463
+ equals: "equals";
464
+ not_equals: "not_equals";
465
+ contains: "contains";
466
+ gt: "gt";
467
+ gte: "gte";
468
+ lt: "lt";
469
+ lte: "lte";
470
+ }>;
471
+ value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
472
+ }, z.core.$strip>>;
473
+ }, z.core.$strip>>;
474
+ }, z.core.$strip>, z.ZodObject<{
475
+ type: z.ZodLiteral<"file">;
476
+ maxFiles: z.ZodDefault<z.ZodNumber>;
477
+ accept: z.ZodDefault<z.ZodArray<z.ZodString>>;
478
+ id: z.ZodString;
479
+ label: z.ZodString;
480
+ description: z.ZodOptional<z.ZodString>;
481
+ required: z.ZodDefault<z.ZodBoolean>;
482
+ contactMapping: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"name">, z.ZodLiteral<"email">, z.ZodLiteral<"phone">, z.ZodString]>>;
483
+ visibleWhen: z.ZodOptional<z.ZodObject<{
484
+ match: z.ZodDefault<z.ZodEnum<{
485
+ all: "all";
486
+ any: "any";
487
+ }>>;
488
+ conditions: z.ZodArray<z.ZodObject<{
489
+ kind: z.ZodDefault<z.ZodEnum<{
490
+ field: "field";
491
+ hidden: "hidden";
492
+ }>>;
493
+ ref: z.ZodString;
494
+ op: z.ZodEnum<{
495
+ includes: "includes";
496
+ answered: "answered";
497
+ not_answered: "not_answered";
498
+ not_includes: "not_includes";
499
+ equals: "equals";
500
+ not_equals: "not_equals";
501
+ contains: "contains";
502
+ gt: "gt";
503
+ gte: "gte";
504
+ lt: "lt";
505
+ lte: "lte";
506
+ }>;
507
+ value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
508
+ }, z.core.$strip>>;
509
+ }, z.core.$strip>>;
510
+ }, z.core.$strip>, z.ZodObject<{
511
+ type: z.ZodLiteral<"rating">;
512
+ max: z.ZodDefault<z.ZodNumber>;
513
+ icon: z.ZodDefault<z.ZodEnum<{
514
+ heart: "heart";
515
+ star: "star";
516
+ thumb: "thumb";
517
+ }>>;
518
+ id: z.ZodString;
519
+ label: z.ZodString;
520
+ description: z.ZodOptional<z.ZodString>;
521
+ required: z.ZodDefault<z.ZodBoolean>;
522
+ contactMapping: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"name">, z.ZodLiteral<"email">, z.ZodLiteral<"phone">, z.ZodString]>>;
523
+ visibleWhen: z.ZodOptional<z.ZodObject<{
524
+ match: z.ZodDefault<z.ZodEnum<{
525
+ all: "all";
526
+ any: "any";
527
+ }>>;
528
+ conditions: z.ZodArray<z.ZodObject<{
529
+ kind: z.ZodDefault<z.ZodEnum<{
530
+ field: "field";
531
+ hidden: "hidden";
532
+ }>>;
533
+ ref: z.ZodString;
534
+ op: z.ZodEnum<{
535
+ includes: "includes";
536
+ answered: "answered";
537
+ not_answered: "not_answered";
538
+ not_includes: "not_includes";
539
+ equals: "equals";
540
+ not_equals: "not_equals";
541
+ contains: "contains";
542
+ gt: "gt";
543
+ gte: "gte";
544
+ lt: "lt";
545
+ lte: "lte";
546
+ }>;
547
+ value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
548
+ }, z.core.$strip>>;
549
+ }, z.core.$strip>>;
550
+ }, z.core.$strip>, z.ZodObject<{
551
+ type: z.ZodLiteral<"number">;
552
+ min: z.ZodOptional<z.ZodNumber>;
553
+ max: z.ZodOptional<z.ZodNumber>;
554
+ integer: z.ZodDefault<z.ZodBoolean>;
555
+ id: z.ZodString;
556
+ label: z.ZodString;
557
+ description: z.ZodOptional<z.ZodString>;
558
+ required: z.ZodDefault<z.ZodBoolean>;
559
+ contactMapping: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"name">, z.ZodLiteral<"email">, z.ZodLiteral<"phone">, z.ZodString]>>;
560
+ visibleWhen: z.ZodOptional<z.ZodObject<{
561
+ match: z.ZodDefault<z.ZodEnum<{
562
+ all: "all";
563
+ any: "any";
564
+ }>>;
565
+ conditions: z.ZodArray<z.ZodObject<{
566
+ kind: z.ZodDefault<z.ZodEnum<{
567
+ field: "field";
568
+ hidden: "hidden";
569
+ }>>;
570
+ ref: z.ZodString;
571
+ op: z.ZodEnum<{
572
+ includes: "includes";
573
+ answered: "answered";
574
+ not_answered: "not_answered";
575
+ not_includes: "not_includes";
576
+ equals: "equals";
577
+ not_equals: "not_equals";
578
+ contains: "contains";
579
+ gt: "gt";
580
+ gte: "gte";
581
+ lt: "lt";
582
+ lte: "lte";
583
+ }>;
584
+ value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
585
+ }, z.core.$strip>>;
586
+ }, z.core.$strip>>;
587
+ }, z.core.$strip>, z.ZodObject<{
588
+ type: z.ZodLiteral<"url">;
589
+ id: z.ZodString;
590
+ label: z.ZodString;
591
+ description: z.ZodOptional<z.ZodString>;
592
+ required: z.ZodDefault<z.ZodBoolean>;
593
+ contactMapping: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"name">, z.ZodLiteral<"email">, z.ZodLiteral<"phone">, z.ZodString]>>;
594
+ visibleWhen: z.ZodOptional<z.ZodObject<{
595
+ match: z.ZodDefault<z.ZodEnum<{
596
+ all: "all";
597
+ any: "any";
598
+ }>>;
599
+ conditions: z.ZodArray<z.ZodObject<{
600
+ kind: z.ZodDefault<z.ZodEnum<{
601
+ field: "field";
602
+ hidden: "hidden";
603
+ }>>;
604
+ ref: z.ZodString;
605
+ op: z.ZodEnum<{
606
+ includes: "includes";
607
+ answered: "answered";
608
+ not_answered: "not_answered";
609
+ not_includes: "not_includes";
610
+ equals: "equals";
611
+ not_equals: "not_equals";
612
+ contains: "contains";
613
+ gt: "gt";
614
+ gte: "gte";
615
+ lt: "lt";
616
+ lte: "lte";
617
+ }>;
618
+ value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
619
+ }, z.core.$strip>>;
620
+ }, z.core.$strip>>;
621
+ }, z.core.$strip>, z.ZodObject<{
622
+ type: z.ZodLiteral<"address">;
623
+ defaultCountry: z.ZodOptional<z.ZodString>;
624
+ countries: z.ZodDefault<z.ZodArray<z.ZodString>>;
625
+ askRecipientName: z.ZodDefault<z.ZodBoolean>;
626
+ contactMapping: z.ZodOptional<z.ZodLiteral<"address">>;
627
+ id: z.ZodString;
628
+ label: z.ZodString;
629
+ description: z.ZodOptional<z.ZodString>;
630
+ required: z.ZodDefault<z.ZodBoolean>;
631
+ visibleWhen: z.ZodOptional<z.ZodObject<{
632
+ match: z.ZodDefault<z.ZodEnum<{
633
+ all: "all";
634
+ any: "any";
635
+ }>>;
636
+ conditions: z.ZodArray<z.ZodObject<{
637
+ kind: z.ZodDefault<z.ZodEnum<{
638
+ field: "field";
639
+ hidden: "hidden";
640
+ }>>;
641
+ ref: z.ZodString;
642
+ op: z.ZodEnum<{
643
+ includes: "includes";
644
+ answered: "answered";
645
+ not_answered: "not_answered";
646
+ not_includes: "not_includes";
647
+ equals: "equals";
648
+ not_equals: "not_equals";
649
+ contains: "contains";
650
+ gt: "gt";
651
+ gte: "gte";
652
+ lt: "lt";
653
+ lte: "lte";
654
+ }>;
655
+ value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
656
+ }, z.core.$strip>>;
657
+ }, z.core.$strip>>;
658
+ }, z.core.$strip>, z.ZodObject<{
659
+ type: z.ZodLiteral<"tax_id">;
660
+ defaultCountry: z.ZodOptional<z.ZodString>;
661
+ countries: z.ZodDefault<z.ZodArray<z.ZodString>>;
662
+ companyNameFieldId: z.ZodOptional<z.ZodString>;
663
+ contactMapping: z.ZodOptional<z.ZodLiteral<"tax_identity">>;
664
+ id: z.ZodString;
665
+ label: z.ZodString;
666
+ description: z.ZodOptional<z.ZodString>;
667
+ required: z.ZodDefault<z.ZodBoolean>;
668
+ visibleWhen: z.ZodOptional<z.ZodObject<{
669
+ match: z.ZodDefault<z.ZodEnum<{
670
+ all: "all";
671
+ any: "any";
672
+ }>>;
673
+ conditions: z.ZodArray<z.ZodObject<{
674
+ kind: z.ZodDefault<z.ZodEnum<{
675
+ field: "field";
676
+ hidden: "hidden";
677
+ }>>;
678
+ ref: z.ZodString;
679
+ op: z.ZodEnum<{
680
+ includes: "includes";
681
+ answered: "answered";
682
+ not_answered: "not_answered";
683
+ not_includes: "not_includes";
684
+ equals: "equals";
685
+ not_equals: "not_equals";
686
+ contains: "contains";
687
+ gt: "gt";
688
+ gte: "gte";
689
+ lt: "lt";
690
+ lte: "lte";
691
+ }>;
692
+ value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
693
+ }, z.core.$strip>>;
694
+ }, z.core.$strip>>;
695
+ }, z.core.$strip>, z.ZodObject<{
696
+ id: z.ZodString;
697
+ type: z.ZodLiteral<"statement">;
698
+ label: z.ZodString;
699
+ description: z.ZodOptional<z.ZodString>;
700
+ required: z.ZodPipe<z.ZodDefault<z.ZodBoolean>, z.ZodTransform<boolean, boolean>>;
701
+ contactMapping: z.ZodOptional<z.ZodUndefined>;
702
+ visibleWhen: z.ZodOptional<z.ZodObject<{
703
+ match: z.ZodDefault<z.ZodEnum<{
704
+ all: "all";
705
+ any: "any";
706
+ }>>;
707
+ conditions: z.ZodArray<z.ZodObject<{
708
+ kind: z.ZodDefault<z.ZodEnum<{
709
+ field: "field";
710
+ hidden: "hidden";
711
+ }>>;
712
+ ref: z.ZodString;
713
+ op: z.ZodEnum<{
714
+ includes: "includes";
715
+ answered: "answered";
716
+ not_answered: "not_answered";
717
+ not_includes: "not_includes";
718
+ equals: "equals";
719
+ not_equals: "not_equals";
720
+ contains: "contains";
721
+ gt: "gt";
722
+ gte: "gte";
723
+ lt: "lt";
724
+ lte: "lte";
725
+ }>;
726
+ value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
727
+ }, z.core.$strip>>;
728
+ }, z.core.$strip>>;
729
+ }, z.core.$strip>], "type">;
730
+ type FormField = z.infer<typeof formFieldSchema>;
731
+ declare const formSettingsObjectSchema: z.ZodObject<{
732
+ submitLabel: z.ZodOptional<z.ZodString>;
733
+ successMessage: z.ZodOptional<z.ZodString>;
734
+ redirectUrl: z.ZodOptional<z.ZodString>;
735
+ marketingConsent: z.ZodDefault<z.ZodEnum<{
736
+ off: "off";
737
+ checkbox: "checkbox";
738
+ submit: "submit";
739
+ }>>;
740
+ consentText: z.ZodOptional<z.ZodObject<{
741
+ checkbox: z.ZodOptional<z.ZodString>;
742
+ submit: z.ZodOptional<z.ZodString>;
743
+ }, z.core.$strip>>;
744
+ limitOnePerContact: z.ZodDefault<z.ZodBoolean>;
745
+ openAt: z.ZodOptional<z.ZodString>;
746
+ closeAt: z.ZodOptional<z.ZodString>;
747
+ maxSubmissions: z.ZodOptional<z.ZodNumber>;
748
+ replyKind: z.ZodDefault<z.ZodEnum<{
749
+ inquiry: "inquiry";
750
+ booking: "booking";
751
+ event: "event";
752
+ application: "application";
753
+ signup: "signup";
754
+ feedback: "feedback";
755
+ general: "general";
756
+ }>>;
757
+ hiddenFields: z.ZodDefault<z.ZodArray<z.ZodObject<{
758
+ id: z.ZodString;
759
+ label: z.ZodOptional<z.ZodString>;
760
+ }, z.core.$strip>>>;
761
+ }, z.core.$strip>;
762
+ type FormSettings = z.infer<typeof formSettingsObjectSchema>;
763
+ declare const FORM_STATUSES: readonly ["DRAFT", "ACTIVE", "ARCHIVED"];
764
+ type FormStatusKey = (typeof FORM_STATUSES)[number];
765
+ /** 公開站渲染用的表單定義(不含站主內部欄位) */
766
+ interface PublicFormDefinition {
767
+ id: string;
768
+ name: string;
769
+ description: string | null;
770
+ status: FormStatusKey;
771
+ fields: FormField[];
772
+ settings: FormSettings;
773
+ /** 非 SPAM 提交數;名額判定用(沒設 maxSubmissions 時仍帶) */
774
+ submissionCount: number;
775
+ /** 目前模式的同意文案識別碼(前台送出時原樣回報,伺服器比對);off 時為 null */
776
+ consentTextId: string | null;
777
+ /**
778
+ * 送出成功後前往的網址;沒有設定為 null 或不帶。前台以這一欄為準、不讀 `settings.redirectUrl`:
779
+ * 託管站的多語系頁面會由 public-sites 加上語系前綴。
780
+ */
781
+ redirectUrl?: string | null;
782
+ /** 網站的預設電話國家(ISO 3166-1 alpha-2,營業地點 → 網站語言);電話題沒設預設國碼時,前台初始國碼與伺服器解析都用它 */
783
+ defaultPhoneCountry?: string | null;
784
+ /** 網站時區(IANA);日期題的「今天起算」範圍以它為準,前台與伺服器才會算出同一天 */
785
+ timezone?: string | null;
786
+ /** @deprecated 舊版公開站讀這欄;值與 defaultPhoneCountry 相同,公開站全數更新後移除 */
787
+ businessCountry: string | null;
788
+ }
789
+
790
+ /**
791
+ * 模組 props 建構(純資料邏輯)
792
+ *
793
+ * 不 import 任何 React component,供 Worker / Editor / Renderer 共用。
794
+ * 元件映射見 sections.ts。
795
+ */
796
+
797
+ /** form 模組 UI 文案(公開站與編輯器皆由 host 注入) */
798
+ interface FormSectionLabels {
799
+ submit?: string;
800
+ submitting?: string;
801
+ success?: string;
802
+ error?: string;
803
+ required?: string;
804
+ invalidEmail?: string;
805
+ invalidPhone?: string;
806
+ invalidDate?: string;
807
+ invalidTime?: string;
808
+ tooLong?: string;
809
+ /** 勾了「其他」卻沒填 */
810
+ otherRequired?: string;
811
+ /** 提交層錯誤(答案保留、可重送):每人限填一次、暫停收件(每日上限)、頻率限制、人機驗證過期 */
812
+ duplicate?: string;
813
+ temporarilyUnavailable?: string;
814
+ rateLimited?: string;
815
+ verificationExpired?: string;
816
+ /** 伺服器把錯誤掛在畫面上沒有的題目:訪客開著舊版表單,請重新整理 */
817
+ outdated?: string;
818
+ /** 整份答案超過提交大小上限(資料沒有存) */
819
+ tooLarge?: string;
820
+ /** 送出成功、正要前往站主設定的網址 */
821
+ redirecting?: string;
822
+ /** 單題的通用錯誤:伺服器回了這一版前台不認得的錯誤碼 */
823
+ invalid?: string;
824
+ /** 文字少於最少字數;含 `{min}` */
825
+ tooShort?: string;
826
+ invalidNumber?: string;
827
+ /** 題目只收整數 */
828
+ notInteger?: string;
829
+ /** 數字範圍:只有下限(`{min}`)、只有上限(`{max}`)、兩端都有 */
830
+ numberMin?: string;
831
+ numberMax?: string;
832
+ numberRange?: string;
833
+ invalidUrl?: string;
834
+ /** 日期範圍:`{min}`/`{max}` 是依訪客語系排好的日期 */
835
+ dateMin?: string;
836
+ dateMax?: string;
837
+ dateRange?: string;
838
+ /** 多選數量:`{min}`/`{max}` 是選項數 */
839
+ tooFewOptions?: string;
840
+ tooManyOptions?: string;
841
+ /** 下拉選單還沒選時顯示的字 */
842
+ selectPlaceholder?: string;
843
+ /** 地址題:該國必填的欄位沒填完、郵遞區號格式不對 */
844
+ invalidAddress?: string;
845
+ /** 稅號題:格式或檢查碼不對 */
846
+ invalidTaxId?: string;
847
+ /** 稅號題:正在查登記資料 */
848
+ taxIdChecking?: string;
849
+ /** 稅號題:登記名稱,含 `{name}` */
850
+ taxIdRegisteredName?: string;
851
+ /** 稅號題:登記資料顯示已停業或解散 */
852
+ taxIdInactive?: string;
853
+ /** 稅號題:資料來源,含 `{provider}` */
854
+ taxIdSource?: string;
855
+ invalidPostalCode?: string;
856
+ /** 地址題各欄位的名稱;行政區、城市、郵遞區號依該國的稱呼類型取對應的鍵(customers/address-format.ts) */
857
+ addressCountry?: string;
858
+ addressRecipient?: string;
859
+ addressLine1?: string;
860
+ addressLine2?: string;
861
+ addressPostal_postal?: string;
862
+ addressPostal_zip?: string;
863
+ addressPostal_pin?: string;
864
+ addressPostal_eircode?: string;
865
+ addressLocality_city?: string;
866
+ addressLocality_district?: string;
867
+ addressLocality_post_town?: string;
868
+ addressLocality_suburb?: string;
869
+ addressRegion_area?: string;
870
+ addressRegion_county?: string;
871
+ addressRegion_department?: string;
872
+ addressRegion_district?: string;
873
+ addressRegion_do_si?: string;
874
+ addressRegion_emirate?: string;
875
+ addressRegion_island?: string;
876
+ addressRegion_oblast?: string;
877
+ addressRegion_parish?: string;
878
+ addressRegion_prefecture?: string;
879
+ addressRegion_province?: string;
880
+ addressRegion_state?: string;
881
+ /** 行銷同意勾選的平台預設文案(含 {siteName});站主可在表單設定自訂。版本見 DEFAULT_CONSENT_STATEMENT_IDS */
882
+ marketingOptIn?: string;
883
+ /** 送出即訂閱的平台預設說明(含 {siteName}、{button});站主可在表單設定自訂 */
884
+ subscribeOnSubmit?: string;
885
+ otherOption?: string;
886
+ otherPlaceholder?: string;
887
+ closed?: string;
888
+ notOpenYet?: string;
889
+ full?: string;
890
+ /** file 題型 */
891
+ fileChoose?: string;
892
+ /** 可含 `{max}`(檔數)與 `{size}`(單檔上限)佔位 */
893
+ fileLimitHint?: string;
894
+ fileWaiting?: string;
895
+ fileUploading?: string;
896
+ fileUploadFailed?: string;
897
+ fileTooLarge?: string;
898
+ fileTypeNotAllowed?: string;
899
+ /** 額度滿/服務不可用:該題放行,表單仍可送 */
900
+ fileUnavailable?: string;
901
+ fileRemove?: string;
902
+ /** 編輯器專用 */
903
+ noFormSelected?: string;
904
+ formNotFound?: string;
905
+ previewNotice?: string;
906
+ }
907
+
908
+ type VisitorMessages = {
909
+ globalError: {
910
+ title: string;
911
+ description: string;
912
+ retry: string;
913
+ };
914
+ errors: {
915
+ siteNotFound: string;
916
+ siteConfigError: string;
917
+ pageNotFound: string;
918
+ defaultSiteTitle: string;
919
+ free404Hint: string;
920
+ free404Title: string;
921
+ free404Subtitle: string;
922
+ free404Cta: string;
923
+ free404Feature1: string;
924
+ free404Feature2: string;
925
+ free404Feature3: string;
926
+ free404Feature4: string;
927
+ pro404Title: string;
928
+ pro404Subtitle: string;
929
+ pro404BackHome: string;
930
+ };
931
+ comingSoon: {
932
+ metadataTitle: string;
933
+ metadataDescription: string;
934
+ freeHint: string;
935
+ proTitle: string;
936
+ proSubtitle: string;
937
+ };
938
+ checkout: {
939
+ cancelAndBack: string;
940
+ loadFailedTitle: string;
941
+ loadFailedDescription: string;
942
+ retry: string;
943
+ paymentUnavailableTitle: string;
944
+ paymentUnavailableSellerNotReady: string;
945
+ paymentUnavailableProviderError: string;
946
+ paymentUnavailableUnsupportedCurrency: string;
947
+ deliveryUnavailableTitle: string;
948
+ deliveryUnavailableDescription: string;
949
+ errors: {
950
+ purchase_limit_reached: string;
951
+ purchase_limit_reached_fallback: string;
952
+ total_sales_limit_reached: string;
953
+ quantity_exceeds_remaining: string;
954
+ quantity_exceeds_remaining_fallback: string;
955
+ quantity_exceeds_per_order_limit: string;
956
+ quantity_exceeds_per_order_limit_fallback: string;
957
+ amount_below_minimum: string;
958
+ amount_below_minimum_fallback: string;
959
+ amount_exceeds_maximum: string;
960
+ amount_exceeds_maximum_fallback: string;
961
+ invalid_currency: string;
962
+ provider_unsupported_currency: string;
963
+ product_archived: string;
964
+ store_paused: string;
965
+ tier_not_published: string;
966
+ no_pricing_tier: string;
967
+ payment_request_failed: string;
968
+ network_error: string;
969
+ default: string;
970
+ };
971
+ summaryTitle: string;
972
+ quantity: string;
973
+ total: string;
974
+ payNow: string;
975
+ confirmFree: string;
976
+ securePayByProvider: string;
977
+ securePayDetail: string;
978
+ legalConsent: string;
979
+ legalTermsLabel: string;
980
+ legalPrivacyLabel: string;
981
+ invalidCheckout: string;
982
+ backToStore: string;
983
+ paymentFailed: string;
984
+ shippingFeeChanged: string;
985
+ processing: string;
986
+ unitPrice: string;
987
+ subtotal: string;
988
+ editCart: string;
989
+ itemCount: string;
990
+ discount: string;
991
+ haveDiscountCode: string;
992
+ discountCodePlaceholder: string;
993
+ discountCode: string;
994
+ applyDiscount: string;
995
+ invalidDiscountCode: string;
996
+ customerInfo: string;
997
+ nameLabel: string;
998
+ namePlaceholder: string;
999
+ phoneLabel: string;
1000
+ optional: string;
1001
+ phonePlaceholder: string;
1002
+ noteLabel: string;
1003
+ notePlaceholder: string;
1004
+ paymentMethod: string;
1005
+ providerNames: {
1006
+ PAYUNI: string;
1007
+ SHOPLINE_PAY: string;
1008
+ };
1009
+ aggregatorOption: string;
1010
+ providedBy: string;
1011
+ methods: {
1012
+ card: string;
1013
+ apple_pay: string;
1014
+ google_pay: string;
1015
+ atm: string;
1016
+ cvs: string;
1017
+ line_pay: string;
1018
+ jko_pay: string;
1019
+ bnpl: string;
1020
+ };
1021
+ methodHints: {
1022
+ apple_pay: string;
1023
+ google_pay: string;
1024
+ atm: string;
1025
+ cvs: string;
1026
+ line_pay: string;
1027
+ jko_pay: string;
1028
+ bnpl: string;
1029
+ };
1030
+ redirectNotice: string;
1031
+ cardNumber: string;
1032
+ cardExpiry: string;
1033
+ cardCvc: string;
1034
+ cardDetails: string;
1035
+ installmentLabel: string;
1036
+ installmentOnce: string;
1037
+ installmentUnit: string;
1038
+ contactSeller: string;
1039
+ phoneInvalid: string;
1040
+ phoneRequired: string;
1041
+ emailLabel: string;
1042
+ guestDoneTitle: string;
1043
+ guestDoneMessage: string;
1044
+ emailInvalid: string;
1045
+ emailPrivacyHint: string;
1046
+ acceptsMarketingLabel: string;
1047
+ deliveryTitle: string;
1048
+ shippingFee: string;
1049
+ freeShipping: string;
1050
+ shipmentsCount: string;
1051
+ shipmentLabel: string;
1052
+ shipmentBoxCount: string;
1053
+ splitByPackage: string;
1054
+ combineShipping: string;
1055
+ splitRequired: string;
1056
+ invoice: {
1057
+ sectionTitle: string;
1058
+ personal: string;
1059
+ company: string;
1060
+ donation: string;
1061
+ personalShort: string;
1062
+ companyShort: string;
1063
+ donationShort: string;
1064
+ mobileBarcode: string;
1065
+ citizenCert: string;
1066
+ mobileBarcodeShort: string;
1067
+ citizenCertShort: string;
1068
+ memberCarrier: string;
1069
+ taxIdLabel: string;
1070
+ companyNameLabel: string;
1071
+ companyAddressLabel: string;
1072
+ donationCodeLabel: string;
1073
+ donationCodeHint: string;
1074
+ mobileBarcodeHint: string;
1075
+ citizenCertHint: string;
1076
+ invalidMobileBarcode: string;
1077
+ invalidCitizenCert: string;
1078
+ invalidTaxId: string;
1079
+ invalidDonationCode: string;
1080
+ invalidCompanyName: string;
1081
+ invalidCompanyAddress: string;
1082
+ taxIdRequired: string;
1083
+ companyNameRequired: string;
1084
+ companyAddressRequired: string;
1085
+ donationCodeRequired: string;
1086
+ defaultHint: string;
1087
+ expandCarrier: string;
1088
+ donationTag919: string;
1089
+ donationTag7585: string;
1090
+ donationTag25885: string;
1091
+ registrySource: string;
1092
+ registryInactive: string;
1093
+ };
1094
+ deliveryMethod: string;
1095
+ recipientSameAsCustomer: string;
1096
+ recipientName: string;
1097
+ recipientNamePlaceholder: string;
1098
+ recipientPhone: string;
1099
+ recipientPhonePlaceholder: string;
1100
+ shippingAddress: string;
1101
+ postalCode: string;
1102
+ region: string;
1103
+ locality: string;
1104
+ addressLine1: string;
1105
+ addressLine2: string;
1106
+ cvsStore: string;
1107
+ selectCvsStore: string;
1108
+ methodHomeDelivery: string;
1109
+ methodCvsPickup: string;
1110
+ methodSelfPickup: string;
1111
+ errRecipientName: string;
1112
+ errRecipientPhone: string;
1113
+ errRecipientPhoneInvalid: string;
1114
+ errRecipientNameInvalid: string;
1115
+ errDeliveryMethod: string;
1116
+ errAddress: string;
1117
+ errCvsStore: string;
1118
+ openingCvsStore: string;
1119
+ errCvsStoreTemperature: string;
1120
+ errCvsStoreNotSupported: string;
1121
+ errCvsStoreUnavailable: string;
1122
+ errCvsStoreReselect: string;
1123
+ errAddressStreetUnknown: string;
1124
+ errAddressDistrictMismatch: string;
1125
+ errAddressMissingNumber: string;
1126
+ processingTitle: string;
1127
+ processingHint: string;
1128
+ paymentResultCancelled: string;
1129
+ paymentResultFailed: string;
1130
+ purchaseLimitTitle: string;
1131
+ purchaseLimitDescription: string;
1132
+ purchaseLimitRemaining: string;
1133
+ viewPurchasesLogin: string;
1134
+ storeSelectedAtPayment: string;
1135
+ summaryWithMore: string;
1136
+ cvsCallback: {
1137
+ doneTitle: string;
1138
+ doneNoOpener: string;
1139
+ chainMismatch: string;
1140
+ verifyFailed: string;
1141
+ };
1142
+ };
1143
+ orderStatus: {
1144
+ paidTitle: string;
1145
+ paidSubtitle: string;
1146
+ paidTitleWithNumber: string;
1147
+ confirmationSentTo: string;
1148
+ awaitingTitle: string;
1149
+ awaitingSubtitle: string;
1150
+ awaitingDue: string;
1151
+ awaitingAfterPaid: string;
1152
+ processingTitle: string;
1153
+ processingSubtitle: string;
1154
+ processingTimeoutTitle: string;
1155
+ processingTimeoutSubtitle: string;
1156
+ failedTitle: string;
1157
+ failedSubtitle: string;
1158
+ expiredTitle: string;
1159
+ expiredSubtitle: string;
1160
+ retryCheckout: string;
1161
+ continueShopping: string;
1162
+ thirdPartyInstructionsNotice: string;
1163
+ thirdPartyPaidNotice: string;
1164
+ savePageHint: string;
1165
+ copyLink: string;
1166
+ linkCopied: string;
1167
+ linkValidUntil: string;
1168
+ instructions: {
1169
+ title: string;
1170
+ bankCode: string;
1171
+ account: string;
1172
+ amount: string;
1173
+ amountExact: string;
1174
+ paymentCode: string;
1175
+ channel: string;
1176
+ dueAt: string;
1177
+ copy: string;
1178
+ copied: string;
1179
+ copyAll: string;
1180
+ atmHint: string;
1181
+ cvsHint: string;
1182
+ genericHint: string;
1183
+ channels: {
1184
+ SEVEN: string;
1185
+ FAMILY: string;
1186
+ HILIFE: string;
1187
+ OK: string;
1188
+ };
1189
+ };
1190
+ digital: {
1191
+ title: string;
1192
+ description: string;
1193
+ cta: string;
1194
+ awaiting: string;
1195
+ };
1196
+ delivery: {
1197
+ title: string;
1198
+ method: string;
1199
+ recipient: string;
1200
+ address: string;
1201
+ pickupCvs: string;
1202
+ pickupLocker: string;
1203
+ pickupStore: string;
1204
+ pickupGeneric: string;
1205
+ pendingShipment: string;
1206
+ trackingNo: string;
1207
+ track: string;
1208
+ pickupDeadlineLabel: string;
1209
+ etaLabel: string;
1210
+ shipmentStatus: string;
1211
+ status: {
1212
+ PENDING: string;
1213
+ BOOKED: string;
1214
+ LABEL_CREATED: string;
1215
+ IN_TRANSIT: string;
1216
+ AT_STORE: string;
1217
+ DELIVERED: string;
1218
+ RETURNED: string;
1219
+ CANCELED: string;
1220
+ ASSIGNING_COURIER: string;
1221
+ COURIER_ACCEPTED: string;
1222
+ COURIER_PICKING_UP: string;
1223
+ COURIER_PICKED_UP: string;
1224
+ EXCEPTION: string;
1225
+ ACTION_REQUIRED: string;
1226
+ };
1227
+ };
1228
+ summary: {
1229
+ title: string;
1230
+ quantity: string;
1231
+ subtotal: string;
1232
+ discount: string;
1233
+ shipping: string;
1234
+ free: string;
1235
+ total: string;
1236
+ paymentMethod: string;
1237
+ placedAt: string;
1238
+ refunded: string;
1239
+ refundedQuantity: string;
1240
+ accessRevoked: string;
1241
+ };
1242
+ customer: {
1243
+ title: string;
1244
+ email: string;
1245
+ name: string;
1246
+ };
1247
+ invoice: {
1248
+ title: string;
1249
+ pending: string;
1250
+ failed: string;
1251
+ number: string;
1252
+ secondaryCode: string;
1253
+ issuedAt: string;
1254
+ verify: string;
1255
+ type: string;
1256
+ typePersonal: string;
1257
+ typeCompany: string;
1258
+ typeDonation: string;
1259
+ carrier: string;
1260
+ carrierMobile: string;
1261
+ carrierCitizen: string;
1262
+ carrierMember: string;
1263
+ carrierPrint: string;
1264
+ taxId: string;
1265
+ buyerName: string;
1266
+ donationCode: string;
1267
+ registrationNumber: string;
1268
+ businessNumber: string;
1269
+ };
1270
+ help: {
1271
+ description: string;
1272
+ };
1273
+ methodTypes: {
1274
+ card: string;
1275
+ apple_pay: string;
1276
+ google_pay: string;
1277
+ samsung_pay: string;
1278
+ atm: string;
1279
+ cvs: string;
1280
+ line_pay: string;
1281
+ jko_pay: string;
1282
+ bnpl: string;
1283
+ cod: string;
1284
+ icash_pay: string;
1285
+ aftee: string;
1286
+ bank_account: string;
1287
+ free: string;
1288
+ unknown: string;
1289
+ };
1290
+ redactedTitle: string;
1291
+ redactedDescription: string;
1292
+ signInToView: string;
1293
+ orderTitle: string;
1294
+ orderTitleNoNumber: string;
1295
+ refunds: {
1296
+ title: string;
1297
+ shippingIncluded: string;
1298
+ reasons: {
1299
+ DUPLICATE: string;
1300
+ REQUESTED_BY_CUSTOMER: string;
1301
+ FRAUDULENT: string;
1302
+ OTHER: string;
1303
+ };
1304
+ };
1305
+ };
1306
+ common: {
1307
+ language: string;
1308
+ languageTaiwan: string;
1309
+ languageHongKong: string;
1310
+ previous: string;
1311
+ next: string;
1312
+ };
1313
+ cookieConsent: {
1314
+ title: string;
1315
+ description: string;
1316
+ learnMore: string;
1317
+ acceptNecessary: string;
1318
+ acceptAll: string;
1319
+ close: string;
1320
+ settings: string;
1321
+ };
1322
+ login: {
1323
+ title: string;
1324
+ subtitle: string;
1325
+ verifying: string;
1326
+ verificationFailed: string;
1327
+ signInWithGoogle: string;
1328
+ signingIn: string;
1329
+ footer: string;
1330
+ };
1331
+ blog: {
1332
+ title: string;
1333
+ home: string;
1334
+ allPosts: string;
1335
+ readingTimeSuffix: string;
1336
+ minutesShort: string;
1337
+ categoryPrefix: string;
1338
+ tagPrefix: string;
1339
+ authorPrefix: string;
1340
+ noPosts: string;
1341
+ backToBlog: string;
1342
+ relatedCategory: string;
1343
+ postsCount: string;
1344
+ share: string;
1345
+ shareOn: string;
1346
+ copyLink: string;
1347
+ linkCopied: string;
1348
+ shareEmail: string;
1349
+ tableOfContents: string;
1350
+ gatedTitle: string;
1351
+ gatedDescription: string;
1352
+ gatedSignIn: string;
1353
+ };
1354
+ shop: {
1355
+ title: string;
1356
+ empty: string;
1357
+ priceFrom: string;
1358
+ free: string;
1359
+ viewProduct: string;
1360
+ pageIndicator: string;
1361
+ productUnpublishedNotice: string;
1362
+ };
1363
+ delivery: {
1364
+ name: {
1365
+ selfPickup: string;
1366
+ digitalDelivery: string;
1367
+ cvsFallback: string;
1368
+ homeFallback: string;
1369
+ onDemandFallback: string;
1370
+ meetup: string;
1371
+ localPickup: string;
1372
+ };
1373
+ carrier: {
1374
+ unimart: string;
1375
+ fami: string;
1376
+ hilife: string;
1377
+ okmart: string;
1378
+ tcat: string;
1379
+ ecan: string;
1380
+ post: string;
1381
+ uber: string;
1382
+ lalamove: string;
1383
+ pandago: string;
1384
+ };
1385
+ };
1386
+ form: {
1387
+ submit: string;
1388
+ submitting: string;
1389
+ success: string;
1390
+ redirecting: string;
1391
+ error: string;
1392
+ required: string;
1393
+ invalidEmail: string;
1394
+ invalidPhone: string;
1395
+ invalidDate: string;
1396
+ invalidTime: string;
1397
+ tooLong: string;
1398
+ otherRequired: string;
1399
+ duplicate: string;
1400
+ temporarilyUnavailable: string;
1401
+ rateLimited: string;
1402
+ verificationExpired: string;
1403
+ outdated: string;
1404
+ tooLarge: string;
1405
+ invalid: string;
1406
+ tooShort: string;
1407
+ invalidNumber: string;
1408
+ notInteger: string;
1409
+ numberMin: string;
1410
+ numberMax: string;
1411
+ numberRange: string;
1412
+ invalidUrl: string;
1413
+ dateMin: string;
1414
+ dateMax: string;
1415
+ dateRange: string;
1416
+ tooFewOptions: string;
1417
+ tooManyOptions: string;
1418
+ selectPlaceholder: string;
1419
+ invalidAddress: string;
1420
+ invalidPostalCode: string;
1421
+ addressCountry: string;
1422
+ addressRecipient: string;
1423
+ addressLine1: string;
1424
+ addressLine2: string;
1425
+ addressPostal_postal: string;
1426
+ addressPostal_zip: string;
1427
+ addressPostal_pin: string;
1428
+ addressPostal_eircode: string;
1429
+ addressLocality_city: string;
1430
+ addressLocality_district: string;
1431
+ addressLocality_post_town: string;
1432
+ addressLocality_suburb: string;
1433
+ addressRegion_area: string;
1434
+ addressRegion_county: string;
1435
+ addressRegion_department: string;
1436
+ addressRegion_district: string;
1437
+ addressRegion_do_si: string;
1438
+ addressRegion_emirate: string;
1439
+ addressRegion_island: string;
1440
+ addressRegion_oblast: string;
1441
+ addressRegion_parish: string;
1442
+ addressRegion_prefecture: string;
1443
+ addressRegion_province: string;
1444
+ addressRegion_state: string;
1445
+ otherOption: string;
1446
+ otherPlaceholder: string;
1447
+ closed: string;
1448
+ fileChoose: string;
1449
+ fileLimitHint: string;
1450
+ fileWaiting: string;
1451
+ fileUploading: string;
1452
+ fileUploadFailed: string;
1453
+ fileTooLarge: string;
1454
+ fileTypeNotAllowed: string;
1455
+ fileUnavailable: string;
1456
+ fileRemove: string;
1457
+ marketingOptIn: string;
1458
+ subscribeOnSubmit: string;
1459
+ notOpenYet: string;
1460
+ full: string;
1461
+ invalidTaxId: string;
1462
+ taxIdChecking: string;
1463
+ taxIdRegisteredName: string;
1464
+ taxIdInactive: string;
1465
+ taxIdSource: string;
1466
+ };
1467
+ ui: {
1468
+ navItems: string;
1469
+ contactUs: string;
1470
+ backToTop: string;
1471
+ backToHome: string;
1472
+ footerNavAriaLabel: string;
1473
+ navMenu: string;
1474
+ openMenu: string;
1475
+ closeMenu: string;
1476
+ close: string;
1477
+ decreaseQuantity: string;
1478
+ increaseQuantity: string;
1479
+ buyNow: string;
1480
+ selectOption: string;
1481
+ variantUnavailable: string;
1482
+ soldOut: string;
1483
+ addToCart: string;
1484
+ addedToCart: string;
1485
+ cart: string;
1486
+ cartEmpty: string;
1487
+ cartCheckout: string;
1488
+ cartSubtotal: string;
1489
+ cartTotal: string;
1490
+ cartDiscount: string;
1491
+ cartEstimatedShipping: string;
1492
+ cartRemove: string;
1493
+ cartContinueShopping: string;
1494
+ cartItemUnavailable: string;
1495
+ cartNoCommonDelivery: string;
1496
+ cartStorePaused: string;
1497
+ cartComingSoon: string;
1498
+ cartLoadFailed: string;
1499
+ viewCart: string;
1500
+ cartPurchaseLimit: string;
1501
+ cartShippingAtCheckout: string;
1502
+ cartFreeShipping: string;
1503
+ cartFreeShippingRemaining: string;
1504
+ cartFreeShippingReached: string;
1505
+ cartSecureCheckout: string;
1506
+ cartStartShopping: string;
1507
+ cartEstimatedTotal: string;
1508
+ checkoutArchived: string;
1509
+ checkoutStorePaused: string;
1510
+ checkoutComingSoon: string;
1511
+ quickBuyPreviewHint: string;
1512
+ getFree: string;
1513
+ customAmount: string;
1514
+ planFallbackName: string;
1515
+ noPlansAvailable: string;
1516
+ quantity: string;
1517
+ selectPlan: string;
1518
+ choosePlan: string;
1519
+ minutesRead: string;
1520
+ published: string;
1521
+ noArticles: string;
1522
+ draftArticleNotice: string;
1523
+ autoDisplayPublishedArticles: string;
1524
+ tableOfContents: string;
1525
+ previous: string;
1526
+ next: string;
1527
+ clickToRead: string;
1528
+ pdfPages: string;
1529
+ download: string;
1530
+ monday: string;
1531
+ tuesday: string;
1532
+ wednesday: string;
1533
+ thursday: string;
1534
+ friday: string;
1535
+ saturday: string;
1536
+ sunday: string;
1537
+ closed: string;
1538
+ sold: string;
1539
+ reviews: string;
1540
+ reviewDialogTitle: string;
1541
+ reviewDialogHistoricalNote: string;
1542
+ reviewDialogLoadMore: string;
1543
+ reviewVerifiedPurchase: string;
1544
+ reviewStoreReply: string;
1545
+ showMore: string;
1546
+ showLess: string;
1547
+ skipToContent: string;
1548
+ mainNavigation: string;
1549
+ mobileNavigation: string;
1550
+ moreNav: string;
1551
+ followUs: string;
1552
+ socialProfileLink: string;
1553
+ carouselProgress: string;
1554
+ slideImage: string;
1555
+ slideCard: string;
1556
+ goToItem: string;
1557
+ enlargeImage: string;
1558
+ imageShareTitle: string;
1559
+ imageShareText: string;
1560
+ resetZoom: string;
1561
+ zoomIn: string;
1562
+ zoomOut: string;
1563
+ downloadImage: string;
1564
+ share: string;
1565
+ loading: string;
1566
+ retry: string;
1567
+ untitledFile: string;
1568
+ pdfViewer: string;
1569
+ pdfLoadFailed: string;
1570
+ pdfJumpToPage: string;
1571
+ pdfEnterPage: string;
1572
+ pdfPageStatus: string;
1573
+ pdfThumbnails: string;
1574
+ pdfGoToPage: string;
1575
+ playerPlay: string;
1576
+ playerPause: string;
1577
+ playerReplay: string;
1578
+ playerMute: string;
1579
+ playerUnmute: string;
1580
+ playerVolume: string;
1581
+ playerSeekBackward: string;
1582
+ playerSeekForward: string;
1583
+ playerSpeed: string;
1584
+ playerSpeedNormal: string;
1585
+ playerPip: string;
1586
+ playerAirPlay: string;
1587
+ playerCast: string;
1588
+ playerFullscreen: string;
1589
+ playerExitFullscreen: string;
1590
+ playerPipActive: string;
1591
+ playerPipReturn: string;
1592
+ playerSettings: string;
1593
+ playerQuality: string;
1594
+ playerQualityAuto: string;
1595
+ playerQualityProcessing: string;
1596
+ playerBuffering: string;
1597
+ playerCaptions: string;
1598
+ playerCaptionsOff: string;
1599
+ playerCaptionsAuto: string;
1600
+ playerCaptionsTranslated: string;
1601
+ countdown: string;
1602
+ countdownDays: string;
1603
+ countdownHours: string;
1604
+ countdownMinutes: string;
1605
+ countdownSeconds: string;
1606
+ countdownRemaining: string;
1607
+ countdownEnded: string;
1608
+ countdownEndsAt: string;
1609
+ openInGoogleMaps: string;
1610
+ address: string;
1611
+ phone: string;
1612
+ copyAddress: string;
1613
+ openingHours: string;
1614
+ showAllHours: string;
1615
+ hideAllHours: string;
1616
+ todayTag: string;
1617
+ freeShippingThreshold: string;
1618
+ ordersOver: string;
1619
+ belowThresholdFee: string;
1620
+ selectDistanceTier: string;
1621
+ invalidAmount: string;
1622
+ minimumAmount: string;
1623
+ announcement: string;
1624
+ closeAnnouncement: string;
1625
+ botProtection: string;
1626
+ botProtectionLoading: string;
1627
+ playFacebookVideo: string;
1628
+ playYouTubeVideo: string;
1629
+ embedUnavailable: string;
1630
+ embedViewOn: string;
1631
+ embedLoadFailed: string;
1632
+ pinterestLoadFailed: string;
1633
+ youtubeVideo: string;
1634
+ tiktokVideo: string;
1635
+ behanceProject: string;
1636
+ facebookPost: string;
1637
+ instagramPost: string;
1638
+ threadsPost: string;
1639
+ googleForm: string;
1640
+ surveyCakeForm: string;
1641
+ applePodcastEpisode: string;
1642
+ kanorioBannerTagline: string;
1643
+ kanorioBannerCta: string;
1644
+ kanorioBannerTaglineExpanded: string;
1645
+ kanorioBannerCtaExpanded: string;
1646
+ brandLogoAlt: string;
1647
+ openLink: string;
1648
+ opensInNewWindow: string;
1649
+ productImage: string;
1650
+ phonePlaceholder: string;
1651
+ selectCountry: string;
1652
+ countrySearch: string;
1653
+ countryNoMatch: string;
1654
+ countryGroupCommon: string;
1655
+ countryGroupAll: string;
1656
+ businessHoursNotSet: string;
1657
+ businessClosed: string;
1658
+ businessClosedOpensAt: string;
1659
+ businessTomorrow: string;
1660
+ businessToday: string;
1661
+ businessClosingSoon: string;
1662
+ businessOpenUntil: string;
1663
+ signIn: string;
1664
+ myAccount: string;
1665
+ language: string;
1666
+ selectLanguage: string;
1667
+ breadcrumbExpand: string;
1668
+ };
1669
+ productInfo: {
1670
+ payment: string;
1671
+ delivery: string;
1672
+ leadTime: string;
1673
+ invoice: string;
1674
+ invoiceAutoIssue: string;
1675
+ returns: string;
1676
+ returnPolicyLink: string;
1677
+ instantAccess: string;
1678
+ purchaseNotes: string;
1679
+ freeShipping: string;
1680
+ freeShippingOver: string;
1681
+ transitDays: string;
1682
+ };
1683
+ promotion: {
1684
+ badgePercentage: string;
1685
+ badgeFixedAmount: string;
1686
+ badgeOverridePrice: string;
1687
+ badgeFlashSale: string;
1688
+ badgeTimeLimited: string;
1689
+ badgeFirstPurchase: string;
1690
+ badgeReturning: string;
1691
+ badgeQuantity: string;
1692
+ badgeSpendThreshold: string;
1693
+ taglinePercentageOff: string;
1694
+ taglineFixedOff: string;
1695
+ taglineOverridePrice: string;
1696
+ taglineFirstPurchase: string;
1697
+ taglineReturning: string;
1698
+ taglineQuantityMin: string;
1699
+ taglineSpendMin: string;
1700
+ taglineWithCondition: string;
1701
+ taglineEndsSoon: string;
1702
+ taglineLimited: string;
1703
+ };
1704
+ search: {
1705
+ button: string;
1706
+ dialogTitle: string;
1707
+ placeholder: string;
1708
+ keyboardHint: string;
1709
+ soldOut: string;
1710
+ tooShort: string;
1711
+ resultCount: string;
1712
+ noResults: string;
1713
+ noResultsHint: string;
1714
+ browseBlog: string;
1715
+ browseShop: string;
1716
+ viewAll: string;
1717
+ loading: string;
1718
+ error: string;
1719
+ retry: string;
1720
+ recent: string;
1721
+ clearRecent: string;
1722
+ previewNotice: string;
1723
+ pageTitle: string;
1724
+ resultsFor: string;
1725
+ submit: string;
1726
+ };
1727
+ account: {
1728
+ title: string;
1729
+ signInTitle: string;
1730
+ signInSubtitle: string;
1731
+ signInSubtitleChoose: string;
1732
+ emailCodeHint: string;
1733
+ continueWithEmail: string;
1734
+ orContinueWith: string;
1735
+ continueWithPasskey: string;
1736
+ continueWithGoogle: string;
1737
+ continueWithProvider: string;
1738
+ lastUsed: string;
1739
+ codeStepTitle: string;
1740
+ codeSentHint: string;
1741
+ codeLabel: string;
1742
+ verifyAndSignIn: string;
1743
+ verifying: string;
1744
+ sendingCode: string;
1745
+ resendCode: string;
1746
+ resendIn: string;
1747
+ useAnotherEmail: string;
1748
+ signedInContinue: string;
1749
+ sessionChecking: string;
1750
+ signOut: string;
1751
+ passkeyOfferTitle: string;
1752
+ passkeyOfferBody: string;
1753
+ passkeyOfferCreate: string;
1754
+ passkeyOfferSkip: string;
1755
+ inAppBrowserTitle: string;
1756
+ inAppBrowserBody: string;
1757
+ inAppBrowserCopyLink: string;
1758
+ inAppBrowserCopied: string;
1759
+ inAppBrowserUseEmail: string;
1760
+ errorSignupDisabled: string;
1761
+ errorSendFailed: string;
1762
+ errorMethodDisabled: string;
1763
+ errorEmailNotVerified: string;
1764
+ errorNoEmail: string;
1765
+ errorProviderFailed: string;
1766
+ errorPasskeyUnsupported: string;
1767
+ errorPasskeyFailed: string;
1768
+ errorPasskeyAlreadyRegistered: string;
1769
+ errorServiceUnavailable: string;
1770
+ errorEmailSignInPaused: string;
1771
+ emailLabel: string;
1772
+ emailPlaceholder: string;
1773
+ nav: {
1774
+ orders: string;
1775
+ content: string;
1776
+ account: string;
1777
+ };
1778
+ shell: {
1779
+ backToSite: string;
1780
+ menu: string;
1781
+ signedInAs: string;
1782
+ providedBy: string;
1783
+ };
1784
+ ordersEmptyTitle: string;
1785
+ ordersEmptyDescription: string;
1786
+ orderNumber: string;
1787
+ orderStatusLabel: string;
1788
+ orderStatusPaid: string;
1789
+ orderStatusPartiallyRefunded: string;
1790
+ orderStatusRefunded: string;
1791
+ orderStatusDisputed: string;
1792
+ orderStatusReversed: string;
1793
+ orderStatusUnpaid: string;
1794
+ orderStatusCancelled: string;
1795
+ orderViewDetail: string;
1796
+ orderBackToList: string;
1797
+ orderPlacedAt: string;
1798
+ orderDownloadReceipt: string;
1799
+ contentEmptyTitle: string;
1800
+ contentEmptyDescription: string;
1801
+ contentExpiredBadge: string;
1802
+ contentExpiresOn: string;
1803
+ contentAvailableFrom: string;
1804
+ contentOpen: string;
1805
+ contentDownload: string;
1806
+ contentUnitsCount: string;
1807
+ contentProgress: string;
1808
+ contentWatchedMinutes: string;
1809
+ contentWatchedHours: string;
1810
+ contentLastWatched: string;
1811
+ contentCompleted: string;
1812
+ contentMarkComplete: string;
1813
+ contentOptional: string;
1814
+ contentQuizSubmit: string;
1815
+ contentQuizScore: string;
1816
+ contentQuizPassed: string;
1817
+ contentQuizFailed: string;
1818
+ contentQuizAttemptsLeft: string;
1819
+ contentQuizNoAttempts: string;
1820
+ contentQuizRetry: string;
1821
+ contentQuizPassingScore: string;
1822
+ contentQuizNotReady: string;
1823
+ contentQuizSelectAll: string;
1824
+ contentQuizCorrectCount: string;
1825
+ contentQuizPracticeHint: string;
1826
+ contentQuizPracticeAgain: string;
1827
+ contentQuizAcceptedAnswers: string;
1828
+ contentQuizTextPlaceholder: string;
1829
+ contentQuizNumericPlaceholder: string;
1830
+ contentQuizCorrectMark: string;
1831
+ contentQuizWrongMark: string;
1832
+ contentCertificateDownload: string;
1833
+ contentAutoplayNext: string;
1834
+ contentCompleteAndContinue: string;
1835
+ contentCompleteToContinue: string;
1836
+ contentOutline: string;
1837
+ contentShowOutline: string;
1838
+ contentHideOutline: string;
1839
+ contentCloseOutline: string;
1840
+ contentSettings: string;
1841
+ contentMinutes: string;
1842
+ contentPages: string;
1843
+ contentUnitEmpty: string;
1844
+ contentRetry: string;
1845
+ contentLastViewed: string;
1846
+ contentCourseCompletedTitle: string;
1847
+ contentCourseCompletedOn: string;
1848
+ contentKeepBrowsing: string;
1849
+ contentAttachments: string;
1850
+ contentDownloadFile: string;
1851
+ contentTranscript: string;
1852
+ contentTranscriptShow: string;
1853
+ contentTranscriptHide: string;
1854
+ contentTranscriptSearch: string;
1855
+ contentTranscriptMatches: string;
1856
+ contentTranscriptNoResults: string;
1857
+ contentTranscriptDownload: string;
1858
+ contentTranscriptLanguage: string;
1859
+ contentTranscriptFollow: string;
1860
+ contentTranscriptAutoGenerated: string;
1861
+ contentTranscriptAutoTranslated: string;
1862
+ contentContinueWith: string;
1863
+ contentStartCourse: string;
1864
+ contentOpenFiles: string;
1865
+ contentCompletedOn: string;
1866
+ certificateTitle: string;
1867
+ certificateAwardedTo: string;
1868
+ certificateCompleted: string;
1869
+ certificateIssuedOn: string;
1870
+ certificateSerial: string;
1871
+ certificateSampleName: string;
1872
+ certificatePreviewWatermark: string;
1873
+ certificateLinkExpiredTitle: string;
1874
+ certificateLinkExpiredBody: string;
1875
+ certificateLinkInvalidTitle: string;
1876
+ certificateLinkInvalidBody: string;
1877
+ certificateLinkBusyTitle: string;
1878
+ certificateLinkBusyBody: string;
1879
+ contentContinue: string;
1880
+ contentStart: string;
1881
+ contentLocked: string;
1882
+ contentPreviewBadge: string;
1883
+ contentUnlocksAt: string;
1884
+ contentLockedBy: string;
1885
+ contentBackToList: string;
1886
+ contentNextUnit: string;
1887
+ contentPreviousUnit: string;
1888
+ contentLoadError: string;
1889
+ contentNoUnits: string;
1890
+ profileNameLabel: string;
1891
+ profileNamePlaceholder: string;
1892
+ profileEmailLabel: string;
1893
+ profileInvoiceTitle: string;
1894
+ profileInvoiceKindLabel: string;
1895
+ profileInvoicePersonal: string;
1896
+ profileInvoiceMobile: string;
1897
+ profileInvoiceCitizen: string;
1898
+ profileInvoiceDonate: string;
1899
+ profileInvoiceCompany: string;
1900
+ profileMobileBarcodePlaceholder: string;
1901
+ profileCitizenCertPlaceholder: string;
1902
+ profileDonateCodePlaceholder: string;
1903
+ profileCompanyTaxIdLabel: string;
1904
+ profileCompanyTaxIdPlaceholder: string;
1905
+ profileCompanyTitleLabel: string;
1906
+ profileCompanyTitlePlaceholder: string;
1907
+ profileSave: string;
1908
+ profileSaving: string;
1909
+ profileSaved: string;
1910
+ devicesDescription: string;
1911
+ deviceCurrent: string;
1912
+ deviceUnknown: string;
1913
+ deviceLastActive: string;
1914
+ deviceSignOut: string;
1915
+ deviceSignOutOthers: string;
1916
+ errorInvalidEmail: string;
1917
+ errorInvalidCode: string;
1918
+ errorCodeExpired: string;
1919
+ errorTooManyAttempts: string;
1920
+ errorAccountBlocked: string;
1921
+ errorRateLimited: string;
1922
+ errorBotProtection: string;
1923
+ errorGeneric: string;
1924
+ taxIdentityPending: string;
1925
+ taxIdentityVerified: string;
1926
+ taxIdentityNotFound: string;
1927
+ taxIdentityUnavailable: string;
1928
+ settings: {
1929
+ intro: string;
1930
+ common: {
1931
+ save: string;
1932
+ saving: string;
1933
+ saved: string;
1934
+ cancel: string;
1935
+ close: string;
1936
+ remove: string;
1937
+ edit: string;
1938
+ add: string;
1939
+ confirm: string;
1940
+ optional: string;
1941
+ };
1942
+ profile: {
1943
+ title: string;
1944
+ description: string;
1945
+ nameLabel: string;
1946
+ namePlaceholder: string;
1947
+ };
1948
+ email: {
1949
+ title: string;
1950
+ description: string;
1951
+ currentLabel: string;
1952
+ changeAction: string;
1953
+ newLabel: string;
1954
+ sendCode: string;
1955
+ codeSentTo: string;
1956
+ codeLabel: string;
1957
+ confirmAction: string;
1958
+ resend: string;
1959
+ changed: string;
1960
+ errorInUse: string;
1961
+ errorSame: string;
1962
+ errorInvalid: string;
1963
+ errorInvalidCode: string;
1964
+ errorCodeExpired: string;
1965
+ errorTooManyAttempts: string;
1966
+ };
1967
+ addresses: {
1968
+ title: string;
1969
+ description: string;
1970
+ empty: string;
1971
+ add: string;
1972
+ dialogAddTitle: string;
1973
+ dialogEditTitle: string;
1974
+ kindLabel: string;
1975
+ kindShipping: string;
1976
+ kindBilling: string;
1977
+ phoneLabel: string;
1978
+ setDefault: string;
1979
+ defaultBadge: string;
1980
+ saveAction: string;
1981
+ confirmRemoveTitle: string;
1982
+ confirmRemoveBody: string;
1983
+ errorInvalid: string;
1984
+ errorPhone: string;
1985
+ errorRequired: string;
1986
+ errorPostalCode: string;
1987
+ errorLimit: string;
1988
+ };
1989
+ taxIds: {
1990
+ title: string;
1991
+ description: string;
1992
+ empty: string;
1993
+ add: string;
1994
+ dialogAddTitle: string;
1995
+ dialogEditTitle: string;
1996
+ countryLabel: string;
1997
+ typeLabel: string;
1998
+ valueLabel: string;
1999
+ nameLabel: string;
2000
+ addressLabel: string;
2001
+ saveAction: string;
2002
+ confirmRemoveTitle: string;
2003
+ confirmRemoveBody: string;
2004
+ errorInvalid: string;
2005
+ errorUnsupported: string;
2006
+ statusVerified: string;
2007
+ statusPending: string;
2008
+ statusNotFound: string;
2009
+ statusUnavailable: string;
2010
+ statusValidFormat: string;
2011
+ statusInvalidFormat: string;
2012
+ type_tw_vat: string;
2013
+ type_hk_br: string;
2014
+ type_jp_trn: string;
2015
+ type_kr_brn: string;
2016
+ type_eu_vat: string;
2017
+ type_sg_uen: string;
2018
+ type_my_itn: string;
2019
+ type_my_sst: string;
2020
+ };
2021
+ invoice: {
2022
+ companyUsesTaxId: string;
2023
+ companyNeedsTaxId: string;
2024
+ };
2025
+ marketing: {
2026
+ title: string;
2027
+ description: string;
2028
+ empty: string;
2029
+ channel_EMAIL: string;
2030
+ channel_SMS: string;
2031
+ channel_LINE: string;
2032
+ channel_WHATSAPP: string;
2033
+ subscribed: string;
2034
+ notSubscribed: string;
2035
+ pendingConfirmation: string;
2036
+ locked: string;
2037
+ };
2038
+ loginMethods: {
2039
+ title: string;
2040
+ description: string;
2041
+ emailCode: string;
2042
+ emailCodeHint: string;
2043
+ passkeysTitle: string;
2044
+ noPasskeys: string;
2045
+ addPasskey: string;
2046
+ passkeyAdded: string;
2047
+ passkeyCreated: string;
2048
+ passkeyLastUsed: string;
2049
+ passkeyNeverUsed: string;
2050
+ passkeyStale: string;
2051
+ passkeyUnsupported: string;
2052
+ passkeyFailed: string;
2053
+ confirmRemoveTitle: string;
2054
+ confirmRemoveBody: string;
2055
+ };
2056
+ devices: {
2057
+ title: string;
2058
+ };
2059
+ data: {
2060
+ title: string;
2061
+ description: string;
2062
+ download: string;
2063
+ downloadHint: string;
2064
+ deleteTitle: string;
2065
+ deleteBody: string;
2066
+ deleteAction: string;
2067
+ deleteConfirmTitle: string;
2068
+ deleteConfirmBody: string;
2069
+ deleteConfirmAction: string;
2070
+ pendingTitle: string;
2071
+ pendingBody: string;
2072
+ cancelDeletion: string;
2073
+ canceled: string;
2074
+ };
2075
+ };
2076
+ oauth2: {
2077
+ returnHint: string;
2078
+ errorTitle: string;
2079
+ errorRedirect: string;
2080
+ errorRequest: string;
2081
+ errorBlocked: string;
2082
+ };
2083
+ };
2084
+ unsubscribe: {
2085
+ confirmTitle: string;
2086
+ confirmHeading: string;
2087
+ confirmBody: string;
2088
+ confirmButton: string;
2089
+ doneTitle: string;
2090
+ doneHeading: string;
2091
+ doneBody: string;
2092
+ resubscribeButton: string;
2093
+ resubscribedTitle: string;
2094
+ resubscribedHeading: string;
2095
+ resubscribedBody: string;
2096
+ };
2097
+ };
2098
+
2099
+ type KanorioTheme = "dark" | "light" | "auto";
2100
+ /** `GET /site` 的回應(站台 id、品牌、媒體保護、列表頁狀態) */
2101
+ type KanorioSiteMeta = DeliveryPaths["/site"]["get"]["responses"][200]["content"]["application/json"];
2102
+ type KanorioSiteBrand = KanorioSiteMeta["brand"];
2103
+ interface KanorioConfig {
2104
+ /** 例如 `https://demo.kanorio.com`;省略時用目前網址的 origin(Elements 與站台同網域時) */
2105
+ siteUrl?: string;
2106
+ /** 顧客 Bearer;省略時讀 `localStorage["kanorio.customer.token"]`(`<kanorio-login>` 寫入) */
2107
+ token?: string | null;
2108
+ /** 文字語系;省略時讀 `<html lang>`,再退 en */
2109
+ locale?: string;
2110
+ theme?: KanorioTheme;
2111
+ timeZone?: string | null;
2112
+ /** 自動把站台品牌(品牌色、圓角、字體)套到 `.kanorio-elements`;`false` 時只用宿主頁的 CSS 變數 */
2113
+ brand?: boolean;
2114
+ }
2115
+ interface KanorioContextValue {
2116
+ siteUrl: string;
2117
+ token: string | null;
2118
+ setToken: (token: string | null) => void;
2119
+ locale: string;
2120
+ theme: KanorioTheme;
2121
+ timeZone: string | null;
2122
+ messages: VisitorMessages | null;
2123
+ client: CustomerContentClientLike;
2124
+ /** 站台 meta(`GET /site`,`brand: false` 時不讀);載入中或讀取失敗為 null,失敗時 `siteError` 為 true。需要它的元件自己呼叫 `useSiteMeta` */
2125
+ site: KanorioSiteMeta | null;
2126
+ siteError: boolean;
2127
+ }
2128
+ declare const TOKEN_CHANGE_EVENT = "kanorio:token-change";
2129
+ declare function loadElementsMessages(locale: string): Promise<VisitorMessages>;
2130
+ declare function loadSiteMeta(siteUrl: string): Promise<KanorioSiteMeta | null>;
2131
+ /** 測試用:清掉站台 meta 快取 */
2132
+ declare function clearSiteMetaCache(): void;
2133
+ /** `enabled` 為 false 時不打請求(例如 `brand: false` 且元件本身不需要站台 meta) */
2134
+ declare function useSiteMeta(siteUrl: string, enabled?: boolean): {
2135
+ site: KanorioSiteMeta | null;
2136
+ error: boolean;
2137
+ };
2138
+ /** 品牌 → CSS。色值、圓角尺寸與字體家族都是 Delivery 算好的,這裡只排版 */
2139
+ declare function brandCss(brand: KanorioSiteBrand, locale: string): string;
2140
+ declare function KanorioProvider({ children, ...config }: KanorioConfig & {
2141
+ children: ReactNode;
2142
+ }): react_jsx_runtime.JSX.Element;
2143
+ declare function useKanorio(overrides?: KanorioConfig): KanorioContextValue;
2144
+
2145
+ /**
2146
+ * 播放事件(觀看紀錄用,benchmarks §L):`seeked` 帶目的地、`ratechange` 帶倍速、`quality` 帶畫質高度、
2147
+ * `started` 是第一次真的播出來(算首幀時間)、`waiting`/`playing` 配對算卡頓。時間一律是媒體秒數。
2148
+ */
2149
+ type MediaPlaybackEvent = {
2150
+ type: "play" | "pause" | "ended" | "waiting" | "playing" | "started";
2151
+ time: number;
2152
+ } | {
2153
+ type: "seeked";
2154
+ time: number;
2155
+ } | {
2156
+ type: "ratechange";
2157
+ time: number;
2158
+ rate: number;
2159
+ } | {
2160
+ type: "quality";
2161
+ time: number;
2162
+ height: number | null;
2163
+ };
2164
+ /** 字幕軌(媒體 ADR 0011):VTT 網址、BCP 47 語系、來源(AI 轉錄、上傳、自動翻譯)與是否改過;預設不顯示,觀眾按 CC 才開 */
2165
+ interface CaptionTrack {
2166
+ locale: string;
2167
+ url: string;
2168
+ source: "ai" | "upload" | "translation";
2169
+ edited: boolean;
2170
+ }
2171
+ /** 播放器外框圓角的來源(見 `radius`) */
2172
+ type MediaPlayerRadius = "site" | "app-inner";
2173
+ interface MediaPlayerProps {
2174
+ src: string;
2175
+ mimeType: string;
2176
+ captions?: CaptionTrack[];
2177
+ captionLocale?: string | null;
2178
+ onCaptionChange?: (locale: string | null) => void;
2179
+ /** 影片的 HLS master manifest、進度條縮圖 VTT、畫質處理中(只對影片有意義) */
2180
+ hlsSrc?: string;
2181
+ thumbnails?: string;
2182
+ streamingPartial?: boolean;
2183
+ title?: string;
2184
+ /** 沒有預覽器的格式(Office、EPUB、ZIP)渲染成下載卡片時顯示的檔名與大小 */
2185
+ fileName?: string;
2186
+ fileSize?: number;
2187
+ /** 檔案卡片版型:多欄網格用 tile,與影片、PDF 卡片節奏一致;單欄或文章內用 row */
2188
+ fileCardVariant?: "row" | "tile";
2189
+ thumbnailUrl?: string;
2190
+ /** 封面替代文字;未填時各播放器以標題後備 */
2191
+ thumbnailAlt?: string;
2192
+ pageCount?: number;
2193
+ autoPlay?: boolean;
2194
+ loop?: boolean;
2195
+ muted?: boolean;
2196
+ /** 保留播放位置與音量的鍵(資產 id) */
2197
+ storageKey?: string;
2198
+ /** 從第幾秒開始播(跨裝置續看,伺服器進度優先於本機紀錄) */
2199
+ startTime?: number;
2200
+ /** 外部跳播(逐字稿面板點句):`nonce` 每次不同才再跳 */
2201
+ seekTo?: {
2202
+ time: number;
2203
+ nonce: number;
2204
+ } | null;
2205
+ /** 章節 VTT 網址(`renditions[]` 的 `chapters` 筆) */
2206
+ chapters?: string;
2207
+ onTimeUpdate?: (currentTime: number, duration: number) => void;
2208
+ onComplete?: () => void;
2209
+ onPlaybackEvent?: (event: MediaPlaybackEvent) => void;
2210
+ allowDownload?: boolean;
2211
+ downloadUrl?: string;
2212
+ /**
2213
+ * 外框圓角:`site`(預設)跟著網站的圓角設定(`--site-radius-media`,直角 8/標準 24/圓潤 48px);
2214
+ * `app-inner` 給後台工具裡的內嵌播放器(設計 ADR-0007:卡片內嵌區塊 `rounded-inner` 8px)。後台沒有網站圓角,不給就會吃到標準檔的 24px。
2215
+ */
2216
+ radius?: MediaPlayerRadius;
2217
+ className?: string;
2218
+ }
2219
+
2220
+ interface KanorioMediaProps extends MediaPlayerProps, Pick<KanorioConfig, "locale" | "theme" | "siteUrl" | "brand"> {
2221
+ }
2222
+ declare function KanorioMedia({ locale, theme, siteUrl, brand, ...props }: KanorioMediaProps): react_jsx_runtime.JSX.Element;
2223
+
2224
+ interface ImageLightboxHandle {
2225
+ openLightbox: (index: number) => void;
2226
+ }
2227
+
2228
+ /**
2229
+ * 網站的媒體保護設定(媒體 ADR 0006):存在 `Website.mediaProtection`,即時生效、不走整站發布。
2230
+ * 沒有值或缺欄位時用預設;多媒體模組的影音與檔案依各自的「允許下載」,不受 `allowDownload` 影響。
2231
+ */
2232
+ interface MediaProtection {
2233
+ /** 圖片燈箱與文章 PDF 的訪客下載 */
2234
+ allowDownload: boolean;
2235
+ /** 訪客下載的圖片保留版權欄位(拍攝地點、相機與作者一律拿掉);顯示的圖片不受影響,見媒體 ADR 0006 第 2 點 */
2236
+ keepCopyright: boolean;
2237
+ /** 圖片停用右鍵、拖曳、長按選單,燈箱不顯示下載與分享 */
2238
+ deterrence: boolean;
2239
+ /** 浮水印(媒體 ADR 0006「浮水印」;2026-10-23 起全方案、事先做好整圖浮水印版,媒體 ADR 0007) */
2240
+ watermark: MediaWatermark;
2241
+ }
2242
+ declare const WATERMARK_POSITIONS: readonly ["top-left", "top", "top-right", "left", "center", "right", "bottom-left", "bottom", "bottom-right"];
2243
+ type WatermarkPosition = (typeof WATERMARK_POSITIONS)[number];
2244
+ declare const WATERMARK_SOURCES: readonly ["logo", "text", "image"];
2245
+ type WatermarkSource = (typeof WATERMARK_SOURCES)[number];
2246
+ /** 站主可以改的部分;`overlay`、`version` 由伺服器在存檔時產生 */
2247
+ interface MediaWatermarkSettings {
2248
+ enabled: boolean;
2249
+ /** 圖案:品牌標誌、文字、或自己上傳的圖(`image`,值為 `asset:` 參照或本站圖片網址) */
2250
+ source: WatermarkSource;
2251
+ text: string;
2252
+ image: string | null;
2253
+ /** `single`:放在九宮格的一格;`tile`:整張平鋪(最難裁掉) */
2254
+ layout: "single" | "tile";
2255
+ position: WatermarkPosition;
2256
+ size: number;
2257
+ opacity: number;
2258
+ /** 加在哪些圖片(媒體 ADR 0006 第 7 點);標誌、網站圖示、頁首頁尾、分享圖片、文章封面一律不加,不在選項內 */
2259
+ apply: WatermarkApply;
2260
+ }
2261
+ /**
2262
+ * 依類別自選:訪客下載版跟著顯示的圖(有加就加),不另設選項。
2263
+ * 商品圖預設不加:Google Merchant Center 不接受帶浮水印的商品圖,結構化資料與分享圖片一律用原圖。
2264
+ */
2265
+ interface WatermarkApply {
2266
+ /** 頁面模組裡的照片 */
2267
+ pages: boolean;
2268
+ /** 部落格文章內文的圖片 */
2269
+ articles: boolean;
2270
+ /** 商品模組與商品頁的商品圖 */
2271
+ products: boolean;
2272
+ }
2273
+ interface WatermarkOverlay {
2274
+ url: string;
2275
+ width: number;
2276
+ height: number;
2277
+ /** 產生這張疊圖的輸入(圖案來源、文字、圖片、排列、品牌標誌)的雜湊;不同就要重新產生 */
2278
+ key: string;
2279
+ }
2280
+ interface MediaWatermark extends MediaWatermarkSettings {
2281
+ /**
2282
+ * 疊在圖片上的 PNG(Cloudflare Images 衍生品,不計額度):SVG 標誌與文字都先轉成 PNG,
2283
+ * 平鋪時已留好間距。產生浮水印版時以 sharp 疊這張圖(媒體 ADR 0007)。
2284
+ */
2285
+ overlay: WatermarkOverlay | null;
2286
+ /** 設定版本:疊圖或疊法任何一項改了就換,浮水印版依版本產生(媒體 ADR 0007) */
2287
+ version: string | null;
2288
+ /**
2289
+ * 這次開啟浮水印的時間(ISO)。浮水印版還沒做好時,這之前就有的圖先顯示原圖(本來就公開過),
2290
+ * 之後才上傳或換上新版的圖只顯示佔位,永不交出沒有浮水印的原圖(媒體 ADR 0007)。
2291
+ */
2292
+ activatedAt: string | null;
2293
+ /** 這次關閉浮水印的時間(ISO);關閉滿 30 天才清掉浮水印版,期間重新開啟可直接沿用 */
2294
+ deactivatedAt: string | null;
2295
+ /** 最近 24 小時內觸發整站重做的時間(ISO 陣列;每 24 小時最多 3 次,媒體 ADR 0008) */
2296
+ regenHistory?: string[];
2297
+ /** 超過每 24 小時 3 次整站重做時,新樣式排定開始套用的時間(ISO) */
2298
+ scheduledAt?: string | null;
2299
+ }
2300
+
2301
+ interface KanorioLightboxProps extends Pick<KanorioConfig, "locale" | "theme" | "siteUrl"> {
2302
+ images: string[];
2303
+ alts?: Array<string | undefined>;
2304
+ filenames?: Array<string | undefined>;
2305
+ /** 燈箱保護(允許下載、嚇阻右鍵等);省略 = 讀站台的保護設定;傳 null = 預設(允許下載) */
2306
+ protection?: Partial<MediaProtection> | null;
2307
+ /** 站台 id;給了才會走平台的圖片下載入口(含浮水印版、去除拍攝資訊)。省略且沒傳 protection 時取自站台 */
2308
+ websiteId?: string | null;
2309
+ /** 平台 API 網址(圖片下載入口在 main,不在站台);預設 `https://app.kanorio.com`(apex 對 `/api/*` 會 308,不能當預設) */
2310
+ apiBase?: string;
2311
+ /** 自訂觸發器;回呼 `open(index)` */
2312
+ renderTrigger?: (open: (index: number) => void) => ReactNode;
2313
+ /** 內建縮圖網格的欄數(預設 3) */
2314
+ columns?: number;
2315
+ className?: string;
2316
+ }
2317
+ declare const KanorioLightbox: react.ForwardRefExoticComponent<KanorioLightboxProps & react.RefAttributes<ImageLightboxHandle>>;
2318
+
2319
+ interface DeliverablePlayerLabels {
2320
+ locked: string;
2321
+ /** 被依序完成擋住:{title} 是要先完成的單元 */
2322
+ lockedBy: string;
2323
+ preview: string;
2324
+ unlocksAt: string;
2325
+ open: string;
2326
+ download: string;
2327
+ completed: string;
2328
+ /** 非影音單元的完成按鈕 */
2329
+ markComplete: string;
2330
+ /** 不計入完課的單元(選修) */
2331
+ optional: string;
2332
+ continueLearning: string;
2333
+ start: string;
2334
+ nextUnit: string;
2335
+ previousUnit: string;
2336
+ progress: string;
2337
+ unitsCount: string;
2338
+ loadError: string;
2339
+ noUnits: string;
2340
+ /** 測驗 */
2341
+ quizSubmit: string;
2342
+ quizScore: string;
2343
+ quizPassed: string;
2344
+ quizFailed: string;
2345
+ quizAttemptsLeft: string;
2346
+ quizNoAttempts: string;
2347
+ quizRetry: string;
2348
+ quizPassingScore: string;
2349
+ quizNotReady: string;
2350
+ quizSelectAll: string;
2351
+ quizCorrectCount: string;
2352
+ quizPracticeHint: string;
2353
+ quizPracticeAgain: string;
2354
+ quizAcceptedAnswers: string;
2355
+ quizTextPlaceholder: string;
2356
+ quizNumericPlaceholder: string;
2357
+ quizCorrectMark: string;
2358
+ quizWrongMark: string;
2359
+ /** 結業證書下載 */
2360
+ certificateDownload: string;
2361
+ /** 影音播完自動跳下一單元(學員自己的偏好) */
2362
+ autoplayNext: string;
2363
+ /** 主要按鈕:標記完成並到下一單元(非影音單元) */
2364
+ completeAndContinue: string;
2365
+ /** 下一單元還鎖著(依序完成)時,按鈕旁的說明 */
2366
+ completeToContinue: string;
2367
+ outline: string;
2368
+ showOutline: string;
2369
+ hideOutline: string;
2370
+ closeOutline: string;
2371
+ /** 大綱上方的設定(自動播放) */
2372
+ settings: string;
2373
+ minutes: string;
2374
+ pages: string;
2375
+ /** 單元沒有檔案也沒有內文 */
2376
+ unitEmpty: string;
2377
+ retry: string;
2378
+ /** 大綱裡標出上次離開時的單元 */
2379
+ lastViewed: string;
2380
+ courseCompletedTitle: string;
2381
+ courseCompletedOn: string;
2382
+ keepBrowsing: string;
2383
+ /** 單元附件區的標題 */
2384
+ attachments: string;
2385
+ /** 附件下載鈕的無障礙名稱 */
2386
+ downloadFile: string;
2387
+ transcript: string;
2388
+ transcriptShow: string;
2389
+ transcriptHide: string;
2390
+ transcriptSearch: string;
2391
+ transcriptMatches: string;
2392
+ transcriptNoResults: string;
2393
+ transcriptDownload: string;
2394
+ transcriptLanguage: string;
2395
+ transcriptFollow: string;
2396
+ transcriptAutoGenerated: string;
2397
+ transcriptAutoTranslated: string;
2398
+ }
2399
+
2400
+ interface KanorioUnitProps extends KanorioConfig {
2401
+ /** 交付內容 id(Customer API `GET /deliverables` 或 Agent API `deliverables.list` 取得) */
2402
+ deliverable: string;
2403
+ /** 初始單元 id;省略時續看 */
2404
+ unit?: string | null;
2405
+ /** 切換單元時回呼(可用來同步網址) */
2406
+ onUnitChange?: (unitId: string) => void;
2407
+ /** 進度回報成功後回呼(含交付物剛完成) */
2408
+ /** 進度事件:`coveredPercent` 是這個影音單元看過的比例(0–100),非影音或沒有片長時為 null */
2409
+ onProgress?: (event: {
2410
+ unitId: string;
2411
+ percent: number;
2412
+ completed: boolean;
2413
+ deliverableJustCompleted: boolean;
2414
+ coveredPercent: number | null;
2415
+ }) => void;
2416
+ /** 未登入時顯示的內容(例如 `<KanorioLogin>`);省略顯示預設提示 */
2417
+ renderUnauthenticated?: () => React.ReactNode;
2418
+ /**
2419
+ * 託管站用:伺服器已取好的樹與自己的內容客戶端(BFF cookie),不再打 Customer API。
2420
+ * 兩個都給才生效;Headless 省略,由 Bearer 自取。
2421
+ */
2422
+ tree?: CustomerDeliverableTree | null;
2423
+ client?: CustomerContentClientLike | null;
2424
+ className?: string;
2425
+ }
2426
+ /** 播放器的 labels:與託管站同一份對應(`deliverablePlayerLabels`) */
2427
+ declare function playerLabelsFrom(messages: VisitorMessages): DeliverablePlayerLabels;
2428
+ declare function KanorioUnit({ deliverable, unit, onUnitChange, onProgress, renderUnauthenticated, tree: givenTree, client: givenClient, className, ...config }: KanorioUnitProps): react_jsx_runtime.JSX.Element;
2429
+
2430
+ interface KanorioCurriculumProps extends KanorioConfig {
2431
+ /** 商品 slug(商品頁網址段) */
2432
+ product: string;
2433
+ /** 只顯示其中一個交付物(Bundle 時);省略顯示全部 */
2434
+ deliverable?: string;
2435
+ /** 已直接拿到大綱(例如 SSR 時從 Delivery API 取過)就不再抓 */
2436
+ outline?: PublicDeliverableOutline[];
2437
+ /** 預設全部展開;設 false 只展開第一章 */
2438
+ expandAll?: boolean;
2439
+ className?: string;
2440
+ }
2441
+ declare function KanorioCurriculum({ product, deliverable, outline: given, expandAll, className, ...config }: KanorioCurriculumProps): react_jsx_runtime.JSX.Element;
2442
+
2443
+ interface KanorioReviewsProps extends KanorioConfig {
2444
+ /** `product:<id>` */
2445
+ target: string;
2446
+ /** 每頁幾則;預設 20 */
2447
+ pageSize?: number;
2448
+ /** 「載入更多」按鈕文字;不給就不顯示分頁 */
2449
+ loadMoreLabel?: string;
2450
+ /** 「已購買」標記文字;不給就不顯示 */
2451
+ verifiedLabel?: string;
2452
+ /** 商家回覆的標題;不給就不顯示回覆 */
2453
+ replyLabel?: string;
2454
+ className?: string;
2455
+ }
2456
+ /**
2457
+ * 已核准評論列表。只負責取資料與最小結構,樣式交給宿主頁(各元素都有 data-* 可掛 CSS)。
2458
+ */
2459
+ declare function KanorioReviews({ target, pageSize, loadMoreLabel, verifiedLabel, replyLabel, className, ...config }: KanorioReviewsProps): react_jsx_runtime.JSX.Element | null;
2460
+ interface KanorioRatingProps extends KanorioConfig {
2461
+ /** `product:<id>` */
2462
+ target: string;
2463
+ /** 則數的文字模板,`{count}` 會被替換;不給就只顯示數字 */
2464
+ countLabel?: string;
2465
+ className?: string;
2466
+ }
2467
+ /**
2468
+ * 星等摘要。讀 Delivery `/api/v1/reviews/summary`,站主設定為隱藏(關閉或未達門檻)時不渲染。
2469
+ */
2470
+ declare function KanorioRating({ target, countLabel, className, ...config }: KanorioRatingProps): react_jsx_runtime.JSX.Element | null;
2471
+
2472
+ /**
2473
+ * 顧客中心的區塊登錄表(customers ADR-0001 修訂三第 1 條)。
2474
+ *
2475
+ * 顧客中心是殼,頁面由各原語登錄:這裡只放客戶端也用得到的形狀(路由、順序、導覽文案鍵、圖示、
2476
+ * Customer API 資源前綴);「這個站有沒有開、這個人有沒有資料」由伺服端補件
2477
+ * (`apps/main/lib/customers/portal/`)算出,隨 session 回給前端。
2478
+ *
2479
+ * 導覽、登入後的落點、Customer API 的資源分組、開發者文件都從這份衍生;
2480
+ * 契約測試保證每個對顧客開放的 API 資源都歸屬某個區塊或列在 `CUSTOMER_PORTAL_API_EXEMPT_PREFIXES`。
2481
+ * 對標:Shopify customer account full-page extensions 與顧客帳號選單;Wix 各應用程式往同一個會員區加頁面。
2482
+ */
2483
+ type CustomerPortalSectionId = "orders" | "content" | "account";
2484
+ /** 伺服端算好、隨 session 回給前端的區塊狀態 */
2485
+ interface CustomerPortalSectionState {
2486
+ id: CustomerPortalSectionId;
2487
+ /** 這個站對這個人要不要顯示這個區塊 */
2488
+ visible: boolean;
2489
+ /** 這個人在這個區塊有沒有資料(訂單、交付物…);殼用來決定空狀態與落點提示 */
2490
+ hasData: boolean;
2491
+ }
2492
+
2493
+ /**
2494
+ * 顧客登入面板與伺服器往返的介面(customers ADR-0001 修訂三第 4 條)。
2495
+ *
2496
+ * 同一個 `CustomerAccountPanel` 在託管站與 Elements 都用:託管站走同源 BFF(cookie session)、
2497
+ * Elements 走 Customer API(Bearer);面板只認這個介面,不知道底下是哪一種。
2498
+ * 回傳一律 `{ ok, ... }`,錯誤碼沿用 main 的 `account/*` 路由(開發者文件的錯誤碼表同一份)。
2499
+ */
2500
+
2501
+ interface CustomerAuthFailure {
2502
+ ok: false;
2503
+ code: string;
2504
+ retryAfter?: number;
2505
+ }
2506
+ type CustomerAuthResult<T extends object = Record<never, never>> = ({
2507
+ ok: true;
2508
+ } & T) | CustomerAuthFailure;
2509
+ /** 驗證成功後拿到的 session(託管站由 BFF 種 cookie,`sessionToken` 不回到瀏覽器;Elements 拿到 Bearer) */
2510
+ interface CustomerSessionGrant {
2511
+ sessionToken?: string;
2512
+ expiresAt?: string;
2513
+ contactId?: string;
2514
+ returnTo?: string | null;
2515
+ }
2516
+ interface CustomerAuthSessionUser {
2517
+ id: string;
2518
+ email: string | null;
2519
+ name: string | null;
2520
+ }
2521
+ /** `GET /account/session` 的子集:面板畫登入後選單要的本人、區塊與落點 */
2522
+ interface CustomerAuthSessionOverview {
2523
+ contact: CustomerAuthSessionUser;
2524
+ sections: CustomerPortalSectionState[];
2525
+ landing: string;
2526
+ }
2527
+ interface CustomerAuthTransport {
2528
+ /** ALTCHA challenge 端點(同源或網站網址) */
2529
+ altchaChallengeUrl: string;
2530
+ /** server-signed challenge 端點(variant=standard 用;登入一律 full,但 hook 要一個值) */
2531
+ challengeUrl: string;
2532
+ requestChallenge(input: {
2533
+ email: string;
2534
+ locale?: string;
2535
+ returnTo?: string;
2536
+ protection: Record<string, unknown>;
2537
+ }): Promise<CustomerAuthResult>;
2538
+ verifyCode(input: {
2539
+ email: string;
2540
+ code: string;
2541
+ }): Promise<CustomerAuthResult<CustomerSessionGrant>>;
2542
+ /** 信中一次性連結(`link`)或社群登入回呼帶回的票券(`handoff`) */
2543
+ verifyToken(input: {
2544
+ method: "link" | "handoff";
2545
+ token: string;
2546
+ }): Promise<CustomerAuthResult<CustomerSessionGrant>>;
2547
+ startOauth(input: {
2548
+ method: string;
2549
+ returnTo?: string;
2550
+ locale?: string;
2551
+ }): Promise<CustomerAuthResult<{
2552
+ url: string;
2553
+ }>>;
2554
+ passkeyLoginOptions(): Promise<CustomerAuthResult<{
2555
+ options: unknown;
2556
+ challengeId: string;
2557
+ }>>;
2558
+ passkeyLoginVerify(input: {
2559
+ challengeId: string;
2560
+ response: unknown;
2561
+ returnTo?: string;
2562
+ locale?: string;
2563
+ }): Promise<CustomerAuthResult<CustomerSessionGrant>>;
2564
+ listPasskeys(): Promise<CustomerAuthResult<{
2565
+ passkeys: {
2566
+ id: string;
2567
+ }[];
2568
+ }>>;
2569
+ passkeyRegisterOptions(): Promise<CustomerAuthResult<{
2570
+ options: unknown;
2571
+ }>>;
2572
+ passkeyRegister(input: {
2573
+ response: unknown;
2574
+ name?: string;
2575
+ }): Promise<CustomerAuthResult<{
2576
+ passkey: {
2577
+ id: string;
2578
+ name: string;
2579
+ };
2580
+ }>>;
2581
+ session(): Promise<CustomerAuthSessionOverview | null>;
2582
+ signOut(): Promise<void>;
2583
+ }
2584
+
2585
+ interface KanorioAccountProps extends KanorioConfig {
2586
+ /** 顯示在標題的店名;省略時用網站設定的品牌名稱 */
2587
+ siteName?: string;
2588
+ /**
2589
+ * `direct`(預設):面板就地登入、直打 Customer API。
2590
+ * `redirect`:按鈕把顧客送去 Kanorio 託管登入頁(OAuth 2.1 授權碼+PKCE),登入後回到 `redirectUri` 換 token。
2591
+ */
2592
+ mode?: "direct" | "redirect";
2593
+ /** `redirect` 模式回來的網址(https、origin 在網站的允許來源裡);省略時是目前這頁 */
2594
+ redirectUri?: string;
2595
+ /**
2596
+ * 登入信連結與社群登入回呼要回到的站內路徑(只接受 `/` 開頭)。省略時是目前這頁:
2597
+ * 自建前端沒有 `/account/login`,連結要回到放這個元件的頁面完成登入。
2598
+ */
2599
+ returnTo?: string;
2600
+ /** 成功後回呼(也會發 window 事件 `kanorio:login`) */
2601
+ onLogin?: (session: {
2602
+ token: string;
2603
+ contactId: string;
2604
+ expiresAt: string;
2605
+ }) => void;
2606
+ /** 登出後回呼(也會發 window 事件 `kanorio:logout`) */
2607
+ onLogout?: () => void;
2608
+ /** 已登入時取代預設的顧客中心選單 */
2609
+ renderSignedIn?: (signOut: () => void) => ReactNode;
2610
+ className?: string;
2611
+ }
2612
+ declare const LOGIN_EVENT = "kanorio:login";
2613
+ declare const LOGOUT_EVENT = "kanorio:logout";
2614
+ /**
2615
+ * Customer API 版的 transport:匿名流程不帶 token、已登入流程帶 Bearer;`channel: "bearer"` 讓 main 簽發 Bearer session。
2616
+ * `token` 用 getter 讀最新值:登入成功當下就要能用新 token 查 session。
2617
+ */
2618
+ declare function createBearerCustomerAuthTransport(params: {
2619
+ siteUrl: string;
2620
+ token: () => string | null;
2621
+ onToken: (token: string | null) => void;
2622
+ }): CustomerAuthTransport;
2623
+ declare function KanorioAccount({ siteName, mode, redirectUri, returnTo, onLogin, onLogout, renderSignedIn, className, ...config }: KanorioAccountProps): react_jsx_runtime.JSX.Element;
2624
+
2625
+ type KanorioLoginProps = KanorioAccountProps;
2626
+
2627
+ /** @deprecated 改用 `customerAuthErrorMessage`(`@kanorio/shared/components/customer-auth`) */
2628
+ declare function mapLoginErrorCode(code: string | undefined, messages: VisitorMessages["account"]): string;
2629
+ declare function KanorioLogin(props: KanorioLoginProps): react_jsx_runtime.JSX.Element;
2630
+
2631
+ /**
2632
+ * Bot Protection 類型定義
2633
+ */
2634
+ /**
2635
+ * Bot Protection 驗證資料(前端傳送給後端)
2636
+ */
2637
+ interface BotProtectionData {
2638
+ /** Honeypot 欄位值(應為空) */
2639
+ _hp: string;
2640
+ /** 額外 Honeypot _wp(應為空) */
2641
+ _wp?: string;
2642
+ /** 額外 Honeypot _co(應為空) */
2643
+ _co?: string;
2644
+ /** 表單載入時間戳(毫秒) */
2645
+ _ts: number;
2646
+ /** JavaScript 挑戰 token 或 server-signed token */
2647
+ _tk: string;
2648
+ /** Token 綁定 context(如 formId) */
2649
+ _ctx?: string;
2650
+ /** 站主改用第三方提供者(Turnstile、reCAPTCHA、hCaptcha)時,該家 widget 給的 token */
2651
+ captchaToken?: string;
2652
+ }
2653
+ /**
2654
+ * Form Protection 強度
2655
+ */
2656
+ type FormProtectionVariant = "standard" | "full";
2657
+ /**
2658
+ * useBotProtection hook 返回值
2659
+ */
2660
+ interface UseBotProtectionReturn {
2661
+ /** 取得防護資料(用於表單提交) */
2662
+ getProtectionData: () => BotProtectionData;
2663
+ /** 防護是否已就緒 */
2664
+ isReady: boolean;
2665
+ /** 首次 focus 後經過互動延遲,才可送出 */
2666
+ isSubmittable: boolean;
2667
+ /** 註冊 focus 事件(表單欄位 onFocus 時呼叫) */
2668
+ registerFocus: () => void;
2669
+ /** 註冊 ALTCHA payload(variant=full 時由 widget 呼叫) */
2670
+ registerAltchaPayload?: (payload: string) => void;
2671
+ /** 重置防護狀態(用於表單重新填寫) */
2672
+ reset: () => void;
2673
+ }
2674
+
2675
+ /**
2676
+ * 人機驗證的入口登錄表(docs/infrastructure/security/form-protection.md「人機驗證提供者」)。
2677
+ *
2678
+ * 入口=一個匿名可寫、要過人機驗證的動作。設定頁、公開設定、`withFormProtection` 的分派與契約測試都從這份衍生;
2679
+ * 新入口(留言、評論…)在這裡加一筆,不在各處寫死清單。純資料、可進 client bundle。
2680
+ */
2681
+
2682
+ declare const PROTECTION_ENTRIES: readonly [{
2683
+ readonly id: "forms";
2684
+ readonly builtinVariant: "full";
2685
+ readonly providerSelectable: true;
2686
+ }, {
2687
+ readonly id: "customer_login";
2688
+ readonly builtinVariant: "full";
2689
+ readonly providerSelectable: true;
2690
+ }, {
2691
+ readonly id: "checkout_draft";
2692
+ readonly builtinVariant: "standard";
2693
+ readonly providerSelectable: false;
2694
+ }];
2695
+ /** 站主能改用第三方提供者的入口 */
2696
+ type SelectableProtectionEntryId = Extract<(typeof PROTECTION_ENTRIES)[number], {
2697
+ providerSelectable: true;
2698
+ }>["id"];
2699
+
2700
+ /**
2701
+ * 人機驗證提供者的設定形狀(docs/infrastructure/security/form-protection.md「人機驗證提供者」)。
2702
+ *
2703
+ * - `Website.botProtection` 存這份(只有公開金鑰);密鑰在 TenantSecret(kind `bot_protection`,label=入口 id,空字串是預設)。
2704
+ * - 一站一家提供者;各入口可覆寫 widget 公開金鑰(Turnstile、hCaptcha)或 reCAPTCHA v3 分數門檻。
2705
+ * - 讀寫都經 `parseBotProtectionSettings`:沒有值、壞資料、選了第三方卻沒有公開金鑰,一律退回內建(不讓網站變成沒有防護)。
2706
+ * 純資料與 zod,可進 client bundle。
2707
+ */
2708
+
2709
+ /** 登錄的提供者;順序就是設定頁的排列 */
2710
+ declare const BOT_PROTECTION_PROVIDERS: readonly ["kanorio", "turnstile", "recaptcha", "hcaptcha"];
2711
+ type BotProtectionProvider = (typeof BOT_PROTECTION_PROVIDERS)[number];
2712
+ type ThirdPartyBotProtectionProvider = Exclude<BotProtectionProvider, "kanorio">;
2713
+ declare const RECAPTCHA_VERSIONS: readonly ["v2", "v3"];
2714
+ type RecaptchaVersion = (typeof RECAPTCHA_VERSIONS)[number];
2715
+ /** 前台畫 widget 要的公開設定:只含可換的入口、只含公開金鑰 */
2716
+ interface PublicBotProtectionConfig {
2717
+ provider: BotProtectionProvider;
2718
+ recaptchaVersion: RecaptchaVersion | null;
2719
+ entries: Partial<Record<SelectableProtectionEntryId, {
2720
+ siteKey: string;
2721
+ action: string;
2722
+ }>>;
2723
+ }
2724
+
2725
+ /**
2726
+ * ALTCHA widget `statechange` 事件 → 本地 token 該怎麼動。
2727
+ *
2728
+ * 純函式,抽出來是為了不用 DOM 就能測:widget 一旦離開 verified(expired/unverified/verifying/error),
2729
+ * 手上的 payload 就不該再送,否則伺服器回 token_expired,訪客得重做一次驗證才送得出去。
2730
+ */
2731
+ type AltchaWidgetState = "unverified" | "verifying" | "verified" | "expired" | "error" | "code";
2732
+
2733
+ interface AltchaWidgetProps {
2734
+ challengeUrl: string;
2735
+ onVerified?: (payload: string) => void;
2736
+ /** widget 離開 verified(到期自動重解、錯誤、重置)時呼叫;呼叫端應清掉手上的 payload */
2737
+ onInvalidated?: () => void;
2738
+ /** widget 端到期毫秒數;預設略短於伺服器 challenge TTL */
2739
+ expireMs?: number;
2740
+ /** 網站語系;對應到 altcha 內建翻譯,沒有的退回英文 */
2741
+ locale?: string | null;
2742
+ className?: string;
2743
+ /**
2744
+ * 隱形模式(customers ADR-0001 修訂三第 4 條):掛上就在背景解 PoW(`auto="onload"`)、不畫勾選框;
2745
+ * 解不出來(`error`)時由呼叫端把 `revealed` 設成 true 退回可見的勾選框讓訪客手動重試。
2746
+ * 一次性 payload 用掉後要再解一次時改 `generation`,widget 重掛再解。
2747
+ */
2748
+ invisible?: boolean;
2749
+ /** 隱形模式下仍要顯示(退回可見);非隱形模式忽略 */
2750
+ revealed?: boolean;
2751
+ generation?: number;
2752
+ /** 每次 statechange 都回報(呼叫端據此決定要不要退回可見) */
2753
+ onStateChange?: (state: AltchaWidgetState) => void;
2754
+ }
2755
+
2756
+ interface UseBotProtectionOptions {
2757
+ /** 內建時的防護強度:standard = server-signed token,full = ALTCHA PoW */
2758
+ variant?: "standard" | "full";
2759
+ /** 自訂 challenge URL(預設 /api/form-protection/challenge) */
2760
+ challengeUrl?: string;
2761
+ /** ALTCHA challenge URL(variant=full 時使用,預設 /api/form-protection/altcha) */
2762
+ altchaChallengeUrl?: string;
2763
+ /** Token 綁定 context(如 formId) */
2764
+ context?: string;
2765
+ /**
2766
+ * 入口(form-protection.md「人機驗證提供者」):可換提供者的入口才依網站設定改用第三方。
2767
+ * 省略=一律內建(結帳草稿這類固定內建的入口)。
2768
+ */
2769
+ entry?: SelectableProtectionEntryId;
2770
+ /** 網站的公開設定;省略時讀 BotProtectionConfigProvider,沒有 Provider=內建 */
2771
+ config?: PublicBotProtectionConfig | null;
2772
+ /**
2773
+ * 這個表單會不會申請附件上傳票:第三方提供者的 token 是一次性的,附件上傳票改用伺服器簽發 token
2774
+ * (同 Webflow:上傳靠簽章與限流,人機驗證在送出時);只有需要時才在背景取。
2775
+ */
2776
+ needsUploadToken?: boolean;
2777
+ }
2778
+ interface BotProtectionFieldBindings {
2779
+ variant: "standard" | "full";
2780
+ context: string;
2781
+ altchaChallengeUrl: string;
2782
+ onAltchaVerified?: (payload: string) => void;
2783
+ onAltchaInvalidated?: () => void;
2784
+ onHoneypotChange: (value: string) => void;
2785
+ onHoneypotWpChange: (value: string) => void;
2786
+ onHoneypotCoChange: (value: string) => void;
2787
+ }
2788
+ /** 第三方 widget 要的參數;內建時為 null */
2789
+ interface ThirdPartyCaptchaBinding {
2790
+ provider: ThirdPartyBotProtectionProvider;
2791
+ siteKey: string;
2792
+ action: string;
2793
+ cData: string | null;
2794
+ recaptchaVersion: RecaptchaVersion | null;
2795
+ generation: number;
2796
+ onVerified: (token: string) => void;
2797
+ onInvalidated: () => void;
2798
+ registerExecutor: (executor: (() => Promise<string | null>) | null) => void;
2799
+ }
2800
+ /** 交給 `<BotProtectionChallenge>`:內建畫 ALTCHA、第三方畫該家 widget */
2801
+ interface BotProtectionChallengeBindings {
2802
+ provider: BotProtectionProvider;
2803
+ fieldProps: BotProtectionFieldBindings;
2804
+ captcha: ThirdPartyCaptchaBinding | null;
2805
+ }
2806
+
2807
+ /**
2808
+ * BotProtectionFields Props
2809
+ */
2810
+ interface BotProtectionFieldsProps {
2811
+ /** variant=full 時渲染 ALTCHA widget */
2812
+ variant?: FormProtectionVariant;
2813
+ /** ALTCHA challenge URL(variant=full 時使用) */
2814
+ altchaChallengeUrl?: string;
2815
+ /** Token 綁定 context(formId 等);會附加到 challenge URL,讓 PoW 綁定此表單 */
2816
+ context?: string;
2817
+ /** ALTCHA 驗證完成回調 */
2818
+ onAltchaVerified?: (payload: string) => void;
2819
+ /** ALTCHA 離開 verified(到期重解、錯誤)回調;hook 據此清 token、停用送出 */
2820
+ onAltchaInvalidated?: () => void;
2821
+ /**
2822
+ * 當 honeypot 欄位值變更時的回調
2823
+ * 用於與 useBotProtection hook 配合使用
2824
+ */
2825
+ onHoneypotChange?: (value: string) => void;
2826
+ onHoneypotWpChange?: (value: string) => void;
2827
+ onHoneypotCoChange?: (value: string) => void;
2828
+ /** ALTCHA widget 文案語系;預設英文 */
2829
+ locale?: string | null;
2830
+ /**
2831
+ * 是否在此渲染 ALTCHA widget(預設 true)。
2832
+ * 表單要把 widget 放在送出鍵前而不是第一題時,設 false 並另外掛 `<BotProtectionAltcha>`。
2833
+ */
2834
+ renderAltcha?: boolean;
2835
+ }
2836
+ type BotProtectionAltchaProps = Pick<BotProtectionFieldsProps, "variant" | "altchaChallengeUrl" | "context" | "onAltchaVerified" | "onAltchaInvalidated" | "locale"> & Pick<AltchaWidgetProps, "invisible" | "revealed" | "generation" | "onStateChange"> & {
2837
+ className?: string;
2838
+ };
2839
+ /**
2840
+ * 只有 ALTCHA widget 的那一半:variant=full 才渲染。
2841
+ * 供表單把人機驗證放在送出鍵前(而非題目最上方);蜜罐仍由 `<BotProtectionFields renderAltcha={false}>` 負責。
2842
+ */
2843
+ declare function BotProtectionAltcha({ variant, altchaChallengeUrl, context, onAltchaVerified, onAltchaInvalidated, locale, className, invisible, revealed, generation, onStateChange, }: BotProtectionAltchaProps): react_jsx_runtime.JSX.Element | null;
2844
+ /**
2845
+ * Bot Protection 隱藏欄位元件
2846
+ *
2847
+ * 渲染多個視覺上隱藏但對機器人可見的 honeypot 欄位。
2848
+ * 欄位 name/label 皆為無語意字串(見 constants.ts),避免瀏覽器自動填入。
2849
+ *
2850
+ * @example
2851
+ * ```tsx
2852
+ * <form>
2853
+ * <BotProtectionFields context={formId} onHoneypotChange={setHoneypotValue} ... />
2854
+ * <input name="email" ... />
2855
+ * <button type="submit">送出</button>
2856
+ * </form>
2857
+ * ```
2858
+ */
2859
+ declare function BotProtectionFields({ variant, altchaChallengeUrl, context, onAltchaVerified, onAltchaInvalidated, onHoneypotChange, onHoneypotWpChange, onHoneypotCoChange, locale, renderAltcha, }: BotProtectionFieldsProps): react_jsx_runtime.JSX.Element;
2860
+
2861
+ declare const FORM_SUBMIT_EVENT = "kanorio:form-submit";
2862
+ interface KanorioFormProps extends KanorioConfig {
2863
+ /** 表單 ID(c...) */
2864
+ formId: string;
2865
+ /** 選填:SSR 預先取得的公開表單定義,提供時免去客戶端首次 GET */
2866
+ definition?: PublicFormDefinition | null;
2867
+ /** 每行題目數(1–3),預設單欄 */
2868
+ maxColumns?: MaxColumnsConfig;
2869
+ /** 網站顯示名稱(用於行銷同意聲明 `{siteName}` 插值) */
2870
+ siteName?: string;
2871
+ /** 自訂介面文案覆寫 */
2872
+ labels?: FormSectionLabels;
2873
+ /** 成功送出後回呼(同時派發 `kanorio:form-submit` DOM 事件);表單設了送出後導向時帶 `redirectUrl` */
2874
+ onSuccess?: (detail: {
2875
+ formId: string;
2876
+ redirectUrl?: string;
2877
+ }) => void;
2878
+ /**
2879
+ * 表單設了「送出後前往的網址」時是否由元件導向,預設 true。站內路徑(`/thank-you`)會以你的網站為基準。
2880
+ * 想用自己的路由器換頁時傳 false,從 `onSuccess` 的 `redirectUrl` 取網址。
2881
+ */
2882
+ followRedirect?: boolean;
2883
+ /**
2884
+ * 隱藏欄位的值:key 是表單在後台設定的隱藏欄位 id(例如 `{ campaign: "spring", ref: userId }`)。
2885
+ * 沒傳時元件會讀目前網址的同名參數;兩者都有時以這裡為準。
2886
+ */
2887
+ hiddenValues?: Record<string, string>;
2888
+ className?: string;
2889
+ }
2890
+ interface UseKanorioBotProtectionOptions extends Omit<UseBotProtectionOptions, "challengeUrl" | "altchaChallengeUrl"> {
2891
+ /** Kanorio 系統或服務網址(省略時讀取 `<KanorioProvider>`) */
2892
+ siteUrl?: string;
2893
+ }
2894
+ /**
2895
+ * 公開防機器人 Hook:自動將 challenge 與 ALTCHA 端點指向網站的 `{siteUrl}/api/form-protection/*`。
2896
+ */
2897
+ declare function useKanorioBotProtection(options?: UseKanorioBotProtectionOptions): UseBotProtectionReturn & {
2898
+ fieldProps: BotProtectionFieldBindings;
2899
+ challengeProps: BotProtectionChallengeBindings;
2900
+ provider: BotProtectionProvider;
2901
+ prepare: () => Promise<void>;
2902
+ renewCaptcha: () => void;
2903
+ getUploadProtectionData: () => BotProtectionData;
2904
+ isUploadReady: boolean;
2905
+ _setHoneypotValue: (value: string) => void;
2906
+ _setHoneypotWpValue: (value: string) => void;
2907
+ _setHoneypotCoValue: (value: string) => void;
2908
+ };
2909
+
2910
+ declare function KanorioForm({ formId, definition: initialDefinition, maxColumns, siteName, labels, onSuccess, followRedirect, hiddenValues, className, ...config }: KanorioFormProps): react_jsx_runtime.JSX.Element;
2911
+
2912
+ interface KanorioAnalyticsProps {
2913
+ /** 站台網址(若外層有 `<KanorioProvider>` 可省略) */
2914
+ siteUrl?: string;
2915
+ /**
2916
+ * 覆寫目前路徑(預設取 `window.location.pathname`)。
2917
+ * 元件已自行攔截 `history.pushState`/`replaceState` 與 `popstate`,Next.js App Router、Astro View Transitions
2918
+ * 等 client navigation 不傳也會回報;若你的框架不走 History API,傳入路由器的 pathname 即可。
2919
+ */
2920
+ path?: string;
2921
+ /** 覆寫目前頁面標題(預設在路徑變更後取 `document.title`) */
2922
+ title?: string;
2923
+ /** 覆寫來源網址(預設取站外的 `document.referrer`,只在進站第一頁帶) */
2924
+ referrer?: string;
2925
+ /**
2926
+ * 不回報的路徑前綴(例如 `["/admin", "/myinfo"]`;Web Component 用逗號分隔的字串 `exclude="/admin,/myinfo"`)。
2927
+ * 只搬一部分內容到 Kanorio 的站,後台或含個資的頁面網址不該送出去。比對整段路徑區段:`/admin` 涵蓋 `/admin` 與 `/admin/…`,不涵蓋 `/administrator`。
2928
+ */
2929
+ exclude?: readonly string[] | string;
2930
+ }
2931
+ /**
2932
+ * 回報一次匿名 pageview 到 `POST {site}/api/v1/analytics/pageview`。
2933
+ *
2934
+ * - 優先用 `navigator.sendBeacon`(頁面卸載也送得出去、不阻塞導航);不支援時退回 `fetch(keepalive)`
2935
+ * - body 一律 `text/plain`(simple request):跨網域不觸發 CORS preflight;伺服器端以 JSON 解析
2936
+ * - 外部網域必須加進網站的 `allowedOrigins`(Settings → Developer),否則瀏覽器會擋回應
2937
+ * - `entry` 標示進站第一頁、`utm` 帶網址上的 UTM 與點擊識別碼,後台的來源與活動歸因只計入口頁
2938
+ */
2939
+ declare function reportKanorioPageview(params: {
2940
+ siteUrl: string;
2941
+ path: string;
2942
+ title?: string;
2943
+ referrer?: string;
2944
+ entry?: boolean;
2945
+ utm?: Record<string, string>;
2946
+ fetch?: typeof globalThis.fetch;
2947
+ }): Promise<boolean>;
2948
+ /**
2949
+ * `<KanorioAnalytics />`(與 `<kanorio-analytics>` Web Component):
2950
+ * 於外部自建前端回報匿名 pageview 至 `POST {site}/api/v1/analytics/pageview`(含進站頁旗標、站外來源與 UTM),
2951
+ * 讓後台 `/analytics` 與外部前端健檢(`kanorio doctor`)能持續追蹤流量與來源。
2952
+ */
2953
+ declare function KanorioAnalytics({ siteUrl: propSiteUrl, path, title, referrer, exclude }: KanorioAnalyticsProps): null;
2954
+
2955
+ export { type CustomerDeliverableTree, type CustomerUnitView, FORM_SUBMIT_EVENT, type ImageLightboxHandle, KanorioAccount, type KanorioAccountProps, KanorioAnalytics, type KanorioAnalyticsProps, BotProtectionFields as KanorioBotProtection, BotProtectionAltcha as KanorioBotProtectionAltcha, type KanorioConfig, type KanorioContextValue, KanorioCurriculum, type KanorioCurriculumProps, KanorioForm, type KanorioFormProps, KanorioLightbox, type KanorioLightboxProps, KanorioLogin, type KanorioLoginProps, KanorioMedia, type KanorioMediaProps, KanorioProvider, KanorioRating, type KanorioRatingProps, KanorioReviews, type KanorioReviewsProps, type KanorioSiteBrand, type KanorioSiteMeta, type KanorioTheme, KanorioUnit, type KanorioUnitProps, LOGIN_EVENT, LOGOUT_EVENT, type PublicDeliverableOutline, TOKEN_CHANGE_EVENT, type UseKanorioBotProtectionOptions, brandCss, clearSiteMetaCache, createBearerCustomerAuthTransport, loadElementsMessages, loadSiteMeta, mapLoginErrorCode, playerLabelsFrom, reportKanorioPageview, useKanorio, useKanorioBotProtection, useSiteMeta };