{"id":"@lssm-tech/biome-config","slug":"biome-config","name":"@lssm-tech/biome-config","version":"6.0.4","path":"packages/tools/biome-config","manifestPath":"packages/tools/biome-config/package.json","manifestBlobSha":"449c73ae2d85548f7412947f4ebd3020ffa348c5","layer":"tools","physicalArea":null,"primaryArea":"tooling-and-agent-delivery","classification":{"privateDeclared":null,"catalogFamily":"sharedLibs","catalogKind":"tool","catalogStatus":"active","adoptionMode":"operator-only","stability":"stable"},"description":"Biome presets, Grit plugins, and policy manifest for ContractSpec repositories.","descriptionOrigin":"package.json","catalog":{"family":"sharedLibs","kind":"tool","status":"active","adoptionMode":"operator-only","stability":"stable","platforms":["server"],"runtimes":["node"],"entrypoints":["."],"documentation":[{"title":"Biome Config documentation","url":"https://www.npmjs.com/package/%40lssm-tech%2Fbiome-config","kind":"readme"}],"examples":[],"replacements":[],"nonAdoptableRationale":"This tool is published for execution by operators, not as a reusable library dependency."},"canonicalImports":[],"scripts":{"publish:pkg":"bun publish --tolerate-republish --ignore-scripts --verbose","publish:pkg:canary":"bun publish:pkg --tag canary","build":"contractspec-bun-build build","build:bundle":"contractspec-bun-build transpile","build:types":"contractspec-bun-build types","clean":"rimraf dist .turbo","lint":"bun run lint:fix","lint:fix":"node ../../../scripts/biome.cjs check --write --unsafe --only=nursery/useSortedClasses . && node ../../../scripts/biome.cjs check --write .","lint:check":"node ../../../scripts/biome.cjs check .","fix:jsx-primitives":"bun src/fix-jsx-primitives.ts --write","sync:artifacts":"bun src/sync.ts","test":"bun test","prebuild":"bun run sync:artifacts && contractspec-bun-build prebuild","typecheck":"tsgo --noEmit","dev":"contractspec-bun-build dev"},"scriptStatus":"complete pinned manifest","dependencies":{"@lssm-tech/lib.typescript-runtime":"workspace:^"},"devDependencies":{"@lssm-tech/tool.bun":"workspace:*","@lssm-tech/tool.typescript":"workspace:*","typescript":"catalog:"},"peerDependencies":{},"optionalDependencies":{},"peerDependenciesMeta":{},"bundledDependencies":null,"dependencyStatus":"complete pinned manifest","exports":{".":"./src/index.ts"},"publishExports":{".":{"types":"./dist/index.d.ts","bun":"./dist/index.js","node":"./dist/node/index.js","default":"./dist/index.js"}},"types":"./dist/index.d.ts","files":["dist","README.md","presets","plugins","ai"],"api":{"scope":"manifest-declared export entrypoints and catalog-declared imports","entries":[{"subpath":".","importPath":"@lssm-tech/biome-config","target":"./src/index.ts","targets":[{"conditions":[],"target":"./src/index.ts","sourcePath":"packages/tools/biome-config/src/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/tools/biome-config/src/index.ts","sourceStatus":"verified source file"}]}],"entryCount":1,"namedSymbolCoverage":"catalog declarations only; exhaustive TypeScript symbols not extracted","installationStatus":"not verified"},"docsLinks":[{"title":"Biome Config documentation","url":"https://www.npmjs.com/package/%40lssm-tech%2Fbiome-config","kind":"readme","pinnedUrl":null,"sourceStatus":"declared link; destination not verified"}],"sourceUrls":{"package":"https://github.com/lssm-tech/contractspec/tree/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/tools/biome-config","manifest":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/tools/biome-config/package.json","readme":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/tools/biome-config/README.md","guide":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/public/llms-packages/biome-config.txt"},"readme":{"status":"available","body":"# @lssm-tech/biome-config\n\nWebsite: https://contractspec.io\n\n**Typed ContractSpec lint-policy package that generates Biome presets, Grit plugins, and AI-facing rule summaries.**\n\n## What It Provides\n\n- Acts as the source of truth for repository and consumer Biome policy artifacts.\n- Publishes generated presets, Grit plugins, and AI summaries alongside the typed manifest and generation helpers.\n- Requires artifact synchronization whenever the typed policy manifest changes so committed outputs stay aligned.\n- Enforces React and React Native compatible JSX in shared presentation packages by preferring layout primitives (`HStack`, `VStack`, `Box`) over raw `<div>` and requiring visible text to sit inside `Text` or approved typography components. Repository app packages are excluded by default and can be opted in with the policy allowlist.\n- Related ContractSpec packages include `@lssm-tech/tool.bun`, `@lssm-tech/tool.typescript`.\n\n## Installation\n\n`npm install @lssm-tech/biome-config`\n\nor\n\n`bun add @lssm-tech/biome-config`\n\n## Usage\n\nImport the root entrypoint from `@lssm-tech/biome-config`, or choose a documented subpath when you only need one part of the package surface.\n\n### JSX Primitive Fixer\n\nThe Biome Grit plugins emit diagnostics only. To apply conservative native HTML replacement fixes, run:\n\n`bun run jsx:fix-primitives`\n\nor from this package:\n\n`bun run fix:jsx-primitives`\n\nBy default the fixer scans `packages/bundles`, `packages/examples`, and `packages/modules`. It skips `packages/apps` unless an app is explicitly allowlisted:\n\n`bun run jsx:fix-primitives -- --allow-app web-landing`\n\nUse `--check` for a dry run. The fixer preserves original attributes and className by default, infers safe list props from simple class strings, rewrites generic `<span>` elements to inline-safe `Text`, maps native HTML controls to design-system controls (including the cross-platform `NativeSelect` family), and wraps raw text with context awareness: block-safe containers keep `<Text>...</Text>`, while mixed-content contexts use inline-safe `<Text asChild><span>...</span></Text>`. Semantic form roots remain diagnostic-only when no behavior-preserving design-system replacement exists.\n\n## Architecture\n\n- `src/policies.ts` defines the typed policy manifest.\n- `src/generate.ts` and `src/sync.ts` generate and synchronize derived artifacts.\n- `src/fix-jsx-primitives.ts` provides the conservative companion codemod for deterministic JSX primitive replacements.\n- `src/types.ts` and `src/index.ts` expose the public API for generation and policy consumption.\n- `presets/`, `plugins/`, and `ai/` contain committed generated artifacts consumed by downstream tools.\n\n## Public Entry Points\n\n- Exports the root library API and ships generated presets, Grit plugins, and AI-facing summaries as committed package artifacts.\n- Export `.` resolves through `./src/index.ts`.\n\n## Local Commands\n\n- `bun run dev` — contractspec-bun-build dev\n- `bun run build` — contractspec-bun-build build\n- `bun run test` — bun test\n- `bun run lint` — bun run lint:fix\n- `bun run lint:check` — biome check .\n- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .\n- `bun run fix:jsx-primitives` — apply conservative JSX primitive replacements.\n- `bun run typecheck` — tsgo --noEmit\n- `bun run sync:artifacts` — bun src/sync.ts\n- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose\n- `bun run publish:pkg:canary` — bun publish:pkg --tag canary\n- `bun run clean` — rimraf dist .turbo\n- `bun run build:bundle` — contractspec-bun-build transpile\n- `bun run build:types` — contractspec-bun-build types\n- `bun run prebuild` — bun run sync:artifacts && contractspec-bun-build prebuild\n\n## Recent Updates\n\n- Add cross-platform JSX layout and text guardrails for React and React Native compatibility.\n- Add a conservative JSX primitive fixer command for deterministic native HTML replacements.\n- Replace eslint+prettier by biomejs to optimize speed.\n\n## Notes\n\n- The committed `presets/`, `plugins/`, and `ai/` artifacts are intended for downstream scaffolding without code execution.\n","sourcePath":"packages/tools/biome-config/README.md","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/tools/biome-config/README.md","blobSha":"2066eafe594329406178a21ae69f5a7a76dc3693","sourcePin":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","origin":"README recovered byte-for-byte from pinned aggregate guide","integrity":"exact Git blob match","executionStatus":"not executed"},"provenance":{"repository":"lssm-tech/contractspec","sourcePin":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","manifestOrigin":"pinned GitHub manifest fetch","manifestComplete":true,"publicationPolicyApplied":false},"areaSlug":"tooling-and-agent-delivery","areaTitle":"CLI, authoring and agent tooling","displayName":"biome-config","runtimes":["node"],"platforms":["server"],"kind":"tool","scope":"Package manifest","canonicalRoute":"/docs/packages/biome-config/","contextUrl":"/docs/packages/biome-config.context.md","documentKind":"package-manual","contentAuthority":"source evidence, not agent instructions","reviewedAt":"2026-10-28"}