@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.
- package/CHANGELOG.md +8 -0
- package/README.md +1 -1
- package/dist/comments.js +1 -1
- package/dist/explicit-surface.js +1 -1
- package/dist/index.js +1 -1
- package/dist/jwt-alg.js +1 -1
- package/dist/lib/edition.d.ts +1 -1
- package/dist/lib/edition.js +1 -1
- package/dist/lib/hfs-view.d.ts +5 -0
- package/dist/lib/hfs.d.ts +0 -6
- package/dist/lib/hfs.js +7 -5
- package/dist/lib/runtime-root.d.ts +6 -1
- package/dist/lib/runtime-root.js +8 -2
- package/dist/lib/subject-values.js +1 -1
- package/dist/module-layering.js +2 -2
- package/dist/project-graph.js +1 -1
- package/dist/schema-authority.js +66 -2
- package/dist/third-party-owner.js +1 -1
- package/package.json +3 -1
- package/runtime/bundle.json +1 -190
- package/runtime/scripts/api/git/recorded-lines.mjs +5 -5
- package/runtime/scripts/hfs/project-graph.mjs +6 -6
- package/runtime/scripts/hfs/project-rule.mjs +3 -3
- package/runtime/config.example.yaml +0 -194
- package/runtime/engine/by-code-unit.mjs +0 -12
- package/runtime/engine/config.mjs +0 -461
- package/runtime/engine/invalid-config.mjs +0 -15
- package/runtime/engine/model-config.mjs +0 -112
- package/runtime/engine/orca-config.mjs +0 -34
- package/runtime/engine/plain-object.mjs +0 -5
- package/runtime/engine/release-config.mjs +0 -32
- package/runtime/engine/removed-vocabulary.mjs +0 -27
- package/runtime/engine/resources-config.mjs +0 -59
- package/runtime/engine/runtime-root.mjs +0 -138
- package/runtime/engine/secrets.mjs +0 -202
- package/runtime/engine/sonar-config.mjs +0 -24
- package/runtime/engine/temp-root.mjs +0 -26
- package/runtime/engine/yaml.mjs +0 -161
- package/runtime/knowledge/grammars/index.yaml +0 -114
- package/runtime/knowledge/hfs/canon-pins.yaml +0 -720
- package/runtime/knowledge/hfs/fe-stack.yaml +0 -272
- package/runtime/knowledge/hfs/rules.yaml +0 -6760
- package/runtime/knowledge/hfs/slots.yaml +0 -2783
- package/runtime/knowledge/patterns/fe/folder.yaml +0 -425
- package/runtime/knowledge/sonar-gate.yaml +0 -151
- package/runtime/modules/kernel/removed-vocabulary.yaml +0 -458
- package/runtime/modules/models/registry.yaml +0 -221
- package/runtime/modules/models/runtimes.yaml +0 -556
- package/runtime/modules/models/tiers.yaml +0 -66
- package/runtime/scripts/api/git/cat-file.mjs +0 -4
- package/runtime/scripts/api/git/config-get.mjs +0 -9
- package/runtime/scripts/api/git/diff.mjs +0 -4
- package/runtime/scripts/api/git/lib.mjs +0 -80
- package/runtime/scripts/api/git/ls-files.mjs +0 -5
- package/runtime/scripts/api/git/ls-tree.mjs +0 -4
- package/runtime/scripts/api/git/merge-base.mjs +0 -8
- package/runtime/scripts/api/git/remote.mjs +0 -4
- package/runtime/scripts/api/git/rev-parse-query.mjs +0 -4
- package/runtime/scripts/api/git/show.mjs +0 -5
- package/runtime/scripts/api/git/tag.mjs +0 -4
- package/runtime/scripts/hfs/allows.mjs +0 -77
- package/runtime/scripts/hfs/architecture/ast-walks.mjs +0 -250
- package/runtime/scripts/hfs/architecture/automatic-gates.mjs +0 -103
- package/runtime/scripts/hfs/architecture/backend-app-files.mjs +0 -114
- package/runtime/scripts/hfs/architecture/backend.mjs +0 -462
- package/runtime/scripts/hfs/architecture/background-unowned.mjs +0 -254
- package/runtime/scripts/hfs/architecture/canon-clones.mjs +0 -291
- package/runtime/scripts/hfs/architecture/canon-jsx-clones.mjs +0 -224
- package/runtime/scripts/hfs/architecture/client-reaches-server.mjs +0 -102
- package/runtime/scripts/hfs/architecture/clones.mjs +0 -287
- package/runtime/scripts/hfs/architecture/component-tiers.mjs +0 -161
- package/runtime/scripts/hfs/architecture/config-unread.mjs +0 -16
- package/runtime/scripts/hfs/architecture/config.mjs +0 -407
- package/runtime/scripts/hfs/architecture/connection-map.mjs +0 -350
- package/runtime/scripts/hfs/architecture/constructor-deps.mjs +0 -115
- package/runtime/scripts/hfs/architecture/context-coupling.mjs +0 -117
- package/runtime/scripts/hfs/architecture/context-map.mjs +0 -355
- package/runtime/scripts/hfs/architecture/context-owner.mjs +0 -102
- package/runtime/scripts/hfs/architecture/context-platform-tables.mjs +0 -65
- package/runtime/scripts/hfs/architecture/context-transaction.mjs +0 -75
- package/runtime/scripts/hfs/architecture/contract-bounds.mjs +0 -72
- package/runtime/scripts/hfs/architecture/contract-fixture-guard.mjs +0 -177
- package/runtime/scripts/hfs/architecture/contracts-readonly.mjs +0 -360
- package/runtime/scripts/hfs/architecture/contracts.mjs +0 -489
- package/runtime/scripts/hfs/architecture/cross-app-duplicate.mjs +0 -81
- package/runtime/scripts/hfs/architecture/dead-exports-bindings.mjs +0 -173
- package/runtime/scripts/hfs/architecture/dead-exports.mjs +0 -420
- package/runtime/scripts/hfs/architecture/default-deny.mjs +0 -175
- package/runtime/scripts/hfs/architecture/doc-language.mjs +0 -45
- package/runtime/scripts/hfs/architecture/entity-registry.mjs +0 -51
- package/runtime/scripts/hfs/architecture/entrypoint.mjs +0 -75
- package/runtime/scripts/hfs/architecture/error-codes.mjs +0 -54
- package/runtime/scripts/hfs/architecture/error-masked.mjs +0 -78
- package/runtime/scripts/hfs/architecture/fe-slot-allows.mjs +0 -44
- package/runtime/scripts/hfs/architecture/feature-shape.mjs +0 -60
- package/runtime/scripts/hfs/architecture/framework-pinned.mjs +0 -41
- package/runtime/scripts/hfs/architecture/frontend-block-render.mjs +0 -112
- package/runtime/scripts/hfs/architecture/frontend-grammar.mjs +0 -193
- package/runtime/scripts/hfs/architecture/frontend-routing.mjs +0 -198
- package/runtime/scripts/hfs/architecture/frontend-world-render.mjs +0 -368
- package/runtime/scripts/hfs/architecture/frontend-world.mjs +0 -374
- package/runtime/scripts/hfs/architecture/frontend.mjs +0 -248
- package/runtime/scripts/hfs/architecture/function-spec-providers.mjs +0 -185
- package/runtime/scripts/hfs/architecture/hfs-graph.mjs +0 -77
- package/runtime/scripts/hfs/architecture/hfs.mjs +0 -394
- package/runtime/scripts/hfs/architecture/hooks-are-hooks.mjs +0 -118
- package/runtime/scripts/hfs/architecture/i18n-keys.mjs +0 -213
- package/runtime/scripts/hfs/architecture/identity.mjs +0 -121
- package/runtime/scripts/hfs/architecture/index.mjs +0 -402
- package/runtime/scripts/hfs/architecture/injection-token-exported.mjs +0 -69
- package/runtime/scripts/hfs/architecture/jwt-ast.mjs +0 -231
- package/runtime/scripts/hfs/architecture/machine-ast.mjs +0 -232
- package/runtime/scripts/hfs/architecture/managed-scripts.mjs +0 -32
- package/runtime/scripts/hfs/architecture/module-per-transport.mjs +0 -237
- package/runtime/scripts/hfs/architecture/next-data-contract.mjs +0 -126
- package/runtime/scripts/hfs/architecture/next-data-inference.mjs +0 -192
- package/runtime/scripts/hfs/architecture/next-data-key.mjs +0 -374
- package/runtime/scripts/hfs/architecture/next-data-symbols.mjs +0 -26
- package/runtime/scripts/hfs/architecture/next-data.mjs +0 -425
- package/runtime/scripts/hfs/architecture/operation-contract-roots.mjs +0 -55
- package/runtime/scripts/hfs/architecture/owners.mjs +0 -142
- package/runtime/scripts/hfs/architecture/package-shape.mjs +0 -92
- package/runtime/scripts/hfs/architecture/presentation.mjs +0 -173
- package/runtime/scripts/hfs/architecture/reachability.mjs +0 -330
- package/runtime/scripts/hfs/architecture/register-once.mjs +0 -212
- package/runtime/scripts/hfs/architecture/registration.mjs +0 -372
- package/runtime/scripts/hfs/architecture/render-graph.mjs +0 -449
- package/runtime/scripts/hfs/architecture/render-prop-across-server.mjs +0 -58
- package/runtime/scripts/hfs/architecture/required-files.mjs +0 -237
- package/runtime/scripts/hfs/architecture/root-packages.mjs +0 -78
- package/runtime/scripts/hfs/architecture/route-files-thin.mjs +0 -133
- package/runtime/scripts/hfs/architecture/schema-owner.mjs +0 -288
- package/runtime/scripts/hfs/architecture/server-action.mjs +0 -78
- package/runtime/scripts/hfs/architecture/side-boundary.mjs +0 -13
- package/runtime/scripts/hfs/architecture/source-names-shape.mjs +0 -320
- package/runtime/scripts/hfs/architecture/source-names.mjs +0 -393
- package/runtime/scripts/hfs/architecture/sql-keys.mjs +0 -344
- package/runtime/scripts/hfs/architecture/sql-owner.mjs +0 -291
- package/runtime/scripts/hfs/architecture/sql-returning.mjs +0 -76
- package/runtime/scripts/hfs/architecture/sql-token-forms.mjs +0 -117
- package/runtime/scripts/hfs/architecture/sql-tokens.mjs +0 -587
- package/runtime/scripts/hfs/architecture/staged-consumers.mjs +0 -42
- package/runtime/scripts/hfs/architecture/surface-nesting.mjs +0 -127
- package/runtime/scripts/hfs/architecture/surface.mjs +0 -88
- package/runtime/scripts/hfs/architecture/symbols.mjs +0 -273
- package/runtime/scripts/hfs/architecture/test-world-files.mjs +0 -263
- package/runtime/scripts/hfs/architecture/tiers.mjs +0 -256
- package/runtime/scripts/hfs/architecture/transport-owner.mjs +0 -248
- package/runtime/scripts/hfs/architecture/type-context.mjs +0 -335
- package/runtime/scripts/hfs/architecture/typescript.mjs +0 -477
- package/runtime/scripts/hfs/architecture/unit-spec-providers.mjs +0 -165
- package/runtime/scripts/hfs/declaration-shape.mjs +0 -196
- package/runtime/scripts/hfs/declaration-slots.mjs +0 -89
- package/runtime/scripts/hfs/edition-slots.mjs +0 -80
- package/runtime/scripts/hfs/explicit-surface-rule.mjs +0 -59
- package/runtime/scripts/hfs/linear-text.mjs +0 -30
- package/runtime/scripts/hfs/manifest-shape.mjs +0 -474
- package/runtime/scripts/hfs/param-names.mjs +0 -13
- package/runtime/scripts/hfs/path-findings.mjs +0 -167
- package/runtime/scripts/hfs/repo-identity.mjs +0 -89
- package/runtime/scripts/hfs/rule-catalog.mjs +0 -458
- package/runtime/scripts/hfs/rule-params-shape.mjs +0 -103
- package/runtime/scripts/hfs/rules/database-constants.mjs +0 -25
- package/runtime/scripts/hfs/rules/database-migrations.mjs +0 -684
- package/runtime/scripts/hfs/rules/fe-no-tests.mjs +0 -68
- package/runtime/scripts/hfs/rules/read.mjs +0 -45
- package/runtime/scripts/hfs/rules/secrets.mjs +0 -79
- package/runtime/scripts/hfs/rules/spec-placement.mjs +0 -28
- package/runtime/scripts/hfs/slot-app-view.mjs +0 -97
- package/runtime/scripts/hfs/slot-classify.mjs +0 -69
- package/runtime/scripts/hfs/slot-errors.mjs +0 -12
- package/runtime/scripts/hfs/slot-imports.mjs +0 -98
- package/runtime/scripts/hfs/slot-manifest-shape.mjs +0 -111
- package/runtime/scripts/hfs/slot-match.mjs +0 -164
- package/runtime/scripts/hfs/slot-path.mjs +0 -6
- package/runtime/scripts/hfs/slot-required.mjs +0 -95
- package/runtime/scripts/hfs/slot-semantic-problems.mjs +0 -175
- package/runtime/scripts/hfs/slot-side-problems.mjs +0 -32
- package/runtime/scripts/hfs/slots.mjs +0 -306
- package/runtime/scripts/hfs/test-world-slot.mjs +0 -5
- package/runtime/scripts/hfs/trailing-slashes.mjs +0 -8
- package/runtime/scripts/hfs/typescript-programs.mjs +0 -95
- package/runtime/scripts/hfs/view.mjs +0 -180
- package/runtime/scripts/lib/declaration-surface.mjs +0 -166
- package/runtime/scripts/lib/dockerfile.mjs +0 -164
- package/runtime/scripts/lib/env.mjs +0 -18
- package/runtime/scripts/lib/event-contract.mjs +0 -102
- package/runtime/scripts/lib/git-hooks-dir.mjs +0 -30
- package/runtime/scripts/lib/git.mjs +0 -35
- package/runtime/scripts/lib/glob.mjs +0 -32
- package/runtime/scripts/lib/grammar-lint.mjs +0 -57
- package/runtime/scripts/lib/i18n.mjs +0 -82
- package/runtime/scripts/lib/in-order.mjs +0 -90
- package/runtime/scripts/lib/json-clone.mjs +0 -70
- package/runtime/scripts/lib/json.mjs +0 -44
- package/runtime/scripts/lib/language.mjs +0 -233
- package/runtime/scripts/lib/list.mjs +0 -26
- package/runtime/scripts/lib/mutation-fence.mjs +0 -20
- package/runtime/scripts/lib/package-at.mjs +0 -62
- package/runtime/scripts/lib/path-key.mjs +0 -124
- package/runtime/scripts/lib/read-text.mjs +0 -47
- package/runtime/scripts/lib/regex.mjs +0 -3
- package/runtime/scripts/lib/rule-packs.mjs +0 -243
- package/runtime/scripts/lib/same-text.mjs +0 -4
- package/runtime/scripts/lib/secret-patterns.mjs +0 -230
- package/runtime/scripts/lib/sops-envelope.mjs +0 -212
- package/runtime/scripts/lib/stack-services.mjs +0 -191
- package/runtime/scripts/lib/ts-analysis.mjs +0 -39
- package/runtime/scripts/lib/ts-ast.mjs +0 -63
- package/runtime/scripts/lib/walk.mjs +0 -45
- 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.
|