@xylabs/ts-scripts-yarn3 7.4.4 → 7.4.6

package/templates/rules/xylabs-naming.md

@@ -0,0 +1,10 @@
+# XY Labs - Naming Conventions
+
+> Auto-managed by `yarn xy claude-rules`. Do not edit manually.
+
+- Files: camelCase for modules (`myModule.ts`), PascalCase for components/classes (`MyComponent.tsx`)
+- Variables/functions: camelCase
+- Classes/interfaces/types: PascalCase
+- Constants: UPPER_SNAKE_CASE (e.g. `MAX_RETRIES`, `DEFAULT_TIMEOUT`)
+- Boolean variables: prefix with `is`, `has`, `should`, `can` (e.g. `isReady`, `hasError`)
+- Event handlers: prefix with `on` (e.g. `onClick`, `onSubmit`)

package/templates/rules/xylabs-style.md

@@ -0,0 +1,22 @@
+# XY Labs - Style & Formatting
+
+> Auto-managed by `yarn xy claude-rules`. Do not edit manually.
+
+- Use TypeScript strict mode for all source files
+- Use ESM (`import`/`export`) exclusively - never use CommonJS (`require`/`module.exports`)
+- Prefer `const` over `let`; never use `var`
+- Use standard `function` declarations for all top-level functions, even short ones (e.g. `export function foo() { ... }`)
+- Use arrow functions only for callbacks, inline arguments, and closures
+- Use explicit return types on exported functions
+- Use `interface` over `type` for object shapes when possible
+- Prefer named exports over default exports
+- Use template literals over string concatenation
+- Use optional chaining (`?.`) and nullish coalescing (`??`) over manual checks
+- Keep files focused and small - prefer many small files over few large ones
+- Use `index.ts` barrel files for clean re-exports from directories
+- No unused imports or variables - the linter will catch these
+- Use default imports for Node.js built-in modules: `import PATH from 'node:path'`, `import FS from 'node:fs'` — not named imports like `import { resolve } from 'node:path'` (enforced by `unicorn/import-style`)
+- String quotes: single quotes for code, backticks for interpolation
+- Trailing commas: always (ES5+)
+- Semicolons: never (rely on ASI)
+- Indent with 2 spaces

package/templates/rules/xylabs-typescript.md

@@ -0,0 +1,11 @@
+# XY Labs - TypeScript Specifics
+
+> Auto-managed by `yarn xy claude-rules`. Do not edit manually.
+
+- Enable `strict: true` in all tsconfig files
+- Avoid `any` - use `unknown` when the type is truly unknown
+- Avoid type assertions (`as`) - prefer type guards and narrowing
+- Use `satisfies` for type checking without widening
+- Prefer `Record<string, T>` over index signatures
+- Use discriminated unions for state machines and variant types
+- When a function uses `await`, its return type must be `Promise<T>` — never `Promise<Promisable<T>>`. If converting a `Promisable<T>` return type to async, replace it with `Promise<T>`, do not wrap it