@starci/eslint-grammar-offset-pop 0.12.14 → 0.14.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## Unreleased (0.15.0 with the Grammar family)
+
+- Unreleased: the Grammar family (`grammar`, `eslint-grammar-core`, `eslint-grammar-offset-pop`) keeps one version and `packages/grammar` is outside this lane, so the minor bump to 0.15.0 lands with the family's release; the package stays 0.14.0 until then.
+- 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.
+
+## 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`.
+- Changed: the package lives in github.com/starci183/starci-harness under `packages/` and publishes from there; its bundled `runtime/` is committed source, edited in place (no generator, no `prepack`/`pretest` hook).
+
+
 ## 0.12.14 - 2026-10-27
 
 - Fixed: the bundled runtime copy now carries the static import closure of its slot view, so the slot modules it imports are present.

package/README.md

@@ -1,8 +1,8 @@
 # @starci/eslint-grammar-offset-pop
 
-Offset Pop composes the Common renderers and types. This package inherits their checks from the exact matching `@starci/eslint-grammar-starci` release; the rule implementations and shared infrastructure have one owner. Offset Pop has no additional component API rules yet. Its visual choices belong to its DNA and packaged stylesheet.
+Offset Pop composes the Common renderers and types. This package inherits their checks from the exact matching `@starci/eslint-grammar-core` release; the rule implementations and shared infrastructure have one owner. Offset Pop has no additional component API rules yet. Its visual choices belong to its DNA and packaged stylesheet.
 
-Rule ownership follows `FE-RULE-OWNERSHIP` in `knowledge/patterns/fe/index.yaml`. The family's inheritance is declared in `knowledge/grammars/offset-pop/family.yaml`; the app-shell law is `knowledge/ui/composition/app-shell.yaml`.
+Rule ownership follows `FE-RULE-OWNERSHIP` in `contexts/code/fe/README.md` of the StarCi harness. The family's inheritance is declared in `contexts/grammars/offset-pop.md`; the app-shell law is `contexts/ui/composition.md`.
 
 The managed `fe/eslint.config.mjs` consumes the universal canon and the selected family:
 
@@ -18,13 +18,13 @@ The inherited rule IDs use the `starci-grammar` prefix. `rules`, `recommended`,
 
 ## Migrating from @starci/eslint-canon-fe 8.x
 
-The pinned canon-fe release moved the twenty Grammar component rules (listed in the `@starci/eslint-grammar-starci`
+The pinned canon-fe release moved the twenty Grammar component rules (listed in the `@starci/eslint-grammar-core`
 README and the pinned canon-fe changelog) out of the universal canon. An Offset Pop app receives them
 through this package under the `starci-grammar/` namespace with unchanged IDs, codes and severity.
 
 1. Set `sides.fe.grammar` to `offset-pop` in `hfs.json`; no family is inferred.
 2. Install this package at its canon-pins version beside `@starci/eslint-canon-fe` 9 in the app
-   root `devDependencies`; it brings the matching `@starci/eslint-grammar-starci`. `starci app check`
+   root `devDependencies`; it brings the matching `@starci/eslint-grammar-core`. `starci app check`
    refuses canon-fe 9 without it (`FE_STACK_FAMILY_LINT_MISSING`).
 3. Compose `starciFeConfig({ hfs })` first and `offsetPopGrammarConfig({ hfs })` second (the block
    above); `starci app sync` renders that managed `fe/eslint.config.mjs`.
@@ -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.ts";

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,25 +1,40 @@
 {
   "name": "@starci/eslint-grammar-offset-pop",
-  "version": "0.12.14",
+  "version": "0.14.0",
   "description": "Offset Pop Grammar lint: the inherited Common component contract over its own visual family.",
+  "keywords": [
+    "eslint",
+    "eslintplugin",
+    "starci",
+    "grammar",
+    "offset-pop"
+  ],
   "type": "module",
   "license": "MIT",
+  "author": "starci183",
+  "homepage": "https://github.com/starci183/starci-harness/tree/main/packages/eslint-grammar-offset-pop#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/starci183/starci-harness.git",
+    "directory": "packages/eslint-grammar-offset-pop"
+  },
+  "bugs": {
+    "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"
   ],
@@ -28,30 +43,26 @@
   },
   "peerDependencies": {
     "eslint": ">=9",
-    "typescript": ">=5.9"
-  },
-  "dependencies": {
-    "@starci/eslint-grammar-starci": "0.12.14"
+    "typescript": ">=5.9",
+    "@starci/eslint-grammar-core": "0.14.0"
   },
   "devDependencies": {
+    "@starci/eslint-canon-fe": "file:../eslint-canon-fe",
+    "@starci/eslint-grammar-core": "file:../eslint-grammar-core",
     "@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": {
-    "prepack": "node ../../hfs/prep-runtime.mjs",
-    "pretest": "node ../../hfs/prep-runtime.mjs",
-    "test": "node --test \"*.spec.mjs\""
+    "build": "node -e \"require('node:fs').rmSync('dist', {recursive: true, force: true})\" && tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json",
+    "prepack": "npm run build",
+    "test": "npm run typecheck && node --test \"src/**/*.spec.ts\""
   },
   "publishConfig": {
     "access": "public"
-  },
-  "keywords": [
-    "eslint",
-    "eslintplugin",
-    "starci",
-    "grammar",
-    "offset-pop"
-  ]
+  }
 }

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

