@starci/eslint-grammar-offset-pop 0.13.0 → 0.15.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.15.0 - 2026-10-28
+
+- Changed: versioned together with Grammar 0.15.0; `@starci/eslint-grammar-core` 0.15.0 is the peer dependency, and the bundled canon pins follow release C (Grammar family 0.15.0, hfs 4.9.1, canon-fe 9.4.0, canon-be 3.6.0, jest-preset 2.4.1, `@starci/ai-router` 0.2.1), so an app installs the released versions without pin drift. Offset Pop is unchanged.
+- Changed: the source is TypeScript in `src/`, built to `dist/` (`npm run build`; `prepack` builds); the package ships `dist/` and `runtime/` and no hand-written JavaScript or `index.d.ts` (the build emits the declarations, with the same public types: the re-exports of `@starci/eslint-grammar-core` and `offsetPopGrammarConfig`). No rule or behaviour changed; the exports and specifiers (`.` and `./package.json`) are unchanged.
+- Changed: the spec is `src/inheritance.spec.ts`, typechecked first by `npm test`; it resolves `@starci/eslint-grammar-core` through its built `dist/`, so build that package first.
+- Fixed: the built declarations name `.js`, not the `.ts` sources (`tsc` keeps a relative `.ts` specifier in a `.d.ts`, which a consumer tsc cannot read).
+
+## 0.14.0 - 2026-10-27
+
+- Changed: versioned together with Grammar 0.14.0; `@starci/eslint-grammar-core` 0.14.0 is the peer dependency and the bundled canon pins name the 0.14.0 Grammar family. Offset Pop is unchanged.
+- Changed: the bundled canon pins name `starci-harness` 1.1.0-alpha.1 (`source: cli/package.json`) in place of the retired `@starci/cli`, the one command line a product installs for `starci app`, and follow hfs 4.9.0, canon-fe 9.3.0 and canon-be 3.5.0. No rule changes.
+
 ## 0.13.0 - 2026-10-27
 
 - Changed: versioned together with Grammar 0.13.0; `@starci/eslint-grammar-core` 0.13.0 is a peer dependency, installed by the app beside this package. Offset Pop is unchanged and refuses `core`.

package/README.md

@@ -33,3 +33,5 @@ through this package under the `starci-grammar/` namespace with unchanged IDs, c
 Consuming apps migrate in their own release.
 
 `npm test` runs package regression specs. Grammar and application front ends carry no specs.
+
+The source is TypeScript in `src/`; `npm run build` emits `dist/`, which the package ships beside `runtime/`. The spec resolves `@starci/eslint-grammar-core` through its built `dist/`, so build that package first (`npm run build` in `packages/eslint-grammar-core`), then `npm install` here.

package/dist/config.d.ts

@@ -0,0 +1,10 @@
+import { coreGrammarConfig } from "@starci/eslint-grammar-core";
+/**
+ * Attach the inherited Common API laws for a front end selecting Offset Pop.
+ *
+ * @param input - The front-end HFS view from the universal canon's loadHfs.
+ * @returns Family rules at error under the shared starci-grammar namespace.
+ */
+export declare const offsetPopGrammarConfig: ({ hfs }: {
+    hfs: Parameters<typeof coreGrammarConfig>[0]["hfs"];
+}) => ReturnType<typeof coreGrammarConfig>;

package/dist/config.js

@@ -0,0 +1,8 @@
+import { coreGrammarConfig } from "@starci/eslint-grammar-core";
+/**
+ * Attach the inherited Common API laws for a front end selecting Offset Pop.
+ *
+ * @param input - The front-end HFS view from the universal canon's loadHfs.
+ * @returns Family rules at error under the shared starci-grammar namespace.
+ */
+export const offsetPopGrammarConfig = ({ hfs }) => coreGrammarConfig({ hfs, family: "offset-pop" });

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+/** Offset Pop inherits the Common component checks from the exact matching Grammar lint release. */
+export { default, rules, recommended, ruleOwners, lawOwners, ruleDeclarations, why, } from "@starci/eslint-grammar-core";
+export { offsetPopGrammarConfig } from "./config.js";

