@kirill.konshin/lint 0.8.0 → 0.8.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/README.md CHANGED
@@ -170,6 +170,7 @@ export default defineConfig(vitePlusConfig());
170
170
 
171
171
  - Merging: lists add up (`plugins`, `jsPlugins`, `overrides`, `ignorePatterns`), maps merge by key (`rules`, `settings`, `env`), a `staged` block replaces the default
172
172
  - Building blocks are exported: `lintConfig(config)` (synchronous, takes a resolved config), `fmtConfig()`, `stagedConfig()`
173
+ - Rolldown module-directive warnings (`'use server'`, `'use client'`) default off for builds and dependency optimization; set `build.rolldownOptions.checks.moduleLevelDirective` or `optimizeDeps.rolldownOptions.checks.moduleLevelDirective` to `true` to re-enable. This changes logging only, not directive handling.
173
174
  - Lint and format settings live in the **root** config only: Vite+ ignores nested `lint`/`fmt` blocks, use `lint.overrides` / `fmt.overrides` with workspace paths
174
175
  - `.gitignore` and `.prettierignore` are honoured by Oxfmt; the recommended `.prettierignore` entries are default `fmt.ignorePatterns`, add others there
175
176
 
@@ -484,7 +485,7 @@ In the project root, `lint-prepare`:
484
485
  - Creates real `rules/` and `skills/` directories in `.agents/` (canonical, cross-tool — Codex reads it) and `.claude/` (Claude Code).
