@starci/eslint-canon-be 3.18.4 → 3.19.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 (208) hide show
  1. package/CHANGELOG.md +4 -0
  2. package/dist/comments.js +1 -1
  3. package/dist/explicit-surface.js +1 -1
  4. package/dist/index.js +1 -1
  5. package/dist/jwt-alg.js +1 -1
  6. package/dist/lib/edition.d.ts +1 -1
  7. package/dist/lib/edition.js +1 -1
  8. package/dist/lib/hfs.d.ts +0 -6
  9. package/dist/lib/hfs.js +7 -5
  10. package/dist/lib/runtime-root.d.ts +6 -1
  11. package/dist/lib/runtime-root.js +8 -2
  12. package/dist/lib/subject-values.js +1 -1
  13. package/dist/module-layering.js +2 -2
  14. package/dist/project-graph.js +1 -1
  15. package/dist/third-party-owner.js +1 -1
  16. package/package.json +3 -1
  17. package/runtime/bundle.json +1 -190
  18. package/runtime/scripts/api/git/recorded-lines.mjs +5 -5
  19. package/runtime/scripts/hfs/project-graph.mjs +6 -6
  20. package/runtime/scripts/hfs/project-rule.mjs +3 -3
  21. package/runtime/config.example.yaml +0 -194
  22. package/runtime/engine/by-code-unit.mjs +0 -12
  23. package/runtime/engine/config.mjs +0 -461
  24. package/runtime/engine/invalid-config.mjs +0 -15
  25. package/runtime/engine/model-config.mjs +0 -112
  26. package/runtime/engine/orca-config.mjs +0 -34
  27. package/runtime/engine/plain-object.mjs +0 -5
  28. package/runtime/engine/release-config.mjs +0 -32
  29. package/runtime/engine/removed-vocabulary.mjs +0 -27
  30. package/runtime/engine/resources-config.mjs +0 -59
  31. package/runtime/engine/runtime-root.mjs +0 -138
  32. package/runtime/engine/secrets.mjs +0 -202
  33. package/runtime/engine/sonar-config.mjs +0 -24
  34. package/runtime/engine/temp-root.mjs +0 -26
  35. package/runtime/engine/yaml.mjs +0 -161
  36. package/runtime/knowledge/grammars/index.yaml +0 -114
  37. package/runtime/knowledge/hfs/canon-pins.yaml +0 -720
  38. package/runtime/knowledge/hfs/fe-stack.yaml +0 -272
  39. package/runtime/knowledge/hfs/rules.yaml +0 -6760
  40. package/runtime/knowledge/hfs/slots.yaml +0 -2783
  41. package/runtime/knowledge/patterns/fe/folder.yaml +0 -425
  42. package/runtime/knowledge/sonar-gate.yaml +0 -151
  43. package/runtime/modules/kernel/removed-vocabulary.yaml +0 -458
  44. package/runtime/modules/models/registry.yaml +0 -221
  45. package/runtime/modules/models/runtimes.yaml +0 -556
  46. package/runtime/modules/models/tiers.yaml +0 -66
  47. package/runtime/scripts/api/git/cat-file.mjs +0 -4
  48. package/runtime/scripts/api/git/config-get.mjs +0 -9
  49. package/runtime/scripts/api/git/diff.mjs +0 -4
  50. package/runtime/scripts/api/git/lib.mjs +0 -80
  51. package/runtime/scripts/api/git/ls-files.mjs +0 -5
  52. package/runtime/scripts/api/git/ls-tree.mjs +0 -4
  53. package/runtime/scripts/api/git/merge-base.mjs +0 -8
  54. package/runtime/scripts/api/git/remote.mjs +0 -4
  55. package/runtime/scripts/api/git/rev-parse-query.mjs +0 -4
  56. package/runtime/scripts/api/git/show.mjs +0 -5
  57. package/runtime/scripts/api/git/tag.mjs +0 -4
  58. package/runtime/scripts/hfs/allows.mjs +0 -77
  59. package/runtime/scripts/hfs/architecture/ast-walks.mjs +0 -250
  60. package/runtime/scripts/hfs/architecture/automatic-gates.mjs +0 -103
  61. package/runtime/scripts/hfs/architecture/backend-app-files.mjs +0 -114
  62. package/runtime/scripts/hfs/architecture/backend.mjs +0 -462
  63. package/runtime/scripts/hfs/architecture/background-unowned.mjs +0 -254
  64. package/runtime/scripts/hfs/architecture/canon-clones.mjs +0 -291
  65. package/runtime/scripts/hfs/architecture/canon-jsx-clones.mjs +0 -224
  66. package/runtime/scripts/hfs/architecture/client-reaches-server.mjs +0 -102
  67. package/runtime/scripts/hfs/architecture/clones.mjs +0 -287
  68. package/runtime/scripts/hfs/architecture/component-tiers.mjs +0 -161
  69. package/runtime/scripts/hfs/architecture/config-unread.mjs +0 -16
  70. package/runtime/scripts/hfs/architecture/config.mjs +0 -407
  71. package/runtime/scripts/hfs/architecture/connection-map.mjs +0 -350
  72. package/runtime/scripts/hfs/architecture/constructor-deps.mjs +0 -115
  73. package/runtime/scripts/hfs/architecture/context-coupling.mjs +0 -117
  74. package/runtime/scripts/hfs/architecture/context-map.mjs +0 -355
  75. package/runtime/scripts/hfs/architecture/context-owner.mjs +0 -102
  76. package/runtime/scripts/hfs/architecture/context-platform-tables.mjs +0 -65
  77. package/runtime/scripts/hfs/architecture/context-transaction.mjs +0 -75
  78. package/runtime/scripts/hfs/architecture/contract-bounds.mjs +0 -72
  79. package/runtime/scripts/hfs/architecture/contract-fixture-guard.mjs +0 -177
  80. package/runtime/scripts/hfs/architecture/contracts-readonly.mjs +0 -360
  81. package/runtime/scripts/hfs/architecture/contracts.mjs +0 -489
  82. package/runtime/scripts/hfs/architecture/cross-app-duplicate.mjs +0 -81
  83. package/runtime/scripts/hfs/architecture/dead-exports-bindings.mjs +0 -173
  84. package/runtime/scripts/hfs/architecture/dead-exports.mjs +0 -420
  85. package/runtime/scripts/hfs/architecture/default-deny.mjs +0 -175
  86. package/runtime/scripts/hfs/architecture/doc-language.mjs +0 -45
  87. package/runtime/scripts/hfs/architecture/entity-registry.mjs +0 -51
  88. package/runtime/scripts/hfs/architecture/entrypoint.mjs +0 -75
  89. package/runtime/scripts/hfs/architecture/error-codes.mjs +0 -54
  90. package/runtime/scripts/hfs/architecture/error-masked.mjs +0 -78
  91. package/runtime/scripts/hfs/architecture/fe-slot-allows.mjs +0 -44
  92. package/runtime/scripts/hfs/architecture/feature-shape.mjs +0 -60
  93. package/runtime/scripts/hfs/architecture/framework-pinned.mjs +0 -41
  94. package/runtime/scripts/hfs/architecture/frontend-block-render.mjs +0 -112
  95. package/runtime/scripts/hfs/architecture/frontend-grammar.mjs +0 -193
  96. package/runtime/scripts/hfs/architecture/frontend-routing.mjs +0 -198
  97. package/runtime/scripts/hfs/architecture/frontend-world-render.mjs +0 -368
  98. package/runtime/scripts/hfs/architecture/frontend-world.mjs +0 -374
  99. package/runtime/scripts/hfs/architecture/frontend.mjs +0 -248
  100. package/runtime/scripts/hfs/architecture/function-spec-providers.mjs +0 -185
  101. package/runtime/scripts/hfs/architecture/hfs-graph.mjs +0 -77
  102. package/runtime/scripts/hfs/architecture/hfs.mjs +0 -394
  103. package/runtime/scripts/hfs/architecture/hooks-are-hooks.mjs +0 -118
  104. package/runtime/scripts/hfs/architecture/i18n-keys.mjs +0 -213
  105. package/runtime/scripts/hfs/architecture/identity.mjs +0 -121
  106. package/runtime/scripts/hfs/architecture/index.mjs +0 -402
  107. package/runtime/scripts/hfs/architecture/injection-token-exported.mjs +0 -69
  108. package/runtime/scripts/hfs/architecture/jwt-ast.mjs +0 -231
  109. package/runtime/scripts/hfs/architecture/machine-ast.mjs +0 -232
  110. package/runtime/scripts/hfs/architecture/managed-scripts.mjs +0 -32
  111. package/runtime/scripts/hfs/architecture/module-per-transport.mjs +0 -237
  112. package/runtime/scripts/hfs/architecture/next-data-contract.mjs +0 -126
  113. package/runtime/scripts/hfs/architecture/next-data-inference.mjs +0 -192
  114. package/runtime/scripts/hfs/architecture/next-data-key.mjs +0 -374
  115. package/runtime/scripts/hfs/architecture/next-data-symbols.mjs +0 -26
  116. package/runtime/scripts/hfs/architecture/next-data.mjs +0 -425
  117. package/runtime/scripts/hfs/architecture/operation-contract-roots.mjs +0 -55
  118. package/runtime/scripts/hfs/architecture/owners.mjs +0 -142
  119. package/runtime/scripts/hfs/architecture/package-shape.mjs +0 -92
  120. package/runtime/scripts/hfs/architecture/presentation.mjs +0 -173
  121. package/runtime/scripts/hfs/architecture/reachability.mjs +0 -330
  122. package/runtime/scripts/hfs/architecture/register-once.mjs +0 -212
  123. package/runtime/scripts/hfs/architecture/registration.mjs +0 -372
  124. package/runtime/scripts/hfs/architecture/render-graph.mjs +0 -449
  125. package/runtime/scripts/hfs/architecture/render-prop-across-server.mjs +0 -58
  126. package/runtime/scripts/hfs/architecture/required-files.mjs +0 -237
  127. package/runtime/scripts/hfs/architecture/root-packages.mjs +0 -78
  128. package/runtime/scripts/hfs/architecture/route-files-thin.mjs +0 -133
  129. package/runtime/scripts/hfs/architecture/schema-owner.mjs +0 -288
  130. package/runtime/scripts/hfs/architecture/server-action.mjs +0 -78
  131. package/runtime/scripts/hfs/architecture/side-boundary.mjs +0 -13
  132. package/runtime/scripts/hfs/architecture/source-names-shape.mjs +0 -320
  133. package/runtime/scripts/hfs/architecture/source-names.mjs +0 -393
  134. package/runtime/scripts/hfs/architecture/sql-keys.mjs +0 -344
  135. package/runtime/scripts/hfs/architecture/sql-owner.mjs +0 -291
  136. package/runtime/scripts/hfs/architecture/sql-returning.mjs +0 -76
  137. package/runtime/scripts/hfs/architecture/sql-token-forms.mjs +0 -117
  138. package/runtime/scripts/hfs/architecture/sql-tokens.mjs +0 -587
  139. package/runtime/scripts/hfs/architecture/staged-consumers.mjs +0 -42
  140. package/runtime/scripts/hfs/architecture/surface-nesting.mjs +0 -127
  141. package/runtime/scripts/hfs/architecture/surface.mjs +0 -88
  142. package/runtime/scripts/hfs/architecture/symbols.mjs +0 -273
  143. package/runtime/scripts/hfs/architecture/test-world-files.mjs +0 -263
  144. package/runtime/scripts/hfs/architecture/tiers.mjs +0 -256
  145. package/runtime/scripts/hfs/architecture/transport-owner.mjs +0 -248
  146. package/runtime/scripts/hfs/architecture/type-context.mjs +0 -335
  147. package/runtime/scripts/hfs/architecture/typescript.mjs +0 -477
  148. package/runtime/scripts/hfs/architecture/unit-spec-providers.mjs +0 -165
  149. package/runtime/scripts/hfs/declaration-shape.mjs +0 -196
  150. package/runtime/scripts/hfs/declaration-slots.mjs +0 -89
  151. package/runtime/scripts/hfs/edition-slots.mjs +0 -80
  152. package/runtime/scripts/hfs/explicit-surface-rule.mjs +0 -59
  153. package/runtime/scripts/hfs/linear-text.mjs +0 -30
  154. package/runtime/scripts/hfs/manifest-shape.mjs +0 -474
  155. package/runtime/scripts/hfs/param-names.mjs +0 -13
  156. package/runtime/scripts/hfs/path-findings.mjs +0 -167
  157. package/runtime/scripts/hfs/repo-identity.mjs +0 -89
  158. package/runtime/scripts/hfs/rule-catalog.mjs +0 -458
  159. package/runtime/scripts/hfs/rule-params-shape.mjs +0 -103
  160. package/runtime/scripts/hfs/rules/database-constants.mjs +0 -25
  161. package/runtime/scripts/hfs/rules/database-migrations.mjs +0 -684
  162. package/runtime/scripts/hfs/rules/fe-no-tests.mjs +0 -68
  163. package/runtime/scripts/hfs/rules/read.mjs +0 -45
  164. package/runtime/scripts/hfs/rules/secrets.mjs +0 -79
  165. package/runtime/scripts/hfs/rules/spec-placement.mjs +0 -28
  166. package/runtime/scripts/hfs/slot-app-view.mjs +0 -97
  167. package/runtime/scripts/hfs/slot-classify.mjs +0 -69
  168. package/runtime/scripts/hfs/slot-errors.mjs +0 -12
  169. package/runtime/scripts/hfs/slot-imports.mjs +0 -98
  170. package/runtime/scripts/hfs/slot-manifest-shape.mjs +0 -111
  171. package/runtime/scripts/hfs/slot-match.mjs +0 -164
  172. package/runtime/scripts/hfs/slot-path.mjs +0 -6
  173. package/runtime/scripts/hfs/slot-required.mjs +0 -95
  174. package/runtime/scripts/hfs/slot-semantic-problems.mjs +0 -175
  175. package/runtime/scripts/hfs/slot-side-problems.mjs +0 -32
  176. package/runtime/scripts/hfs/slots.mjs +0 -306
  177. package/runtime/scripts/hfs/test-world-slot.mjs +0 -5
  178. package/runtime/scripts/hfs/trailing-slashes.mjs +0 -8
  179. package/runtime/scripts/hfs/typescript-programs.mjs +0 -95
  180. package/runtime/scripts/hfs/view.mjs +0 -180
  181. package/runtime/scripts/lib/declaration-surface.mjs +0 -166
  182. package/runtime/scripts/lib/dockerfile.mjs +0 -164
  183. package/runtime/scripts/lib/env.mjs +0 -18
  184. package/runtime/scripts/lib/event-contract.mjs +0 -102
  185. package/runtime/scripts/lib/git-hooks-dir.mjs +0 -30
  186. package/runtime/scripts/lib/git.mjs +0 -35
  187. package/runtime/scripts/lib/glob.mjs +0 -32
  188. package/runtime/scripts/lib/grammar-lint.mjs +0 -57
  189. package/runtime/scripts/lib/i18n.mjs +0 -82
  190. package/runtime/scripts/lib/in-order.mjs +0 -90
  191. package/runtime/scripts/lib/json-clone.mjs +0 -70
  192. package/runtime/scripts/lib/json.mjs +0 -44
  193. package/runtime/scripts/lib/language.mjs +0 -233
  194. package/runtime/scripts/lib/list.mjs +0 -26
  195. package/runtime/scripts/lib/mutation-fence.mjs +0 -20
  196. package/runtime/scripts/lib/package-at.mjs +0 -62
  197. package/runtime/scripts/lib/path-key.mjs +0 -124
  198. package/runtime/scripts/lib/read-text.mjs +0 -47
  199. package/runtime/scripts/lib/regex.mjs +0 -3
  200. package/runtime/scripts/lib/rule-packs.mjs +0 -243
  201. package/runtime/scripts/lib/same-text.mjs +0 -4
  202. package/runtime/scripts/lib/secret-patterns.mjs +0 -230
  203. package/runtime/scripts/lib/sops-envelope.mjs +0 -212
  204. package/runtime/scripts/lib/stack-services.mjs +0 -191
  205. package/runtime/scripts/lib/ts-analysis.mjs +0 -39
  206. package/runtime/scripts/lib/ts-ast.mjs +0 -63
  207. package/runtime/scripts/lib/walk.mjs +0 -45
  208. 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.