package/dist/index.js

@@ -0,0 +1,3 @@
+/** Offset Pop inherits the Common component checks from the exact matching Grammar lint release. */
+export { default, rules, recommended, ruleOwners, lawOwners, ruleDeclarations, why, } from "@starci/eslint-grammar-core";
+export { offsetPopGrammarConfig } from "./config.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@starci/eslint-grammar-offset-pop",
-  "version": "0.13.0",
+  "version": "0.15.0",
   "description": "Offset Pop Grammar lint: the inherited Common component contract over its own visual family.",
   "keywords": [
     "eslint",
@@ -22,21 +22,19 @@
     "url": "https://github.com/starci183/starci-harness/issues"
   },
   "private": false,
-  "main": "./index.mjs",
-  "types": "./index.d.ts",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./index.d.ts",
-      "import": "./index.mjs"
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
     },
     "./package.json": "./package.json"
   },
   "files": [
-    "LICENSE",
-    "*.mjs",
-    "*.d.ts",
+    "dist",
     "runtime/**",
-    "!*.spec.mjs",
+    "LICENSE",
     "README.md",
     "CHANGELOG.md"
   ],
@@ -46,7 +44,7 @@
   "peerDependencies": {
     "eslint": ">=9",
     "typescript": ">=5.9",
-    "@starci/eslint-grammar-core": "0.13.0"
+    "@starci/eslint-grammar-core": "0.15.0"
   },
   "devDependencies": {
     "@starci/eslint-canon-fe": "file:../eslint-canon-fe",
@@ -54,10 +52,15 @@
     "@typescript-eslint/parser": "8.71.0",
     "eslint": "9.39.5",
     "eslint-plugin-react-hooks": "7.1.1",
-    "typescript": "5.9.3"
+    "typescript": "5.9.3",
+    "@starci/tsconfig": "file:../tsconfig",
+    "@types/node": "24.19.2"
   },
   "scripts": {
-    "test": "node --test \"*.spec.mjs\""
+    "build": "node -e \"require('node:fs').rmSync('dist', {recursive: true, force: true})\" && tsc -p tsconfig.build.json && node -e \"const fs = require('node:fs'); for (const f of fs.readdirSync('dist', {recursive: true}).filter((n) => n.endsWith('.d.ts'))) fs.writeFileSync('dist/' + f, fs.readFileSync('dist/' + f, 'utf8').replace(/((?:from |import\\()['\\x22]\\.\\.?\\/[^'\\x22]+)\\.ts(['\\x22])/g, (all, head, quote) => head + '.js' + quote))\"",
+    "typecheck": "tsc -p tsconfig.json",
+    "prepack": "npm run build",
+    "test": "npm run typecheck && node --test \"src/**/*.spec.ts\""
   },
   "publishConfig": {
     "access": "public"

package/runtime/knowledge/hfs/canon-pins.yaml

@@ -30,61 +30,61 @@ pins:
     source: packages/event-stream/package.json
     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.'
   '@starci/grammar':
-    version: 0.13.0
+    version: 0.15.0
     group: starci
     install: registry
     side: fe
     source: packages/grammar/package.json
     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.'
   '@starci/eslint-canon-be':
-    version: 3.4.57
+    version: 3.6.0
     group: starci
     install: registry
     side: be
     source: packages/eslint-canon-be/package.json
     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.'
   '@starci/eslint-canon-fe':
-    version: 9.2.0
+    version: 9.4.0
     group: starci
     install: registry
     side: fe
     source: packages/eslint-canon-fe/package.json
     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.'
   '@starci/eslint-grammar-core':
-    version: 0.13.0
+    version: 0.15.0
     group: starci
     install: registry
     side: fe
     source: packages/eslint-grammar-core/package.json
     why: 'the StarCi Grammar component API lint, versioned with @starci/grammar; front ends compose this family package with the universal FE canon.'
   '@starci/eslint-grammar-offset-pop':
-    version: 0.13.0
+    version: 0.15.0
     group: starci
     install: registry
     side: fe
     source: packages/eslint-grammar-offset-pop/package.json
     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.'
   '@starci/stylelint-canon':
-    version: 2.1.0
+    version: 2.2.1
     group: starci
     install: registry
     side: fe
     source: packages/stylelint-canon/package.json
     why: 'the front-end stylelint canon: no-class-selector refuses a compound class selector (`div.card`); the brand layer accepts `--font-sans` and `--font-mono`; status-contrast measures the HeroUI soft pairs per theme; brand-layer-shape reads the shared :root,.light,.dark block and the info soft pair; appTokens come from loadAppTokens(import.meta.url) for the managed one-line stylelint.config.mjs.'
   '@starci/tsconfig':
-    version: 2.0.8
+    version: 2.1.0
     group: starci
     install: registry
     side: both
     source: packages/tsconfig/package.json
   '@starci/prettier-config':
-    version: 1.0.5
+    version: 1.1.0
     group: starci
     install: registry
     side: both
     source: packages/prettier-config/package.json
   '@starci/jest-preset':
-    version: 2.3.7
+    version: 2.4.1
     group: starci
     install: registry
     side: be
@@ -97,19 +97,27 @@ pins:
     side: be
     source: packages/test-world/package.json
     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.'
-  '@starci/cli':
-    version: 1.7.47
+  '@starci/ai-router':
+    version: 0.2.1
+    group: starci
+    install: registry
+    side: be
+    source: packages/ai-router/package.json
+    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.'
+  'starci-harness':
+    version: 1.1.0-alpha.1
     group: starci
     install: registry
     side: both
-    why: 'the only StarCi command package; product repositories install it for starci app, while @starci/hfs remains its pinned transitive implementation.'
+    source: cli/package.json
+    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.'
   '@starci/hfs':
-    version: 4.8.0
+    version: 4.9.1
     group: starci
     install: registry
     side: both
     source: packages/hfs/package.json
-    why: 'the transitive app implementation used by @starci/cli; it carries the generated runtime slice read by starci app commands.'
+    why: 'the app implementation starci-harness runs for starci app; it carries the generated runtime slice read by starci app commands.'
   # --- tooling
   typescript:
     version: 5.9.3

package/config.mjs

@@ -1,9 +0,0 @@
-import { coreGrammarConfig } from "@starci/eslint-grammar-core"
-
-/**
- * Attach the inherited Common API laws for a front end selecting Offset Pop.
- *
- * @param {{ hfs: object }} input - The front-end HFS view from the universal canon's loadHfs.
- * @returns {Array<object>} Family rules at error under the shared starci-grammar namespace.
- */
-export const offsetPopGrammarConfig = ({ hfs }) => coreGrammarConfig({ hfs, family: "offset-pop" })

package/index.d.ts

@@ -1,16 +0,0 @@
-import type { coreGrammarConfig } from "@starci/eslint-grammar-core"
-
-export {
-  default,
-  rules,
-  recommended,
-  ruleOwners,
-  lawOwners,
-  ruleDeclarations,
-  why,
-} from "@starci/eslint-grammar-core"
-
-/** Attach the inherited Common API checks for the selected Offset Pop family. */
-export declare function offsetPopGrammarConfig(input: {
-  hfs: Parameters<typeof coreGrammarConfig>[0]["hfs"]
-}): ReturnType<typeof coreGrammarConfig>

package/index.mjs

@@ -1,11 +0,0 @@
-/** Offset Pop inherits the Common component checks from the exact matching Grammar lint release. */
-export {
-  default,
-  rules,
-  recommended,
-  ruleOwners,
-  lawOwners,
-  ruleDeclarations,
-  why,
-} from "@starci/eslint-grammar-core"
-export { offsetPopGrammarConfig } from "./config.mjs"