chore: bump version

Author: sonofmagic

packages/tailwindcss-patch/MIGRATION.md

@@ -6,11 +6,11 @@ This document describes the changes introduced by the full refactor of `tailwind
 
 ## 1. Package layout
 
-| Before | After |
-| --- | --- |
-| `src/core/**` mix of cache, patch and runtime helpers | Dedicated folders: `api/`, `cache/`, `patching/`, `runtime/`, `options/`, `extraction/` |
-| `CacheManager`, `InternalPatchOptions`, ad-hoc exports | `CacheStore`, `normalizeOptions`, typed helpers with explicit imports |
-| `processTailwindcss` | `runTailwindBuild` in `runtime/process-tailwindcss.ts` |
+| Before                                                 | After                                                                                   |
+| ------------------------------------------------------ | --------------------------------------------------------------------------------------- |
+| `src/core/**` mix of cache, patch and runtime helpers  | Dedicated folders: `api/`, `cache/`, `patching/`, `runtime/`, `options/`, `extraction/` |
+| `CacheManager`, `InternalPatchOptions`, ad-hoc exports | `CacheStore`, `normalizeOptions`, typed helpers with explicit imports                   |
+| `processTailwindcss`                                   | `runTailwindBuild` in `runtime/process-tailwindcss.ts`                                  |
 
 Imports such as `@/core/patcher` or `@/core/cache` must be updated. Use the new entry-points:
 
@@ -25,7 +25,7 @@ import { applyTailwindPatches } from 'tailwindcss-patch/patching/patch-runner'
 ### Previous shape
 
 ```ts
-new TailwindcssPatcher({
+const patcher = new TailwindcssPatcher({
   cache: { dir: '.cache', file: 'classes.json' },
   patch: {
     overwrite: true,
@@ -39,7 +39,7 @@ new TailwindcssPatcher({
 ### New shape
 
 ```ts
-new TailwindcssPatcher({
+const patcher = new TailwindcssPatcher({
   overwrite: true,
   cache: {
     enabled: true,

packages/tailwindcss-patch/README-cn.md

@@ -38,13 +38,13 @@ pnpm dlx tw-patch extract
 
 ### `extract` 常用参数
 
-| 参数 | 说明 |
-| --- | --- |
-| `--cwd <dir>` | 指定读取配置的工作目录。 |
-| `--output <file>` | 覆盖输出文件路径。 |
-| `--format <json|lines>` | 切换 JSON（默认）或换行分隔的纯文本。 |
-| `--css <file>` | 使用 Tailwind v4 时指定 CSS 入口文件。 |
-| `--no-write` | 仅返回结果，不落盘。 |
+| 参数                     | 说明                                   |
+| ------------------------ | -------------------------------------- |
+| `--cwd <dir>`            | 指定读取配置的工作目录。               |
+| `--output <file>`        | 覆盖输出文件路径。                     |
+| `--format <json\|lines>` | 切换 JSON（默认）或换行分隔的纯文本。  |
+| `--css <file>`           | 使用 Tailwind v4 时指定 CSS 入口文件。 |
+| `--no-write`             | 仅返回结果，不落盘。                   |
 
 CLI 会通过 `@tailwindcss-mangle/config` 加载 `tailwindcss-patch.config.ts`。旧配置仍可使用，详情请参考 [迁移指南](./MIGRATION.md)。
 
@@ -111,9 +111,7 @@ export default defineConfig({
       version: 4,
       v4: {
         cssEntries: ['dist/tailwind.css'],
-        sources: [
-          { base: 'src', pattern: '**/*.{html,tsx}', negated: false },
-        ],
+        sources: [{ base: 'src', pattern: '**/*.{html,tsx}', negated: false }],
       },
     },
     applyPatches: {

packages/tailwindcss-patch/README.md

@@ -38,13 +38,13 @@ pnpm dlx tw-patch extract
 
 ### Extract options
 
-| Flag | Description |
-| --- | --- |
-| `--cwd <dir>` | Use a different working directory when loading configuration. |
-| `--output <file>` | Override the target file for the generated class list. |
-| `--format <json|lines>` | Switch between JSON output (default) and newline-delimited text. |
-| `--css <file>` | Provide a CSS entry file when working with Tailwind v4 projects. |
-| `--no-write` | Skip writing to disk and only return the collected classes. |
+| Flag                     | Description                                                      |
+| ------------------------ | ---------------------------------------------------------------- |
+| `--cwd <dir>`            | Use a different working directory when loading configuration.    |
+| `--output <file>`        | Override the target file for the generated class list.           |
+| `--format <json\|lines>` | Switch between JSON output (default) and newline-delimited text. |
+| `--css <file>`           | Provide a CSS entry file when working with Tailwind v4 projects. |
+| `--no-write`             | Skip writing to disk and only return the collected classes.      |
 
 The CLI loads `tailwindcss-patch.config.ts` via `@tailwindcss-mangle/config`. Legacy configs continue to work; see the [migration guide](./MIGRATION.md) for hints on the new fields.
 
@@ -111,9 +111,7 @@ export default defineConfig({
       version: 4,
       v4: {
         cssEntries: ['dist/tailwind.css'],
-        sources: [
-          { base: 'src', pattern: '**/*.{html,tsx}', negated: false },
-        ],
+        sources: [{ base: 'src', pattern: '**/*.{html,tsx}', negated: false }],
       },
     },
     applyPatches: {

packages/tailwindcss-patch/how-it-works.md

@@ -1,16 +1,16 @@
 ---
 id: 20230630
-title: 'How to get the context of tailwindcss at runtime?'
+title: "How to get the context of tailwindcss at runtime?"
 date: 2023-06-30
-description: 'The core principle of `tailwindcss-patch`'
+description: "The core principle of `tailwindcss-patch`"
 authors:
   - icebreaker
 tags:
-  - 'tailwindcss'
-  - 'context'
-  - 'runtime'
-  - 'plugin'
-  - 'postcss'
+  - "tailwindcss"
+  - "context"
+  - "runtime"
+  - "plugin"
+  - "postcss"
 ---
 
 # How to get the context of tailwindcss at runtime?
@@ -251,13 +251,13 @@ In this file, we create a `contextRef` object, `push` the context of `tailwindcs
 
 At this point, we'll be able to create a method to get it
 
-```js
+```ts
 function getContexts() {
   const twPath = require.resolve('tailwindcss')
 
   const distPath = path.dirname(twPath)
 
-  let injectFilePath = path.join(distPath, 'plugin.js')
+  const injectFilePath = path.join(distPath, 'plugin.js')
 
   const mo = require(injectFilePath)
   if (mo.contextRef) {

packages/tailwindcss-patch/src/api/tailwindcss-patcher.ts

@@ -1,21 +1,21 @@
 import type { PackageInfo } from 'local-pkg'
+import type { LegacyTailwindcssPatcherOptions } from '../options/legacy'
+import type { NormalizedTailwindcssPatchOptions } from '../options/types'
 import type { ExtractResult, TailwindcssPatchOptions } from '../types'
 import process from 'node:process'
-import { getPackageInfoSync } from 'local-pkg'
-import { coerce } from 'semver'
 import fs from 'fs-extra'
+import { getPackageInfoSync } from 'local-pkg'
 import path from 'pathe'
+import { coerce } from 'semver'
 import { CacheStore } from '../cache/store'
-import { normalizeOptions } from '../options/normalize'
-import type { NormalizedTailwindcssPatchOptions } from '../options/types'
-import type { LegacyTailwindcssPatcherOptions } from '../options/legacy'
+import { extractValidCandidates as extractCandidates } from '../extraction/candidate-extractor'
+import logger from '../logger'
 import { fromLegacyOptions } from '../options/legacy'
+import { normalizeOptions } from '../options/normalize'
 import { applyTailwindPatches } from '../patching/patch-runner'
-import { loadRuntimeContexts } from '../runtime/context-registry'
 import { collectClassesFromContexts, collectClassesFromTailwindV4 } from '../runtime/class-collector'
+import { loadRuntimeContexts } from '../runtime/context-registry'
 import { runTailwindBuild } from '../runtime/process-tailwindcss'
-import logger from '../logger'
-import { extractValidCandidates as extractCandidates } from '../extraction/candidate-extractor'
 
 type TailwindMajorVersion = 2 | 3 | 4
 

packages/tailwindcss-patch/src/cli.ts

@@ -1,20 +1,24 @@
+import type { LegacyTailwindcssPatcherOptions } from './options/legacy'
 import type { TailwindcssPatchOptions } from './types'
 import process from 'node:process'
+
 import { CONFIG_NAME, getConfig, initConfig } from '@tailwindcss-mangle/config'
 import { defu } from '@tailwindcss-mangle/shared'
 import cac from 'cac'
-import logger from './logger'
+
 import { TailwindcssPatcher } from './api/tailwindcss-patcher'
+import logger from './logger'
 import { fromLegacyOptions, fromUnifiedConfig } from './options/legacy'
 
 const cli = cac('tw-patch')
 
 async function loadPatchOptions(cwd: string, overrides?: TailwindcssPatchOptions) {
   const { config } = await getConfig(cwd)
+  const legacyConfig = config as (typeof config) & { patch?: LegacyTailwindcssPatcherOptions['patch'] }
   const base = config?.registry
     ? fromUnifiedConfig(config.registry)
-    : config?.patch
-      ? fromLegacyOptions({ patch: config.patch })
+    : legacyConfig?.patch
+      ? fromLegacyOptions({ patch: legacyConfig.patch })
       : {}
   const merged = defu<TailwindcssPatchOptions, TailwindcssPatchOptions[]>(overrides ?? {}, base)
   return merged

packages/tailwindcss-patch/src/index.ts

@@ -1,14 +1,14 @@
 export { TailwindcssPatcher } from './api/tailwindcss-patcher'
-export { normalizeOptions } from './options/normalize'
 export { CacheStore } from './cache/store'
 export {
-  extractValidCandidates,
   extractRawCandidates,
   extractRawCandidatesWithPositions,
+  extractValidCandidates,
 } from './extraction/candidate-extractor'
-export { loadRuntimeContexts } from './runtime/context-registry'
+export { default as logger } from './logger'
+export { normalizeOptions } from './options/normalize'
 export { collectClassesFromContexts, collectClassesFromTailwindV4 } from './runtime/class-collector'
+export { loadRuntimeContexts } from './runtime/context-registry'
 export { runTailwindBuild } from './runtime/process-tailwindcss'
-export { default as logger } from './logger'
 export * from './types'
 export { defineConfig } from '@tailwindcss-mangle/config'

packages/tailwindcss-patch/src/options/legacy.ts

@@ -4,8 +4,8 @@ import type {
   TailwindNextOptions,
 } from '@tailwindcss-mangle/config'
 import type { PackageResolvingOptions } from 'local-pkg'
-import type { TailwindcssPatchOptions, ExtendLengthUnitsUserOptions } from './types'
 import type { ILengthUnitsPatchOptions } from '../types'
+import type { ExtendLengthUnitsUserOptions, TailwindcssPatchOptions } from './types'
 
 export interface LegacyCacheOptions {
   dir?: string

packages/tailwindcss-patch/src/options/normalize.ts

@@ -1,18 +1,20 @@
-import process from 'node:process'
-import path from 'pathe'
+import type { ILengthUnitsPatchOptions } from '../types'
 import type {
+  CacheStrategy,
+  FeatureUserOptions,
   NormalizedCacheOptions,
   NormalizedFeatureOptions,
   NormalizedOutputOptions,
   NormalizedTailwindConfigOptions,
-  NormalizedTailwindV4Options,
   NormalizedTailwindcssPatchOptions,
+  NormalizedTailwindV4Options,
+  OutputUserOptions,
   TailwindcssPatchOptions,
   TailwindUserOptions,
   TailwindV4UserOptions,
 } from './types'
-import type { CacheStrategy, ExtendLengthUnitsUserOptions, FeatureUserOptions, OutputUserOptions } from './types'
-import type { ILengthUnitsPatchOptions } from '../types'
+import process from 'node:process'
+import path from 'pathe'
 import { pkgName } from '../constants'
 
 function toPrettyValue(value: OutputUserOptions['pretty']): number | false {

packages/tailwindcss-patch/src/patching/operations/export-context/index.ts

@@ -1,8 +1,8 @@
 import fs from 'fs-extra'
 import path from 'pathe'
 import logger from '../../../logger'
-import { transformPostcssPlugin, transformProcessTailwindFeaturesReturnContext } from './postcss-v3'
 import { transformPostcssPluginV2, transformProcessTailwindFeaturesReturnContextV2 } from './postcss-v2'
+import { transformPostcssPlugin, transformProcessTailwindFeaturesReturnContext } from './postcss-v3'
 
 export interface ExposeContextPatchParams {
   rootDir: string