@fullstackunicorn/root 3.0.0 → 4.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 (295) hide show
  1. package/assets/blank/backend/files.json +102 -0
  2. package/assets/blank/backend/index.dep.js +6 -0
  3. package/assets/blank/backend/index.js +8 -7
  4. package/assets/blank/backend/index.uri.js +14 -0
  5. package/assets/blank/backend/modules/checkout/checkout.content.js +49 -0
  6. package/assets/blank/backend/modules/checkout/checkout.credential.js +8 -0
  7. package/assets/blank/backend/modules/checkout/checkout.input.js +33 -0
  8. package/assets/blank/backend/modules/checkout/checkout.js +61 -0
  9. package/assets/blank/backend/modules/checkout/checkout.order.js +7 -0
  10. package/assets/blank/backend/modules/checkout/checkout.stripe.agent.js +39 -0
  11. package/assets/blank/backend/modules/checkout/checkout.stripe.executor.js +22 -0
  12. package/assets/blank/backend/modules/data/data.js +204 -0
  13. package/assets/blank/backend/modules/data/data.test.js +104 -0
  14. package/assets/blank/backend/modules/pulse/pulse.js +11 -0
  15. package/assets/blank/backend/package.json +12 -1
  16. package/assets/blank/backend/server/app.js +16 -0
  17. package/assets/blank/backend/server/errors.js +46 -0
  18. package/assets/blank/backend/server/resolvers.js +16 -0
  19. package/assets/blank/backend/server/router.private.js +8 -0
  20. package/assets/blank/backend/server/router.public.js +42 -0
  21. package/assets/blank/backend/tests/server.test.mjs +47 -0
  22. package/assets/blank/backend/yarn.lock +680 -0
  23. package/assets/blank/frontend/templates/index.js +1 -0
  24. package/assets/blank/root/package.json +10 -0
  25. package/assets/blank/root/yarn.lock +12 -0
  26. package/assets/monorepo/files.json +448 -822
  27. package/assets/monorepo/frontend/App.js +2 -19
  28. package/assets/monorepo/frontend/App.sw.js +3 -3
  29. package/assets/monorepo/frontend/App.uri.js +10 -6
  30. package/assets/monorepo/frontend/abstracts/abs.js +1 -1
  31. package/assets/monorepo/frontend/abstracts/images.js +1 -1
  32. package/assets/monorepo/frontend/abstracts/img.js +35 -28
  33. package/assets/monorepo/frontend/abstracts/size.js +2 -2
  34. package/assets/monorepo/frontend/base/alerts/Alert.pod.js +3 -3
  35. package/assets/monorepo/frontend/base/callout/Callout.pod.js +3 -3
  36. package/assets/monorepo/frontend/base/checkout/@use.js +2 -2
  37. package/assets/monorepo/frontend/base/checkout/CheckoutCard.pod.js +3 -3
  38. package/assets/monorepo/frontend/base/cookies/@tools.js +1 -1
  39. package/assets/monorepo/frontend/base/cookies/@use.js +6 -6
  40. package/assets/monorepo/frontend/base/language/@use.js +4 -4
  41. package/assets/monorepo/frontend/base/layout/@use.js +3 -3
  42. package/assets/monorepo/frontend/base/layout/Footer.pod.js +3 -3
  43. package/assets/monorepo/frontend/base/layout/Header.js +1 -8
  44. package/assets/monorepo/frontend/base/layout/Header.pod.js +10 -9
  45. package/assets/monorepo/frontend/base/layout/Layout.js +2 -2
  46. package/assets/monorepo/frontend/base/layout/Layout.pod.js +2 -2
  47. package/assets/monorepo/frontend/base/layout/menus/MenuTwo.js +2 -2
  48. package/assets/monorepo/frontend/base/layout/menus/MenuTwo.pod.js +4 -4
  49. package/assets/monorepo/frontend/base/layout/sideTwo/IconTwo.pod.js +2 -2
  50. package/assets/monorepo/frontend/base/layout/sideTwo/SidebarTwo.js +7 -4
  51. package/assets/monorepo/frontend/base/layout/sideTwo/SidebarTwo.pod.js +20 -7
  52. package/assets/monorepo/frontend/base/loader/@tools.js +4 -4
  53. package/assets/monorepo/frontend/base/loader/Content.js +1 -1
  54. package/assets/monorepo/frontend/base/loader/Initial.pod.js +2 -2
  55. package/assets/monorepo/frontend/base/loader/Loader.js +5 -5
  56. package/assets/monorepo/frontend/base/loader/Normalizer.js +4 -4
  57. package/assets/monorepo/frontend/base/loader/Starter.js +6 -8
  58. package/assets/monorepo/frontend/base/modals/@use.js +1 -1
  59. package/assets/monorepo/frontend/base/modals/Modal.js +1 -1
  60. package/assets/monorepo/frontend/base/modals/Modal.pod.js +4 -4
  61. package/assets/monorepo/frontend/base/modals/ModalPopup.pod.js +4 -4
  62. package/assets/monorepo/frontend/base/router/@tools.js +3 -3
  63. package/assets/monorepo/frontend/base/router/@use.js +3 -3
  64. package/assets/monorepo/frontend/base/router/Router.js +2 -2
  65. package/assets/monorepo/frontend/base/theme/@use.js +2 -2
  66. package/assets/monorepo/frontend/client/@api.js +3 -3
  67. package/assets/monorepo/frontend/client/content.js +3 -3
  68. package/assets/monorepo/frontend/client/cookies.js +3 -3
  69. package/assets/monorepo/frontend/client/fonts.js +1 -1
  70. package/assets/monorepo/frontend/client/json.js +2 -2
  71. package/assets/monorepo/frontend/client/statics.js +2 -2
  72. package/assets/monorepo/frontend/client/stripe.js +4 -4
  73. package/assets/monorepo/frontend/config.cmd.vite.js +2 -4
  74. package/assets/monorepo/frontend/config.style.js +1 -0
  75. package/assets/monorepo/frontend/configure/images.json +20 -16
  76. package/assets/monorepo/frontend/configure/preload.json +1 -1
  77. package/assets/monorepo/frontend/eslint.config.js +11 -6
  78. package/assets/monorepo/frontend/features/legal/Legal.js +1 -1
  79. package/assets/monorepo/frontend/features/legal/Legal.pod.js +1 -1
  80. package/assets/monorepo/frontend/imports/npm.js +42 -20
  81. package/assets/monorepo/frontend/index.html +7 -1
  82. package/assets/monorepo/frontend/menus/@use.js +3 -3
  83. package/assets/monorepo/frontend/modals/contentCurrencies/contentCurrencies.api.js +4 -3
  84. package/assets/monorepo/frontend/modals/contentCurrencies/contentCurrencies.js +1 -1
  85. package/assets/monorepo/frontend/modals/cookies/cookies.js +2 -2
  86. package/assets/monorepo/frontend/modals/languages/languages.js +2 -2
  87. package/assets/monorepo/frontend/modals/productOptions/productOptions.js +1 -1
  88. package/assets/monorepo/frontend/modules/base/Bottom.pod.js +4 -4
  89. package/assets/monorepo/frontend/modules/base/ComingSoon.pod.js +2 -2
  90. package/assets/monorepo/frontend/modules/base/ErrorPage.pod.js +2 -2
  91. package/assets/monorepo/frontend/modules/base/PageTitle.pod.js +2 -2
  92. package/assets/monorepo/frontend/modules/buttons/IconTextButton.js +2 -2
  93. package/assets/monorepo/frontend/modules/buttons/IconTextButton.pod.js +3 -3
  94. package/assets/monorepo/frontend/modules/buttons/TextButton.js +2 -2
  95. package/assets/monorepo/frontend/modules/buttons/TextButton.pod.js +8 -8
  96. package/assets/monorepo/frontend/modules/cards/Account.js +1 -1
  97. package/assets/monorepo/frontend/modules/cards/Account.pod.js +4 -4
  98. package/assets/monorepo/frontend/modules/cards/Launcher.js +1 -1
  99. package/assets/monorepo/frontend/modules/cards/Launcher.pod.js +3 -3
  100. package/assets/monorepo/frontend/modules/cards/Linker.js +1 -1
  101. package/assets/monorepo/frontend/modules/cards/Linker.pod.js +2 -2
  102. package/assets/monorepo/frontend/modules/cards/Slider.js +1 -1
  103. package/assets/monorepo/frontend/modules/cards/Slider.pod.js +3 -3
  104. package/assets/monorepo/frontend/modules/core/Back.pod.js +2 -2
  105. package/assets/monorepo/frontend/modules/core/Bulleted.js +2 -2
  106. package/assets/monorepo/frontend/modules/core/Icon.js +2 -2
  107. package/assets/monorepo/frontend/modules/core/Icon.pod.js +3 -3
  108. package/assets/monorepo/frontend/modules/core/Img.js +2 -2
  109. package/assets/monorepo/frontend/modules/core/Img.pod.js +6 -4
  110. package/assets/monorepo/frontend/modules/core/Link.js +3 -3
  111. package/assets/monorepo/frontend/modules/core/Link.pod.js +2 -2
  112. package/assets/monorepo/frontend/modules/core/Slider.pod.js +3 -3
  113. package/assets/monorepo/frontend/modules/layout/Wrapper.pod.js +1 -1
  114. package/assets/monorepo/frontend/modules/modals/select/Actions.pod.js +1 -1
  115. package/assets/monorepo/frontend/modules/modals/select/SelectItem.js +2 -2
  116. package/assets/monorepo/frontend/modules/modals/select/SelectItem.pod.js +4 -4
  117. package/assets/monorepo/frontend/modules/modals/select/SelectPage.pod.js +3 -3
  118. package/assets/monorepo/frontend/modules/modals/select/SelectPicked.js +2 -2
  119. package/assets/monorepo/frontend/modules/modals/select/SelectPicked.pod.js +4 -4
  120. package/assets/monorepo/frontend/modules/modals/slider/Actions.pod.js +2 -2
  121. package/assets/monorepo/frontend/modules/modals/slider/SliderItem.js +2 -2
  122. package/assets/monorepo/frontend/modules/modals/slider/SliderItem.pod.js +5 -5
  123. package/assets/monorepo/frontend/modules/modals/slider/SliderPage.pod.js +4 -4
  124. package/assets/monorepo/frontend/modules/page/PageBox.js +2 -2
  125. package/assets/monorepo/frontend/modules/page/PageScrollable.js +2 -2
  126. package/assets/monorepo/frontend/modules/page/PageScrollable.pod.js +2 -2
  127. package/assets/monorepo/frontend/modules/prose/Basic.js +2 -2
  128. package/assets/monorepo/frontend/modules/prose/Basic.pod.js +2 -2
  129. package/assets/monorepo/frontend/modules/prose/Prose.pod.js +2 -2
  130. package/assets/monorepo/frontend/modules/trademarks/Logo.pod.js +3 -3
  131. package/assets/monorepo/frontend/modules/trademarks/Trademark.js +1 -1
  132. package/assets/monorepo/frontend/modules/trademarks/Trademark.pod.js +5 -4
  133. package/assets/monorepo/frontend/package.json +14 -5
  134. package/assets/monorepo/frontend/pages/@use.js +5 -5
  135. package/assets/monorepo/frontend/panels/buy/BuyButton.js +1 -1
  136. package/assets/monorepo/frontend/panels/buy/BuyButton.pod.js +5 -4
  137. package/assets/monorepo/frontend/panels/content/Metadata.js +5 -5
  138. package/assets/monorepo/frontend/panels/content/Payment.js +12 -6
  139. package/assets/monorepo/frontend/panels/content/Product.js +11 -7
  140. package/assets/monorepo/frontend/panels/content/Rich.js +1 -1
  141. package/assets/monorepo/frontend/panels/content/loader.js +4 -4
  142. package/assets/monorepo/frontend/panels/glass/Backdrop.pod.js +2 -2
  143. package/assets/monorepo/frontend/panels/glass/Content.pod.js +3 -2
  144. package/assets/monorepo/frontend/panels/person/Biography.pod.js +9 -8
  145. package/assets/monorepo/frontend/panels/person/Person.pod.js +9 -7
  146. package/assets/monorepo/frontend/panels/person/Portrait.js +8 -4
  147. package/assets/monorepo/frontend/panels/product/FormatOption.pod.js +2 -2
  148. package/assets/monorepo/frontend/panels/product/Product.js +2 -2
  149. package/assets/monorepo/frontend/panels/product/Product.pod.js +4 -4
  150. package/assets/monorepo/frontend/panels/product/Shopper.pod.js +9 -8
  151. package/assets/monorepo/frontend/panels/shelf/BookTile.pod.js +16 -15
  152. package/assets/monorepo/frontend/panels/shelf/Shelf.pod.js +27 -17
  153. package/assets/monorepo/frontend/panels/shelf/useDescriptionLines.js +1 -1
  154. package/assets/monorepo/frontend/root/preferences.js +4 -3
  155. package/assets/monorepo/frontend/root/registry.js +3 -0
  156. package/assets/monorepo/frontend/templates/glass.js +65 -6
  157. package/assets/monorepo/frontend/yarn.lock +4725 -0
  158. package/assets/monorepo/headers/account/base/layout/Header.js +2 -8
  159. package/assets/monorepo/headers/account/base/layout/Header.pod.js +6 -5
  160. package/assets/monorepo/headers/minimal/base/layout/Header.pod.js +8 -7
  161. package/assets/monorepo/headers/minimal/selection.json +1 -1
  162. package/assets/monorepo/headers/navigation/base/layout/Header.js +1 -1
  163. package/assets/monorepo/headers/navigation/base/layout/Header.pod.js +8 -7
  164. package/assets/monorepo/headers/navigation/selection.json +1 -1
  165. package/assets/monorepo/sources/@origin/support/lookup/languages/en-US.json +366 -122
  166. package/assets/yarnrc.yml +3 -0
  167. package/index.dep.js +8 -0
  168. package/modules/bootstrap.js +182 -42
  169. package/package.json +51 -46
  170. package/package.md +82 -8
  171. package/scripts/check-model.mjs +16 -22
  172. package/scripts/check-platform.mjs +44 -0
  173. package/assets/monorepo/frontend/base/loader/initial.css +0 -12
  174. package/assets/monorepo/frontend/client/load.js +0 -86
  175. package/assets/monorepo/frontend/client/priority.js +0 -41
  176. package/assets/monorepo/frontend/client/requests.js +0 -40
  177. package/assets/monorepo/frontend/features/legal/legal.css +0 -16
  178. package/assets/monorepo/frontend/imports/animated/Button.js +0 -66
  179. package/assets/monorepo/frontend/imports/animated/Crossfader.js +0 -32
  180. package/assets/monorepo/frontend/imports/animated/Fader.js +0 -46
  181. package/assets/monorepo/frontend/imports/animated/HoverCard.js +0 -31
  182. package/assets/monorepo/frontend/imports/animated/Layout.js +0 -68
  183. package/assets/monorepo/frontend/imports/animated/Layout.use.js +0 -33
  184. package/assets/monorepo/frontend/imports/animated/Layout.vars.js +0 -20
  185. package/assets/monorepo/frontend/imports/animated/Placeholder.js +0 -4
  186. package/assets/monorepo/frontend/imports/animated/Root.js +0 -24
  187. package/assets/monorepo/frontend/imports/animated/placeholder.css +0 -12
  188. package/assets/monorepo/frontend/imports/cache.js +0 -119
  189. package/assets/monorepo/frontend/imports/client.js +0 -272
  190. package/assets/monorepo/frontend/imports/core/Ambient.js +0 -9
  191. package/assets/monorepo/frontend/imports/core/Ambient.pod.js +0 -29
  192. package/assets/monorepo/frontend/imports/core/Backdrop.js +0 -21
  193. package/assets/monorepo/frontend/imports/core/Background.js +0 -21
  194. package/assets/monorepo/frontend/imports/core/Background.pod.js +0 -20
  195. package/assets/monorepo/frontend/imports/core/Glass.js +0 -12
  196. package/assets/monorepo/frontend/imports/core/Glass.pod.js +0 -31
  197. package/assets/monorepo/frontend/imports/core/Href.js +0 -22
  198. package/assets/monorepo/frontend/imports/core/Iframe.js +0 -13
  199. package/assets/monorepo/frontend/imports/core/Img.js +0 -135
  200. package/assets/monorepo/frontend/imports/core/Img.pod.js +0 -71
  201. package/assets/monorepo/frontend/imports/core/InputFile.js +0 -26
  202. package/assets/monorepo/frontend/imports/core/InputTextItem.js +0 -23
  203. package/assets/monorepo/frontend/imports/core/InputTextarea.js +0 -39
  204. package/assets/monorepo/frontend/imports/core/InputTextline.js +0 -23
  205. package/assets/monorepo/frontend/imports/core/Json.js +0 -19
  206. package/assets/monorepo/frontend/imports/core/LegalDocument.js +0 -13
  207. package/assets/monorepo/frontend/imports/core/Link.js +0 -111
  208. package/assets/monorepo/frontend/imports/core/List.js +0 -18
  209. package/assets/monorepo/frontend/imports/core/Main.js +0 -7
  210. package/assets/monorepo/frontend/imports/core/Pressable.js +0 -17
  211. package/assets/monorepo/frontend/imports/core/Raised.js +0 -13
  212. package/assets/monorepo/frontend/imports/core/Raised.pod.js +0 -20
  213. package/assets/monorepo/frontend/imports/core/Rich.js +0 -34
  214. package/assets/monorepo/frontend/imports/core/Scrollable.js +0 -41
  215. package/assets/monorepo/frontend/imports/core/Svg.js +0 -23
  216. package/assets/monorepo/frontend/imports/core/Svg.pod.js +0 -24
  217. package/assets/monorepo/frontend/imports/core/Text.js +0 -130
  218. package/assets/monorepo/frontend/imports/core/View.js +0 -13
  219. package/assets/monorepo/frontend/imports/core/Viewport.js +0 -29
  220. package/assets/monorepo/frontend/imports/core/legal.css +0 -16
  221. package/assets/monorepo/frontend/imports/core/prose.css +0 -16
  222. package/assets/monorepo/frontend/imports/device.js +0 -46
  223. package/assets/monorepo/frontend/imports/fonts/tools.js +0 -66
  224. package/assets/monorepo/frontend/imports/fonts/use.js +0 -56
  225. package/assets/monorepo/frontend/imports/head/Head.js +0 -29
  226. package/assets/monorepo/frontend/imports/head/Metadata.js +0 -25
  227. package/assets/monorepo/frontend/imports/head/Page.js +0 -8
  228. package/assets/monorepo/frontend/imports/layout.js +0 -28
  229. package/assets/monorepo/frontend/imports/router.js +0 -23
  230. package/assets/monorepo/frontend/imports/scroll/@use.js +0 -85
  231. package/assets/monorepo/frontend/imports/scroll/scroll.js +0 -33
  232. package/assets/monorepo/frontend/imports/service.js +0 -27
  233. package/assets/monorepo/frontend/imports/storage.js +0 -61
  234. package/assets/monorepo/frontend/imports/use.js +0 -146
  235. package/assets/monorepo/frontend/panels/content/prose.css +0 -16
  236. package/assets/monorepo/frontend/preloader/@use.js +0 -19
  237. package/assets/monorepo/frontend/preloader/Preloader.js +0 -40
  238. package/assets/monorepo/frontend/root/preload.js +0 -73
  239. package/assets/monorepo/native/dependencies.json +0 -5
  240. package/assets/monorepo/native/imports/animated/Button.js +0 -65
  241. package/assets/monorepo/native/imports/animated/Crossfader.js +0 -51
  242. package/assets/monorepo/native/imports/animated/Fader.js +0 -50
  243. package/assets/monorepo/native/imports/animated/HoverCard.js +0 -46
  244. package/assets/monorepo/native/imports/animated/Layout.js +0 -75
  245. package/assets/monorepo/native/imports/animated/Layout.use.js +0 -33
  246. package/assets/monorepo/native/imports/animated/Layout.vars.js +0 -20
  247. package/assets/monorepo/native/imports/animated/Placeholder.js +0 -26
  248. package/assets/monorepo/native/imports/animated/Root.js +0 -29
  249. package/assets/monorepo/native/imports/cache.js +0 -124
  250. package/assets/monorepo/native/imports/client.js +0 -265
  251. package/assets/monorepo/native/imports/core/Ambient.js +0 -9
  252. package/assets/monorepo/native/imports/core/Ambient.pod.js +0 -13
  253. package/assets/monorepo/native/imports/core/Backdrop.js +0 -26
  254. package/assets/monorepo/native/imports/core/Background.js +0 -20
  255. package/assets/monorepo/native/imports/core/Background.pod.js +0 -15
  256. package/assets/monorepo/native/imports/core/Glass.js +0 -12
  257. package/assets/monorepo/native/imports/core/Glass.pod.js +0 -9
  258. package/assets/monorepo/native/imports/core/Href.js +0 -22
  259. package/assets/monorepo/native/imports/core/Iframe.js +0 -22
  260. package/assets/monorepo/native/imports/core/Img.js +0 -30
  261. package/assets/monorepo/native/imports/core/Img.pod.js +0 -58
  262. package/assets/monorepo/native/imports/core/InputCheckbox.js +0 -16
  263. package/assets/monorepo/native/imports/core/InputFile.js +0 -20
  264. package/assets/monorepo/native/imports/core/InputTextItem.js +0 -22
  265. package/assets/monorepo/native/imports/core/InputTextarea.js +0 -29
  266. package/assets/monorepo/native/imports/core/InputTextline.js +0 -41
  267. package/assets/monorepo/native/imports/core/Json.js +0 -22
  268. package/assets/monorepo/native/imports/core/LegalDocument.js +0 -32
  269. package/assets/monorepo/native/imports/core/Link.js +0 -53
  270. package/assets/monorepo/native/imports/core/List.js +0 -19
  271. package/assets/monorepo/native/imports/core/Main.js +0 -9
  272. package/assets/monorepo/native/imports/core/Pressable.js +0 -20
  273. package/assets/monorepo/native/imports/core/Raised.js +0 -13
  274. package/assets/monorepo/native/imports/core/Raised.pod.js +0 -12
  275. package/assets/monorepo/native/imports/core/Rich.js +0 -43
  276. package/assets/monorepo/native/imports/core/Scrollable.js +0 -81
  277. package/assets/monorepo/native/imports/core/Svg.js +0 -24
  278. package/assets/monorepo/native/imports/core/Svg.pod.js +0 -30
  279. package/assets/monorepo/native/imports/core/Text.js +0 -160
  280. package/assets/monorepo/native/imports/core/View.js +0 -25
  281. package/assets/monorepo/native/imports/core/Viewport.js +0 -22
  282. package/assets/monorepo/native/imports/device.js +0 -57
  283. package/assets/monorepo/native/imports/fonts/tools.js +0 -65
  284. package/assets/monorepo/native/imports/fonts/use.js +0 -51
  285. package/assets/monorepo/native/imports/head/Head.js +0 -2
  286. package/assets/monorepo/native/imports/head/Metadata.js +0 -2
  287. package/assets/monorepo/native/imports/head/Page.js +0 -2
  288. package/assets/monorepo/native/imports/layout.js +0 -28
  289. package/assets/monorepo/native/imports/npm.js +0 -33
  290. package/assets/monorepo/native/imports/router.js +0 -29
  291. package/assets/monorepo/native/imports/scroll/@use.js +0 -76
  292. package/assets/monorepo/native/imports/scroll/scroll.js +0 -32
  293. package/assets/monorepo/native/imports/service.js +0 -19
  294. package/assets/monorepo/native/imports/storage.js +0 -58
  295. package/assets/monorepo/native/imports/use.js +0 -100
