@starci/eslint-canon-fe 9.4.0 → 9.4.2

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,15 @@
1
1
  # Changelog
2
2
 
3
+ ## 9.4.2 - 2026-10-28
4
+
5
+ - Changed: the bundled canon pins follow release E (Grammar family 0.15.2, hfs 4.9.3, canon-fe 9.4.2, canon-be 3.6.2, ai-router 0.3.0) and pin no `starci-harness`: an app's CLI is the version of the CLI that runs @starci/hfs. No rule changed.
6
+
7
+ ## 9.4.1 - 2026-10-28
8
+
9
+ - Fixed: `server-module-marks-server-only` exempts every route-tier file (`fe.route`, `fe.source-root-pinned` and the opt-in `fe.route.callback`), so the auth callback route is no longer told to carry the marker route files need not.
10
+ - Changed: the bundled runtime's `repo-identity.mjs` names a repository by its origin remote (hfs 4.9.2); the fixture copy of the callback route template exports an arrow `GET`.
11
+ - Changed: the bundled canon pins follow release D (Grammar family 0.15.1, hfs 4.9.2, canon-fe 9.4.1, canon-be 3.6.1, starci-harness 1.1.0-alpha.2), so an app installs the released versions without pin drift.
12
+
3
13
  ## 9.4.0 - 2026-10-28
4
14
 
5
15
  - Changed: the package is TypeScript. `src/**/*.ts` (rules, the shared `lib/` readers and every spec) is strict and builds to `dist/` with the `@starci/tsconfig` `package-esm` preset; `main`, `types` and `exports` point at `dist`, keeping `@starci/eslint-canon-fe/lib/*.mjs` (also `lib/*.js`). The fixture tester is `fixtures/typed/tester.ts`. The bundled runtime is read through the package import `#runtime/*`, typed by `src/types/runtime` until the runtime is built from `@starci/hfs`. Rules are typed against typescript-eslint's rule module; `@typescript-eslint/utils` joins the dependencies. No rule changed behaviour in the conversion.
@@ -132,8 +132,6 @@ export const clientNoServerImport = defineRule({
132
132
  },
133
133
  });
134
134
  // -- FE-CLIENT-2b ----------------------------------------------------------------------------------
135
- /** The slots whose files are Next route files: server components by construction, so the framework decides, not a marker. */
136
- const ROUTE_FILE_SLOTS = new Set(["fe.route", "fe.source-root-pinned"]);
137
135
  /** True when a statement is `import "server-only"`: an import with no bindings from the marker package. */
138
136
  const isMarkerStatement = (statement) => statement?.type === "ImportDeclaration" && statement.specifiers.length === 0 && statement.source.value === "server-only";
139
137
  /** True when a TypeScript source file opens with `import "server-only"`. */
@@ -174,8 +172,9 @@ export const serverModuleMarksServerOnly = defineRule({
174
172
  },
175
173
  },
