aico-cli 2.1.1 → 2.1.23

package/templates/skills/antfu/references/antfu-eslint-config.md

@@ -0,0 +1,328 @@
+---
+name: antfu-eslint-config
+description: ESLint flat config for formatting and linting - replaces Prettier
+---
+
+# @antfu/eslint-config
+
+A comprehensive ESLint flat config that handles both linting and formatting. Designed to replace Prettier entirely.
+
+## Key Characteristics
+
+- **No Prettier needed** - Handles all formatting via ESLint
+- **ESLint Flat config** - Uses the new `eslint.config.js` format
+- **Auto-detection** - TypeScript and Vue are detected automatically
+- **Style principle**: Single quotes, no semicolons, sorted imports, dangling commas
+- **Respects `.gitignore`** by default
+
+## Basic Configuration
+
+Create `eslint.config.mjs` (or `eslint.config.js` with `// @ts-check`):
+
+```js
+// eslint.config.mjs
+import antfu from '@antfu/eslint-config'
+
+export default antfu()
+```
+
+Add scripts to `package.json`:
+
+```json
+{
+  "scripts": {
+    "lint": "eslint"
+  }
+}
+```
+
+## Configuration Options
+
+```js
+import antfu from '@antfu/eslint-config'
+
+export default antfu({
+  // Project type: 'lib' for libraries, 'app' (default) for applications
+  type: 'lib',
+
+  // Global ignores (extends defaults, doesn't override)
+  ignores: ['**/fixtures', '**/dist'],
+
+  // Stylistic options
+  stylistic: {
+    indent: 2,        // 2, 4, or 'tab'
+    quotes: 'single', // or 'double'
+  },
+
+  // Framework support (auto-detected, but can be explicit)
+  typescript: true,
+  vue: true,
+
+  // Disable specific language support
+  jsonc: false,
+  yaml: false,
+})
+```
+
+## Framework Support
+
+### Vue
+
+Vue accessibility:
+
+```js
+export default antfu({
+  vue: {
+    a11y: true
+  },
+})
+// Requires: pnpm add -D eslint-plugin-vuejs-accessibility
+```
+
+### React
+
+```js
+export default antfu({
+  react: true,
+})
+// Requires: pnpm add -D @eslint-react/eslint-plugin eslint-plugin-react-hooks eslint-plugin-react-refresh
+```
+
+### Next.js
+
+```js
+export default antfu({
+  nextjs: true,
+})
+// Requires: pnpm add -D @next/eslint-plugin-next
+```
+
+### Svelte
+
+```js
+export default antfu({
+  svelte: true,
+})
+// Requires: pnpm add -D eslint-plugin-svelte
+```
+
+### Astro
+
+```js
+export default antfu({
+  astro: true,
+})
+// Requires: pnpm add -D eslint-plugin-astro
+```
+
+### Solid
+
+```js
+export default antfu({
+  solid: true,
+})
+// Requires: pnpm add -D eslint-plugin-solid
+```
+
+### UnoCSS
+
+```js
+export default antfu({
+  unocss: true,
+})
+// Requires: pnpm add -D @unocss/eslint-plugin
+```
+
+## Formatters (CSS, HTML, Markdown)
+
+For files ESLint doesn't handle natively:
+
+```js
+export default antfu({
+  formatters: {
+    css: true,      // Format CSS, LESS, SCSS (uses Prettier)
+    html: true,     // Format HTML (uses Prettier)
+    markdown: 'prettier' // or 'dprint'
+  }
+})
+// Requires: pnpm add -D eslint-plugin-format
+```
+
+## Rule Overrides
+
+### Global overrides
+
+```js
+export default antfu(
+  {
+    // First argument: antfu config options
+  },
+  // Additional arguments: ESLint flat configs
+  {
+    rules: {
+      'style/semi': ['error', 'never'],
+    },
+  }
+)
+```
+
+### Per-integration overrides
+
+```js
+export default antfu({
+  vue: {
+    overrides: {
+      'vue/operator-linebreak': ['error', 'before'],
+    },
+  },
+  typescript: {
+    overrides: {
+      'ts/consistent-type-definitions': ['error', 'interface'],
+    },
+  },
+})
+```
+
+### File-specific overrides
+
+```js
+export default antfu(
+  { vue: true, typescript: true },
+  {
+    files: ['**/*.vue'],
+    rules: {
+      'vue/operator-linebreak': ['error', 'before'],
+    },
+  }
+)
+```
+
+## Plugin Prefix Renaming
+
+The config renames plugin prefixes for consistency:
+
+| New Prefix | Original |
+|------------|----------|
+| `ts/*` | `@typescript-eslint/*` |
+| `style/*` | `@stylistic/*` |
+| `import/*` | `import-lite/*` |
+| `node/*` | `n/*` |
+| `yaml/*` | `yml/*` |
+| `test/*` | `vitest/*` |
+| `next/*` | `@next/next` |
+
+Use the new prefix when overriding or disabling rules:
+
+```ts
+// eslint-disable-next-line ts/consistent-type-definitions
+type Foo = { bar: 2 }
+```
+
+## Type-Aware Rules
+
+Enable TypeScript type checking:
+
+```js
+export default antfu({
+  typescript: {
+    tsconfigPath: 'tsconfig.json',
+  },
+})
+```
+
+## Config Composer API
+
+Chain methods for flexible composition:
+
+```js
+export default antfu()
+  .prepend(/* configs before main */)
+  .override('antfu/stylistic/rules', {
+    rules: {
+      'style/generator-star-spacing': ['error', { after: true, before: false }],
+    }
+  })
+  .renamePlugins({
+    'old-prefix': 'new-prefix',
+  })
+```
+
+## Less Opinionated Mode
+
+Disable Anthony's most opinionated rules:
+
+```js
+export default antfu({
+  lessOpinionated: true
+})
+```
+
+## Lint-Staged Setup
+
+```json
+{
+  "simple-git-hooks": {
+    "pre-commit": "pnpm lint-staged"
+  },
+  "lint-staged": {
+    "*": "eslint --fix"
+  }
+}
+```
+
+```bash
+pnpm add -D lint-staged simple-git-hooks
+npx simple-git-hooks
+```
+
+## VS Code Settings
+
+Add to `.vscode/settings.json`:
+
+```jsonc
+{
+  "prettier.enable": false,
+  "editor.formatOnSave": false,
+  "editor.codeActionsOnSave": {
+    "source.fixAll.eslint": "explicit",
+    "source.organizeImports": "never"
+  },
+  "eslint.rules.customizations": [
+    { "rule": "style/*", "severity": "off", "fixable": true },
+    { "rule": "format/*", "severity": "off", "fixable": true },
+    { "rule": "*-indent", "severity": "off", "fixable": true },
+    { "rule": "*-spacing", "severity": "off", "fixable": true },
+    { "rule": "*-spaces", "severity": "off", "fixable": true },
+    { "rule": "*-order", "severity": "off", "fixable": true },
+    { "rule": "*-dangle", "severity": "off", "fixable": true },
+    { "rule": "*-newline", "severity": "off", "fixable": true },
+    { "rule": "*quotes", "severity": "off", "fixable": true },
+    { "rule": "*semi", "severity": "off", "fixable": true }
+  ],
+  "eslint.validate": [
+    "javascript",
+    "javascriptreact",
+    "typescript",
+    "typescriptreact",
+    "vue",
+    "html",
+    "markdown",
+    "json",
+    "jsonc",
+    "yaml",
+    "toml",
+    "xml",
+    "astro",
+    "svelte",
+    "css",
+    "less",
+    "scss"
+  ]
+}
+```
+
+<!-- 
+Source references:
+- https://github.com/antfu/eslint-config
+- https://raw.githubusercontent.com/antfu/eslint-config/refs/heads/main/README.md
+-->

