@shrkcrft/presets 0.1.0-alpha.7 → 0.1.0-alpha.9

package/dist/builtin/nest11-snippets.js

@@ -1,270 +0,0 @@
-// NestJS 11+ rule snippets.
-//
-// Covers the modern Nest service surface: module structure, thin
-// controllers, DTOs with class-validator, the global ValidationPipe with
-// strict options, async providers + lifecycle hooks, graceful shutdown,
-// the Fastify adapter, caching, throttling, helmet, explicit CORS, JWT
-// auth, structured logging via the Nest Logger, @nestjs/terminus health
-// checks, and the TestingModule patterns for unit + supertest e2e.
-//
-// Each snippet is a string injected verbatim into a generated
-// `sharkcraft/*.ts` file; `defineKnowledgeEntry`, `KnowledgeType`, and
-// `KnowledgePriority` are provided by the local-mirror preamble the
-// synthesizer prepends to the file.
-import { ruleSnippet } from "./r26-snippets.js";
-// ─── Architecture: modules, controllers, services, repos ──────────────────
-export const NEST11_THIN_CONTROLLERS = ruleSnippet({
-    id: 'nest11.thin-controllers',
-    title: 'Controllers are thin — no business logic',
-    priority: 'critical',
-    tags: ['nestjs', 'nest-11', 'architecture'],
-    appliesWhen: ['generate-controller', 'review'],
-    content: 'Controllers parse the request (params/query/body via DTOs), call ONE service method, and return the result. No conditionals over domain rules, no inline database access, no orchestration of multiple services. If a controller method body is more than a handful of lines or branches on domain state, the logic belongs in a service.',
-});
-export const NEST11_SERVICE_OWNS_DOMAIN = ruleSnippet({
-    id: 'nest11.service-owns-domain',
-    title: 'Services own domain logic; repositories own data access',
-    priority: 'high',
-    tags: ['nestjs', 'nest-11', 'architecture'],
-    appliesWhen: ['generate-service', 'review'],
-    content: 'Services express domain rules and orchestrate work. Data access lives behind a repository (TypeORM Repository, Prisma client, or a hand-rolled interface). Services depend on repository interfaces, not on the ORM directly — that boundary is what makes unit tests cheap.',
-});
-export const NEST11_MODULE_PER_FEATURE = ruleSnippet({
-    id: 'nest11.module-per-feature',
-    title: 'Module per feature, not per layer',
-    priority: 'high',
-    tags: ['nestjs', 'nest-11', 'architecture'],
-    appliesWhen: ['create-feature'],
-    content: 'Each feature gets its own module under src/<feature>/ owning controller(s), service(s), DTOs, and (optionally) entities. Top-level grab-bags like ControllersModule / ServicesModule are an anti-pattern — they couple every feature to every other.',
-});
-export const NEST11_MODULE_PUBLIC_API = ruleSnippet({
-    id: 'nest11.module-public-api',
-    title: 'Each module exports its public API only',
-    priority: 'high',
-    tags: ['nestjs', 'nest-11', 'architecture', 'boundaries'],
-    appliesWhen: ['generate-code', 'review'],
-    content: 'A module\'s `exports: [...]` lists exactly the providers other modules may inject. Internal services stay unexported. Avoid `exports: [SomeModule]` re-exports unless you intentionally want the entire surface to be transitive.',
-});
-export const NEST11_NO_CIRCULAR_MODULES = ruleSnippet({
-    id: 'nest11.no-circular-modules',
-    title: 'Avoid circular module dependencies',
-    priority: 'critical',
-    tags: ['nestjs', 'nest-11', 'architecture'],
-    appliesWhen: ['generate-code', 'review'],
-    content: 'If module A imports module B and B imports A, extract the shared piece into a third module that both depend on. `forwardRef()` exists to escape genuine cycles in the dependency graph, not to paper over a missing abstraction.',
-});
-export const NEST11_DTO_AT_BOUNDARY = ruleSnippet({
-    id: 'nest11.dto-at-boundary',
-    title: 'DTOs at the HTTP boundary; never expose entities',
-    priority: 'critical',
-    tags: ['nestjs', 'nest-11', 'dto', 'security'],
-    appliesWhen: ['generate-controller', 'generate-dto'],
-    content: 'Request shapes live in `<feature>.dto.ts`; response shapes either in a dedicated response DTO or as a serialized projection. Never return an ORM entity directly — that leaks internal columns (audit fields, soft-delete flags, foreign keys) and couples your HTTP contract to your schema.',
-});
-// ─── Validation: ValidationPipe + class-validator ─────────────────────────
-export const NEST11_GLOBAL_VALIDATION_PIPE = ruleSnippet({
-    id: 'nest11.global-validation-pipe',
-    title: 'Global ValidationPipe with whitelist + forbidNonWhitelisted + transform',
-    priority: 'critical',
-    tags: ['nestjs', 'nest-11', 'validation', 'security'],
-    appliesWhen: ['bootstrap'],
-    content: 'main.ts registers a global ValidationPipe: `app.useGlobalPipes(new ValidationPipe({ whitelist: true, forbidNonWhitelisted: true, transform: true, transformOptions: { enableImplicitConversion: true } }))`. whitelist strips unknown properties, forbidNonWhitelisted rejects them, transform turns plain objects into the DTO class so class-validator + class-transformer decorators fire.',
-});
-export const NEST11_CLASS_VALIDATOR_DTO = ruleSnippet({
-    id: 'nest11.class-validator-dto',
-    title: 'DTOs are classes with class-validator decorators',
-    priority: 'critical',
-    tags: ['nestjs', 'nest-11', 'validation', 'dto'],
-    appliesWhen: ['generate-dto'],
-    content: 'Define DTOs as classes (not interfaces) so class-validator can attach metadata. Use @IsString, @IsInt, @IsEmail, @IsUUID, @Length, @Min, @Max, @IsOptional, @IsEnum, @IsArray + @ValidateNested + @Type(() => Inner). Mark optional fields with @IsOptional() + a `?` on the property; the ValidationPipe will skip them when absent.',
-});
-export const NEST11_REQUEST_RESPONSE_DTOS = ruleSnippet({
-    id: 'nest11.request-response-dtos',
-    title: 'Separate request DTOs from response DTOs',
-    priority: 'high',
-    tags: ['nestjs', 'nest-11', 'dto'],
-    appliesWhen: ['generate-dto', 'generate-controller'],
-    content: 'CreateXDto, UpdateXDto, and XResponseDto are distinct classes — even when fields overlap. PartialType(CreateXDto) and PickType / OmitType from @nestjs/mapped-types compose them without duplication. This keeps the input surface (validated) and output surface (serialized) under independent control.',
-});
-export const NEST11_SWAGGER_DECORATORS = ruleSnippet({
-    id: 'nest11.swagger-decorators',
-    title: 'Annotate DTOs with @ApiProperty for OpenAPI',
-    priority: 'medium',
-    tags: ['nestjs', 'nest-11', 'openapi', 'swagger'],
-    appliesWhen: ['generate-dto'],
-    content: 'Pair each class-validator decorator with @ApiProperty / @ApiPropertyOptional from @nestjs/swagger. Set example, description, enum, and type explicitly — Swagger UI is the canonical contract reference for clients.',
-});
-// ─── Async lifecycle + graceful shutdown ──────────────────────────────────
-export const NEST11_LIFECYCLE_HOOKS = ruleSnippet({
-    id: 'nest11.lifecycle-hooks',
-    title: 'Use Nest lifecycle hooks, not raw process events',
-    priority: 'high',
-    tags: ['nestjs', 'nest-11', 'lifecycle'],
-    appliesWhen: ['generate-service'],
-    content: 'Implement OnModuleInit / OnApplicationBootstrap for warm-up, OnModuleDestroy / OnApplicationShutdown for teardown. They run in DI-resolution order, so dependencies of a provider are still live during its destroy hook. Don\'t hook process.on(\'SIGTERM\') directly — Nest already wires it via enableShutdownHooks().',
-});
-export const NEST11_ENABLE_SHUTDOWN_HOOKS = ruleSnippet({
-    id: 'nest11.enable-shutdown-hooks',
-    title: 'Call app.enableShutdownHooks() in main.ts',
-    priority: 'high',
-    tags: ['nestjs', 'nest-11', 'lifecycle'],
-    appliesWhen: ['bootstrap'],
-    content: 'Without enableShutdownHooks() the OnModuleDestroy / OnApplicationShutdown hooks never fire on SIGTERM, leaving connections (DB pools, Kafka clients, etc.) dangling. Call it before app.listen().',
-});
-export const NEST11_ASYNC_PROVIDERS = ruleSnippet({
-    id: 'nest11.async-providers',
-    title: 'Use useFactory for async configuration providers',
-    priority: 'medium',
-    tags: ['nestjs', 'nest-11', 'di'],
-    appliesWhen: ['generate-module'],
-    content: 'Configuration that must be resolved at boot (env, secrets vault, schema generation) goes through `{ provide: TOKEN, useFactory: async (cfg) => …, inject: [ConfigService] }`. Don\'t lazy-load it inside a service\'s onModuleInit — that delays the readiness signal.',
-});
-// ─── Performance: Fastify, cache, throttler, pagination ──────────────────
-export const NEST11_FASTIFY_ADAPTER = ruleSnippet({
-    id: 'nest11.fastify-adapter',
-    title: 'Use the Fastify adapter for high-throughput services',
-    priority: 'high',
-    tags: ['nestjs', 'nest-11', 'performance'],
-    appliesWhen: ['bootstrap'],
-    content: 'NestFactory.create<NestFastifyApplication>(AppModule, new FastifyAdapter()) gives ~2× the RPS of the default Express adapter and matches Nest\'s typed-decorator surface. Only stay on Express if you need a middleware that isn\'t available for Fastify (rare).',
-});
-export const NEST11_CACHE_MANAGER = ruleSnippet({
-    id: 'nest11.cache-manager',
-    title: 'Cache idempotent GETs via @nestjs/cache-manager',
-    priority: 'medium',
-    tags: ['nestjs', 'nest-11', 'performance'],
-    appliesWhen: ['generate-controller', 'optimize'],
-    content: 'Register CacheModule with a TTL appropriate to the data (seconds for hot reads, minutes for slowly-changing references). Decorate idempotent GET endpoints with @UseInterceptors(CacheInterceptor) or inject CACHE_MANAGER for explicit key-based caches. Never cache user-private responses without a per-user key.',
-});
-export const NEST11_THROTTLER = ruleSnippet({
-    id: 'nest11.throttler',
-    title: 'Rate-limit with @nestjs/throttler',
-    priority: 'high',
-    tags: ['nestjs', 'nest-11', 'performance', 'security'],
-    appliesWhen: ['bootstrap', 'generate-controller'],
-    content: 'Register ThrottlerModule globally with sane defaults (e.g. 60 requests / minute / IP), then loosen or tighten per route via @Throttle({ default: { limit, ttl } }) or @SkipThrottle() for internal endpoints. Without throttler a single client can DOS your service trivially.',
-});
-export const NEST11_PAGINATION_BY_DEFAULT = ruleSnippet({
-    id: 'nest11.pagination-by-default',
-    title: 'List endpoints paginate by default',
-    priority: 'high',
-    tags: ['nestjs', 'nest-11', 'performance'],
-    appliesWhen: ['generate-controller'],
-    content: 'Every list endpoint accepts `?page=1&pageSize=20` (or cursor-based) and caps pageSize server-side (e.g. max 100). Returning an unbounded array works on day 1 and dies in week 3 — paginate from the start so the contract never has to break.',
-});
-// ─── Security: helmet, CORS, auth, secrets ────────────────────────────────
-export const NEST11_HELMET = ruleSnippet({
-    id: 'nest11.helmet',
-    title: 'Register helmet for HTTP security headers',
-    priority: 'critical',
-    tags: ['nestjs', 'nest-11', 'security'],
-    appliesWhen: ['bootstrap'],
-    content: 'Add `app.register(helmet)` (Fastify) or `app.use(helmet())` (Express) before any route is mounted. helmet sets X-Content-Type-Options, X-Frame-Options, Strict-Transport-Security, and CSP defaults. Skipping it leaves you on every "missing security header" audit.',
-});
-export const NEST11_EXPLICIT_CORS = ruleSnippet({
-    id: 'nest11.explicit-cors',
-    title: 'CORS allowlist — never `origin: true` in production',
-    priority: 'critical',
-    tags: ['nestjs', 'nest-11', 'security'],
-    appliesWhen: ['bootstrap'],
-    content: 'Configure CORS with an explicit `origin: ["https://app.example.com"]` array (or a function that validates against an allowlist). `origin: true` reflects whatever the request sent — fine for local dev, catastrophic in prod for any cookie-/credential-bearing endpoint.',
-});
-export const NEST11_JWT_GUARDS = ruleSnippet({
-    id: 'nest11.jwt-guards',
-    title: 'Authentication via Guards, not middleware',
-    priority: 'high',
-    tags: ['nestjs', 'nest-11', 'security', 'auth'],
-    appliesWhen: ['generate-controller'],
-    content: 'Auth runs through @nestjs/passport + a JwtAuthGuard (or custom AuthGuard) applied via @UseGuards() at controller or method level. Guards see the full execution context (request, handler metadata) and integrate with @SetMetadata for role-based / permission-based checks. Middleware can\'t do that.',
-});
-export const NEST11_NO_SECRETS_IN_CODE = ruleSnippet({
-    id: 'nest11.no-secrets-in-code',
-    title: 'Secrets come from the env, never from source',
-    priority: 'critical',
-    tags: ['nestjs', 'nest-11', 'security'],
-    appliesWhen: ['generate-code', 'review'],
-    content: 'JWT signing keys, DB passwords, third-party API keys, encryption secrets — all loaded through @nestjs/config (ConfigService.get) from environment variables, .env (local only, in .gitignore), or a vault. A literal secret in a `.ts` file is a CVE waiting for a commit.',
-});
-export const NEST11_TRUST_PROXY_AWARE = ruleSnippet({
-    id: 'nest11.trust-proxy-aware',
-    title: 'Configure trust-proxy when behind a load balancer',
-    priority: 'medium',
-    tags: ['nestjs', 'nest-11', 'security'],
-    appliesWhen: ['bootstrap'],
-    content: 'When the service runs behind an ALB / Cloudflare / nginx, set the trust-proxy option on the adapter so req.ip + X-Forwarded-For resolve correctly. Otherwise throttler keys, audit logs, and rate-limiting all degenerate to the proxy\'s IP.',
-});
-// ─── Observability: Logger, structured logs, terminus ────────────────────
-export const NEST11_LOGGER_WITH_CONTEXT = ruleSnippet({
-    id: 'nest11.logger-with-context',
-    title: 'Logger instances carry a context name',
-    priority: 'high',
-    tags: ['nestjs', 'nest-11', 'observability'],
-    appliesWhen: ['generate-service'],
-    content: 'In each provider, do `private readonly logger = new Logger(MyService.name)`. The context name appears in every log line so filtering by component is trivial. Don\'t share a single Logger instance across the app — you lose the grouping.',
-});
-export const NEST11_STRUCTURED_LOGS = ruleSnippet({
-    id: 'nest11.structured-logs',
-    title: 'JSON-structured logs in production (pino or nest-winston)',
-    priority: 'high',
-    tags: ['nestjs', 'nest-11', 'observability'],
-    appliesWhen: ['bootstrap', 'configure'],
-    content: 'Plug a structured logger (nestjs-pino or nest-winston) and route the Nest Logger through it. Production logs are JSON one-line records that ship cleanly into Loki / CloudWatch / Datadog. The default ConsoleLogger is fine for dev only.',
-});
-export const NEST11_NO_LOG_SECRETS = ruleSnippet({
-    id: 'nest11.no-log-secrets',
-    title: 'Never log secrets, tokens, PII, or full request bodies',
-    priority: 'critical',
-    tags: ['nestjs', 'nest-11', 'observability', 'security'],
-    appliesWhen: ['generate-code', 'review'],
-    content: 'Redact Authorization headers, JWTs, passwords, credit-card numbers, government IDs, and full request/response bodies that may contain user data. Configure the logger redact paths once (pino: redact: [\'req.headers.authorization\', \'body.password\']) so the discipline survives drive-by edits.',
-});
-export const NEST11_TERMINUS_HEALTH = ruleSnippet({
-    id: 'nest11.terminus-health',
-    title: 'Expose /health via @nestjs/terminus with liveness + readiness',
-    priority: 'high',
-    tags: ['nestjs', 'nest-11', 'observability'],
-    appliesWhen: ['generate-controller'],
-    content: 'Use @nestjs/terminus HealthCheckService to compose indicators (db.pingCheck, http.pingCheck, memory.heapCheck). Expose /health/liveness (process is up) AND /health/readiness (deps are reachable) separately — Kubernetes treats them differently. Don\'t return 200 from readiness when the DB is down.',
-});
-// ─── Testing: TestingModule + e2e ────────────────────────────────────────
-export const NEST11_TESTING_MODULE = ruleSnippet({
-    id: 'nest11.testing-module',
-    title: 'Unit tests use Test.createTestingModule + overrideProvider',
-    priority: 'high',
-    tags: ['nestjs', 'nest-11', 'testing'],
-    appliesWhen: ['generate-test'],
-    content: 'Build a TestingModule that imports the module under test, then `overrideProvider(SlowDep).useValue(mock)` for whatever you want to fake. Resolve the unit under test with `module.get(MyService)`. Avoid `new MyService(...)` outside of testing the constructor itself — DI is part of the contract.',
-});
-export const NEST11_E2E_SUPERTEST = ruleSnippet({
-    id: 'nest11.e2e-supertest',
-    title: 'E2E with supertest against the real AppModule',
-    priority: 'high',
-    tags: ['nestjs', 'nest-11', 'testing'],
-    appliesWhen: ['generate-test'],
-    content: 'E2E tests bootstrap a TestingModule from AppModule, build a Nest application, and drive it with supertest (`request(app.getHttpServer()).get(...)`). Override only the truly slow/expensive deps (external HTTP, message brokers); keep the validation pipeline, guards, and interceptors live — that\'s the contract being tested.',
-});
-export const NEST11_TEST_FILE_LAYOUT = ruleSnippet({
-    id: 'nest11.test-file-layout',
-    title: 'Unit specs co-located; e2e under test/',
-    priority: 'medium',
-    tags: ['nestjs', 'nest-11', 'testing'],
-    appliesWhen: ['generate-test'],
-    content: 'Unit specs live next to the unit (`users.service.spec.ts` beside `users.service.ts`). E2E specs live under `test/*.e2e-spec.ts` — Nest\'s default jest-e2e.json glob matches that pattern. Don\'t mix the two; they have different setup costs and different debugging stories.',
-});
-// ─── API design ──────────────────────────────────────────────────────────
-export const NEST11_API_VERSIONING = ruleSnippet({
-    id: 'nest11.api-versioning',
-    title: 'Enable versioning when the contract is consumed externally',
-    priority: 'medium',
-    tags: ['nestjs', 'nest-11', 'api'],
-    appliesWhen: ['bootstrap', 'generate-controller'],
-    content: 'For any service whose API has external consumers, call `app.enableVersioning({ type: VersioningType.URI, defaultVersion: \'1\' })` at bootstrap. Annotate controllers with @Controller({ path: \'users\', version: \'1\' }). Breaking changes ship as v2 alongside v1 — never as a silent overwrite.',
-});
-export const NEST11_NO_QUERY_IN_CONTROLLER = ruleSnippet({
-    id: 'nest11.no-query-in-controller',
-    title: 'Never query the database from a controller',
-    priority: 'high',
-    tags: ['nestjs', 'nest-11', 'architecture'],
-    appliesWhen: ['generate-controller', 'review'],
-    content: 'Repositories are injected into services, not controllers. A controller that imports `Repository<User>` or `prisma.user` directly is on the path to a 600-line "controller that does everything" — back it out into a service.',
-});

