@starci/eslint-grammar-offset-pop 0.20.1 → 0.21.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.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,14 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.21.0 - 2026-11-02
4
+
5
+ Follows the Grammar 0.21.0.
6
+
7
+ ## 0.20.2 - 2026-11-01
8
+
9
+ - Changed: inherits the changed `status-text-uses-soft-foreground` of `@starci/eslint-grammar-core` and the Offset Pop information soft pair of `@starci/grammar`.
10
+ - Changed: moves with `@starci/grammar` 0.20.2 (the stat strip's dividers) and requires `@starci/eslint-grammar-core` 0.20.2; the bundled canon pins follow; the status rule changes (below).
11
+
3
12
  ## 0.20.1 - 2026-11-01
4
13
 
5
14
  - Changed: requires `@starci/eslint-grammar-core` 0.20.1; the bundled canon pins follow hfs 4.16.4; no rule changed.
@@ -175,7 +184,7 @@
175
184
 
176
185
  ## 0.15.5 - 2026-10-28
177
186
 
178
- - Changed: versioned together with Grammar 0.15.5; `@starci/eslint-grammar-core` 0.15.5 is the peer dependency, and the bundled canon pins name the Grammar family 0.15.5. No rule changes.
187
+ - Changed: versioned together with Grammar 0.15.5; `@starci/eslint-grammar-core` 0.15.5 is the peer dependency, and the bundled canon pins name the Grammar family 0.15.5. One rule law changes (above).
179
188
 
180
189
  ## 0.15.4 - 2026-10-28
181
190
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@starci/eslint-grammar-offset-pop",
3
- "version": "0.20.1",
3
+ "version": "0.21.0",
4
4
  "description": "Offset Pop Grammar lint: the inherited Common component contract over its own visual family.",
5
5
  "keywords": [
6
6
  "eslint",
@@ -44,7 +44,7 @@
44
44
  "peerDependencies": {
45
45
  "eslint": ">=9",
46
46
  "typescript": ">=5.9",
47
- "@starci/eslint-grammar-core": "0.20.1"
47
+ "@starci/eslint-grammar-core": "0.21.0"
48
48
  },
49
49
  "devDependencies": {
50
50
  "@starci/eslint-canon-fe": "file:../eslint-canon-fe",
@@ -31,42 +31,42 @@ pins:
31
31
  source: packages/event-stream/package.json
32
32
  why: 'the one server-sent-events client of every front end (fe-stack event-stream, owner:event-stream-package): the transport client layer (modules/api/sse/clients) creates one instance for the app with the bearer token source and the stream operations follow on it; it carries Last-Event-ID resume, the capped doubling backoff, the heartbeat timeout, the single 401 renewal and the useSWRSubscription adapter, so no app keeps a hand-written reader.'
33
33
  '@starci/grammar':
34
- version: 0.20.1
34
+ version: 0.21.0
35
35
  group: starci
36
36
  install: registry
37
37
  side: fe
38
38
  source: packages/grammar/package.json
39
39
  why: 'the grammar front ends read: the brand layer sets `--font-sans` and `--font-mono` and the grammar reads them; it carries the Input tel kind, the copyable and read-only Input, the IconButton disclosure props and count badge, ChatBubble, FillViewport, Textarea mentions and Enter-to-send, the leading PrimaryRailLayout rail, the plate-less Image, ListRow, the soft Alert, Progress steps, the floating primary IconButton, FlowGraph, the STATE-8 loading views and the bordered selectable TagGroup chips. The runtime source version wins for a @starci package.'
40
40
  '@starci/eslint-canon-be':
41
- version: 3.11.5
41
+ version: 3.11.7
42
42
  group: starci
43
43
  install: registry
44
44
  side: be
45
45
  source: packages/eslint-canon-be/package.json
46
46
  why: 'the back-end ESLint canon: `loadHfs(import.meta.url)` of be/eslint.config.mjs finds the app-root hfs.json (kind app) and gives every linted file the view of the be side, and the project graph is built per side; its bundled runtime copies (slots, canon-pins, failure codes, the architecture machine) put .starcistacks and .sops.yaml at the app root; `starciBeConfig({ hfs: loadHfs(import.meta.url) })` is the typed factory and the BE-CONVENTION laws are its rules.'
47
47
  '@starci/eslint-canon-fe':
48
- version: 9.8.4
48
+ version: 9.9.0
49
49
  group: starci
50
50
  install: registry
51
51
  side: fe
52
52
  source: packages/eslint-canon-fe/package.json
53
53
  why: 'the front-end ESLint canon: `loadHfs(import.meta.url)` of fe/eslint.config.mjs finds the app-root hfs.json (kind app) and gives every linted file the view of the fe side, and the project graph is built per side; its bundled runtime copies (slots, canon-pins, failure codes, the architecture machine) put .starcistacks and .sops.yaml at the app root; the front end has no tests (FE_NO_TESTS R97 in hfs) and no-vietnamese-in-source (R91) applies.'
54
54
  '@starci/eslint-grammar-core':
55
- version: 0.20.1
55
+ version: 0.21.0
56
56
  group: starci
57
57
  install: registry
58
58
  side: fe
59
59
  source: packages/eslint-grammar-core/package.json
60
60
  why: 'the StarCi Grammar component API lint, versioned with @starci/grammar; front ends compose this family package with the universal FE canon.'
61
61
  '@starci/eslint-grammar-offset-pop':
62
- version: 0.20.1
62
+ version: 0.21.0
63
63
  group: starci
64
64
  install: registry
65
65
  side: fe
66
66
  source: packages/eslint-grammar-offset-pop/package.json
67
67
  why: 'the Offset Pop Grammar component API lint, versioned with @starci/grammar; its shared component contract comes from the StarCi family lint without copying rules.'
68
68
  '@starci/stylelint-canon':
69
- version: 2.4.0
69
+ version: 2.5.0
70
70
  group: starci
71
71
  install: registry
72
72
  side: fe
@@ -106,7 +106,7 @@ pins:
106
106
  source: packages/ai-router/package.json
107
107
  why: 'the AI pool router of a back end: a NestJS module that routes OpenAI-compatible chat, stream and embeddings calls across keys, models and providers, with @starci/ai-router/testing for its specs; @starci/jest-preset compiles it as an ESM-only dependency.'
108
108
  '@starci/hfs':
109
- version: 4.16.4
109
+ version: 4.17.0
110
110
  group: starci
111
111
  install: registry
112
112
  side: both
@@ -196,7 +196,7 @@ tiers:
196
196
  feature: {mayImport: [feature, components, hooks, foundation, modules, package], mayImportKinds: {feature: {from: [pages, layouts], to: [overlays]}}} # pages and layouts compose overlays and blocks; data goes through hooks/swr
197
197
  # A component never reaches data: config, routes, i18n and types are foundation; every other module and the api
198
198
  # transport are reached through a hook (owner decision 2026-09-29).
199
- components: {mayImport: [components, hooks, foundation, package], lowerLayerOnly: true} # blocks, composites, branches, leaves
199
+ components: {mayImport: [components, hooks, foundation, package], lowerLayerOnly: true} # blocks, frames, composites, branches, leaves
200
200
  # Across domains a hook is imported only through the other domain's public index (hooks/<domain>/index.ts), never deep.
201
201
  hooks: {mayImport: [hooks, foundation, modules, transport, package], mayImportSlots: {transport: {from: [fe.hooks.swr]}}} # only hooks/swr imports an operation
202
202
  foundation: {mayImport: [foundation, package], acyclic: true} # modules/{config,i18n,routes,types}
@@ -2227,12 +2227,12 @@ slots:
2227
2227
  - id: fe.components
2228
2228
  since: 3.1.0
2229
2229
  profiles: [fe]
2230
- path: "apps/<app>/src/components/{blocks,composites,branches,leaves}/<name>/"
2230
+ path: "apps/<app>/src/components/{blocks,frames,composites,branches,leaves}/<name>/"
2231
2231
  presence: optional
2232
2232
  tracked: tracked
2233
2233
  tier: components
2234
2234
  owner: true
2235
- layers: [blocks, composites, branches, leaves] # a layer imports only the layers after it
2235
+ layers: [blocks, frames, composites, branches, leaves] # a layer imports only the layers after it
2236
2236
  requires: [index.tsx]
2237
2237
  allows: [index.tsx, component.tsx, classNames.ts]
2238
2238
  roles: {entry: index.tsx, drawing: component.tsx, styles: classNames.ts} # the connected entry, the pure drawing half and the styling declarations of a component owner
@@ -2575,12 +2575,12 @@ slots:
2575
2575
  tracked: tracked
2576
2576
  tier: package
2577
2577
  owner: true
2578
- kinds: [composites, branches, leaves] # the layer folders under src/ (a package owns no blocks)
2578
+ kinds: [frames, composites, branches, leaves] # the layer folders under src/ (a package owns no blocks)
2579
2579
  roles: {entry: index.tsx, drawing: component.tsx, styles: classNames.ts}
2580
2580
  requires: [package.json, src/index.ts, tsconfig.json]
2581
2581
  tests: none
2582
2582
  budget: {component.tsx: 300, index.tsx: 200, dataHooks: 6, useState: 6}
2583
- why: built to dist with explicit named exports; only composites, branches and leaves; no unused export; no colour literal
2583
+ why: built to dist with explicit named exports; only frames, composites, branches and leaves; no unused export; no colour literal
2584
2584
  rules: [FE_PACKAGE_SHAPE, HFS_UNUSED_EXPORT, FE_STYLE_TOKEN_ONLY]
2585
2585
  - id: fe.package.api
2586
2586
  since: 3.1.0
@@ -49,13 +49,27 @@ function checkProfileMaps(m, bad) {
49
49
  continue;
50
50
  }
51
51
  for (const extra of Object.keys(m[key]))
52
- if (!isSide(extra))
52
+ if (!isSide(extra) && !(key === 'tiers' && extra === COMPONENT_LIBRARY))
53
53
  bad.push(`${key}.${extra} is not a profile`);
54
54
  for (const profile of PROFILES)
55
55
  if (!(profile in m[key]))
56
56
  bad.push(`${key}.${profile} is missing`);
57
57
  }
58
58
  }
59
+ /** The tier matrix of a component library (packages/grammar), beside the be and fe profiles: tiers.grammar. */
60
+ const COMPONENT_LIBRARY = 'grammar';
61
+ function checkComponentLibraryTiers(m, bad) {
62
+ const tiers = m.tiers?.[COMPONENT_LIBRARY];
63
+ if (tiers === undefined)
64
+ return;
65
+ bad.push(...tierMapProblems(COMPONENT_LIBRARY, tiers));
66
+ if (!isPlainObject(tiers))
67
+ return;
68
+ for (const [tier, def] of Object.entries(tiers))
69
+ for (const target of def?.mayImport ?? [])
70
+ if (!(target in tiers))
71
+ bad.push(`tiers.${COMPONENT_LIBRARY}.${tier}.mayImport names ${target}, which is not a ${COMPONENT_LIBRARY} tier`);
72
+ }
59
73
  function checkAppKindAndTierShapes(m, bad) {
60
74
  for (const profile of PROFILES) {
61
75
  const kinds = m.appKinds?.[profile];
@@ -66,6 +80,7 @@ function checkAppKindAndTierShapes(m, bad) {
66
80
  continue;
67
81
  bad.push(...tierMapProblems(profile, tiers));
68
82
  }
83
+ checkComponentLibraryTiers(m, bad);
69
84
  }
70
85
  function checkSlotShapes(m, bad) {
71
86
  if (!Array.isArray(m.slots) || !m.slots.length) {