@@ -21,7 +21,7 @@ pins:
     install: registry
     side: fe
     source: packages/heroicons/package.json
-    why: 'StarCi custom Heroicons-compatible cuts; eslint-grammar-starci (icon.mjs) admits @starci/heroicons/24/outline and /16/solid as icon sources, so an app that uses them gets this exact version.'
+    why: 'StarCi custom Heroicons-compatible cuts; eslint-grammar-core (icon.mjs) admits @starci/heroicons/24/outline and /16/solid as icon sources, so an app that uses them gets this exact version.'
   '@starci/event-stream':
     version: 0.1.0
     group: starci
@@ -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.12.14
+    version: 0.14.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.56
+    version: 3.5.0
     group: starci
     install: registry
     side: be
-    source: packages/eslint/be/package.json
+    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.1.10
+    version: 9.3.0
     group: starci
     install: registry
     side: fe
-    source: packages/eslint/fe/package.json
+    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-starci':
-    version: 0.12.14
+  '@starci/eslint-grammar-core':
+    version: 0.14.0
     group: starci
     install: registry
     side: fe
-    source: packages/eslint/grammar-starci/package.json
+    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.12.14
+    version: 0.14.0
     group: starci
     install: registry
     side: fe
-    source: packages/eslint/grammar-offset-pop/package.json
+    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.0.13
+    version: 2.1.0
     group: starci
     install: registry
     side: fe
-    source: packages/stylelint/package.json
+    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.7
+    version: 2.0.8
     group: starci
     install: registry
     side: both
     source: packages/tsconfig/package.json
   '@starci/prettier-config':
-    version: 1.0.4
+    version: 1.0.5
     group: starci
     install: registry
     side: both
     source: packages/prettier-config/package.json
   '@starci/jest-preset':
-    version: 2.3.6
+    version: 2.3.7
     group: starci
     install: registry
     side: be
@@ -97,20 +97,20 @@ 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-harness':
+    version: 1.1.0-alpha.1
     group: starci
     install: registry
     side: both
-    source: packages/cli/package.json
-    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.7.47
+    version: 4.9.0
     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
@@ -406,7 +406,7 @@ pins:
     version: 2.2.0
     group: ui
     side: fe
-    why: 'the base of the one application icon set (fe-stack icons, with @starci/heroicons for the glyphs it lacks); eslint-grammar-starci (icon.mjs) admits @heroicons/react/24/outline and /16/solid.'
+    why: 'the base of the one application icon set (fe-stack icons, with @starci/heroicons for the glyphs it lacks); eslint-grammar-core (icon.mjs) admits @heroicons/react/24/outline and /16/solid.'
   '@dicebear/core':
     version: 10.4.0
     group: ui

package/runtime/scripts/hfs/rule-catalog.mjs

@@ -12,7 +12,7 @@ import { fail } from './slot-errors.mjs';
 
 const HFS_RULES_FILE = 'knowledge/hfs/rules.yaml';
 const RULE_GATES = Object.freeze(['pre-commit', 'pre-push', 'settle', 'land', 'ci', 'sonar', 'runtime']);
-const ENFORCER_FAMILIES = Object.freeze(['eslint-be', 'eslint-fe', 'eslint-grammar-starci', 'stylelint', 'machine', 'hfs', 'work-validate', 'sonar', 'runtime']);
+const ENFORCER_FAMILIES = Object.freeze(['eslint-be', 'eslint-fe', 'eslint-grammar-core', 'stylelint', 'machine', 'hfs', 'work-validate', 'sonar', 'runtime']);
 const RULE_KINDS = Object.freeze(['codemod', 'lint', 'check', 'design']);
 const FINDING_CODE = /^[A-Z][A-Z0-9]*(_[A-Z0-9]+)+$/;
 const ENFORCER_ID = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;
@@ -346,7 +346,7 @@ export function loadRuleCatalog({ root = skillRoot, file = path.join(root, HFS_R
     /** The catalogued why code of a lint finding's rule id (`starci-be/<id>`, `starci-fe/<id>`), or undefined. */
     lintCode: (ruleId) => {
       const [plugin, id] = String(ruleId ?? '').split('/');
-      const kind = (plugin === 'starci-be' && 'eslint-be') || (plugin === 'starci-fe' && 'eslint-fe') || (plugin === 'starci-grammar' && 'eslint-grammar-starci') || null;
+      const kind = (plugin === 'starci-be' && 'eslint-be') || (plugin === 'starci-fe' && 'eslint-fe') || (plugin === 'starci-grammar' && 'eslint-grammar-core') || null;
       return kind ? list.find((rule) => rule.enforcers.some((enforcer) => enforcer.kind === kind && enforcer.id === id))?.code : undefined;
     },
     /** The rules one enforcer judges, e.g. forEnforcer('eslint-be', 'error-home'). */

package/config.mjs

@@ -1,9 +0,0 @@
-import { starciGrammarConfig } from "@starci/eslint-grammar-starci"
-
-/**
- * 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 }) => starciGrammarConfig({ hfs, family: "offset-pop" })

package/index.d.ts

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

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-starci"
-export { offsetPopGrammarConfig } from "./config.mjs"