package/dist/builtin/react19-presets.d.ts

@@ -1,12 +0,0 @@
-import type { IPreset } from '../model/preset.js';
-export declare const REACT_19_MODERN_COMPONENTS: IPreset;
-export declare const REACT_19_HOOKS_DISCIPLINE: IPreset;
-export declare const REACT_19_ACTIONS_FORMS: IPreset;
-export declare const REACT_19_STATE: IPreset;
-export declare const REACT_19_PERFORMANCE: IPreset;
-export declare const REACT_19_CONCURRENT: IPreset;
-export declare const REACT_19_TESTING: IPreset;
-export declare const REACT_19_RSC: IPreset;
-export declare const REACT_19_MODERN: IPreset;
-export declare const REACT_19_PRESETS: readonly IPreset[];
-//# sourceMappingURL=react19-presets.d.ts.map

package/dist/builtin/react19-presets.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"react19-presets.d.ts","sourceRoot":"","sources":["../../src/builtin/react19-presets.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAmElD,eAAO,MAAM,0BAA0B,EAAE,OAgCvC,CAAC;AAIH,eAAO,MAAM,yBAAyB,EAAE,OA+BtC,CAAC;AAIH,eAAO,MAAM,sBAAsB,EAAE,OA8BnC,CAAC;AAIH,eAAO,MAAM,cAAc,EAAE,OA6B3B,CAAC;AAIH,eAAO,MAAM,oBAAoB,EAAE,OA6BjC,CAAC;AAIH,eAAO,MAAM,mBAAmB,EAAE,OA6BhC,CAAC;AAIH,eAAO,MAAM,gBAAgB,EAAE,OA4B7B,CAAC;AAIH,eAAO,MAAM,YAAY,EAAE,OA6BzB,CAAC;AAIH,eAAO,MAAM,eAAe,EAAE,OA8C5B,CAAC;AAEH,eAAO,MAAM,gBAAgB,EAAE,SAAS,OAAO,EAU7C,CAAC"}