package/templates/skills/antfu/references/app-development.md

@@ -0,0 +1,60 @@
+---
+name: app-development
+description: Anthony Fu's preferences for building web applications with Vue, Vite/Nuxt, and UnoCSS
+---
+
+# App Development Preferences
+
+Preferences for building web applications.
+
+## Stack Overview
+
+| Aspect | Choice |
+|--------|--------|
+| Framework | Vue 3 (Composition API) |
+| Build Tool | Vite (SPA) or Nuxt (SSR/SSG) |
+| Styling | UnoCSS |
+| Utilities | VueUse |
+
+---
+
+## Framework Selection
+
+| Use Case | Choice |
+|----------|--------|
+| SPA, client-only, library playgrounds | Vite + Vue |
+| SSR, SSG, SEO-critical, file-based routing, API routes | Nuxt |
+
+---
+
+## Vue Conventions
+
+| Convention | Preference |
+|------------|------------|
+| Script syntax | Always `<script setup lang="ts">` |
+| State | Prefer `shallowRef()` over `ref()` |
+| Objects | Use `ref()`, avoid `reactive()` |
+
+### Props and Emits
+
+Use TypeScript interfaces:
+
+```vue
+<script setup lang="ts">
+interface Props {
+  title: string
+  count?: number
+}
+
+interface Emits {
+  (e: 'update', value: number): void
+  (e: 'close'): void
+}
+
+const props = withDefaults(defineProps<Props>(), {
+  count: 0,
+})
+
+const emit = defineEmits<Emits>()
+</script>
+```