@@ -0,0 +1,3 @@
1
+ nodeLinker: node-modules
2
+ enableTelemetry: false
3
+ npmMinimalAgeGate: 0
package/index.dep.js ADDED
@@ -0,0 +1,8 @@
1
+ // FULLSTACKUNICORN
2
+ export { websites } from '@fullstackunicorn/websites'
3
+
4
+ // NODE
5
+ export { readFile, writeFile, mkdir, cp, stat, access } from 'node:fs/promises'
6
+ export { default as path } from 'node:path'
7
+ export { fileURLToPath } from 'node:url'
8
+ export { default as assert } from 'node:assert/strict'
@@ -1,10 +1,10 @@
1
- import { readFile, writeFile, mkdir, cp, stat, access } from 'node:fs/promises'
2
- import path from 'node:path'
3
- import { fileURLToPath } from 'node:url'
4
- import assert from 'node:assert/strict'
1
+ import { readFile, writeFile, mkdir, cp, stat, access, path, fileURLToPath, assert, websites } from '#@/index.dep.js'
5
2
 
6
3
  const template = fileURLToPath(new URL('../assets/monorepo/', import.meta.url))
7
4
  const backend = fileURLToPath(new URL('../assets/blank/backend/', import.meta.url))
5
+ const root = fileURLToPath(new URL('../assets/blank/root/', import.meta.url))
6
+ const yarnrc = fileURLToPath(new URL('../assets/yarnrc.yml', import.meta.url))
7
+ const sourceText = asset => typeof asset?.text === 'string' && asset.text.trim() ? asset.text.trim() : ''
8
8
  const json = async (file, value) => {
9
9
  await mkdir(path.dirname(file), { recursive: true })
10
10
  await writeFile(file, JSON.stringify(value, null, 4) + '\n')
@@ -14,8 +14,90 @@ const absent = async file => {
14
14
  catch (error) { if (error.code === 'ENOENT') return; throw error }
15
15
  throw new Error('destination_exists: ' + file)
16
16
  }
17
+ const canonicalYarnLock = content => {
18
+ const blocks = content.trimEnd().split('\n\n')
19
+ assert(blocks[0]?.startsWith('# This file is generated by running "yarn install"'), 'workspace_lock_header_invalid')
20
+ assert(blocks[1]?.startsWith('__metadata:'), 'workspace_lock_metadata_invalid')
21
+ const firstLine = block => block.slice(0, block.indexOf('\n'))
22
+ const entries = blocks.slice(2).sort((left, right) => firstLine(left) < firstLine(right) ? -1 : firstLine(left) > firstLine(right) ? 1 : 0)
23
+ return [...blocks.slice(0, 2), ...entries].join('\n\n') + '\n'
24
+ }
25
+ const renameWorkspaceLock = async (file, previousName, nextName) => {
26
+ const content = await readFile(file, 'utf8')
27
+ assert(content.includes('"' + previousName + '@workspace:.":'), 'workspace_lock_name_missing')
28
+ assert.equal(content.split(previousName).length - 1, 2, 'workspace_lock_name_invalid')
29
+ await writeFile(file, canonicalYarnLock(content.replaceAll(previousName, nextName)))
30
+ }
31
+ const pngDimensions = buffer => {
32
+ assert(buffer.length >= 24 && buffer.subarray(0, 8).equals(Buffer.from([137, 80, 78, 71, 13, 10, 26, 10])), 'invalid_png')
33
+ return { width: buffer.readUInt32BE(16), height: buffer.readUInt32BE(20) }
34
+ }
35
+ const svgDimensions = buffer => {
36
+ const root = buffer.toString('utf8').match(/<svg\b[^>]*>/i)?.[0]
37
+ assert(root, 'invalid_svg')
38
+ const attribute = name => root.match(new RegExp('\\b' + name + '=["\\\']([^"\\\']+)["\\\']', 'i'))?.[1]
39
+ const numeric = value => /^\d+(?:\.\d+)?(?:px)?$/i.test(value || '') ? Number.parseFloat(value) : 0
40
+ let width = numeric(attribute('width'))
41
+ let height = numeric(attribute('height'))
42
+ const viewBox = attribute('viewBox')?.trim().split(/[\s,]+/).map(Number)
43
+ if ((!width || !height) && viewBox?.length === 4 && viewBox.every(Number.isFinite)) {
44
+ width ||= viewBox[2]
45
+ height ||= viewBox[3]
46
+ }
47
+ assert(width > 0 && height > 0, 'svg_dimensions_required')
48
+ return { width, height }
49
+ }
50
+ const assetDimensions = async file => path.extname(file).toLowerCase() === '.png'
51
+ ? pngDimensions(await readFile(file))
52
+ : svgDimensions(await readFile(file))
53
+ const validateSquare = async (file, name) => {
54
+ const { width, height } = await assetDimensions(file)
55
+ assert.equal(width, height, name + '_square_required')
56
+ }
57
+ const expectedIcons = { 'favicon.png': 32, 'favicon.ico': 32, 'icon-180.png': 180, 'icon-192.png': 192, 'icon-512.png': 512 }
58
+ const validateGeneratedIcons = generated => {
59
+ for (const [name, size] of Object.entries(expectedIcons)) {
60
+ const buffer = Buffer.from(generated[name] || [])
61
+ assert(buffer.length > 0, name + '_missing')
62
+ const image = name.endsWith('.ico') ? buffer.subarray(22) : buffer
63
+ assert.deepEqual(pngDimensions(image), { width: size, height: size }, name + '_dimensions_invalid')
64
+ }
65
+ }
66
+ const generateIcons = async input => {
67
+ const generated = await websites.icons.generate({
68
+ favicon: { name: path.basename(input.favicon.file), buffer: await readFile(input.favicon.file) },
69
+ icon: { name: path.basename(input.icon.file), buffer: await readFile(input.icon.file) }
70
+ })
71
+ validateGeneratedIcons(generated)
72
+ return generated
73
+ }
74
+ const writeIcons = async (folder, generated) => {
75
+ await mkdir(folder, { recursive: true })
76
+ for (const name of Object.keys(expectedIcons)) await writeFile(path.join(folder, name), generated[name])
77
+ }
78
+ const webmanifest = title => ({
79
+ name: title,
80
+ short_name: title,
81
+ theme_color: '#ffffff',
82
+ background_color: '#ffffff',
83
+ display: 'fullscreen',
84
+ icons: [
85
+ { src: '/icons/icon-192.png', sizes: '192x192', type: 'image/png', purpose: 'maskable' },
86
+ { src: '/icons/icon-512.png', sizes: '512x512', type: 'image/png', purpose: 'maskable' }
87
+ ]
88
+ })
89
+ const validateWebmanifest = async (file, title) => {
90
+ const value = JSON.parse(await readFile(file, 'utf8'))
91
+ assert.deepEqual(value, webmanifest(title), 'webmanifest_invalid')
92
+ }
93
+ const validateIconsFolder = async folder => {
94
+ const generated = {}
95
+ for (const name of Object.keys(expectedIcons)) generated[name] = await readFile(path.join(folder, name))
96
+ validateGeneratedIcons(generated)
97
+ }
17
98
  const validate = async (input, domain) => {
18
99
  assert.equal(input.domain, domain, 'domain_mismatch')
100
+ assert(input.codeOnly === undefined || typeof input.codeOnly === 'boolean', 'invalid_code_only')
19
101
  assert(/^[a-z0-9]+(?:[.-][a-z0-9]+)+$/.test(domain), 'invalid_domain')
20
102
  assert(typeof input.group === 'string' && (domain === input.group || domain.endsWith('.' + input.group)), 'invalid_group')
21
103
  assert(path.isAbsolute(input.websites), 'websites_path_required')
@@ -26,9 +108,23 @@ const validate = async (input, domain) => {
26
108
  assert(asset && path.isAbsolute(asset.file), name + '_file_required')
27
109
  assert(/\.(svg|png)$/.test(asset.file), name + '_format_invalid')
28
110
  assert((await stat(asset.file)).isFile(), name + '_file_missing')
111
+ if (asset.inverseFile !== undefined) {
112
+ assert(path.isAbsolute(asset.inverseFile), name + '_inverse_file_required')
113
+ assert(/\.(svg|png)$/.test(asset.inverseFile), name + '_inverse_format_invalid')
114
+ assert((await stat(asset.inverseFile)).isFile(), name + '_inverse_file_missing')
115
+ }
29
116
  }
30
117
  assert(input.trademark.width > 0 && input.trademark.height > 0, 'trademark_dimensions_required')
31
118
  assert(input.logo.size > 0 && typeof input.logo.visible === 'boolean', 'logo_settings_required')
119
+ if (!input.codeOnly) {
120
+ for (const name of ['favicon', 'icon']) {
121
+ const asset = input[name]
122
+ assert(asset && path.isAbsolute(asset.file), name + '_file_required')
123
+ assert(/\.(svg|png)$/i.test(asset.file), name + '_format_invalid')
124
+ assert((await stat(asset.file)).isFile(), name + '_file_missing')
125
+ await validateSquare(asset.file, name)
126
+ }
127
+ }
32
128
  }
33
129
 
34
130
  const generate = async ({ domain, config }) => {
@@ -36,69 +132,113 @@ const generate = async ({ domain, config }) => {
36
132
  await validate(input, domain)
37
133
  const code = path.join(input.websites, 'Code', input.group, domain)
38
134
  const data = path.join(input.websites, 'Data', input.group, domain)
39
- await absent(code)
40
- await absent(data)
135
+ const source = input.codeOnly ? JSON.parse(await readFile(path.join(data, '@origin/input.json'), 'utf8')) : { original: input.language, locales: [input.language] }
136
+ assert(Array.isArray(source.locales) && source.locales.length > 0 && source.locales.every(locale => /^[a-z]{2,3}-[A-Za-z]{2,4}$/.test(locale)) && new Set(source.locales).size === source.locales.length, 'invalid_source_locales')
137
+ assert(source.original === input.language && source.locales.includes(input.language), 'source_language_mismatch')
138
+ if (input.codeOnly) {
139
+ assert((await stat(data)).isDirectory(), 'source_data_required')
140
+ await validateIconsFolder(path.join(data, 'icons'))
141
+ await validateWebmanifest(path.join(data, 'site/index.webmanifest'), input.title)
142
+ for (const target of ['frontend', 'backend', '.env', '.env.test', '.env.next', '.env.live', '.yarnrc.yml', 'yarn.lock', 'package.json', 'root.config.json', 'route-map.json', 'bootstrap.json']) {
143
+ await absent(path.join(code, target))
144
+ }
145
+ } else {
146
+ await absent(code)
147
+ await absent(data)
148
+ }
149
+ const generatedIcons = input.codeOnly ? null : await generateIcons(input)
41
150
  await mkdir(path.dirname(code), { recursive: true })
42
151
  await cp(path.join(template, 'frontend'), path.join(code, 'frontend'), { recursive: true, errorOnExist: true, force: false })
43
152
  await cp(backend, path.join(code, 'backend'), { recursive: true, errorOnExist: true, force: false })
44
- await cp(path.join(template, 'sources'), data, { recursive: true, errorOnExist: true, force: false })
45
- for (const folder of ['@origin', 'data', 'page', 'media/trademarks', 'fonts', 'site']) await mkdir(path.join(data, folder), { recursive: true })
153
+ const yarnConfiguration = await readFile(yarnrc)
154
+ await writeFile(path.join(code, 'frontend/.yarnrc.yml'), yarnConfiguration)
155
+ await writeFile(path.join(code, 'backend/.yarnrc.yml'), yarnConfiguration)
156
+ if (!input.codeOnly) {
157
+ await cp(path.join(template, 'sources'), data, { recursive: true, errorOnExist: true, force: false })
158
+ for (const folder of ['@origin', 'data', 'page', 'media/trademarks', 'icons', 'fonts', 'site']) await mkdir(path.join(data, folder), { recursive: true })
159
+ await writeIcons(path.join(data, 'icons'), generatedIcons)
160
+ }
161
+ await json(path.join(code, 'frontend/root/content.locales.json'), source.locales)
46
162
  const site = { domain, title: input.title, language: input.language }
47
163
  for (const name of ['trademark', 'logo']) {
48
- const source = input[name], file = name + path.extname(source.file)
49
- await cp(source.file, path.join(data, 'media/trademarks', file))
164
+ const source = input[name]
165
+ const canonical = name + path.extname(source.file)
166
+ const inverseSource = source.inverseFile || source.file
167
+ const inverse = source.inverseFile ? name + '.inverse' + path.extname(source.inverseFile) : canonical
168
+ if (!input.codeOnly) {
169
+ await cp(source.file, path.join(data, 'media/trademarks', canonical))
170
+ if (source.inverseFile) await cp(inverseSource, path.join(data, 'media/trademarks', inverse))
171
+ }
50
172
  const publicFolder = path.join(code, 'frontend/assets/media/trademarks')
51
173
  await mkdir(publicFolder, { recursive: true })
52
- await cp(source.file, path.join(publicFolder, file))
53
- site[name] = { ...source, src: './media/trademarks/' + file }
174
+ await cp(source.file, path.join(publicFolder, canonical))
175
+ if (source.inverseFile) await cp(inverseSource, path.join(publicFolder, inverse))
176
+ site[name] = { ...source, canonical: './media/trademarks/' + canonical, inverse: './media/trademarks/' + inverse }
54
177
  delete site[name].file
178
+ delete site[name].inverseFile
55
179
  }
56
- await json(path.join(code, 'frontend/configure/trademark.json'), { canonical: path.basename(site.trademark.src), inverse: path.basename(site.trademark.src), X: site.trademark.width, Y: site.trademark.height })
57
- await json(path.join(code, 'frontend/configure/logo.json'), { canonical: path.basename(site.logo.src), inverse: path.basename(site.logo.src), XY: site.logo.size })
180
+ await json(path.join(code, 'frontend/configure/trademark.json'), { canonical: path.basename(site.trademark.canonical), inverse: path.basename(site.trademark.inverse), X: site.trademark.width, Y: site.trademark.height, ...(sourceText(input.trademark) ? { text: sourceText(input.trademark) } : {}) })
181
+ await json(path.join(code, 'frontend/configure/logo.json'), { canonical: path.basename(site.logo.canonical), inverse: path.basename(site.logo.inverse), XY: site.logo.size })
58
182
  for (const part of ['frontend', 'backend']) {
59
183
  const file = path.join(code, part, 'package.json')
60
184
  const content = JSON.parse(await readFile(file, 'utf8'))
185
+ const previousName = content.name
61
186
  content.name = '@' + domain + '/' + part
62
- if (part === 'frontend') content.scripts.build = 'style && vite build'
187
+ if (part === 'frontend') {
188
+ content.scripts.build = 'style && vite build'
189
+ content.homepage = 'https://' + domain
190
+ }
63
191
  await json(file, content)
64
- if (part === 'backend') await json(path.join(code, part, 'package-lock.json'), {
65
- name: content.name, version: content.version, lockfileVersion: 3, requires: true,
66
- packages: { '': { name: content.name, version: content.version } }
67
- })
192
+ await renameWorkspaceLock(path.join(code, part, 'yarn.lock'), previousName, content.name)
68
193
  }
69
194
  const html = path.join(code, 'frontend/index.html')
70
195
  const title = input.title.replaceAll('&', '&amp;').replaceAll('<', '&lt;').replaceAll('"', '&quot;')
71
- await writeFile(html, (await readFile(html, 'utf8')).replace('<title></title>', '<title>' + title + '</title>'))
196
+ await writeFile(html, (await readFile(html, 'utf8')).replace('<title></title>', '<title>' + title + '</title>').replace('<meta content="" name="apple-mobile-web-app-title" />', '<meta content="' + title + '" name="apple-mobile-web-app-title" />'))
197
+ await json(path.join(code, 'frontend/assets/index.webmanifest'), webmanifest(input.title))
72
198
  for (const environment of ['', 'test', 'next', 'live']) {
73
199
  const prefix = environment === 'test' || environment === 'next' ? environment : ''
74
200
  const siteOrigin = environment ? 'https://' + (prefix ? prefix + '.' : '') + domain : 'http://127.0.0.1:8080'
75
201
  const cdnOrigin = 'https://cdn.' + domain
76
202
  await writeFile(path.join(code, environment ? '.env.' + environment : '.env'), 'PLATFORM=web\nCLIENT_ID=' + domain + '\nSITE_ORIGIN=' + siteOrigin + '\nCDN0=' + cdnOrigin + (prefix ? '/' + prefix : '') + '\n')
77
203
  }
78
- await json(path.join(code, 'package.json'), { name: domain, version: '1.0.0', private: true, type: 'module', scripts: { build: 'npm --prefix frontend run build' }, devDependencies: { '@fullstackunicorn/root': '3.0.0' } })
204
+ const rootPackage = JSON.parse(await readFile(path.join(root, 'package.json'), 'utf8'))
205
+ const previousRootName = rootPackage.name
206
+ rootPackage.name = domain
207
+ await json(path.join(code, 'package.json'), rootPackage)
208
+ await writeFile(path.join(code, '.yarnrc.yml'), yarnConfiguration)
209
+ await cp(path.join(root, 'yarn.lock'), path.join(code, 'yarn.lock'), { errorOnExist: true, force: false })
210
+ await renameWorkspaceLock(path.join(code, 'yarn.lock'), previousRootName, rootPackage.name)
79
211
  await json(path.join(code, 'root.config.json'), input)
80
- await json(path.join(data, '@origin/bootstrap.json'), { version: 3, domain, language: input.language, title: input.title, pages: ['home'], trademark: site.trademark, logo: site.logo })
81
- await json(path.join(data, '@origin/input.json'), {
82
- mode: 'direct', original: input.language, locales: [input.language],
83
- sourceSets: [], compositions: [], components: { home: 'Home' }
84
- })
85
- await json(path.join(data, '@origin/covers.json'), [])
86
- await json(path.join(data, 'page/home/logic.json'), { calls: {} })
87
- await json(path.join(data, 'page/home/' + input.language + '.schema.json'), {
88
- '@context': 'https://schema.org', '@graph': [{
89
- '@type': 'WebPage', '@id': 'https://' + domain + '/' + input.language + '/home#page',
90
- url: 'https://' + domain + '/' + input.language + '/home', name: input.title,
91
- inLanguage: input.language
92
- }]
93
- })
94
- const logicFile = path.join(data, 'site/root/@logic.json')
95
- const logic = JSON.parse(await readFile(logicFile, 'utf8'))
96
- logic['@lang'] = input.language
97
- logic['@langs'] = []
98
- await json(logicFile, logic)
99
- await json(path.join(data, 'site/settings.json'), site)
212
+ if (!input.codeOnly) {
213
+ await json(path.join(data, '@origin/bootstrap.json'), {
214
+ version: 3, domain, language: input.language, title: input.title, pages: ['home'],
215
+ trademark: site.trademark, logo: site.logo,
216
+ icons: { favicon: './icons/favicon.png', appleTouch: './icons/icon-180.png', webmanifest: './site/index.webmanifest', manifest: ['./icons/icon-192.png', './icons/icon-512.png'] }
217
+ })
218
+ await json(path.join(data, 'site/index.webmanifest'), webmanifest(input.title))
219
+ await json(path.join(data, '@origin/input.json'), {
220
+ mode: 'direct', original: input.language, locales: [input.language],
221
+ sourceSets: [], compositions: [], components: { home: 'Home' },
222
+ images: { sizes: [] }
223
+ })
224
+ await json(path.join(data, '@origin/covers.json'), [])
225
+ await json(path.join(data, 'page/home/logic.json'), { calls: {} })
226
+ await json(path.join(data, 'page/home/' + input.language + '.schema.json'), {
227
+ '@context': 'https://schema.org', '@graph': [{
228
+ '@type': 'WebPage', '@id': 'https://' + domain + '/' + input.language + '/home#page',
229
+ url: 'https://' + domain + '/' + input.language + '/home', name: input.title,
230
+ inLanguage: input.language
231
+ }]
232
+ })
233
+ const logicFile = path.join(data, 'site/root/@logic.json')
234
+ const logic = JSON.parse(await readFile(logicFile, 'utf8'))
235
+ logic['@lang'] = input.language
236
+ logic['@langs'] = []
237
+ await json(logicFile, logic)
238
+ await json(path.join(data, 'site/settings.json'), site)
239
+ }
100
240
  await json(path.join(code, 'route-map.json'), { version: 1, routes: {} })
101
- await json(path.join(code, 'bootstrap.json'), { generator: '@fullstackunicorn/root', version: '3.0.0', code, data })
241
+ await json(path.join(code, 'bootstrap.json'), { generator: '@fullstackunicorn/root', version: '4.0.0', code, data })
102
242
  return { code, data }
103
243
  }
104
244
 
package/package.json CHANGED
@@ -1,47 +1,52 @@
1
1
  {
2
- "version": "3.0.0",
3
- "name": "@fullstackunicorn/root",
4
- "author": "lucanigido (https://fullstackunicorn.dev/author/lucanigido)",
5
- "description": "Create a build-only website monorepo with original brand components and Websites source data",
6
- "license": "MIT",
7
- "type": "module",
8
- "private": false,
9
- "readme": "package.md",
10
- "files": [
11
- "index.cmd.js",
12
- "package.md",
13
- "index.js",
14
- "modules/bootstrap.js",
15
- "assets/blank/backend",
16
- "assets/monorepo",
17
- "scripts/check-model.mjs"
18
- ],
19
- "bin": {
20
- "root": "./index.cmd.js"
21
- },
22
- "repository": {
23
- "type": "git",
24
- "url": "https://gitlab.com/fullstackunicorn/root.git"
25
- },
26
- "keywords": [
27
- "cli",
28
- "root",
29
- "project",
30
- "javascript",
31
- "node",
32
- "fullstackunicorn"
33
- ],
34
- "imports": {
35
- "#@": "./",
36
- "#@/*": "./*"
37
- },
38
- "scripts": {
39
- "test": "node --test tests/*.test.js"
40
- },
41
- "dependencies": {},
42
- "devDependencies": {},
43
- "engines": {
44
- "node": ">=22.12.0"
45
- },
46
- "exports": "./index.js"
47
- }
2
+ "version": "4.0.0",
3
+ "name": "@fullstackunicorn/root",
4
+ "author": "lucanigido (https://fullstackunicorn.dev/author/lucanigido)",
5
+ "description": "Create a build-only website monorepo with original brand components and Websites source data",
6
+ "license": "MIT",
7
+ "type": "module",
8
+ "packageManager": "yarn@4.18.1",
9
+ "readme": "package.md",
10
+ "files": [
11
+ "index.cmd.js",
12
+ "package.md",
13
+ "index.js",
14
+ "index.dep.js",
15
+ "modules/bootstrap.js",
16
+ "assets/blank/backend/**/*",
17
+ "assets/blank/root/**/*",
18
+ "assets/monorepo/**/*",
19
+ "assets/yarnrc.yml",
20
+ "scripts/check-model.mjs",
21
+ "scripts/check-platform.mjs"
22
+ ],
23
+ "bin": "./index.cmd.js",
24
+ "repository": {
25
+ "type": "git",
26
+ "url": "https://gitlab.com/fullstackunicorn/root.git"
27
+ },
28
+ "keywords": [
29
+ "cli",
30
+ "root",
31
+ "project",
32
+ "javascript",
33
+ "node",
34
+ "fullstackunicorn"
35
+ ],
36
+ "imports": {
37
+ "#@": "./",
38
+ "#@/*": "./*"
39
+ },
40
+ "scripts": {
41
+ "test": "node --test tests/*.test.js"
42
+ },
43
+ "dependencies": {
44
+ "@babel/parser": "^8.1.2",
45
+ "@babel/traverse": "^8.1.2",
46
+ "@fullstackunicorn/websites": "3.0.0"
47
+ },
48
+ "engines": {
49
+ "node": ">=22.12.0"
50
+ },
51
+ "exports": "./index.js"
52
+ }
package/package.md CHANGED
@@ -1,20 +1,94 @@
1
- # @fullstackunicorn/root 2.0.0
1
+ # @fullstackunicorn/root 4.0.0
2
2
 
3
- Generate a website monorepo with a white home page and the supplied brand assets.
3
+ Generate a build-only website monorepo from the canonical model.
4
4
 
5
5
  ```sh
6
- root generate andreas.adwiser.me --config /inputs/site.json
6
+ root generate example.test --config /inputs/site.json
7
+ ```
8
+
9
+ From this package checkout the equivalent command is:
10
+
11
+ ```sh
12
+ node index.cmd.js generate example.test --config /inputs/site.json
7
13
  ```
8
14
 
9
15
  Input: `domain`, `group`, absolute `websites` directory, `title`, BCP-47 `language`,
10
- `trademark: {file, width, height}` and `logo: {file, size, visible}`.
16
+ `trademark: {file, inverseFile?, width, height, text?}` and
17
+ `logo: {file, inverseFile?, size, visible}`. A fresh project also requires
18
+ `favicon: {file}` and `icon: {file}`. Both sources must be square SVG or PNG.
11
19
  Brand files are SVG or PNG. Paths refer to the Linux build environment.
12
20
 
13
- Output: `Code/<group>/<domain>` and `Data/<group>/<domain>`.
21
+ Default output: `Code/<group>/<domain>` and `Data/<group>/<domain>`.
14
22
  Existing destinations are rejected. Inputs are validated before files are written.
23
+ The existing Websites icon generator writes the synchronized Data contract:
24
+ `icons/favicon.ico`, `icons/favicon.png`, `icons/icon-180.png`,
25
+ `icons/icon-192.png`, and `icons/icon-512.png`. It also writes
26
+ `site/index.webmanifest` in synchronized Data and `frontend/assets/index.webmanifest`
27
+ for the local frontend build. The HTML references the five canonical public URLs.
28
+
29
+ Set `codeOnly: true` to bootstrap code for already acquired source data.
30
+ `Data/<group>/<domain>` must exist and is left byte-for-byte unchanged.
31
+ Existing `Code/<group>/<domain>/@feed` and other non-generated material are preserved.
32
+ All generated root destinations must be absent: `frontend`, `backend`, `.env`,
33
+ `.env.test`, `.env.next`, `.env.live`, `.yarnrc.yml`, `yarn.lock`, `package.json`, `root.config.json`,
34
+ `route-map.json`, and `bootstrap.json`. Any collision rejects the operation before writing.
35
+ Brand assets are still copied into the frontend build assets. In this mode the
36
+ project feed supplies the CDN brand assets, site initialization data, lookups,
37
+ fonts, pages and schema in Data; the bootstrap does not replace acquired sources.
38
+ The existing Data must contain the complete canonical `icons/` set with exact
39
+ 32, 180, 192 and 512 pixel dimensions plus the matching
40
+ `site/index.webmanifest`; otherwise code-only bootstrap stops before writing Code.
41
+
42
+ Run installation and build in Linux with Node >=22.12.0.
43
+ Use `yarn install --immutable` with the committed `yarn.lock` and the exact Yarn
44
+ version pinned by `packageManager` in the generated root, frontend and backend.
45
+ Install each package without changing its lock:
46
+
47
+ ```sh
48
+ yarn install --immutable --mode=skip-build
49
+ yarn --cwd frontend install --immutable --mode=skip-build
50
+ yarn --cwd backend install --immutable --mode=skip-build
51
+ ```
15
52
 
16
- Run `npm ci` after the first installation has generated the lockfile, then
17
- `npm run build` inside `frontend`. The build runs the Style compiler and Vite.
18
- Serve `dist` with Nginx. The template defines no HMR, development server or preview command.
53
+ Check the generated frontend before building:
54
+
55
+ ```sh
56
+ node scripts/check-model.mjs /Websites/Code/example.test/example.test/frontend --platform
57
+ yarn --cwd /Websites/Code/example.test/example.test/frontend build
58
+ ```
59
+
60
+ The build runs the Style compiler and Vite. Serve `dist` with Nginx.
61
+ The template defines no HMR, development server or preview command.
19
62
  Use the same build for test, next and live; choose the environment at container startup.
20
63
  Synchronize Data through Websites, generate, and publish through the Websites BFF/API or MCP.
64
+
65
+ The generated frontend uses media sizes contract version 2. `src` always contains
66
+ `/S40/`; `sizes` declares `OO`, `S40` and only the available `S{width}` hashes.
67
+ The browser caps effective DPR at 2, resolves only keys present in `sizes`, never
68
+ downloads more than one variant, and does not double rendered widths above 960 CSS px.
69
+ Projects declare only their required generation widths in `images.sizes`; Website
70
+ never upscales and rejects originals narrower than 40 px. Legacy `max`, `full`,
71
+ `widths`, `hashes` and S1–L3 metadata are not accepted. The public version route is
72
+ `${CDN0}/version/:lang`. Per-site loads resolve below
73
+ `${CDN0}/data/load/:id/`; the legacy `preload.json` URL is not generated.
74
+
75
+ ## Locale and identity configuration
76
+
77
+ Before writing Code, bootstrap validates the locale contract. A fresh project uses
78
+ `[language]`. With `codeOnly: true`, bootstrap reads `Data/<group>/<domain>/@origin/input.json`
79
+ and writes its `locales` array to `frontend/root/content.locales.json`. The source
80
+ `original` must equal the requested `language`, and that language must be present
81
+ in the unique, valid locale list. A mismatch rejects bootstrap before writing.
82
+ The acquisition feed owns translated page data and site-root UI for these locales.
83
+
84
+ `title` supplies the Apple web-app title in `frontend/index.html`, escaped for HTML.
85
+ The model contains no project-specific Apple title. Per-page HTML titles and schema
86
+ remain supplied by Websites from page schema; they are not substituted with this
87
+ project-level identity setting.
88
+
89
+ Platform checks parse JavaScript/JSX and resolve lexical scope. Locally bound names
90
+ such as `document` and object properties such as `labels.document` are ordinary
91
+ application data. Unbound browser globals, DOM JSX tags and browser/CSS imports
92
+ outside imports remain errors. Supply a project's actual Native imports directory
93
+ with `--native /project/@feed/native/imports`; those adapters supplement the
94
+ canonical model adapters without disabling any platform check.
@@ -2,51 +2,45 @@ import { readFile, readdir } from 'node:fs/promises'
2
2
  import { createHash } from 'node:crypto'
3
3
  import path from 'node:path'
4
4
  import { fileURLToPath } from 'node:url'
5
+ import { platformIssues } from './check-platform.mjs'
5
6
 
6
7
  const model = fileURLToPath(new URL('../assets/monorepo/', import.meta.url))
7
- const target = path.resolve(process.argv.slice(2).find(value => !value.startsWith('--')) || path.join(model, 'frontend'))
8
+ const args = process.argv.slice(2)
9
+ const positional = args.filter(value => !value.startsWith('--'))
10
+ const target = path.resolve(positional[0] || path.join(model, 'frontend'))
8
11
  const manifest = JSON.parse(await readFile(path.join(model, 'files.json'), 'utf8'))
9
12
  const errors = []
13
+ const classes = new Set(['byte-sacred', 'file-sacred', 'role-sacred'])
10
14
  for (const item of manifest.files) {
15
+ if (!classes.has(item.class)) {
16
+ errors.push({ code: 'MODEL_CLASS_INVALID', path: item.path, class: item.class })
17
+ continue
18
+ }
11
19
  let bytes
12
20
  try { bytes = await readFile(path.join(target, item.path)) }
13
21
  catch (error) {
14
22
  if (error.code !== 'ENOENT') throw error
15
23
  errors.push({ code: 'MODEL_FILE_MISSING', path: item.path }); continue
16
24
  }
17
- if (item.class === 'sacred' && createHash('sha256').update(bytes).digest('hex') !== item.sha256) {
18
- errors.push({ code: 'SACRED_FILE_CHANGED', path: item.path })
25
+ if (item.class === 'byte-sacred' && createHash('sha256').update(bytes).digest('hex') !== item.sha256) {
26
+ errors.push({ code: 'BYTE_SACRED_FILE_CHANGED', path: item.path })
19
27
  }
20
28
  }
21
29
  if (process.argv.includes('--platform')) {
22
- const forbidden = /\b(?:window|document|navigator|localStorage|sessionStorage|DOMParser|ResizeObserver|MutationObserver|IntersectionObserver|getComputedStyle)\b|<(?:[a-z][a-z0-9]*)\b|['"](?:react-dom(?:\/[^'"]*)?|react-helmet-async)['"]|import\s+['"][^'"]+\.css['"]/
23
30
  const walk = async (folder, relative = '') => {
24
31
  for (const item of await readdir(folder, { withFileTypes: true })) {
25
32
  if (['node_modules', 'dist', '.devtools', '.git', 'assets', 'style', 'imports'].includes(item.name)) continue
26
33
  const name = path.join(relative, item.name), file = path.join(folder, item.name)
27
34
  if (item.isDirectory()) await walk(file, name)
28
- else if (relative && item.name.endsWith('.js')) {
29
- const lines = (await readFile(file, 'utf8')).split('\n')
30
- lines.forEach((line, index) => {
31
- if (!line.trim().startsWith('//') && forbidden.test(line)) errors.push({ code: 'PLATFORM_CODE_OUTSIDE_IMPORTS', path: name, line: index + 1 })
32
- })
35
+ else if (item.name.endsWith('.js')) {
36
+ errors.push(...platformIssues(await readFile(file, 'utf8'), name))
33
37
  }
34
38
  }
35
39
  }
36
40
  await walk(target)
37
- const imports = async (folder, relative = '') => {
38
- const files = []
39
- for (const item of await readdir(folder, { withFileTypes: true })) {
40
- const name = path.join(relative, item.name)
41
- if (item.isDirectory()) files.push(...await imports(path.join(folder, item.name), name))
42
- else if (item.name.endsWith('.js')) files.push(name)
43
- }
44
- return files
45
- }
46
- const native = new Set(await imports(path.join(model, 'native/imports')))
47
- for (const name of await imports(path.join(target, 'imports'))) {
48
- if (!native.has(name)) errors.push({ code: 'NATIVE_ADAPTER_MISSING', path: 'imports/' + name })
41
+ for (const item of await readdir(path.join(target, 'imports'), { withFileTypes: true })) {
42
+ if (item.name !== 'npm.js') errors.push({ code: 'LOCAL_IMPORT_ENGINE_FORBIDDEN', path: 'imports/' + item.name })
49
43
  }
50
44
  }
51
- console.log(JSON.stringify({ files: manifest.files.length, protected: manifest.files.filter(item => item.class === 'sacred').length, errors }, null, 2))
45
+ console.log(JSON.stringify({ files: manifest.files.length, byteSacred: manifest.files.filter(item => item.class === 'byte-sacred').length, errors }, null, 2))
52
46
  if (errors.length) process.exitCode = 1
@@ -0,0 +1,44 @@
1
+ import { parse } from '@babel/parser'
2
+ import traverseModule from '@babel/traverse'
3
+
4
+ const traverse = traverseModule.default || traverseModule
5
+ const globals = new Set(['window', 'document', 'navigator', 'localStorage', 'sessionStorage', 'DOMParser', 'ResizeObserver', 'MutationObserver', 'IntersectionObserver', 'getComputedStyle'])
6
+ const platformImport = value => /^(react-dom(?:\/.*)?|react-helmet-async)$/.test(value) || /\.css(?:[?#].*)?$/.test(value)
7
+
8
+ export const platformIssues = (source, file) => {
9
+ const errors = []
10
+ const lines = new Set()
11
+ const report = node => {
12
+ const line = node.loc.start.line
13
+ if (lines.has(line)) return
14
+ lines.add(line)
15
+ errors.push({ code: 'PLATFORM_CODE_OUTSIDE_IMPORTS', path: file, line })
16
+ }
17
+ let ast
18
+ try { ast = parse(source, { sourceType: 'unambiguous', plugins: ['jsx'] }) }
19
+ catch (error) { return [{ code: 'PLATFORM_PARSE_ERROR', path: file, line: error.loc?.line, message: error.message }] }
20
+ traverse(ast, {
21
+ ReferencedIdentifier(path) {
22
+ if (globals.has(path.node.name) && !path.scope.getBinding(path.node.name)) report(path.node)
23
+ },
24
+ MemberExpression(path) {
25
+ const { object, property, computed } = path.node
26
+ if (object.type !== 'Identifier' || object.name !== 'globalThis' || path.scope.getBinding('globalThis')) return
27
+ const name = computed && property.type === 'StringLiteral' ? property.value : !computed && property.type === 'Identifier' ? property.name : null
28
+ if (globals.has(name)) report(path.node)
29
+ },
30
+ JSXOpeningElement(path) {
31
+ const name = path.node.name
32
+ if (name.type === 'JSXIdentifier' && /^[a-z]/.test(name.name)) report(path.node)
33
+ },
34
+ ImportDeclaration(path) { if (platformImport(path.node.source.value)) report(path.node) },
35
+ ExportNamedDeclaration(path) { if (path.node.source && platformImport(path.node.source.value)) report(path.node) },
36
+ ExportAllDeclaration(path) { if (platformImport(path.node.source.value)) report(path.node) },
37
+ CallExpression(path) {
38
+ const callee = path.node.callee
39
+ const argument = path.node.arguments[0]
40
+ if ((callee.type === 'Import' || callee.type === 'Identifier' && callee.name === 'require' && !path.scope.getBinding('require')) && argument?.type === 'StringLiteral' && platformImport(argument.value)) report(path.node)
41
+ }
42
+ })
43
+ return errors
44
+ }
@@ -1,12 +0,0 @@
1
- .initial-placeholder {
2
- animation: initial-pulse 1.2s ease-in-out infinite;
3
- }
4
-
5
- @keyframes initial-pulse {
6
- 0%, 100% { opacity: 0.4; }
7
- 50% { opacity: 1; }
8
- }
9
-
10
- @media (prefers-reduced-motion: reduce) {
11
- .initial-placeholder { animation: none; opacity: 0.6; }
12
- }