package/dist/builtin/react19-presets.js

@@ -1,299 +0,0 @@
-// React 19+ preset family.
-//
-// Eight presets — seven focused on a single slice of the modernisation
-// surface, one comprehensive `react-19-modern` that composes the rest.
-// Targets HasReact workspaces with weight 11-12 so the recommender
-// prefers these when the workspace is React-based. The existing legacy
-// `frontend-app` (weight 6) stays for projects pinned to it.
-//
-// Each preset's `paths` references the canonical React SPA structure
-// (src/components, src/hooks, src/pages, src/lib) — the init paths
-// advisory annotator flags any of these that don't exist in the live
-// workspace, so RSC-framework users (Next.js app router under app/) see
-// the mismatch immediately.
-import { WorkspaceProfile } from '@shrkcrft/workspace';
-import { definePreset } from "../define/define-preset.js";
-import { COMMON_AGENT_BRIEFING, COMMON_PIPELINE_CONTEXT_ONLY, COMMON_PIPELINE_FEATURE_DEV, COMMON_PIPELINE_UNIT_TEST, COMMON_SAFETY_RULE, OVERVIEW_DOC, REACT_PATH_COMPONENTS, REACT_PATH_HOOKS, REACT_PATH_LIB, REACT_PATH_PAGES, } from "./shared-snippets.js";
-import { REACT19_ASYNC_TRANSITIONS, REACT19_AVOID_PROP_DRILLING, REACT19_CLIENT_STATE_PROPORTIONAL, REACT19_COMPILER_AUTO_MEMO, REACT19_CONTEXT_AS_PROVIDER, REACT19_CUSTOM_HOOK_NAMING, REACT19_DOCUMENT_METADATA, REACT19_EFFECT_CLEANUP, REACT19_FORMS_LIBRARY, REACT19_FORM_ACTIONS, REACT19_FUNCTION_COMPONENTS, REACT19_IMAGE_OPTIMIZATION, REACT19_KEYS_FOR_RESET, REACT19_LAZY_SUSPENSE, REACT19_MSW, REACT19_NO_DERIVED_STATE_IN_EFFECT, REACT19_NO_FETCH_IN_EFFECT, REACT19_NO_REACT_FC, REACT19_PROPS_INTERFACE, REACT19_REF_AS_PROP, REACT19_RULES_OF_HOOKS, REACT19_SELF_CLOSING, REACT19_SERVER_ACTIONS, REACT19_SERVER_COMPONENTS_DEFAULT, REACT19_SERVER_STATE_LIBRARY, REACT19_STABLE_KEYS, REACT19_STREAMING_SSR, REACT19_STRICT_MODE, REACT19_STYLESHEETS_IN_TREE, REACT19_SUSPENSE_BOUNDARIES, REACT19_TEST_BEHAVIOR_NOT_IMPL, REACT19_TESTING_LIBRARY, REACT19_USE_ACTION_STATE, REACT19_USE_CLIENT_BOUNDARY, REACT19_USE_DEFERRED_VALUE, REACT19_USE_EFFECT_FOR_EXTERNAL_SYNC, REACT19_USE_FORM_STATUS, REACT19_USE_HOOK, REACT19_USE_OPTIMISTIC, REACT19_USE_TRANSITION, REACT19_VIRTUALIZE_LISTS, REACT19_VITEST, } from "./react19-snippets.js";
-const REACT19_TAGS = ['react', 'react-19', 'frontend'];
-const REACT19_NEXT_COMMANDS = [
-    'shrk doctor',
-    'shrk task "<task>"',
-    'shrk ci scaffold github-actions --quickstart',
-];
-// ─── 1) Modern component shape ────────────────────────────────────────────
-export const REACT_19_MODERN_COMPONENTS = definePreset({
-    id: 'react-19-modern-components',
-    title: 'React 19 — modern component shape',
-    description: 'Function components only (no class components, no React.FC), props declared as interfaces, ref accepted as a regular prop (no forwardRef in the common case), <Context> rendered as the provider directly, document metadata in the component tree, scoped stylesheets via <link precedence>.',
-    tags: [...REACT19_TAGS, 'components'],
-    appliesTo: [WorkspaceProfile.HasReact, WorkspaceProfile.IsFrontend],
-    weight: 11,
-    includes: {
-        knowledge: [COMMON_AGENT_BRIEFING],
-        rules: [
-            COMMON_SAFETY_RULE,
-            REACT19_FUNCTION_COMPONENTS,
-            REACT19_NO_REACT_FC,
-            REACT19_PROPS_INTERFACE,
-            REACT19_REF_AS_PROP,
-            REACT19_CONTEXT_AS_PROVIDER,
-            REACT19_DOCUMENT_METADATA,
-            REACT19_STYLESHEETS_IN_TREE,
-            REACT19_SELF_CLOSING,
-        ],
-        paths: [REACT_PATH_COMPONENTS, REACT_PATH_HOOKS, REACT_PATH_LIB],
-        templates: [],
-        pipelines: [COMMON_PIPELINE_CONTEXT_ONLY, COMMON_PIPELINE_FEATURE_DEV],
-        docs: {
-            'overview.md': OVERVIEW_DOC('React 19 modern components', 'Function components only. No React.FC, no class components for new code. Props live in interfaces. Refs are regular props. <MyContext value={x}>{children}</MyContext> — no .Provider. Document metadata (<title>, <meta>) renders inside the tree; React hoists it.'),
-        },
-    },
-    recommendedNextCommands: REACT19_NEXT_COMMANDS,
-});
-// ─── 2) Hooks discipline ──────────────────────────────────────────────────
-export const REACT_19_HOOKS_DISCIPLINE = definePreset({
-    id: 'react-19-hooks-discipline',
-    title: 'React 19 — hooks discipline',
-    description: 'Rules of hooks enforced via eslint-plugin-react-hooks (errors, not warnings). useEffect is for external-system sync only — derived state is computed during render, event responses live in handlers, fetches live in a server-state library, state resets are keyed. Custom hooks start with `use` and clean up their subscriptions.',
-    tags: [...REACT19_TAGS, 'hooks'],
-    appliesTo: [WorkspaceProfile.HasReact],
-    weight: 11,
-    includes: {
-        knowledge: [COMMON_AGENT_BRIEFING],
-        rules: [
-            COMMON_SAFETY_RULE,
-            REACT19_RULES_OF_HOOKS,
-            REACT19_USE_EFFECT_FOR_EXTERNAL_SYNC,
-            REACT19_NO_DERIVED_STATE_IN_EFFECT,
-            REACT19_NO_FETCH_IN_EFFECT,
-            REACT19_CUSTOM_HOOK_NAMING,
-            REACT19_EFFECT_CLEANUP,
-            REACT19_KEYS_FOR_RESET,
-        ],
-        paths: [REACT_PATH_HOOKS, REACT_PATH_COMPONENTS],
-        templates: [],
-        pipelines: [COMMON_PIPELINE_CONTEXT_ONLY, COMMON_PIPELINE_FEATURE_DEV],
-        docs: {
-            'overview.md': OVERVIEW_DOC('React 19 hooks discipline', 'Hooks at the top, never conditional. useEffect ONLY for syncing with external systems. Derived values are computed in render. Fetches go through TanStack Query / SWR / RTK Query. State resets use a `key` prop on the consumer, not a useEffect.'),
-        },
-    },
-    recommendedNextCommands: REACT19_NEXT_COMMANDS,
-});
-// ─── 3) Actions + forms (React 19) ────────────────────────────────────────
-export const REACT_19_ACTIONS_FORMS = definePreset({
-    id: 'react-19-actions-forms',
-    title: 'React 19 — Actions, async transitions, optimistic UI',
-    description: 'The React 19 Actions surface: <form action> for submission, useActionState for result + pending + error in one hook, useFormStatus for child-level pending UI, useOptimistic for instant feedback on mutations, use() for promises and contexts in conditionals, async functions passed to startTransition / useTransition.',
-    tags: [...REACT19_TAGS, 'actions', 'forms'],
-    appliesTo: [WorkspaceProfile.HasReact, WorkspaceProfile.IsFrontend],
-    weight: 11,
-    includes: {
-        knowledge: [COMMON_AGENT_BRIEFING],
-        rules: [
-            COMMON_SAFETY_RULE,
-            REACT19_FORM_ACTIONS,
-            REACT19_USE_ACTION_STATE,
-            REACT19_USE_FORM_STATUS,
-            REACT19_USE_OPTIMISTIC,
-            REACT19_USE_HOOK,
-            REACT19_ASYNC_TRANSITIONS,
-        ],
-        paths: [REACT_PATH_COMPONENTS, REACT_PATH_HOOKS],
-        templates: [],
-        pipelines: [COMMON_PIPELINE_CONTEXT_ONLY, COMMON_PIPELINE_FEATURE_DEV],
-        docs: {
-            'overview.md': OVERVIEW_DOC('React 19 Actions', '<form action={async (fd) => ...}> for submission. useActionState owns pending + result. useFormStatus inside form children for spinners. useOptimistic for instant UI on writes. use(promise) inside Suspense. startTransition accepts async functions.'),
-        },
-    },
-    recommendedNextCommands: REACT19_NEXT_COMMANDS,
-});
-// ─── 4) State management — server, client, forms ─────────────────────────
-export const REACT_19_STATE = definePreset({
-    id: 'react-19-state',
-    title: 'React 19 — state management (server, client, forms)',
-    description: 'Server state in TanStack Query / SWR / RTK Query (never useState). Client state in the right shape for its scope: local useState, lifted state for siblings, Context for low-frequency cross-tree, a real store (Zustand / Jotai / RTK) for high-frequency cross-tree. Forms past trivial use React Hook Form + Zod.',
-    tags: [...REACT19_TAGS, 'state'],
-    appliesTo: [WorkspaceProfile.HasReact],
-    weight: 11,
-    includes: {
-        knowledge: [COMMON_AGENT_BRIEFING],
-        rules: [
-            COMMON_SAFETY_RULE,
-            REACT19_SERVER_STATE_LIBRARY,
-            REACT19_CLIENT_STATE_PROPORTIONAL,
-            REACT19_FORMS_LIBRARY,
-            REACT19_AVOID_PROP_DRILLING,
-            REACT19_KEYS_FOR_RESET,
-        ],
-        paths: [REACT_PATH_COMPONENTS, REACT_PATH_HOOKS, REACT_PATH_LIB],
-        templates: [],
-        pipelines: [COMMON_PIPELINE_CONTEXT_ONLY, COMMON_PIPELINE_FEATURE_DEV],
-        docs: {
-            'overview.md': OVERVIEW_DOC('React 19 state', 'Server state belongs in a query library — TanStack Query is the default. Client state is sized to its scope: local / lifted / Context (low-frequency only) / store (high-frequency). Non-trivial forms use React Hook Form + Zod. Long prop-drilling chains are a refactor signal.'),
-        },
-    },
-    recommendedNextCommands: REACT19_NEXT_COMMANDS,
-});
-// ─── 5) Performance — Compiler, lazy, virtualization, images ─────────────
-export const REACT_19_PERFORMANCE = definePreset({
-    id: 'react-19-performance',
-    title: 'React 19 — performance baseline',
-    description: 'React Compiler for automatic memoization (drops most hand-rolled useMemo / useCallback). Route-level code-splitting via React.lazy + Suspense. Virtualization past ~100 visible rows. Stable list keys (never the array index). Image dimensions explicit; lazy by default.',
-    tags: [...REACT19_TAGS, 'performance'],
-    appliesTo: [WorkspaceProfile.HasReact],
-    weight: 11,
-    includes: {
-        knowledge: [COMMON_AGENT_BRIEFING],
-        rules: [
-            COMMON_SAFETY_RULE,
-            REACT19_COMPILER_AUTO_MEMO,
-            REACT19_LAZY_SUSPENSE,
-            REACT19_VIRTUALIZE_LISTS,
-            REACT19_STABLE_KEYS,
-            REACT19_IMAGE_OPTIMIZATION,
-        ],
-        paths: [REACT_PATH_COMPONENTS, REACT_PATH_PAGES],
-        templates: [],
-        pipelines: [COMMON_PIPELINE_CONTEXT_ONLY, COMMON_PIPELINE_FEATURE_DEV],
-        docs: {
-            'overview.md': OVERVIEW_DOC('React 19 performance', 'Turn on the React Compiler (babel-plugin-react-compiler) and stop hand-rolling memo unless the profiler says otherwise. Route boundaries lazy-load. Long lists virtualize. List keys are stable ids, never the array index. Images carry explicit width/height + loading="lazy".'),
-        },
-    },
-    recommendedNextCommands: REACT19_NEXT_COMMANDS,
-});
-// ─── 6) Concurrent rendering ──────────────────────────────────────────────
-export const REACT_19_CONCURRENT = definePreset({
-    id: 'react-19-concurrent',
-    title: 'React 19 — concurrent rendering',
-    description: 'useTransition / startTransition to keep input responsive under slow updates, useDeferredValue (with React 19\'s initialValue) for lagged derived renders, deliberate Suspense-boundary placement for streaming reveal, StrictMode in dev to surface concurrency bugs early.',
-    tags: [...REACT19_TAGS, 'concurrent'],
-    appliesTo: [WorkspaceProfile.HasReact],
-    weight: 11,
-    includes: {
-        knowledge: [COMMON_AGENT_BRIEFING],
-        rules: [
-            COMMON_SAFETY_RULE,
-            REACT19_USE_TRANSITION,
-            REACT19_USE_DEFERRED_VALUE,
-            REACT19_SUSPENSE_BOUNDARIES,
-            REACT19_STRICT_MODE,
-            REACT19_ASYNC_TRANSITIONS,
-        ],
-        paths: [REACT_PATH_COMPONENTS, REACT_PATH_PAGES],
-        templates: [],
-        pipelines: [COMMON_PIPELINE_CONTEXT_ONLY, COMMON_PIPELINE_FEATURE_DEV],
-        docs: {
-            'overview.md': OVERVIEW_DOC('React 19 concurrent rendering', 'Slow updates go through startTransition. Derived expensive views use useDeferredValue. Suspense boundaries are placed where a UI region should reveal together. StrictMode catches missing cleanups and impure renders in dev. React 19: startTransition accepts async functions.'),
-        },
-    },
-    recommendedNextCommands: REACT19_NEXT_COMMANDS,
-});
-// ─── 7) Testing ──────────────────────────────────────────────────────────
-export const REACT_19_TESTING = definePreset({
-    id: 'react-19-testing',
-    title: 'React 19 — Vitest + Testing Library + userEvent + MSW',
-    description: 'Vitest for Vite-based apps, @testing-library/react for rendering + querying, userEvent.setup() for interactions (not fireEvent), MSW for network mocking, behavior-not-implementation as the testing posture.',
-    tags: [...REACT19_TAGS, 'testing'],
-    appliesTo: [WorkspaceProfile.HasReact],
-    weight: 11,
-    includes: {
-        knowledge: [COMMON_AGENT_BRIEFING],
-        rules: [
-            COMMON_SAFETY_RULE,
-            REACT19_VITEST,
-            REACT19_TESTING_LIBRARY,
-            REACT19_TEST_BEHAVIOR_NOT_IMPL,
-            REACT19_MSW,
-        ],
-        paths: [REACT_PATH_COMPONENTS, REACT_PATH_HOOKS],
-        templates: [],
-        pipelines: [COMMON_PIPELINE_CONTEXT_ONLY, COMMON_PIPELINE_UNIT_TEST],
-        docs: {
-            'overview.md': OVERVIEW_DOC('React 19 testing', 'Vitest runs the suite. @testing-library/react queries by role/label/text. userEvent.setup() drives the keyboard + pointer. MSW intercepts fetch at the network. Asserts target what the user sees — not internal hooks or state.'),
-        },
-    },
-    recommendedNextCommands: REACT19_NEXT_COMMANDS,
-});
-// ─── 8) React Server Components (RSC frameworks) ─────────────────────────
-export const REACT_19_RSC = definePreset({
-    id: 'react-19-rsc',
-    title: 'React 19 — Server Components + Server Actions',
-    description: 'For framework-driven fullstack apps (Next.js app router, Remix, Waku): components are Server Components by default; "use client" is pushed to leaf components that actually need interactivity; Server Actions replace manual API routes for mutations; SSR streams through Suspense boundaries.',
-    tags: [...REACT19_TAGS, 'rsc', 'ssr'],
-    appliesTo: [WorkspaceProfile.HasReact, WorkspaceProfile.IsFrontend],
-    weight: 11,
-    includes: {
-        knowledge: [COMMON_AGENT_BRIEFING],
-        rules: [
-            COMMON_SAFETY_RULE,
-            REACT19_SERVER_COMPONENTS_DEFAULT,
-            REACT19_USE_CLIENT_BOUNDARY,
-            REACT19_SERVER_ACTIONS,
-            REACT19_STREAMING_SSR,
-            REACT19_SUSPENSE_BOUNDARIES,
-        ],
-        paths: [REACT_PATH_COMPONENTS, REACT_PATH_PAGES, REACT_PATH_LIB],
-        templates: [],
-        pipelines: [COMMON_PIPELINE_CONTEXT_ONLY, COMMON_PIPELINE_FEATURE_DEV],
-        docs: {
-            'overview.md': OVERVIEW_DOC('React 19 Server Components', 'Server-first by default in RSC frameworks. "use client" lives at the smallest interactive leaf, not the page root. Mutations go through Server Actions ("use server" functions) instead of manual API routes. SSR streams: shell ships first, slow data fills via Suspense.'),
-        },
-    },
-    recommendedNextCommands: REACT19_NEXT_COMMANDS,
-});
-// ─── 9) The whole stack — composes 1-7 ──────────────────────────────────
-export const REACT_19_MODERN = definePreset({
-    id: 'react-19-modern',
-    title: 'React 19 — modern stack (components + hooks + actions + state + perf + concurrent + testing)',
-    description: 'The canonical preset for a new React 19+ app. Composes seven focused presets — components, hooks discipline, Actions, state, performance, concurrent, testing — and leaves RSC opt-in via the separate react-19-rsc preset (only relevant for framework apps).',
-    tags: [...REACT19_TAGS, 'comprehensive'],
-    appliesTo: [WorkspaceProfile.HasReact, WorkspaceProfile.IsFrontend],
-    weight: 12,
-    composes: [
-        'react-19-modern-components',
-        'react-19-hooks-discipline',
-        'react-19-actions-forms',
-        'react-19-state',
-        'react-19-performance',
-        'react-19-concurrent',
-        'react-19-testing',
-    ],
-    includes: {
-        knowledge: [COMMON_AGENT_BRIEFING],
-        rules: [
-            COMMON_SAFETY_RULE,
-            // StrictMode and stable keys are baseline enough to repeat here.
-            REACT19_STRICT_MODE,
-            REACT19_STABLE_KEYS,
-        ],
-        paths: [REACT_PATH_COMPONENTS, REACT_PATH_HOOKS, REACT_PATH_PAGES, REACT_PATH_LIB],
-        templates: [],
-        pipelines: [
-            COMMON_PIPELINE_CONTEXT_ONLY,
-            COMMON_PIPELINE_FEATURE_DEV,
-            COMMON_PIPELINE_UNIT_TEST,
-        ],
-        docs: {
-            'overview.md': OVERVIEW_DOC('React 19 modern stack', 'Function components, no React.FC, ref-as-prop. Hooks at the top, useEffect only for external sync. <form action> + useActionState + useOptimistic for forms. TanStack Query for server state; the right shape for client state. React Compiler does memo for you. Lazy + Suspense for code-split. useTransition / useDeferredValue under load. Vitest + Testing Library + userEvent + MSW. Add react-19-rsc if the project is on a Server Components framework.'),
-        },
-    },
-    recommendedNextCommands: [
-        'shrk doctor',
-        'shrk surface list',
-        'shrk task "<task>"',
-        'shrk presets get react-19-rsc   # add this preset if using Next.js / Remix / Waku',
-    ],
-    surfaceProfile: 'small-app',
-});
-export const REACT_19_PRESETS = Object.freeze([
-    REACT_19_MODERN_COMPONENTS,
-    REACT_19_HOOKS_DISCIPLINE,
-    REACT_19_ACTIONS_FORMS,
-    REACT_19_STATE,
-    REACT_19_PERFORMANCE,
-    REACT_19_CONCURRENT,
-    REACT_19_TESTING,
-    REACT_19_RSC,
-    REACT_19_MODERN,
-]);

