@starci/eslint-canon-be 3.18.4 → 3.19.1

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 (211) hide show
  1. package/CHANGELOG.md +8 -0
  2. package/README.md +1 -1
  3. package/dist/comments.js +1 -1
  4. package/dist/explicit-surface.js +1 -1
  5. package/dist/index.js +1 -1
  6. package/dist/jwt-alg.js +1 -1
  7. package/dist/lib/edition.d.ts +1 -1
  8. package/dist/lib/edition.js +1 -1
  9. package/dist/lib/hfs-view.d.ts +5 -0
  10. package/dist/lib/hfs.d.ts +0 -6
  11. package/dist/lib/hfs.js +7 -5
  12. package/dist/lib/runtime-root.d.ts +6 -1
  13. package/dist/lib/runtime-root.js +8 -2
  14. package/dist/lib/subject-values.js +1 -1
  15. package/dist/module-layering.js +2 -2
  16. package/dist/project-graph.js +1 -1
  17. package/dist/schema-authority.js +66 -2
  18. package/dist/third-party-owner.js +1 -1
  19. package/package.json +3 -1
  20. package/runtime/bundle.json +1 -190
  21. package/runtime/scripts/api/git/recorded-lines.mjs +5 -5
  22. package/runtime/scripts/hfs/project-graph.mjs +6 -6
  23. package/runtime/scripts/hfs/project-rule.mjs +3 -3
  24. package/runtime/config.example.yaml +0 -194
  25. package/runtime/engine/by-code-unit.mjs +0 -12
  26. package/runtime/engine/config.mjs +0 -461
  27. package/runtime/engine/invalid-config.mjs +0 -15
  28. package/runtime/engine/model-config.mjs +0 -112
  29. package/runtime/engine/orca-config.mjs +0 -34
  30. package/runtime/engine/plain-object.mjs +0 -5
  31. package/runtime/engine/release-config.mjs +0 -32
  32. package/runtime/engine/removed-vocabulary.mjs +0 -27
  33. package/runtime/engine/resources-config.mjs +0 -59
  34. package/runtime/engine/runtime-root.mjs +0 -138
  35. package/runtime/engine/secrets.mjs +0 -202
  36. package/runtime/engine/sonar-config.mjs +0 -24
  37. package/runtime/engine/temp-root.mjs +0 -26
  38. package/runtime/engine/yaml.mjs +0 -161
  39. package/runtime/knowledge/grammars/index.yaml +0 -114
  40. package/runtime/knowledge/hfs/canon-pins.yaml +0 -720
  41. package/runtime/knowledge/hfs/fe-stack.yaml +0 -272
  42. package/runtime/knowledge/hfs/rules.yaml +0 -6760
  43. package/runtime/knowledge/hfs/slots.yaml +0 -2783
  44. package/runtime/knowledge/patterns/fe/folder.yaml +0 -425
  45. package/runtime/knowledge/sonar-gate.yaml +0 -151
  46. package/runtime/modules/kernel/removed-vocabulary.yaml +0 -458
  47. package/runtime/modules/models/registry.yaml +0 -221
  48. package/runtime/modules/models/runtimes.yaml +0 -556
  49. package/runtime/modules/models/tiers.yaml +0 -66
  50. package/runtime/scripts/api/git/cat-file.mjs +0 -4
  51. package/runtime/scripts/api/git/config-get.mjs +0 -9
  52. package/runtime/scripts/api/git/diff.mjs +0 -4
  53. package/runtime/scripts/api/git/lib.mjs +0 -80
  54. package/runtime/scripts/api/git/ls-files.mjs +0 -5
  55. package/runtime/scripts/api/git/ls-tree.mjs +0 -4
  56. package/runtime/scripts/api/git/merge-base.mjs +0 -8
  57. package/runtime/scripts/api/git/remote.mjs +0 -4
  58. package/runtime/scripts/api/git/rev-parse-query.mjs +0 -4
  59. package/runtime/scripts/api/git/show.mjs +0 -5
  60. package/runtime/scripts/api/git/tag.mjs +0 -4
  61. package/runtime/scripts/hfs/allows.mjs +0 -77
  62. package/runtime/scripts/hfs/architecture/ast-walks.mjs +0 -250
  63. package/runtime/scripts/hfs/architecture/automatic-gates.mjs +0 -103
  64. package/runtime/scripts/hfs/architecture/backend-app-files.mjs +0 -114
  65. package/runtime/scripts/hfs/architecture/backend.mjs +0 -462
  66. package/runtime/scripts/hfs/architecture/background-unowned.mjs +0 -254
  67. package/runtime/scripts/hfs/architecture/canon-clones.mjs +0 -291
  68. package/runtime/scripts/hfs/architecture/canon-jsx-clones.mjs +0 -224
  69. package/runtime/scripts/hfs/architecture/client-reaches-server.mjs +0 -102
  70. package/runtime/scripts/hfs/architecture/clones.mjs +0 -287
  71. package/runtime/scripts/hfs/architecture/component-tiers.mjs +0 -161
  72. package/runtime/scripts/hfs/architecture/config-unread.mjs +0 -16
  73. package/runtime/scripts/hfs/architecture/config.mjs +0 -407
  74. package/runtime/scripts/hfs/architecture/connection-map.mjs +0 -350
  75. package/runtime/scripts/hfs/architecture/constructor-deps.mjs +0 -115
  76. package/runtime/scripts/hfs/architecture/context-coupling.mjs +0 -117
  77. package/runtime/scripts/hfs/architecture/context-map.mjs +0 -355
  78. package/runtime/scripts/hfs/architecture/context-owner.mjs +0 -102
  79. package/runtime/scripts/hfs/architecture/context-platform-tables.mjs +0 -65
  80. package/runtime/scripts/hfs/architecture/context-transaction.mjs +0 -75
  81. package/runtime/scripts/hfs/architecture/contract-bounds.mjs +0 -72
  82. package/runtime/scripts/hfs/architecture/contract-fixture-guard.mjs +0 -177
  83. package/runtime/scripts/hfs/architecture/contracts-readonly.mjs +0 -360
  84. package/runtime/scripts/hfs/architecture/contracts.mjs +0 -489
  85. package/runtime/scripts/hfs/architecture/cross-app-duplicate.mjs +0 -81
  86. package/runtime/scripts/hfs/architecture/dead-exports-bindings.mjs +0 -173
  87. package/runtime/scripts/hfs/architecture/dead-exports.mjs +0 -420
  88. package/runtime/scripts/hfs/architecture/default-deny.mjs +0 -175
  89. package/runtime/scripts/hfs/architecture/doc-language.mjs +0 -45
  90. package/runtime/scripts/hfs/architecture/entity-registry.mjs +0 -51
  91. package/runtime/scripts/hfs/architecture/entrypoint.mjs +0 -75
  92. package/runtime/scripts/hfs/architecture/error-codes.mjs +0 -54
  93. package/runtime/scripts/hfs/architecture/error-masked.mjs +0 -78
  94. package/runtime/scripts/hfs/architecture/fe-slot-allows.mjs +0 -44
  95. package/runtime/scripts/hfs/architecture/feature-shape.mjs +0 -60
  96. package/runtime/scripts/hfs/architecture/framework-pinned.mjs +0 -41
  97. package/runtime/scripts/hfs/architecture/frontend-block-render.mjs +0 -112
  98. package/runtime/scripts/hfs/architecture/frontend-grammar.mjs +0 -193
  99. package/runtime/scripts/hfs/architecture/frontend-routing.mjs +0 -198
  100. package/runtime/scripts/hfs/architecture/frontend-world-render.mjs +0 -368
  101. package/runtime/scripts/hfs/architecture/frontend-world.mjs +0 -374
  102. package/runtime/scripts/hfs/architecture/frontend.mjs +0 -248
  103. package/runtime/scripts/hfs/architecture/function-spec-providers.mjs +0 -185
  104. package/runtime/scripts/hfs/architecture/hfs-graph.mjs +0 -77
  105. package/runtime/scripts/hfs/architecture/hfs.mjs +0 -394
  106. package/runtime/scripts/hfs/architecture/hooks-are-hooks.mjs +0 -118
  107. package/runtime/scripts/hfs/architecture/i18n-keys.mjs +0 -213
  108. package/runtime/scripts/hfs/architecture/identity.mjs +0 -121
  109. package/runtime/scripts/hfs/architecture/index.mjs +0 -402
  110. package/runtime/scripts/hfs/architecture/injection-token-exported.mjs +0 -69
  111. package/runtime/scripts/hfs/architecture/jwt-ast.mjs +0 -231
  112. package/runtime/scripts/hfs/architecture/machine-ast.mjs +0 -232
  113. package/runtime/scripts/hfs/architecture/managed-scripts.mjs +0 -32
  114. package/runtime/scripts/hfs/architecture/module-per-transport.mjs +0 -237
  115. package/runtime/scripts/hfs/architecture/next-data-contract.mjs +0 -126
  116. package/runtime/scripts/hfs/architecture/next-data-inference.mjs +0 -192
  117. package/runtime/scripts/hfs/architecture/next-data-key.mjs +0 -374
  118. package/runtime/scripts/hfs/architecture/next-data-symbols.mjs +0 -26
  119. package/runtime/scripts/hfs/architecture/next-data.mjs +0 -425
  120. package/runtime/scripts/hfs/architecture/operation-contract-roots.mjs +0 -55
  121. package/runtime/scripts/hfs/architecture/owners.mjs +0 -142
  122. package/runtime/scripts/hfs/architecture/package-shape.mjs +0 -92
  123. package/runtime/scripts/hfs/architecture/presentation.mjs +0 -173
  124. package/runtime/scripts/hfs/architecture/reachability.mjs +0 -330
  125. package/runtime/scripts/hfs/architecture/register-once.mjs +0 -212
  126. package/runtime/scripts/hfs/architecture/registration.mjs +0 -372
  127. package/runtime/scripts/hfs/architecture/render-graph.mjs +0 -449
  128. package/runtime/scripts/hfs/architecture/render-prop-across-server.mjs +0 -58
  129. package/runtime/scripts/hfs/architecture/required-files.mjs +0 -237
  130. package/runtime/scripts/hfs/architecture/root-packages.mjs +0 -78
  131. package/runtime/scripts/hfs/architecture/route-files-thin.mjs +0 -133
  132. package/runtime/scripts/hfs/architecture/schema-owner.mjs +0 -288
  133. package/runtime/scripts/hfs/architecture/server-action.mjs +0 -78
  134. package/runtime/scripts/hfs/architecture/side-boundary.mjs +0 -13
  135. package/runtime/scripts/hfs/architecture/source-names-shape.mjs +0 -320
  136. package/runtime/scripts/hfs/architecture/source-names.mjs +0 -393
  137. package/runtime/scripts/hfs/architecture/sql-keys.mjs +0 -344
  138. package/runtime/scripts/hfs/architecture/sql-owner.mjs +0 -291
  139. package/runtime/scripts/hfs/architecture/sql-returning.mjs +0 -76
  140. package/runtime/scripts/hfs/architecture/sql-token-forms.mjs +0 -117
  141. package/runtime/scripts/hfs/architecture/sql-tokens.mjs +0 -587
  142. package/runtime/scripts/hfs/architecture/staged-consumers.mjs +0 -42
  143. package/runtime/scripts/hfs/architecture/surface-nesting.mjs +0 -127
  144. package/runtime/scripts/hfs/architecture/surface.mjs +0 -88
  145. package/runtime/scripts/hfs/architecture/symbols.mjs +0 -273
  146. package/runtime/scripts/hfs/architecture/test-world-files.mjs +0 -263
  147. package/runtime/scripts/hfs/architecture/tiers.mjs +0 -256
  148. package/runtime/scripts/hfs/architecture/transport-owner.mjs +0 -248
  149. package/runtime/scripts/hfs/architecture/type-context.mjs +0 -335
  150. package/runtime/scripts/hfs/architecture/typescript.mjs +0 -477
  151. package/runtime/scripts/hfs/architecture/unit-spec-providers.mjs +0 -165
  152. package/runtime/scripts/hfs/declaration-shape.mjs +0 -196
  153. package/runtime/scripts/hfs/declaration-slots.mjs +0 -89
  154. package/runtime/scripts/hfs/edition-slots.mjs +0 -80
  155. package/runtime/scripts/hfs/explicit-surface-rule.mjs +0 -59
  156. package/runtime/scripts/hfs/linear-text.mjs +0 -30
  157. package/runtime/scripts/hfs/manifest-shape.mjs +0 -474
  158. package/runtime/scripts/hfs/param-names.mjs +0 -13
  159. package/runtime/scripts/hfs/path-findings.mjs +0 -167
  160. package/runtime/scripts/hfs/repo-identity.mjs +0 -89
  161. package/runtime/scripts/hfs/rule-catalog.mjs +0 -458
  162. package/runtime/scripts/hfs/rule-params-shape.mjs +0 -103
  163. package/runtime/scripts/hfs/rules/database-constants.mjs +0 -25
  164. package/runtime/scripts/hfs/rules/database-migrations.mjs +0 -684
  165. package/runtime/scripts/hfs/rules/fe-no-tests.mjs +0 -68
  166. package/runtime/scripts/hfs/rules/read.mjs +0 -45
  167. package/runtime/scripts/hfs/rules/secrets.mjs +0 -79
  168. package/runtime/scripts/hfs/rules/spec-placement.mjs +0 -28
  169. package/runtime/scripts/hfs/slot-app-view.mjs +0 -97
  170. package/runtime/scripts/hfs/slot-classify.mjs +0 -69
  171. package/runtime/scripts/hfs/slot-errors.mjs +0 -12
  172. package/runtime/scripts/hfs/slot-imports.mjs +0 -98
  173. package/runtime/scripts/hfs/slot-manifest-shape.mjs +0 -111
  174. package/runtime/scripts/hfs/slot-match.mjs +0 -164
  175. package/runtime/scripts/hfs/slot-path.mjs +0 -6
  176. package/runtime/scripts/hfs/slot-required.mjs +0 -95
  177. package/runtime/scripts/hfs/slot-semantic-problems.mjs +0 -175
  178. package/runtime/scripts/hfs/slot-side-problems.mjs +0 -32
  179. package/runtime/scripts/hfs/slots.mjs +0 -306
  180. package/runtime/scripts/hfs/test-world-slot.mjs +0 -5
  181. package/runtime/scripts/hfs/trailing-slashes.mjs +0 -8
  182. package/runtime/scripts/hfs/typescript-programs.mjs +0 -95
  183. package/runtime/scripts/hfs/view.mjs +0 -180
  184. package/runtime/scripts/lib/declaration-surface.mjs +0 -166
  185. package/runtime/scripts/lib/dockerfile.mjs +0 -164
  186. package/runtime/scripts/lib/env.mjs +0 -18
  187. package/runtime/scripts/lib/event-contract.mjs +0 -102
  188. package/runtime/scripts/lib/git-hooks-dir.mjs +0 -30
  189. package/runtime/scripts/lib/git.mjs +0 -35
  190. package/runtime/scripts/lib/glob.mjs +0 -32
  191. package/runtime/scripts/lib/grammar-lint.mjs +0 -57
  192. package/runtime/scripts/lib/i18n.mjs +0 -82
  193. package/runtime/scripts/lib/in-order.mjs +0 -90
  194. package/runtime/scripts/lib/json-clone.mjs +0 -70
  195. package/runtime/scripts/lib/json.mjs +0 -44
  196. package/runtime/scripts/lib/language.mjs +0 -233
  197. package/runtime/scripts/lib/list.mjs +0 -26
  198. package/runtime/scripts/lib/mutation-fence.mjs +0 -20
  199. package/runtime/scripts/lib/package-at.mjs +0 -62
  200. package/runtime/scripts/lib/path-key.mjs +0 -124
  201. package/runtime/scripts/lib/read-text.mjs +0 -47
  202. package/runtime/scripts/lib/regex.mjs +0 -3
  203. package/runtime/scripts/lib/rule-packs.mjs +0 -243
  204. package/runtime/scripts/lib/same-text.mjs +0 -4
  205. package/runtime/scripts/lib/secret-patterns.mjs +0 -230
  206. package/runtime/scripts/lib/sops-envelope.mjs +0 -212
  207. package/runtime/scripts/lib/stack-services.mjs +0 -191
  208. package/runtime/scripts/lib/ts-analysis.mjs +0 -39
  209. package/runtime/scripts/lib/ts-ast.mjs +0 -63
  210. package/runtime/scripts/lib/walk.mjs +0 -45
  211. package/runtime/scripts/lib/yaml-cached.mjs +0 -14