176
174
  create(context) {
177
- const slot = slotOfFile(context);
178
- if (!slot || ROUTE_FILE_SLOTS.has(slot))
175
+ // A route-tier file (the routes, the auth callback, the pinned source-root files) is a Next route file: a server component
176
+ // by construction, so the framework decides, not a marker.
177
+ if (!slotOfFile(context) || tierOfFile(context) === "route")
179
178
  return {};
180
179
  // A block or a page is a server or client COMPONENT, not a server module: whether client code reaches the server through it is
181
180
  // the machine's multi-hop question (FE_CLIENT_REACHES_SERVER). The marker belongs to the modules that hold server work.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@starci/eslint-canon-fe",
3
- "version": "9.4.0",
3
+ "version": "9.4.2",
4
4
  "description": "Universal front-end lint laws for TypeScript and Next.js, independent of the selected Grammar family.",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -1,7 +1,8 @@
1
1
  schema: starci/canon-pins@1
2
2
  purpose: >-
3
3
  The exact version of every shared dependency in the StarCi family, including package-owned runtime dependencies. One version per dependency for the whole
4
- family. Raising a version is a change to this file first (with the package bump when it is a @starci package),
4
+ family. The command line itself is not pinned here: an app's starci-harness is the version of the CLI that runs @starci/hfs to
5
+ judge or scaffold it (scripts/hfs/canon-pins.mjs), since that CLI depends on this package exactly. Raising a version is a change to this file first (with the package bump when it is a @starci package),
5
6
  then the repositories' own upgrade lane (each sets the exact version and reinstalls; nothing else installs a @starci package). Read on 2026-09-29 from the packages under
6
7
  .claude/packages and from the installed node_modules of the six product repositories; where they disagreed the
7
8
  newest version installed in more than one repository won, and the runtime's own version won for @starci packages.
@@ -30,35 +31,35 @@ pins:
30
31
  source: packages/event-stream/package.json
31
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.'
32
33
  '@starci/grammar':
33
- version: 0.15.0
34
+ version: 0.15.2
34
35
  group: starci
35
36
  install: registry
36
37
  side: fe
37
38
  source: packages/grammar/package.json
38
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.'
39
40
  '@starci/eslint-canon-be':
40
- version: 3.6.0
41
+ version: 3.6.2
41
42
  group: starci
42
43
  install: registry
43
44
  side: be
44
45
  source: packages/eslint-canon-be/package.json
45
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.'
46
47
  '@starci/eslint-canon-fe':
47
- version: 9.4.0
48
+ version: 9.4.2
48
49
  group: starci
49
50
  install: registry
50
51
  side: fe
51
52
  source: packages/eslint-canon-fe/package.json
52
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.'
53
54
  '@starci/eslint-grammar-core':
54
- version: 0.15.0
55
+ version: 0.15.2
55
56
  group: starci
56
57
  install: registry
57
58
  side: fe
58
59
  source: packages/eslint-grammar-core/package.json
59
60
  why: 'the StarCi Grammar component API lint, versioned with @starci/grammar; front ends compose this family package with the universal FE canon.'
60
61
  '@starci/eslint-grammar-offset-pop':
61
- version: 0.15.0
62
+ version: 0.15.2
62
63
  group: starci
63
64
  install: registry
64
65
  side: fe
@@ -98,21 +99,14 @@ pins:
98
99
  source: packages/test-world/package.json
99
100
  why: 'the shared e2e library of every back end (R47, R48), a devDependency of every back end: the warm stack behind toxiproxy, the network-edge fakes, the Nest boot, the typed useTestWorld handle, useSandbox for contract specs and the outage lock. Kafka is real own infra (the one digest-pinned apache/kafka KRaft image, a broker listener and proxy per slot, slot-prefixed topics, consumer groups and client ids) and Postgres is schema-per-context (a schema and a login role per context in a shared database). Each worker has its own data slot (<ns>_w<k>) with its own databases, Keycloak realm, leased Redis DB, bucket/collection/topic prefixes, fakes host, toxiproxy proxies and outage lock; a run provisions min(jest workers, workers cap, default 2) slots, and state file protocol 2 pairs exactly with @starci/jest-preset (TEST_WORLD_PAIR_MISMATCH otherwise). A modules world boots real peer apps beside its modules, world.apps.<name>.during(fn) is the outage of a peer app, w.keycloak.clientSecret(client) answers the run-generated secret of a confidential realm client, world.keycloak.events/sessions read the realm user events and live sessions, world.infra.postgresql.connection(name) takes one database connection down while the others serve, and world.resolve and scope.resolve take any Nest token. Every path a declaration names (`stack`, seeds, the realm, Dockerfiles) resolves from the app root (the directory of hfs.json); the globalSetup registers the path aliases as TypeScript resolves them. Its CLI main is exported at ./cli for starci app stack.'
100
101
  '@starci/ai-router':
101
- version: 0.2.1
102
+ version: 0.3.0
102
103
  group: starci
103
104
  install: registry
104
105
  side: be
105
106
  source: packages/ai-router/package.json
106
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.'
107
- 'starci-harness':
108
- version: 1.1.0-alpha.1
109
- group: starci
110
- install: registry
111
- side: both
112
- source: cli/package.json
113
- why: 'the one StarCi command line (bins starci and starci-harness): a product repository installs it for starci app, which it runs in-process through its exact @starci/hfs dependency, and its codegen loads starci-harness/input-bounds.'
114
108
  '@starci/hfs':
115
- version: 4.9.1
109
+ version: 4.9.3
116
110
  group: starci
117
111
  install: registry
118
112
  side: both
@@ -42,13 +42,13 @@ function askGit(root) {
42
42
  }
43
43
 
44
44
  /**
45
- * The product repository name: the main checkout's folder name (so a worktree and its main checkout agree), else the
46
- * origin remote's name, else package.json name outside Git, else the folder name. A folder inside a larger repository
47
- * (a nested product, an example) is named by its own folder.
45
+ * The product repository name: the origin remote's repository name (one name for every clone and worktree, whatever
46
+ * folder holds it), else the main checkout's folder name (so a worktree and its main checkout agree), else package.json
47
+ * name outside Git, else the folder name. A folder inside a larger repository (a nested product, an example) is named by
48
+ * its own folder.
48
49
  */
49
50
  export function repositoryName(root) {
50
51
  const { inWorkTree, repositoryRoot, home } = identityOf(root);
51
- if (home) return path.basename(home);
52
52
  if (repositoryRoot) {
53
53
  try {
54
54
  const remote = trimTrailingSlashes(git(gitRemote, root, ['get-url', 'origin'])).replace(GIT_SUFFIX, '');
@@ -56,6 +56,7 @@ export function repositoryName(root) {
56
56
  if (name) return name;
57
57
  } catch { /* No origin remote. */ }
58
58
  }
59
+ if (home) return path.basename(home);
59
60
  if (inWorkTree && !repositoryRoot) return path.basename(root);
60
61
  try {
61
62
  const pkg = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8'));