package/dist/builtin/react19-snippets.d.ts

@@ -1,43 +0,0 @@
-export declare const REACT19_FUNCTION_COMPONENTS: string;
-export declare const REACT19_NO_REACT_FC: string;
-export declare const REACT19_PROPS_INTERFACE: string;
-export declare const REACT19_REF_AS_PROP: string;
-export declare const REACT19_CONTEXT_AS_PROVIDER: string;
-export declare const REACT19_DOCUMENT_METADATA: string;
-export declare const REACT19_STYLESHEETS_IN_TREE: string;
-export declare const REACT19_SELF_CLOSING: string;
-export declare const REACT19_RULES_OF_HOOKS: string;
-export declare const REACT19_USE_EFFECT_FOR_EXTERNAL_SYNC: string;
-export declare const REACT19_NO_DERIVED_STATE_IN_EFFECT: string;
-export declare const REACT19_NO_FETCH_IN_EFFECT: string;
-export declare const REACT19_CUSTOM_HOOK_NAMING: string;
-export declare const REACT19_EFFECT_CLEANUP: string;
-export declare const REACT19_FORM_ACTIONS: string;
-export declare const REACT19_USE_ACTION_STATE: string;
-export declare const REACT19_USE_FORM_STATUS: string;
-export declare const REACT19_USE_OPTIMISTIC: string;
-export declare const REACT19_USE_HOOK: string;
-export declare const REACT19_ASYNC_TRANSITIONS: string;
-export declare const REACT19_SERVER_STATE_LIBRARY: string;
-export declare const REACT19_CLIENT_STATE_PROPORTIONAL: string;
-export declare const REACT19_FORMS_LIBRARY: string;
-export declare const REACT19_AVOID_PROP_DRILLING: string;
-export declare const REACT19_KEYS_FOR_RESET: string;
-export declare const REACT19_COMPILER_AUTO_MEMO: string;
-export declare const REACT19_LAZY_SUSPENSE: string;
-export declare const REACT19_VIRTUALIZE_LISTS: string;
-export declare const REACT19_STABLE_KEYS: string;
-export declare const REACT19_IMAGE_OPTIMIZATION: string;
-export declare const REACT19_USE_TRANSITION: string;
-export declare const REACT19_USE_DEFERRED_VALUE: string;
-export declare const REACT19_SUSPENSE_BOUNDARIES: string;
-export declare const REACT19_STRICT_MODE: string;
-export declare const REACT19_VITEST: string;
-export declare const REACT19_TESTING_LIBRARY: string;
-export declare const REACT19_TEST_BEHAVIOR_NOT_IMPL: string;
-export declare const REACT19_MSW: string;
-export declare const REACT19_SERVER_COMPONENTS_DEFAULT: string;
-export declare const REACT19_USE_CLIENT_BOUNDARY: string;
-export declare const REACT19_SERVER_ACTIONS: string;
-export declare const REACT19_STREAMING_SSR: string;
-//# sourceMappingURL=react19-snippets.d.ts.map