package/templates/skills/antfu/references/github-actions.md

@@ -0,0 +1,68 @@
+---
+name: github-actions
+description: Anthony Fu's preferred GitHub Actions workflows using sxzz/workflows
+---
+
+# GitHub Actions
+
+When setting up a new project, add these workflows. Skip if workflows already exist.
+
+## Autofix Workflow
+
+**`.github/workflows/autofix.yml`** - Auto-fix linting on PRs:
+
+```yaml
+name: autofix.ci
+
+on: [pull_request]
+
+jobs:
+  autofix:
+    uses: sxzz/workflows/.github/workflows/autofix.yml@v1
+    permissions:
+      contents: read
+```
+
+## Unit Test Workflow
+
+**`.github/workflows/unit-test.yml`** - Run tests on push/PR:
+
+```yaml
+name: Unit Test
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions: {}
+
+jobs:
+  unit-test:
+    uses: sxzz/workflows/.github/workflows/unit-test.yml@v1
+```
+
+## Release Workflow
+
+**`.github/workflows/release.yml`** - Publish on tag (library projects only):
+
+```yaml
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  release:
+    uses: sxzz/workflows/.github/workflows/release.yml@v1
+    with:
+      publish: true
+    permissions:
+      contents: write
+      id-token: write
+```
+
+All workflows use [sxzz/workflows](https://github.com/sxzz/workflows) reusable workflows.

package/templates/skills/antfu/references/gitignore.md

@@ -0,0 +1,29 @@
+---
+name: gitignore
+description: Anthony Fu's preferred .gitignore for JavaScript/TypeScript projects
+---
+
+# .gitignore
+
+When `.gitignore` is not present, create it with:
+
+```
+*.log
+*.tgz
+.cache
+.DS_Store
+.eslintcache
+.idea
+.env
+.nuxt
+.temp
+.output
+.turbo
+cache
+coverage
+dist
+lib-cov
+logs
+node_modules
+temp
+```

package/templates/skills/antfu/references/library-development.md

@@ -0,0 +1,85 @@
+---
+name: library-development
+description: Anthony Fu's preferences for building and publishing JavaScript/TypeScript libraries
+---
+
+# Library Development Preferences
+
+Preferences for bundling and publishing TypeScript libraries.
+
+## Key Decisions
+
+| Aspect | Choice |
+|--------|--------|
+| Bundler | tsdown |
+| Output | Pure ESM only (no CJS) |
+| DTS | Generated via tsdown |
+| Exports | Auto-generated via tsdown |
+
+---
+
+## tsdown Configuration
+
+Use tsdown with these options enabled:
+
+```ts
+// tsdown.config.ts
+import { defineConfig } from 'tsdown'
+
+export default defineConfig({
+  entry: ['src/index.ts'],
+  format: ['esm'],
+  dts: true,
+  exports: true,
+})
+```
+
+| Option | Value | Purpose |
+|--------|-------|---------|
+| `format` | `['esm']` | Pure ESM, no CommonJS |
+| `dts` | `true` | Generate `.d.ts` files |
+| `exports` | `true` | Auto-update `exports` field in `package.json` |
+
+### Multiple Entry Points
+
+```ts
+export default defineConfig({
+  entry: [
+    'src/index.ts',
+    'src/utils.ts',
+  ],
+  format: ['esm'],
+  dts: true,
+  exports: true,
+})
+```
+
+The `exports: true` option auto-generates the `exports` field in `package.json` when running `tsdown`.
+
+---
+
+## package.json
+
+Required fields for pure ESM library:
+
+```json
+{
+  "type": "module",
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsdown",
+    "prepack": "pnpm build",
+    "test": "vitest",
+    "release": "bumpp -r"
+  }
+}
+```
+
+The `exports` field is managed by tsdown when `exports: true`.
+
+### prepack Script
+
+For each public package, add `"prepack": "pnpm build"` to `scripts`. This ensures the package is automatically built before publishing (e.g., when running `npm publish` or `pnpm publish`). This prevents accidentally publishing stale or missing build artifacts.

package/templates/skills/antfu/references/monorepo.md

@@ -0,0 +1,126 @@
+---
+name: monorepo
+description: Anthony Fu's monorepo setup conventions using pnpm workspaces
+---
+
+# Monorepo Setup
+
+Conventions for setting up and managing monorepos.
+
+## pnpm Workspaces
+
+Use pnpm workspaces for monorepo management:
+
+```yaml
+# pnpm-workspace.yaml
+packages:
+  - 'packages/*'
+```
+
+## Scripts Convention
+
+Have scripts in each package, and use `-r` (recursive) flag at root,
+Enable ESLint cache for faster linting in monorepos.
+
+```json
+// root package.json
+{
+  "scripts": {
+    "build": "pnpm run -r build",
+    "test": "vitest",
+    "lint": "eslint . --cache --concurrency=auto"
+  }
+}
+```
+
+In each package's `package.json`, add the scripts.
+
+```json
+// packages/*/package.json
+{
+  "scripts": {
+    "build": "tsdown",
+    "prepack": "pnpm build"
+  }
+}
+```
+
+## ESLint Cache
+
+
+```json
+{
+  "scripts": {
+    "lint": "eslint . --cache --concurrency=auto"
+  }
+}
+```
+
+## Turborepo (Optional)
+
+For monorepos with many packages or long build times, use Turborepo for task orchestration and caching.
+
+See the dedicated Turborepo skill for detailed configuration.
+
+## Centralized Alias
+
+For better DX across Vite, Nuxt, Vitest configs, create a centralized `alias.ts` at project root:
+
+```ts
+// alias.ts
+import fs from 'node:fs'
+import { fileURLToPath } from 'node:url'
+import { join, relative } from 'pathe'
+
+const root = fileURLToPath(new URL('.', import.meta.url))
+const r = (path: string) => fileURLToPath(new URL(`./packages/${path}`, import.meta.url))
+
+export const alias = {
+  '@myorg/core': r('core/src/index.ts'),
+  '@myorg/utils': r('utils/src/index.ts'),
+  '@myorg/ui': r('ui/src/index.ts'),
+  // Add more aliases as needed
+}
+
+// Auto-update tsconfig.alias.json paths
+const raw = fs.readFileSync(join(root, 'tsconfig.alias.json'), 'utf-8').trim()
+const tsconfig = JSON.parse(raw)
+tsconfig.compilerOptions.paths = Object.fromEntries(
+  Object.entries(alias).map(([key, value]) => [key, [`./${relative(root, value)}`]]),
+)
+const newRaw = JSON.stringify(tsconfig, null, 2)
+if (newRaw !== raw)
+  fs.writeFileSync(join(root, 'tsconfig.alias.json'), `${newRaw}\n`, 'utf-8')
+```
+
+Then update the `tsconfig.json` to use the alias file:
+
+```json
+{
+  "extends": [
+    "./tsconfig.alias.json"
+  ]
+}
+```
+
+### Using Alias in Configs
+
+Reference the centralized alias in all config files:
+
+```ts
+// vite.config.ts
+import { alias } from './alias'
+
+export default defineConfig({
+  resolve: { alias },
+})
+```
+
+```ts
+// nuxt.config.ts
+import { alias } from './alias'
+
+export default defineNuxtConfig({
+  alias,
+})
+```