485
486
  - Links every `rules/*.md` file into both, except the ones the `rules` map of [`lint.config.ts`](#lintconfigts) turns off (`rules: { redux: false }`). Links point straight at the installed package's real location (`node_modules/@kirill.konshin/lint`, or the workspace package). A rule of yours with the same name in `.agents/` wins, the package one is not installed.
486
487
  - Installs the skills of the `skills` map of `lint.config.ts`, merged over the defaults, with the [`skills` CLI](https://github.com/vercel-labs/skills), into `.agents/skills/` and from there into `.claude/skills/`. The map is keyed by source, each value uses the toggle notation; `skills: { name: true | false }` picks skills of a source — with no `true` entry every skill except the `false` ones:
487
- - npm packages (`@scope/name`, or a name without `/`) are dependencies that ship skills: `skills experimental_sync -y -a codex claude-code` links every `skills/<name>/` folder of your dependencies; the map only leaves some out (`--exclude`). Default: this package's own skills (`'@kirill.konshin/lint': true`) — e.g. `lint-repo`, which sets up the tooling above and audits the repo against the rules.
488
+ - npm packages (`@scope/name`, or a name without `/`) are dependencies that ship skills: `skills experimental_sync -y -r -a codex claude-code` links every `skills/<name>/` folder of the dependencies of the root and of every workspace package; the map only leaves some out (`--exclude`). Default: this package's own skills (`'@kirill.konshin/lint': true`) — e.g. `lint-repo`, which sets up the tooling above and audits the repo against the rules.
488
489
  - Git sources (`owner/repo`) are installed with `skills add`, at `ref` when set (pin a full 40-character commit SHA). A source whose skills `skills-lock.json` already has at the same ref is not fetched again. `lint.config.ts` owns the remote skills of `skills-lock.json`: a remote skill it no longer lists is removed (`skills remove`).
489
490
  - Defaults — every project gets them, turn off what it does not need: the [Core Pack](https://skills.sh/p/DxVN7q53wGdAcZQt) (`vercel-labs/agent-skills` incl. `web-design-guidelines`, `vercel/ai`, `shadcn-ui/ui`, `heroui-inc/heroui`, `mui/material-ui` without `material-ui-tailwind`, `neondatabase/agent-skills`) and the official skills of the libraries the rules cover (`vercel/next.js`, `reduxjs/redux-toolkit`, `vercel/turborepo`, `nrwl/nx-ai-agents-config`, `expo/skills`, `microsoft/playwright-cli`). Each source lists its skills and pins a commit: `DEFAULT_LINT_CONFIG` in `src/config.ts`.
490
491
  - A skill folder of yours with the same name in `.agents/skills/` wins.
@@ -57,9 +57,10 @@ export declare function readSyncedSkills(cwd: string): Set<string>;
57
57
  */
58
58
  export declare function readUserEntries(cwd: string): Map<string, string>;
59
59
  /**
60
- * Install the skills dependencies ship (this package's own `skills/` folder among them) with the `skills` CLI, into
61
- * `.agents/skills`, linked into `.claude/skills`. `exclude`: `package` or `package#skill` patterns to leave out. On CI
62
- * nothing remote is touched (`--no-remote`). Returns whether the sync succeeded.
60
+ * Install the skills that the dependencies of the root and of every workspace package ship (this package's own
61
+ * `skills/` folder among them) with the `skills` CLI, into `.agents/skills`, linked into `.claude/skills`. `exclude`:
62
+ * `package` or `package#skill` patterns to leave out. On CI nothing remote is touched (`--no-remote`). Returns whether
63
+ * the sync succeeded.
63
64
  */
64
65
  export declare function runSkillsSync(cwd: string, run?: RunCommand, exclude?: string[]): boolean;
65
66
  /** An npm package that ships skills (`@scope/name`, or a name without `/`); anything else is a git source. */
@@ -50,6 +50,7 @@ const SKILLS_AGENTS = [
50
50
  const SKILLS_SYNC_ARGS = [
51
51
  "experimental_sync",
52
52
  "-y",
53
+ "-r",
53
54
  ...SKILLS_AGENTS
54
55
  ];
55
56
  const FRONTMATTER = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/;
@@ -339,9 +340,10 @@ function runSkillsCli(cwd, args, run) {
339
340
  return false;
340
341
  }
341
342
  /**
342
- * Install the skills dependencies ship (this package's own `skills/` folder among them) with the `skills` CLI, into
343
- * `.agents/skills`, linked into `.claude/skills`. `exclude`: `package` or `package#skill` patterns to leave out. On CI
344
- * nothing remote is touched (`--no-remote`). Returns whether the sync succeeded.
343
+ * Install the skills that the dependencies of the root and of every workspace package ship (this package's own
344
+ * `skills/` folder among them) with the `skills` CLI, into `.agents/skills`, linked into `.claude/skills`. `exclude`:
345
+ * `package` or `package#skill` patterns to leave out. On CI nothing remote is touched (`--no-remote`). Returns whether
346
+ * the sync succeeded.
345
347
  */
346
348
  function runSkillsSync(cwd, run = spawnSync, exclude = []) {
347
349
  const args = [...SKILLS_SYNC_ARGS];
@@ -33,8 +33,8 @@ export declare function stagedConfig(): StagedConfig;
33
33
  /**
34
34
  * The shared Vite+ config, from the workspace root `lint.config.ts`: {@link lintConfig}, {@link fmtConfig} and
35
35
  * {@link stagedConfig}, then the project's own blocks (`vitePlus` key of `lint.config.ts`), then `config` (see
36
- * `mergeUserConfig` for how blocks merge). `overrides` merge deep over `lint.config.ts`. Async: wrap the Promise in
37
- * `defineConfig`, Vite+ awaits it:
36
+ * `mergeUserConfig` for how blocks merge). Rolldown's module-directive warning defaults off in builds and dependency
37
+ * optimization. `overrides` merge deep over `lint.config.ts`. Async: wrap the Promise in `defineConfig`, Vite+ awaits it:
38
38
  *
39
39
  * ```ts
40
40
  * import { vitePlusConfig } from '@kirill.konshin/lint/vite-plus';
package/dist/vitePlus.js CHANGED
@@ -404,8 +404,8 @@ function mergeUserConfig(base, extra) {
404
404
  /**
405
405
  * The shared Vite+ config, from the workspace root `lint.config.ts`: {@link lintConfig}, {@link fmtConfig} and
406
406
  * {@link stagedConfig}, then the project's own blocks (`vitePlus` key of `lint.config.ts`), then `config` (see
407
- * `mergeUserConfig` for how blocks merge). `overrides` merge deep over `lint.config.ts`. Async: wrap the Promise in
408
- * `defineConfig`, Vite+ awaits it:
407
+ * `mergeUserConfig` for how blocks merge). Rolldown's module-directive warning defaults off in builds and dependency
408
+ * optimization. `overrides` merge deep over `lint.config.ts`. Async: wrap the Promise in `defineConfig`, Vite+ awaits it:
409
409
  *
410
410
  * ```ts
411
411
  * import { vitePlusConfig } from '@kirill.konshin/lint/vite-plus';
@@ -417,11 +417,36 @@ function mergeUserConfig(base, extra) {
417
417
  async function vitePlusConfig(config = {}, overrides = {}) {
418
418
  const options = await resolveLintConfig(overrides);
419
419
  const { typeAware: _typeAware, ...blocks } = options.vitePlus ?? {};
420
- return mergeUserConfig(mergeUserConfig({
420
+ const merged = mergeUserConfig(mergeUserConfig({
421
421
  lint: lintConfig(options),
422
422
  fmt: fmtConfig(),
423
423
  staged: stagedConfig()
424
424
  }, blocks), config);
425
+ const buildOptions = merged.build?.rolldownOptions ?? merged.build?.rollupOptions;
426
+ const optimizeOptions = merged.optimizeDeps?.rolldownOptions ?? merged.optimizeDeps?.rollupOptions;
427
+ return {
428
+ ...merged,
429
+ build: {
430
+ ...merged.build,
431
+ rolldownOptions: {
432
+ ...buildOptions,
433
+ checks: {
434
+ moduleLevelDirective: false,
435
+ ...buildOptions?.checks
436
+ }
437
+ }
438
+ },
439
+ optimizeDeps: {
440
+ ...merged.optimizeDeps,
441
+ rolldownOptions: {
442
+ ...optimizeOptions,
443
+ checks: {
444
+ moduleLevelDirective: false,
445
+ ...optimizeOptions?.checks
446
+ }
447
+ }
448
+ }
449
+ };
425
450
  }
426
451
  //#endregion
427
452
  export { fmtConfig, lintConfig, stagedConfig, tsExts, vitePlusConfig };
package/package.json CHANGED
@@ -1,7 +1,10 @@
1
1
  {
2
2
  "name": "@kirill.konshin/lint",
3
3
  "description": "Vite+ (Oxlint + Oxfmt), ESLint + Prettier + lint-staged configs and AI agent rules/skills for monorepos",
4
- "version": "0.8.0",
4
+ "keywords": [
5
+ "tanstack-intent"
6
+ ],
7
+ "version": "0.8.2",
5
8
  "type": "module",
6
9
  "skipGenerate": true,
7
10
  "bin": {
package/rules/db.md CHANGED
@@ -14,7 +14,7 @@ Migration and import procedures, Neon: the `lint-db` skill.
14
14
 
15
15
  - Use Drizzle as ORM if user asks to add ORM
16
16
  - Keep schemas, repositories, tenancy, and authorization app-owned; keep reusable driver plumbing in `@kirill.konshin/db`.
17
- - Import `@kirill.konshin/db` through focused driver, migration, URL, and type subpaths so unrelated drivers are not loaded.
17
+ - Import `@kirill.konshin/db` through focused driver, migration, URL, and type subpaths so unrelated drivers are not loaded; which subpath for which work: the `db` skill of `@kirill.konshin/db`
18
18
  - Keep database access server-only and separate the database/repository layer from API, UI, and state-management layers.
19
19
  - Preserve canonical external identifiers as strings; never coerce opaque IDs or URNs to numbers.
20
20
  - Model related state once per owner and entity when that avoids duplicate rows, and enforce invariants with keys, constraints, and indexes.
package/rules/mui.md CHANGED
@@ -6,9 +6,9 @@ paths:
6
6
  - '**/*.ts'
7
7
  ---
8
8
 
9
- Details and admin pages: the `lint-mui` skill.
9
+ Details: the `lint-mui` skill; admin pages and Toolpad: the `mui` skill of `@kirill.konshin/mui`.
10
10
 
11
11
  - Import from the barrels (`@mui/material`, `@mui/icons-material`) in apps; use direct imports (`@mui/material/Button`) in libraries
12
12
  - This rule overrides `bundle-barrel-imports` of the `vercel-react-best-practices` skill and the one-level imports of the `material-ui-styling` skill
13
13
  - NEVER mix MUI and Tailwind in one interface; do not follow the `material-ui-tailwind` skill
14
- - `@toolpad/core` is archived (no longer maintained): use it only through `@kirill.konshin/mui/admin`, add no new direct Toolpad usage
14
+ - `@toolpad/core` is archived (no longer maintained): import it ONLY from `@kirill.konshin/mui/toolpad` (pinned, same names, some components fixed) or the `@kirill.konshin/mui/admin` presets; NEVER add `@toolpad/core` to an app
package/rules/nextjs.md CHANGED
@@ -19,12 +19,13 @@ Use the `lint-nextjs` skill when working with a Next.js project.
19
19
  - Use `iron-session` for authentication via `@kirill.konshin/auth`, see [auth.md](auth.md)
20
20
  - Server-only modules MUST start with `import 'server-only'`: see [typescript.md](typescript.md)
21
21
  - `package.json` MUST ALWAYS have version of Next.js, NEVER `*`, otherwise Vercel will fall into legacy mode instead of serverless
22
- - ALWAYS create `next.config.ts` with `defineNextConfig` from `@kirill.konshin/next/config` (the `/config` subpath, NEVER the barrel — Next transpiles `next.config.ts` to CJS and `require`s it outside any bundler); what it sets: the `lint-nextjs` skill
22
+ - ALWAYS create `next.config.ts` with `defineNextConfig` from `@kirill.konshin/next/config` (the `/config` subpath, NEVER the barrel — Next transpiles `next.config.ts` to CJS and `require`s it outside any bundler); what it sets: the `next` skill of `@kirill.konshin/next`
23
23
  - Use `@kirill.konshin/icons` for FontAwesome / Gravity UI icons — the barrel is safe with `optimizePackageImports` (`defineNextConfig` sets it); this overrides `bundle-barrel-imports` of the `vercel-react-best-practices` skill
24
24
  - Page and component file placement: the `lint-nextjs` skill
25
+ - App icons, favicons, manifest icons and iOS launch screens: use `@kirill.konshin/app-images`, its `app-images` skill installs with it; NEVER write icon lists by hand
25
26
 
26
27
  # Admin Pages & Login
27
28
 
28
29
  - ALWAYS use MUI for admin page layouts and login screens, see the `lint-mui` skill
29
- - ALWAYS prefer `@kirill.konshin/mui/admin` (`AdminAppProvider`, `AdminDashboardLayout`, `AdminSignInPage`) — encapsulates the Toolpad boilerplate and wires `@kirill.konshin/auth`, see the `lint-mui` skill; `@toolpad/core` is archived, add no new direct Toolpad usage
30
+ - ALWAYS prefer `@kirill.konshin/mui/admin` (`AdminAppProvider`, `AdminDashboardLayout`, `AdminSignInPage`) — encapsulates the Toolpad boilerplate and wires `@kirill.konshin/auth`, see the `lint-mui` skill; other Toolpad parts ONLY from `@kirill.konshin/mui/toolpad`, NEVER `@toolpad/core` (see [mui.md](mui.md))
30
31
  - Tailwind is ONLY for user-facing sites, NEVER for admin (see [tailwind.md](tailwind.md))
@@ -14,7 +14,7 @@ The binding rules are in [rules/db.md](../../rules/db.md). This skill holds the
14
14
 
15
15
  # Neon
16
16
 
17
- Only when the user asks for Neon, or the project already uses it. Drivers, connection strings, branches and migrations: the `neon-postgres` skill and the `neon-postgres-branches` skill; the driver plumbing lives in `@kirill.konshin/db`.
17
+ Only when the user asks for Neon, or the project already uses it. Connection strings, branches and migrations: the `neon-postgres` skill and the `neon-postgres-branches` skill. Drivers, URLs and migration runs: `@kirill.konshin/db` and its `db` skill, it installs with the package.
18
18
 
19
19
  Neon Auth: set it up per the `neon-auth` skill, then fold it into Iron Session ([rules/auth.md](../../rules/auth.md)):
20
20
 
@@ -1,8 +1,16 @@
1
1
  ---
2
2
  name: lint-electron
3
- description: Skill for Electron-based apps - dev runner that restarts Electron (vp pack --watch), packaging a Next.js standalone server with electron-builder in a hoisted monorepo, CI builds. Use when setting up, running or packaging an Electron app.
3
+ description: Skill for Electron-based apps - packages to use (`@kirill.konshin/electron`, `@kirill.konshin/electron-builder`, `next-electron-rsc`), dev runner that restarts Electron (vp pack --watch), packaging a Next.js standalone server with electron-builder in a hoisted monorepo, CI builds. Use when setting up, running or packaging an Electron app.
4
4
  ---
5
5
 
6
+ # Packages
7
+
8
+ Use these packages before you write the same code:
9
+
10
+ - `@kirill.konshin/electron` — main-process helpers: `createWindow` (a window that loads the dev server, a static export or a remote URL; it remembers its bounds, adds the default menu, can check for updates) and `checkForUpdates` (`electron-updater` with dialogs, for a menu item)
11
+ - `@kirill.konshin/electron-builder` — `builerConfig()` for `electron-builder.ts`: DMG and zip targets (DMG only without signing), S3 and GitHub Releases publishing by CI ref, `assets` as build resources, `mac.icon` from `@kirill.konshin/app-images`; it keeps the app config you pass
12
+ - `next-electron-rsc` — runs a Next.js app with React Server Components and Server Actions in Electron, with no open port in production; install `next` as a dependency, not a devDependency: electron-builder copies only dependencies into the app
13
+
6
14
  # Dev Runner
7
15
 
8
16
  ALWAYS run the main process in development with `vp pack --watch` (Vite+, tsdown), never `tsc-watch`, `nodemon` or `electron .` alone: it rebuilds the entrypoint and restarts Electron through `onSuccess` (tsdown stops the previous process). Files outside the main process module graph that need a restart (`next.config.*`: Next.js applies config only on a restart, like `next dev`; a linked library build) go in through a plugin — the `watch` option cannot list them, `--watch` overrides it with `true`:
@@ -46,6 +54,10 @@ Scripts: `"start": "vp pack --watch"`, `"build:main": "vp pack"`.
46
54
 
47
55
  This is the `vite.config.ts` of the Electron app's own workspace package. When the app is the workspace root, the root `vite.config.ts` stays `defineConfig(vitePlusConfig())`: put the `pack` block under the `vitePlus` key of `lint.config.ts` (`vitePlus: { pack: { … } }`).
48
56
 
57
+ # Icons
58
+
59
+ App icons (macOS `.icns`, no Xcode needed; opt-in Icon Composer `.icon`), Windows and Linux icons, splash and DMG background: use `@kirill.konshin/app-images`, its `app-images` skill installs with it.
60
+
49
61
  # Packaging a Next.js Standalone Server
50
62
 
51
63
  In a hoisted workspace (see [rules/npm-yarn.md](../../rules/npm-yarn.md#hoisting)) Next.js traces the server's dependencies into `.next/standalone/node_modules`, beside the app folder; package both, without Electron:
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: lint-mui
3
- description: Our MUI conventions on top of the vendor MUI skills - class-name usage in `sx`, safe-area insets in the theme, admin pages and login with `@kirill.konshin/mui/admin`. Use when writing or reviewing code that uses MUI, or building an admin interface.
3
+ description: Our MUI conventions on top of the vendor MUI skills - class-name usage in `sx`, safe-area insets in the theme, which package to use for admin pages and login. Use when writing or reviewing code that uses MUI, or building an admin interface.
4
4
  ---
5
5
 
6
6
  The binding rules are in [rules/mui.md](../../rules/mui.md): imports, no Tailwind, Toolpad. MUI API knowledge: the `material-ui-styling` skill, the `material-ui-theming` skill and the `material-ui-nextjs` skill; where they differ, the rules win.
@@ -23,6 +23,6 @@ import { Box, Input, inputClasses } from '@mui/material';
23
23
 
24
24
  # Admin Pages and Login
25
25
 
26
- - Use `@kirill.konshin/mui/admin`: `AdminAppProvider`, `AdminDashboardLayout`, `AdminSignInPage`. It holds the Toolpad boilerplate (`@toolpad/core` is archived: add no new direct Toolpad usage).
27
- - `AdminSignInPage.loginAction` takes `loginFormAction` from `@kirill.konshin/auth` ([rules/auth.md](../../rules/auth.md)).
28
- - Use the built-ins of the admin layout (navigation, dialogs, notifications) before custom JSX.
26
+ Use `@kirill.konshin/mui`: the `/admin` presets and `/toolpad` (Toolpad, pinned and fixed). Details: the `mui` skill, it installs with the package.
27
+
28
+ When Toolpad does not cover what you need, start from the [free Material UI templates](https://mui.com/material-ui/getting-started/templates/#free-templates) (dashboard, CRUD dashboard, sign-in, sign-up, checkout, blog, marketing page): copy the parts you need into the app, do not write them from zero.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: lint-nextjs
3
- description: Our Next.js App Router conventions on top of the vendor Next.js skills - typed `LayoutProps` / `PageProps`, auth-guarded layouts, `params` / `searchParams` in server and client pages, page and component file placement, what `defineNextConfig` sets in `next.config.ts`. Use when writing or reviewing Next.js pages, layouts, route handlers or `next.config.ts`.
3
+ description: Our Next.js App Router conventions on top of the vendor Next.js skills - typed `LayoutProps` / `PageProps`, auth-guarded layouts, `params` / `searchParams` in server and client pages, page and component file placement, where `next.config.ts` details are. Use when writing or reviewing Next.js pages, layouts, route handlers or `next.config.ts`.
4
4
  ---
5
5
 
6
6
  The binding rules are in [rules/nextjs.md](../../rules/nextjs.md). Next.js API knowledge: the docs that `next` bundles (`node_modules/next/dist/docs/`), the `next-*` skills and the `vercel-react-best-practices` skill; MUI setup: the `material-ui-nextjs` skill.
@@ -87,10 +87,4 @@ export default function Page({ params }: PageProps<'/blog/[slug]'>) {
87
87
 
88
88
  # `next.config.ts`
89
89
 
90
- `defineNextConfig` from `@kirill.konshin/next/config` (the `/config` subpath: Next transpiles `next.config.ts` to CJS and `require`s it outside any bundler) sets `cacheComponents`, `typedRoutes`, `experimental.typedEnv`, `reactStrictMode: false` and an exhaustive `experimental.optimizePackageImports` (`@mui/*`, `@toolpad/core`, `@fortawesome/*`, `@gravity-ui/*`, `lodash`, `@heroui/react`, `react-bootstrap`, `@kirill.konshin/icons`, …). Extra entries cost nothing; a missing one costs dev startup time and bundle size.
91
-
92
- ```ts
93
- import { defineNextConfig } from '@kirill.konshin/next/config';
94
-
95
- export default defineNextConfig((defaults) => ({ ...defaults, transpilePackages: ['my-lib'] }));
96
- ```
90
+ `defineNextConfig` of `@kirill.konshin/next/config`: what it sets and how to extend it is in the `next` skill, it installs with the package. The same skill lists the package's utilities (`AppLink`, `SoftLink`, `NoSSR`, …).