package/dist/builtin/react19-snippets.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"react19-snippets.d.ts","sourceRoot":"","sources":["../../src/builtin/react19-snippets.ts"],"names":[],"mappings":"AAuBA,eAAO,MAAM,2BAA2B,QAQtC,CAAC;AAEH,eAAO,MAAM,mBAAmB,QAQ9B,CAAC;AAEH,eAAO,MAAM,uBAAuB,QAQlC,CAAC;AAEH,eAAO,MAAM,mBAAmB,QAQ9B,CAAC;AAEH,eAAO,MAAM,2BAA2B,QAQtC,CAAC;AAEH,eAAO,MAAM,yBAAyB,QAQpC,CAAC;AAEH,eAAO,MAAM,2BAA2B,QAQtC,CAAC;AAEH,eAAO,MAAM,oBAAoB,QAQ/B,CAAC;AAIH,eAAO,MAAM,sBAAsB,QAQjC,CAAC;AAEH,eAAO,MAAM,oCAAoC,QAQ/C,CAAC;AAEH,eAAO,MAAM,kCAAkC,QAQ7C,CAAC;AAEH,eAAO,MAAM,0BAA0B,QAQrC,CAAC;AAEH,eAAO,MAAM,0BAA0B,QAQrC,CAAC;AAEH,eAAO,MAAM,sBAAsB,QAQjC,CAAC;AAIH,eAAO,MAAM,oBAAoB,QAQ/B,CAAC;AAEH,eAAO,MAAM,wBAAwB,QAQnC,CAAC;AAEH,eAAO,MAAM,uBAAuB,QAQlC,CAAC;AAEH,eAAO,MAAM,sBAAsB,QAQjC,CAAC;AAEH,eAAO,MAAM,gBAAgB,QAQ3B,CAAC;AAEH,eAAO,MAAM,yBAAyB,QAQpC,CAAC;AAIH,eAAO,MAAM,4BAA4B,QAQvC,CAAC;AAEH,eAAO,MAAM,iCAAiC,QAQ5C,CAAC;AAEH,eAAO,MAAM,qBAAqB,QAQhC,CAAC;AAEH,eAAO,MAAM,2BAA2B,QAQtC,CAAC;AAEH,eAAO,MAAM,sBAAsB,QAQjC,CAAC;AAIH,eAAO,MAAM,0BAA0B,QAQrC,CAAC;AAEH,eAAO,MAAM,qBAAqB,QAQhC,CAAC;AAEH,eAAO,MAAM,wBAAwB,QAQnC,CAAC;AAEH,eAAO,MAAM,mBAAmB,QAQ9B,CAAC;AAEH,eAAO,MAAM,0BAA0B,QAQrC,CAAC;AAIH,eAAO,MAAM,sBAAsB,QAQjC,CAAC;AAEH,eAAO,MAAM,0BAA0B,QAQrC,CAAC;AAEH,eAAO,MAAM,2BAA2B,QAQtC,CAAC;AAEH,eAAO,MAAM,mBAAmB,QAQ9B,CAAC;AAIH,eAAO,MAAM,cAAc,QAQzB,CAAC;AAEH,eAAO,MAAM,uBAAuB,QAQlC,CAAC;AAEH,eAAO,MAAM,8BAA8B,QAQzC,CAAC;AAEH,eAAO,MAAM,WAAW,QAQtB,CAAC;AAIH,eAAO,MAAM,iCAAiC,QAQ5C,CAAC;AAEH,eAAO,MAAM,2BAA2B,QAQtC,CAAC;AAEH,eAAO,MAAM,sBAAsB,QAQjC,CAAC;AAEH,eAAO,MAAM,qBAAqB,QAQhC,CAAC"}