@dloizides/frontend-devtools 2.3.0 → 2.4.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,185 +1,192 @@
1
- # Changelog
2
-
3
- All notable changes to `@dloizides/frontend-devtools` are documented here.
4
-
5
- The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6
- and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
-
8
- ## [2.3.0] - 2026-10-28
9
-
10
- OBS-1 "Every app ships metrics, production-grade logs and alerts with working links", D-OBS-15 "Front-end budgets, warn only".
11
-
12
- ### Added
13
- - `./lighthouse` subpath: `budgetAssertions` (LCP < 2500 ms, TBT < 200 ms, CLS < 0.1, script transfer < 300 KB, all `warn`), `mobileSettings` (Lighthouse's mid-range phone profile) and `withBudgets(config)`, which merges both into an app's `lighthouserc.js`; keys the app sets win.
14
-
15
- ## [2.2.0] - 2026-10-23
16
-
17
- FOCUS-1 "Every screen names its initial focus", D-FOCUS-2 "Lint rule and ledger".
18
-
19
- ### Added
20
- - `explicit-initial-focus`: flags a file that builds a menu of 2+ buttons (HTML strings or `createElement('button')`) with no `MENU_DEFAULT_ATTR` / `data-menu-default` / `dataset.menuDefault` / `initialFocus`, and a JSX `*Dialog` / `*Modal` / `role="dialog"` in a file with no `autoFocus`, `initialFocus(Ref)` or `.focus()` call. Options: `minControls`, `dialogPattern`, `selfFocusing`.
21
- - `focusConfig` + `FOCUS_RULE_NAMES` (opt-in, not part of `recommendedConfig` or `gameConfig`).
22
-
23
- ## [2.1.0] - 2026-10-20
24
-
25
- QUAL-ADOPT-1 "Fail lint/arch tests when an app re-implements an existing package" (TS half).
26
-
27
- ### Added
28
- - `no-reimplemented-package`: flags app code that re-implements a shared package (hand-rolled analytics/Umami -> `@dloizides/analytics-web`, `X-BFF-Csrf` header or `bffCsrf` -> `@dloizides/bff-web-client`, `forgotPasswordRequest` -> `@dloizides/auth-web`, `utils/logger` -> `@dloizides/logging-web`). Pairs live in one registry, `src/rules/reimplemented-packages-registry.js`. Tests, e2e and package sources are exempt; `allow` adds path fragments.
29
- - `reuseConfig` + `REUSE_RULE_NAMES` (opt-in, not part of `recommendedConfig`).
30
-
31
- ## [2.0.0] - 2026-10-20
32
-
33
- D-PAT-15 "Move initI18n out of frontend-devtools so it is dev-only".
34
-
35
- ### Removed (BREAKING)
36
- - `initI18n` and `InitI18nOptions`: import them from `@dloizides/i18n` (>= 1.1.0), same signature: `import { initI18n } from '@dloizides/i18n';`.
37
- - The root entry (`@dloizides/frontend-devtools`): it exported only `initI18n`. Use the `/eslint` and `/test-results` subpaths.
38
- - The `i18next` and `react-i18next` optional peer dependencies.
39
-
40
- ## [1.10.0] - 2026-10-19
41
-
42
- PATTERN-1.12 "TS rule packs + house rules in frontend-devtools" (D-PAT-12 "Whole rule packs as warnings, one shared approach").
43
-
44
- ### Added
45
- - `patternPacksConfig`: the recommended rules of `@tanstack/eslint-plugin-query`, `eslint-plugin-react-you-might-not-need-an-effect`, `eslint-plugin-boundaries` and `eslint-plugin-sonarjs`, every rule at `warn`, plus the house rules.
46
- - `query-key-factory` (PAT-QUERY-KEY-1 "queryKey only from a key factory"): flags an inline array/string/template `queryKey`; key-factory files (`*Keys.ts`), tests and generated code are exempt; `allow` adds path fragments.
47
- - `HOUSE_PATTERN_RULE_NAMES`.
48
-
49
- ## [1.9.0] - 2026-10-19
50
-
51
- PATTERN-1.4 "TypeScript pattern rules as ESLint rules", `no-raw-backend-fetch` (PAT-API-1 "web apps call the backend through the shared client") hardening.
52
-
53
- ### Changed
54
- - `no-raw-backend-fetch` no longer reports `fetch` of a literal absolute `http(s)://host/...` URL (third-party), or of a value produced by `URL.createObjectURL(...)` / `new FileReader().result` (direct, or via a single `const`).
55
- - `no-raw-backend-fetch` registers no visitors when the parsed AST is not an ESTree `Program` (non-JS languages under an unscoped `apiConfig`).
56
-
57
- ### Tests
58
- - `apiConfigUnscoped.test.ts`: `apiConfig` without `files` lints `.js`/`.mjs`/`.cjs`, build output and a 2000-deep nested file without throwing, and still reports under `src/`.
59
-
60
- ## [1.8.0] - 2026-10-19
61
-
62
- PATTERN-1.4 "TypeScript pattern rules as ESLint rules", row PAT-API-1 "web apps call the backend through the shared client".
63
-
64
- ### Added
65
-
66
- - `no-raw-backend-fetch`: reports `fetch(` / `window.fetch(` / `globalThis.fetch(` / `self.fetch(` and value imports of `axios`
67
- (`import`, `require`, `import()`) in `src/**`. Exempt: `src/server/`, `src/http/`, `src/lib/http/`, `packages/*-client/`,
68
- `/generated/`, service worker files, `app/+html.*`, tests, `data:`/`blob:` URLs, `import type` from axios. Option `{ allow: string[] }`.
69
- - `apiConfig` flat-config preset (`API_RULE_NAMES`) at `error`; included in `recommendedConfig`.
70
-
71
- ## [1.7.0] - 2026-10-19
72
-
73
- NAV-1 "Every game menu works with arrow keys and controller", phase 3.
74
-
75
- ### Added
76
-
77
- - `game-menu-focusable`: reports a `click` / `pointerdown` / `pointerup` listener or `onclick =` on an element created as
78
- `div` / `span` / `li` / `img` whose variable never gets `tabIndex` / `role` (property or `setAttribute`), and every
79
- `stopPropagation()` inside a `keydown` / `onkeydown` handler (inline, named function or const). No options, no autofix.
80
- - `gameConfig` flat-config preset (`GAME_RULE_NAMES`): enables `game-menu-focusable` at `error`. Not part of
81
- `recommendedConfig`; game repos opt in.
82
-
83
- ### Changed
84
-
85
- - `testdoc-results.v1.schema.json` copy synced to Dloizides.Testing 7fbf809 (adds the optional `features` array).
86
-
87
- ## [1.5.0] - 2026-10-07
88
-
89
- KEFI-ACT-1 "Same attendee actions everywhere" (generalized: one row-action source per entity, every portal).
90
-
91
- ### Added
92
-
93
- - `single-row-action-source`: reports `<RowActionGroup actions>` from `@dloizides/ui-buttons` built in the same file
94
- (inline array, array-bound identifier, `useMemo` returning an array, local builder function, `RowActionSpec[]`
95
- annotated local). Imported builders/sets and props pass. No options, no autofix.
96
- - `rowActionsConfig` and `recommendedConfig` flat-config blocks (`recommendedConfig` = comments + row actions, all `error`).
97
-
98
- ## [1.4.0] - 2026-10-07
99
-
100
- COMMENTS-1 "No code comments; only short doc comments on public members", decision D-CMT-4 "One-line summary, no call chains".
101
-
102
- ### Changed
103
-
104
- - `doc-comment-max-lines`: the description (lines other than `@param` / `@returns`) is capped at ONE line
105
- (`summaryMaxLines`, default 1), every doc line at 120 chars (`lineMaxChars`), and a line containing an arrow
106
- (U+2192 or `->`) or starting `Flow:` is reported (`callChain`). Matches `.claude/hooks/review-violations.js` docBlock().
107
- The 3-line total cap is unchanged. One report per block; banned tags take precedence.
108
-
109
- ## [1.3.0] - 2026-10-06
110
-
111
- COMMENTS-1 "No code comments; only short doc comments on public members" (decisions D-CMT-1, D-CMT-3).
112
-
113
- ### Added
114
-
115
- - `no-comments`: reports every comment that is not a `/**` doc block and not a tool directive
116
- (`eslint-*`, `@ts-*`, `prettier-ignore`, `istanbul`/`c8`, `/// <reference>`, `#__PURE__`,
117
- `webpackChunkName`, shebang). `allow: string[]` adds directive regexes. Suggestion only, no autofix.
118
- - `doc-comment-public-only`: a doc block must sit on an exported declaration (incl. `export { x }`,
119
- `export default x`, `module.exports`, ambient `declare module`) or a public member of one;
120
- `private` / `protected` / `#` members and local declarations are reported.
121
- - `doc-comment-max-lines`: doc body capped at `max` (default 3) content lines; block tags other than
122
- `allowedTags` (default `@param`, `@returns`) are reported. JSDoc type-annotation blocks
123
- (`@type`, `@typedef`, ...) are exempt from both doc rules.
124
- - `commentsConfig` flat-config block (the three rules at `error`) and `COMMENT_RULE_NAMES`, exported
125
- from `/eslint`. Not adopted by any app yet: each repo opts in as step 1 of its COMMENTS-CLEAN sweep.
126
-
127
- ## [1.1.0] - 2026-07-13
128
-
129
- Both changes come out of the ES-04 (agora-web) build, which surfaced two ways the
130
- rule pack misbehaved against a freshly scaffolded app.
131
-
132
- ### Fixed
133
-
134
- - **`no-null-check`: the autofixer no longer corrupts files.** It rewrote
135
- `x === undefined` → `!isValueDefined(x)` *without importing `isValueDefined`*,
136
- so `eslint --fix` emitted source referencing an undeclared global. Running
137
- `lint:fix` on agora-web rewrote ~20 files and produced 67 `no-unsafe-call` /
138
- `strict-boolean-expressions` errors. A fixer that produces broken code is worse
139
- than no fixer — `lint:fix` is the first thing anyone runs.
140
-
141
- The fixer now inserts `import { isValueDefined } from '@dloizides/utils';` (the
142
- path is configurable via the pre-existing but previously **unused**
143
- `utilImportPath` option) when the file has no binding for the guard, and skips
144
- the autofix entirely in the module that defines or re-exports it. Proven with
145
- `Linter.verifyAndFix` multipass tests — the actual `--fix` code path.
146
-
147
- ⚠️ The package's own test suite had *codified* the bug: it asserted the
148
- import-less output was correct. Those expectations were wrong and are updated.
149
-
150
- ### Changed
151
-
152
- - **`smart-max-lines`: `functionWarn` is now opt-in (default: off).** ESLint has
153
- no per-report severity, so a `functionWarn` report is emitted at the severity
154
- the *rule* is configured with. Every app configured the rule as `'error'` and
155
- passed `functionWarn: 30` — which made the real, enforced limit **30 lines**
156
- while the docs promised **50**. The rule lied about its own threshold.
157
-
158
- Out of the box the only enforced thresholds are now `componentMax` (200) and
159
- `functionMax` (50) — exactly what the documentation has always promised.
160
- `functionWarn` remains available as an explicit *stricter second threshold*,
161
- and its schema/message now say plainly that it reports at the rule's severity
162
- rather than as a warning.
163
-
164
- Migration: drop `functionWarn: 30` from your ESLint config. This only relaxes
165
- linting (30 → 50), so it cannot introduce new failures.
166
-
167
- ## [1.0.0] - 2026-06-14
168
-
169
- ### Added
170
-
171
- - Initial extraction of the shared RN-web dev tooling duplicated across
172
- erevna-web, katalogos-web, and kefi-web.
173
- - **ESLint custom rule pack** (17 rules) exported as `plugin` / `rules` /
174
- `legacyPlugins`, also available under the `@dloizides/frontend-devtools/eslint`
175
- subpath. Rule names preserved byte-for-byte so existing config keys and
176
- `eslint-disable-next-line <rule>` comments keep working:
177
- `enforce-function-style`, `enforce-module-structure`, `enforce-route-preload`,
178
- `enforce-test-colocation`, `enum-file-isolation`, `i18n-interpolation`,
179
- `i18n-param-names`, `no-barrel-companion-file`, `no-duplicate-nav-prefix`,
180
- `no-duplicate-shared-patterns`, `no-generated-models-barrel-value-import`,
181
- `no-null-check`, `no-optional-undefined`, `no-product-imports-in-shared`,
182
- `prefer-const-enum`, `require-stable-hook-args`, `smart-max-lines`.
183
- - **`initI18n(options)`** — parameterized i18next + react-i18next init factory.
184
- Carries the `import/no-named-as-default-member` disable so apps stop repeating
185
- it. The app owns its `locales/*.json` strings and the active language.
1
+ # Changelog
2
+
3
+ All notable changes to `@dloizides/frontend-devtools` are documented here.
4
+
5
+ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6
+ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
+
8
+ ## [2.4.0] - 2026-11-03
9
+
10
+ UI-COMPOSE-1 "Extract shared UI from the start; compose small single-purpose parts", D-COMPOSE-2 "Single responsibility, few props, compose with slots".
11
+
12
+ ### Added
13
+ - `max-component-props` rule (default cap 12, `frozen` names may only shrink) and the opt-in `composeConfig` pack.
14
+
15
+ ## [2.3.0] - 2026-10-28
16
+
17
+ OBS-1 "Every app ships metrics, production-grade logs and alerts with working links", D-OBS-15 "Front-end budgets, warn only".
18
+
19
+ ### Added
20
+ - `./lighthouse` subpath: `budgetAssertions` (LCP < 2500 ms, TBT < 200 ms, CLS < 0.1, script transfer < 300 KB, all `warn`), `mobileSettings` (Lighthouse's mid-range phone profile) and `withBudgets(config)`, which merges both into an app's `lighthouserc.js`; keys the app sets win.
21
+
22
+ ## [2.2.0] - 2026-10-23
23
+
24
+ FOCUS-1 "Every screen names its initial focus", D-FOCUS-2 "Lint rule and ledger".
25
+
26
+ ### Added
27
+ - `explicit-initial-focus`: flags a file that builds a menu of 2+ buttons (HTML strings or `createElement('button')`) with no `MENU_DEFAULT_ATTR` / `data-menu-default` / `dataset.menuDefault` / `initialFocus`, and a JSX `*Dialog` / `*Modal` / `role="dialog"` in a file with no `autoFocus`, `initialFocus(Ref)` or `.focus()` call. Options: `minControls`, `dialogPattern`, `selfFocusing`.
28
+ - `focusConfig` + `FOCUS_RULE_NAMES` (opt-in, not part of `recommendedConfig` or `gameConfig`).
29
+
30
+ ## [2.1.0] - 2026-10-20
31
+
32
+ QUAL-ADOPT-1 "Fail lint/arch tests when an app re-implements an existing package" (TS half).
33
+
34
+ ### Added
35
+ - `no-reimplemented-package`: flags app code that re-implements a shared package (hand-rolled analytics/Umami -> `@dloizides/analytics-web`, `X-BFF-Csrf` header or `bffCsrf` -> `@dloizides/bff-web-client`, `forgotPasswordRequest` -> `@dloizides/auth-web`, `utils/logger` -> `@dloizides/logging-web`). Pairs live in one registry, `src/rules/reimplemented-packages-registry.js`. Tests, e2e and package sources are exempt; `allow` adds path fragments.
36
+ - `reuseConfig` + `REUSE_RULE_NAMES` (opt-in, not part of `recommendedConfig`).
37
+
38
+ ## [2.0.0] - 2026-10-20
39
+
40
+ D-PAT-15 "Move initI18n out of frontend-devtools so it is dev-only".
41
+
42
+ ### Removed (BREAKING)
43
+ - `initI18n` and `InitI18nOptions`: import them from `@dloizides/i18n` (>= 1.1.0), same signature: `import { initI18n } from '@dloizides/i18n';`.
44
+ - The root entry (`@dloizides/frontend-devtools`): it exported only `initI18n`. Use the `/eslint` and `/test-results` subpaths.
45
+ - The `i18next` and `react-i18next` optional peer dependencies.
46
+
47
+ ## [1.10.0] - 2026-10-19
48
+
49
+ PATTERN-1.12 "TS rule packs + house rules in frontend-devtools" (D-PAT-12 "Whole rule packs as warnings, one shared approach").
50
+
51
+ ### Added
52
+ - `patternPacksConfig`: the recommended rules of `@tanstack/eslint-plugin-query`, `eslint-plugin-react-you-might-not-need-an-effect`, `eslint-plugin-boundaries` and `eslint-plugin-sonarjs`, every rule at `warn`, plus the house rules.
53
+ - `query-key-factory` (PAT-QUERY-KEY-1 "queryKey only from a key factory"): flags an inline array/string/template `queryKey`; key-factory files (`*Keys.ts`), tests and generated code are exempt; `allow` adds path fragments.
54
+ - `HOUSE_PATTERN_RULE_NAMES`.
55
+
56
+ ## [1.9.0] - 2026-10-19
57
+
58
+ PATTERN-1.4 "TypeScript pattern rules as ESLint rules", `no-raw-backend-fetch` (PAT-API-1 "web apps call the backend through the shared client") hardening.
59
+
60
+ ### Changed
61
+ - `no-raw-backend-fetch` no longer reports `fetch` of a literal absolute `http(s)://host/...` URL (third-party), or of a value produced by `URL.createObjectURL(...)` / `new FileReader().result` (direct, or via a single `const`).
62
+ - `no-raw-backend-fetch` registers no visitors when the parsed AST is not an ESTree `Program` (non-JS languages under an unscoped `apiConfig`).
63
+
64
+ ### Tests
65
+ - `apiConfigUnscoped.test.ts`: `apiConfig` without `files` lints `.js`/`.mjs`/`.cjs`, build output and a 2000-deep nested file without throwing, and still reports under `src/`.
66
+
67
+ ## [1.8.0] - 2026-10-19
68
+
69
+ PATTERN-1.4 "TypeScript pattern rules as ESLint rules", row PAT-API-1 "web apps call the backend through the shared client".
70
+
71
+ ### Added
72
+
73
+ - `no-raw-backend-fetch`: reports `fetch(` / `window.fetch(` / `globalThis.fetch(` / `self.fetch(` and value imports of `axios`
74
+ (`import`, `require`, `import()`) in `src/**`. Exempt: `src/server/`, `src/http/`, `src/lib/http/`, `packages/*-client/`,
75
+ `/generated/`, service worker files, `app/+html.*`, tests, `data:`/`blob:` URLs, `import type` from axios. Option `{ allow: string[] }`.
76
+ - `apiConfig` flat-config preset (`API_RULE_NAMES`) at `error`; included in `recommendedConfig`.
77
+
78
+ ## [1.7.0] - 2026-10-19
79
+
80
+ NAV-1 "Every game menu works with arrow keys and controller", phase 3.
81
+
82
+ ### Added
83
+
84
+ - `game-menu-focusable`: reports a `click` / `pointerdown` / `pointerup` listener or `onclick =` on an element created as
85
+ `div` / `span` / `li` / `img` whose variable never gets `tabIndex` / `role` (property or `setAttribute`), and every
86
+ `stopPropagation()` inside a `keydown` / `onkeydown` handler (inline, named function or const). No options, no autofix.
87
+ - `gameConfig` flat-config preset (`GAME_RULE_NAMES`): enables `game-menu-focusable` at `error`. Not part of
88
+ `recommendedConfig`; game repos opt in.
89
+
90
+ ### Changed
91
+
92
+ - `testdoc-results.v1.schema.json` copy synced to Dloizides.Testing 7fbf809 (adds the optional `features` array).
93
+
94
+ ## [1.5.0] - 2026-10-07
95
+
96
+ KEFI-ACT-1 "Same attendee actions everywhere" (generalized: one row-action source per entity, every portal).
97
+
98
+ ### Added
99
+
100
+ - `single-row-action-source`: reports `<RowActionGroup actions>` from `@dloizides/ui-buttons` built in the same file
101
+ (inline array, array-bound identifier, `useMemo` returning an array, local builder function, `RowActionSpec[]`
102
+ annotated local). Imported builders/sets and props pass. No options, no autofix.
103
+ - `rowActionsConfig` and `recommendedConfig` flat-config blocks (`recommendedConfig` = comments + row actions, all `error`).
104
+
105
+ ## [1.4.0] - 2026-10-07
106
+
107
+ COMMENTS-1 "No code comments; only short doc comments on public members", decision D-CMT-4 "One-line summary, no call chains".
108
+
109
+ ### Changed
110
+
111
+ - `doc-comment-max-lines`: the description (lines other than `@param` / `@returns`) is capped at ONE line
112
+ (`summaryMaxLines`, default 1), every doc line at 120 chars (`lineMaxChars`), and a line containing an arrow
113
+ (U+2192 or `->`) or starting `Flow:` is reported (`callChain`). Matches `.claude/hooks/review-violations.js` docBlock().
114
+ The 3-line total cap is unchanged. One report per block; banned tags take precedence.
115
+
116
+ ## [1.3.0] - 2026-10-06
117
+
118
+ COMMENTS-1 "No code comments; only short doc comments on public members" (decisions D-CMT-1, D-CMT-3).
119
+
120
+ ### Added
121
+
122
+ - `no-comments`: reports every comment that is not a `/**` doc block and not a tool directive
123
+ (`eslint-*`, `@ts-*`, `prettier-ignore`, `istanbul`/`c8`, `/// <reference>`, `#__PURE__`,
124
+ `webpackChunkName`, shebang). `allow: string[]` adds directive regexes. Suggestion only, no autofix.
125
+ - `doc-comment-public-only`: a doc block must sit on an exported declaration (incl. `export { x }`,
126
+ `export default x`, `module.exports`, ambient `declare module`) or a public member of one;
127
+ `private` / `protected` / `#` members and local declarations are reported.
128
+ - `doc-comment-max-lines`: doc body capped at `max` (default 3) content lines; block tags other than
129
+ `allowedTags` (default `@param`, `@returns`) are reported. JSDoc type-annotation blocks
130
+ (`@type`, `@typedef`, ...) are exempt from both doc rules.
131
+ - `commentsConfig` flat-config block (the three rules at `error`) and `COMMENT_RULE_NAMES`, exported
132
+ from `/eslint`. Not adopted by any app yet: each repo opts in as step 1 of its COMMENTS-CLEAN sweep.
133
+
134
+ ## [1.1.0] - 2026-07-13
135
+
136
+ Both changes come out of the ES-04 (agora-web) build, which surfaced two ways the
137
+ rule pack misbehaved against a freshly scaffolded app.
138
+
139
+ ### Fixed
140
+
141
+ - **`no-null-check`: the autofixer no longer corrupts files.** It rewrote
142
+ `x === undefined` → `!isValueDefined(x)` *without importing `isValueDefined`*,
143
+ so `eslint --fix` emitted source referencing an undeclared global. Running
144
+ `lint:fix` on agora-web rewrote ~20 files and produced 67 `no-unsafe-call` /
145
+ `strict-boolean-expressions` errors. A fixer that produces broken code is worse
146
+ than no fixer — `lint:fix` is the first thing anyone runs.
147
+
148
+ The fixer now inserts `import { isValueDefined } from '@dloizides/utils';` (the
149
+ path is configurable via the pre-existing but previously **unused**
150
+ `utilImportPath` option) when the file has no binding for the guard, and skips
151
+ the autofix entirely in the module that defines or re-exports it. Proven with
152
+ `Linter.verifyAndFix` multipass tests — the actual `--fix` code path.
153
+
154
+ ⚠️ The package's own test suite had *codified* the bug: it asserted the
155
+ import-less output was correct. Those expectations were wrong and are updated.
156
+
157
+ ### Changed
158
+
159
+ - **`smart-max-lines`: `functionWarn` is now opt-in (default: off).** ESLint has
160
+ no per-report severity, so a `functionWarn` report is emitted at the severity
161
+ the *rule* is configured with. Every app configured the rule as `'error'` and
162
+ passed `functionWarn: 30` — which made the real, enforced limit **30 lines**
163
+ while the docs promised **50**. The rule lied about its own threshold.
164
+
165
+ Out of the box the only enforced thresholds are now `componentMax` (200) and
166
+ `functionMax` (50) — exactly what the documentation has always promised.
167
+ `functionWarn` remains available as an explicit *stricter second threshold*,
168
+ and its schema/message now say plainly that it reports at the rule's severity
169
+ rather than as a warning.
170
+
171
+ Migration: drop `functionWarn: 30` from your ESLint config. This only relaxes
172
+ linting (30 → 50), so it cannot introduce new failures.
173
+
174
+ ## [1.0.0] - 2026-06-14
175
+
176
+ ### Added
177
+
178
+ - Initial extraction of the shared RN-web dev tooling duplicated across
179
+ erevna-web, katalogos-web, and kefi-web.
180
+ - **ESLint custom rule pack** (17 rules) exported as `plugin` / `rules` /
181
+ `legacyPlugins`, also available under the `@dloizides/frontend-devtools/eslint`
182
+ subpath. Rule names preserved byte-for-byte so existing config keys and
183
+ `eslint-disable-next-line <rule>` comments keep working:
184
+ `enforce-function-style`, `enforce-module-structure`, `enforce-route-preload`,
185
+ `enforce-test-colocation`, `enum-file-isolation`, `i18n-interpolation`,
186
+ `i18n-param-names`, `no-barrel-companion-file`, `no-duplicate-nav-prefix`,
187
+ `no-duplicate-shared-patterns`, `no-generated-models-barrel-value-import`,
188
+ `no-null-check`, `no-optional-undefined`, `no-product-imports-in-shared`,
189
+ `prefer-const-enum`, `require-stable-hook-args`, `smart-max-lines`.
190
+ - **`initI18n(options)`** — parameterized i18next + react-i18next init factory.
191
+ Carries the `import/no-named-as-default-member` disable so apps stop repeating
192
+ it. The app owns its `locales/*.json` strings and the active language.
@@ -98,5 +98,8 @@ declare const recommendedConfig: FlatConfig;
98
98
  declare const FOCUS_RULE_NAMES: readonly string[];
99
99
  /** FOCUS-1: a game menu or dialog names the control focused on open. Opt-in, not part of recommendedConfig. */
100
100
  declare const focusConfig: FlatConfig;
101
+ declare const COMPOSE_RULE_NAMES: readonly string[];
102
+ /** UI-COMPOSE-1: a component stays small and composes with slots. Opt-in; pass `frozen` for existing over-limit ones. */
103
+ declare const composeConfig: FlatConfig;
101
104
 
102
- export { API_RULE_NAMES, COMMENT_RULE_NAMES, type CustomRule, FOCUS_RULE_NAMES, type FlatConfig, type FlatConfigPlugin, GAME_RULE_NAMES, HOUSE_PATTERN_RULE_NAMES, REUSE_RULE_NAMES, ROW_ACTION_RULE_NAMES, type SingleRulePlugin, apiConfig, commentsConfig, focusConfig, gameConfig, legacyPlugins, patternPacksConfig, plugin, recommendedConfig, reuseConfig, rowActionsConfig, ruleNames, rules };
105
+ export { API_RULE_NAMES, COMMENT_RULE_NAMES, COMPOSE_RULE_NAMES, type CustomRule, FOCUS_RULE_NAMES, type FlatConfig, type FlatConfigPlugin, GAME_RULE_NAMES, HOUSE_PATTERN_RULE_NAMES, REUSE_RULE_NAMES, ROW_ACTION_RULE_NAMES, type SingleRulePlugin, apiConfig, commentsConfig, composeConfig, focusConfig, gameConfig, legacyPlugins, patternPacksConfig, plugin, recommendedConfig, reuseConfig, rowActionsConfig, ruleNames, rules };
@@ -98,5 +98,8 @@ declare const recommendedConfig: FlatConfig;
98
98
  declare const FOCUS_RULE_NAMES: readonly string[];
99
99
  /** FOCUS-1: a game menu or dialog names the control focused on open. Opt-in, not part of recommendedConfig. */
100
100
  declare const focusConfig: FlatConfig;
101
+ declare const COMPOSE_RULE_NAMES: readonly string[];
102
+ /** UI-COMPOSE-1: a component stays small and composes with slots. Opt-in; pass `frozen` for existing over-limit ones. */
103
+ declare const composeConfig: FlatConfig;
101
104
 
102
- export { API_RULE_NAMES, COMMENT_RULE_NAMES, type CustomRule, FOCUS_RULE_NAMES, type FlatConfig, type FlatConfigPlugin, GAME_RULE_NAMES, HOUSE_PATTERN_RULE_NAMES, REUSE_RULE_NAMES, ROW_ACTION_RULE_NAMES, type SingleRulePlugin, apiConfig, commentsConfig, focusConfig, gameConfig, legacyPlugins, patternPacksConfig, plugin, recommendedConfig, reuseConfig, rowActionsConfig, ruleNames, rules };
105
+ export { API_RULE_NAMES, COMMENT_RULE_NAMES, COMPOSE_RULE_NAMES, type CustomRule, FOCUS_RULE_NAMES, type FlatConfig, type FlatConfigPlugin, GAME_RULE_NAMES, HOUSE_PATTERN_RULE_NAMES, REUSE_RULE_NAMES, ROW_ACTION_RULE_NAMES, type SingleRulePlugin, apiConfig, commentsConfig, composeConfig, focusConfig, gameConfig, legacyPlugins, patternPacksConfig, plugin, recommendedConfig, reuseConfig, rowActionsConfig, ruleNames, rules };