@@ -1,272 +0,0 @@
1
- schema: starci/fe-stack@1
2
- purpose: >-
3
- The front-end stack of every app, lite and full alike (owner ruling 2026-10-13, R212 case-2 (owner:lite-production-swarm), with the Work boundary amended by ruling:R212/case-4): for each common front-end concern the
4
- ONE canonical library, its HFS home (slot ids of knowledge/hfs/slots.yaml), the pattern id that teaches it
5
- (knowledge/patterns/fe/*.yaml) and the alternatives a front end never depends on or imports. Versions live in
6
- knowledge/hfs/canon-pins.yaml only. `tier: core` packages are installed by every scaffold; `opt` packages are added when a feature
7
- needs the concern. Source example: starci-lab/starci-academy (origin/main, 2026-10-13); it illustrates, this file decides.
8
- concerns:
9
- - id: framework
10
- tier: core
11
- packages: [next, react, react-dom, typescript]
12
- home: [fe.route, fe.source-root-pinned]
13
- pattern: FE-ROUTE
14
- forbids: []
15
- why: App Router with thin routes; route handlers (except health/live and the auth callback slot) and Server Actions are refused by FE_ROUTE_HANDLER_FORBIDDEN and FE_SERVER_ACTION_FORBIDDEN.
16
- - id: graphql
17
- tier: core
18
- packages: ['@apollo/client', graphql]
19
- home: [fe.modules.api, fe.transport.client, fe.transport.outcome]
20
- pattern: FE-API-GRAPHQL
21
- forbids: [urql, graphql-request, '@urql/core', graphql-hooks, apollo-boost]
22
- why: one file per operation under modules/api/graphql/{queries,mutations,subscriptions}, run by the auth or no-auth Apollo client with the link chain.
23
- - id: graphql-subscriptions
24
- tier: opt
25
- packages: [graphql-ws]
26
- home: [fe.transport.client, fe.package.api.client]
27
- pattern: FE-REALTIME
28
- forbids: []
29
- why: the subscription transport of a GraphQL subscription door (be.feature.realtime.graphql); only the Apollo clients folder imports it (GraphQLWsLink of @apollo/client/link/subscriptions), a subscription operation runs on that client and a useSubscribe hook of hooks/swr reads it.
30
- - id: codegen
31
- tier: core
32
- packages: ['@graphql-codegen/cli', '@graphql-codegen/client-preset']
33
- home: [fe.modules.api]
34
- pattern: FE-WIRE-GENERATED
35
- forbids: []
36
- why: the wire types are generated from be/contracts/<app>/schema.graphql into modules/api/graphql/__generated__, never typed by hand.
37
- - id: rest
38
- tier: core
39
- packages: [axios]
40
- home: [fe.modules.api]
41
- pattern: FE-API-REST
42
- forbids: [ky, superagent, node-fetch, cross-fetch, isomorphic-fetch]
43
- why: modules/api/rest/<area>/*.ts for uploads and presigned URLs, only; GraphQL carries every other call.
44
- - id: data
45
- tier: core
46
- packages: [swr, '@starci/next-data']
47
- home: [fe.hooks.swr]
48
- pattern: FE-DATA-SWR
49
- forbids: ['@tanstack/react-query', react-query]
50
- why: hooks/swr/api/{graphql,rest}/{queries,mutations}/use*Swr.ts wrap one operation each; components call hooks only. The polling-restart middleware (pollingRestart), the key helpers, the viewer-keyed config and the viewer cache are @starci/next-data's (owner next-data-package); an app imports no Middleware or ScopedMutator type of swr and writes none of them.
51
- - id: toast
52
- tier: core
53
- packages: ['@heroui/react']
54
- home: [fe.modules.toast]
55
- pattern: FE-TOAST
56
- forbids: [sonner, react-toastify, react-hot-toast, notistack]
57
- why: mutation outcomes are reported by modules/toast (showGraphQLToast, use*WithToast) with next-intl labels.
58
- - id: forms
59
- tier: core
60
- packages: [react-hook-form, '@hookform/resolvers', zod]
61
- home: [fe.hooks.rhf]
62
- pattern: FE-FORM
63
- forbids: [formik, yup, final-form, react-final-form]
64
- why: hooks/rhf/use<X>Form.ts builds a zod schema with next-intl messages and submits through an SWR mutation and the toast.
65
- - id: state-global
66
- tier: core
67
- packages: ['@reduxjs/toolkit', react-redux]
68
- home: [fe.redux]
69
- pattern: FE-STATE-REDUX
70
- forbids: [mobx, mobx-react, mobx-react-lite, recoil, jotai, valtio, redux-saga]
71
- why: app-wide shared state (selected ids synced from the route, server-pushed entities) lives in redux/slices.
72
- - id: state-local
73
- tier: core
74
- packages: [zustand]
75
- home: [fe.hooks.zustand]
76
- pattern: FE-STATE-ZUSTAND
77
- forbids: []
78
- why: feature-local UI, wizard and editor state lives in hooks/zustand/<store>.
79
- - id: realtime
80
- tier: opt
81
- packages: [socket.io-client, eventemitter2]
82
- home: [fe.hooks.socketio]
83
- pattern: FE-REALTIME
84
- forbids: [subscriptions-transport-ws, '@supabase/realtime-js', pusher-js, ably]
85
- why: one socket.io-client singleton per namespace and one side-effect component that dispatches to redux and SWR; both editions run the gateway in the be api process. A one-way channel served as server-sent events is the event-stream concern below (FE-REALTIME).
86
- - id: event-stream
87
- tier: opt
88
- packages: ['@starci/event-stream']
89
- home: [fe.transport.stream]
90
- pattern: FE-REALTIME
91
- forbids: ['@microsoft/fetch-event-source', eventsource, event-source-polyfill, eventsource-parser, reconnecting-eventsource, 'sse.js', 'fetch-sse', 'sse-ts']
92
- why: >-
93
- the one server-sent-events client (owner:event-stream-package): the app creates one instance in modules/api/sse/clients/event-stream.ts
94
- with createEventStream (the bearer token source, one renewal on a 401, backoff, heartbeat timeout), each stream operation
95
- (sse/<area>/stream-<channel>.ts) follows on it, and the useSubscribe<Channel>Swr hook reads that operation. No app keeps a
96
- hand-written reader (read-event-stream.ts) and no second SSE library is installed.
97
- - id: auth
98
- tier: core
99
- packages: ['@starci/auth', '@starci/auth-oidc']
100
- home: [fe.modules.auth]
101
- pattern: FE-AUTH
102
- forbids: ['@supabase/supabase-js', '@supabase/ssr', '@supabase/auth-js', jose, jwt-decode, next-auth, '@auth/core', keycloak-js, oidc-client-ts]
103
- why: modules/auth is the session issuer's client (one @starci/auth client instance over the app's own back-end auth doors, the access token in its memory; full - the app's IdP client); it yields the session and the access token for the Apollo link and never reads data.
104
- - id: i18n
105
- tier: core
106
- packages: [next-intl, '@starci/next-i18n']
107
- home: [fe.modules.i18n]
108
- pattern: FE-I18N
109
- forbids: [i18next, react-i18next, next-i18next, react-intl, '@lingui/react']
110
- why: useTranslations for copy and the next-intl formatter for numbers, fixed dates and currency; FE-DATE owns live time display. The routing, the proxy, the navigation, the request config and the locale read of the layout are @starci/next-i18n's (owner next-i18n-package); an app calls no defineRouting, createNavigation, getRequestConfig or createMiddleware.
111
- - id: ui
112
- tier: core
113
- packages: ['@heroui/react', '@heroui/styles', tailwindcss, '@starci/grammar', react-aria-components]
114
- home: [fe.components, fe.feature]
115
- pattern: FE-UI
116
- forbids: ['@mantine/core', '@mui/material', '@chakra-ui/react', antd, styled-components, '@emotion/react', '@emotion/styled']
117
- why: the grammar renderers over HeroUI and Tailwind; no second UI kit and no CSS-in-JS.
118
- - id: icons
119
- tier: core
120
- packages: ['@heroicons/react', '@starci/heroicons']
121
- home: [fe.components]
122
- pattern: FE-ICON
123
- forbids: ['@phosphor-icons/react', react-icons, lucide-react, '@iconify/react', '@gravity-ui/icons', '@tabler/icons-react', '@fortawesome/react-fontawesome']
124
- why: >-
125
- one application icon set, the heroicons family (owner ruling 2026-10-13), on the 24/outline and 16/solid cuts. @heroicons/react
126
- is the base set and is used first; @starci/heroicons holds only the glyphs heroicons lacks (brand or domain glyphs drawn in
127
- heroicons style), never duplicates a heroicons glyph, and a missing glyph is added to it.
128
- - id: avatar-illustration
129
- tier: opt
130
- packages: ['@starci/grammar']
131
- home: [fe.components]
132
- pattern: FE-UI
133
- forbids: ['@dicebear/*', boring-avatars, 'react-nice-avatar', multiavatar]
134
- why: >-
135
- Grammar owns avatars: pass the uploaded avatar as src and the user or identity id as seed on Avatar, AvatarButton
136
- or AvatarGroup members. Without src, Grammar renders bundled DiceBear initials using the first and last words of
137
- name, with colour seeded by seed when present and by name otherwise. kind="agent" adds the Grammar-owned bot badge
138
- without changing the name rule. @dicebear/core and @dicebear/styles are Grammar runtime dependencies pinned in
139
- canon-pins.yaml. Apps declare and import @starci/grammar, never @dicebear/*, and draw no avatar visuals.
140
- - id: theme
141
- tier: core
142
- packages: [next-themes]
143
- home: [fe.components.providers]
144
- pattern: FE-THEME
145
- forbids: []
146
- why: the theme provider lives in components/providers.
147
- - id: motion
148
- tier: opt
149
- packages: [framer-motion]
150
- home: [fe.components]
151
- pattern: FE-MOTION
152
- forbids: [react-spring, '@react-spring/web', gsap]
153
- why: one motion library.
154
- - id: dates
155
- tier: core
156
- packages: [dayjs]
157
- home: [fe.modules]
158
- pattern: FE-DATE
159
- forbids: [moment, moment-timezone, date-fns, luxon]
160
- why: FE-DATE owns application date math, fixed date formatting and Grammar's live time display.
161
- - id: numbers
162
- tier: opt
163
- packages: [decimal.js]
164
- home: [fe.modules]
165
- pattern: FE-NUMBER
166
- forbids: [big.js, bignumber.js, numeral]
167
- why: decimal.js for money arithmetic in modules/utils; display through the next-intl formatter.
168
- - id: storage
169
- tier: core
170
- packages: [superjson]
171
- home: [fe.modules]
172
- pattern: FE-STORAGE
173
- forbids: [localforage, store2]
174
- why: modules/storage (local and session storage) serializes through modules/superjson; components never touch storage directly.
175
- - id: utils
176
- tier: opt
177
- packages: [lodash, usehooks-ts]
178
- home: [fe.modules, fe.hooks.reuseables]
179
- pattern: FE-UTILS
180
- forbids: [underscore, ramda, lodash-es]
181
- why: per-method lodash imports in modules/utils and reusable hooks in hooks/reuseables.
182
- - id: charts
183
- tier: opt
184
- packages: [recharts]
185
- home: [fe.components]
186
- pattern: FE-CHART
187
- forbids: [chart.js, react-chartjs-2, '@nivo/core', d3, echarts, echarts-for-react]
188
- why: one chart library, styled by the dataviz grammar.
189
- - id: flow
190
- tier: opt
191
- packages: ['@xyflow/react']
192
- home: [fe.components]
193
- pattern: FE-FLOW
194
- forbids: [reactflow, cytoscape]
195
- why: graph canvases go through the grammar FlowGraph over React Flow.
196
- - id: markdown
197
- tier: opt
198
- packages: [react-markdown, remark-gfm, remark-directive]
199
- home: [fe.components]
200
- pattern: FE-MARKDOWN
201
- forbids: [marked, markdown-it, showdown]
202
- why: markdown renders through react-markdown, never dangerouslySetInnerHTML.
203
- - id: code
204
- tier: opt
205
- packages: [react-shiki, '@monaco-editor/react']
206
- home: [fe.components]
207
- pattern: FE-CODE
208
- forbids: [prismjs, react-syntax-highlighter, highlight.js, '@uiw/react-codemirror', codemirror]
209
- why: react-shiki highlights and Monaco edits.
210
- - id: diagrams
211
- tier: opt
212
- packages: [mermaid]
213
- home: [fe.components]
214
- pattern: FE-DIAGRAM
215
- forbids: []
216
- why: diagrams render through mermaid in a block.
217
- - id: upload
218
- tier: opt
219
- packages: [react-dropzone]
220
- home: [fe.components, fe.modules.api]
221
- pattern: FE-UPLOAD
222
- forbids: [react-dropzone-uploader, filepond, react-filepond, uppy]
223
- why: react-dropzone in a block and a presigned PUT through modules/api/rest.
224
- - id: pdf
225
- tier: opt
226
- packages: [react-pdf]
227
- home: [fe.components]
228
- pattern: FE-PDF
229
- forbids: ['@react-pdf-viewer/core', pdfjs-dist]
230
- why: PDF viewing through react-pdf in a block.
231
- - id: device-id
232
- tier: opt
233
- packages: ['@fingerprintjs/fingerprintjs']
234
- home: [fe.transport.client]
235
- pattern: FE-API-GRAPHQL
236
- forbids: []
237
- why: the fingerprint link of the Apollo client attaches the device id.
238
- - id: observability
239
- tier: opt
240
- packages: ['@sentry/nextjs']
241
- home: [fe.source-root-pinned]
242
- pattern: FE-OBSERVE
243
- forbids: [logrocket, bugsnag-js, '@bugsnag/js', '@datadog/browser-rum']
244
- why: errors are reported through @sentry/nextjs (sentry.*.config.ts, instrumentation.ts), never console-only.
245
- - id: lint
246
- tier: core
247
- packages: [eslint, prettier, '@starci/eslint-canon-fe', '@starci/prettier-config']
248
- home: [fe.tool-config]
249
- pattern: FE-LINT
250
- forbids: []
251
- why: the canon lint and format configuration.
252
- - id: grammar-lint
253
- tier: opt
254
- packages: ['@starci/eslint-grammar-core', '@starci/eslint-grammar-offset-pop']
255
- home: [fe.source-root-pinned]
256
- pattern: FE-RULE-OWNERSHIP
257
- forbids: []
258
- why: The selected Grammar family's lint package runs beside the universal front-end canon; the family catalog declares the package and factory.
259
- - id: framework-support
260
- tier: opt
261
- packages: [server-only, rxjs]
262
- home: [fe.source-root-pinned]
263
- pattern: FE-ROUTE
264
- forbids: []
265
- why: the Next server boundary marker and Apollo peer support used by canonical workspaces.
266
- - id: tool-support
267
- tier: opt
268
- packages: ['@types/node', '@types/react', '@types/react-dom', '@starci/tsconfig', '@starci/stylelint-canon', '@tailwindcss/postcss', postcss-value-parser, stylelint, eslint-plugin-react-hooks]
269
- home: [fe.tool-config]
270
- pattern: FE-LINT
271
- forbids: []
272
- why: the compiler, CSS and lint support packages of the canonical front-end configs.