@hzab/vite-config 0.0.3-alpha.0 → 0.0.3-alpha.1

package/docs/sync-public-path.md

@@ -1,52 +1,52 @@
-# 已实施：从 Vite 仓回灌 `PUBLIC_PATH` / `./client`
-
-> 状态：**已实施**（2026-08-28）。
-> 源：`~/Workbench/Vite/monorepo-packages/tooling/vite-config`（`@ccc/vite-config`）。
-> 对照现状见 [vs-ccc-vite-config.md](./vs-ccc-vite-config.md)。
-
-工厂在 `configure` 之后写入 `import.meta.env.PUBLIC_PATH`，供根入口 JS `fetch` / 动态 URL。相对 Hash 必须用 `./{hash}/`，不能跟 Vite `base`（后者保持 `./`）。HTML 子目录模板里的 `PUBLIC_PATH` 仍为 `./`，与 JS 前缀不是同一个值。
-
-包名保持 `@hzab/vite-config`。本仓引号与对照仓一致（双引号）。单独 changeset / 发版。
-
-## 已落地
-
-1. `applyJsPublicPathDefine` / `resolveJsPublicPath`：`configure` 之后写入 `import.meta.env.PUBLIC_PATH`
-2. `src/client.d.ts` 与 `exports["./client"]`
-3. `test/js-public-path.test.ts`
-4. 模板 `templates/src/vite-env.d.ts` 增加 `/// <reference types="@hzab/vite-config/client" />`
-5. 文档：JS `PUBLIC_PATH` vs HTML `PUBLIC_PATH` vs `BASE_URL`
-6. 重写 [vs-ccc-vite-config.md](./vs-ccc-vite-config.md)
-7. `typecheck` / `test` / `api-report` / `pnpm --filter @hzab/vite-config pack --dry-run`
-
-## 移植清单（对照）
-
-| 源（Vite 仓） | 本仓动作 |
-| --- | --- |
-| `src/create-app-vite-config.ts` | 已拷 `JS_PUBLIC_PATH_DEFINE_KEY`、`ensureTrailingSlash`、`resolveJsPublicPath`、`applyJsPublicPathDefine`；`configure` 之后调用 |
-| `src/client.d.ts` | 已拷；声明 `ImportMetaEnv.PUBLIC_PATH` |
-| `package.json` `exports["./client"]` | `{ "types": "./src/client.d.ts" }` |
-| `test/js-public-path.test.ts` | 已拷；另断言 `./client` 为仅 types |
-| `templates/src/vite-env.d.ts` | 已加 `/// <reference types="@hzab/vite-config/client" />` |
-| `docs/api.md` / README | JS `import.meta.env.PUBLIC_PATH` vs HTML `<%= PUBLIC_PATH %>` vs `BASE_URL` |
-| `src/types.ts` `htmlData` | 已注明 JS 用 `import.meta.env.PUBLIC_PATH` |
-
-消费方必须写成静态成员 `import.meta.env.PUBLIC_PATH`，不要解构。`vite.define` / `configure` 里的同名键会被工厂覆盖。
-
-## 刻意不搬
-
-| 项 | 原因 |
-| --- | --- |
-| `catalog:` | 本仓钉死版本 |
-| `release.config.json` | 本仓走 `publish-target.json` |
-| 改包名为 `@ccc` | scope 即仓身份 |
-
-## 验证
-
-```bash
-pnpm --filter @hzab/vite-config typecheck
-pnpm --filter @hzab/vite-config test
-pnpm --filter @hzab/vite-config api-report
-pnpm --filter @hzab/vite-config pack --dry-run
-```
-
-确认 `exports` 含 `./client`（仅 types）与既有 `./svg-react` runtime。默认入口仍是 `dist/`。
+# 已实施：从 Vite 仓回灌 `PUBLIC_PATH` / `./client`
+
+> 状态：**已实施**（2026-08-28）。
+> 源：`~/Workbench/Vite/monorepo-packages/tooling/vite-config`（`@ccc/vite-config`）。
+> 对照现状见 [vs-ccc-vite-config.md](./vs-ccc-vite-config.md)。
+
+工厂在 `configure` 之后写入 `import.meta.env.PUBLIC_PATH`，供根入口 JS `fetch` / 动态 URL。相对 Hash 必须用 `./{hash}/`，不能跟 Vite `base`（后者保持 `./`）。HTML 子目录模板里的 `PUBLIC_PATH` 仍为 `./`，与 JS 前缀不是同一个值。
+
+包名保持 `@hzab/vite-config`。本仓引号与对照仓一致（双引号）。单独 changeset / 发版。
+
+## 已落地
+
+1. `applyJsPublicPathDefine` / `resolveJsPublicPath`：`configure` 之后写入 `import.meta.env.PUBLIC_PATH`
+2. `src/client.d.ts` 与 `exports["./client"]`
+3. `test/js-public-path.test.ts`
+4. 模板 `templates/src/vite-env.d.ts` 增加 `/// <reference types="@hzab/vite-config/client" />`
+5. 文档：JS `PUBLIC_PATH` vs HTML `PUBLIC_PATH` vs `BASE_URL`
+6. 重写 [vs-ccc-vite-config.md](./vs-ccc-vite-config.md)
+7. `typecheck` / `test` / `api-report` / `pnpm --filter @hzab/vite-config pack --dry-run`
+
+## 移植清单（对照）
+
+| 源（Vite 仓）                        | 本仓动作                                                                                                                        |
+| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------- |
+| `src/create-app-vite-config.ts`      | 已拷 `JS_PUBLIC_PATH_DEFINE_KEY`、`ensureTrailingSlash`、`resolveJsPublicPath`、`applyJsPublicPathDefine`；`configure` 之后调用 |
+| `src/client.d.ts`                    | 已拷；声明 `ImportMetaEnv.PUBLIC_PATH`                                                                                          |
+| `package.json` `exports["./client"]` | `{ "types": "./src/client.d.ts" }`                                                                                              |
+| `test/js-public-path.test.ts`        | 已拷；另断言 `./client` 为仅 types                                                                                              |
+| `templates/src/vite-env.d.ts`        | 已加 `/// <reference types="@hzab/vite-config/client" />`                                                                       |
+| `docs/api.md` / README               | JS `import.meta.env.PUBLIC_PATH` vs HTML `<%= PUBLIC_PATH %>` vs `BASE_URL`                                                     |
+| `src/types.ts` `htmlData`            | 已注明 JS 用 `import.meta.env.PUBLIC_PATH`                                                                                      |
+
+消费方必须写成静态成员 `import.meta.env.PUBLIC_PATH`，不要解构。`vite.define` / `configure` 里的同名键会被工厂覆盖。
+
+## 刻意不搬
+
+| 项                    | 原因                         |
+| --------------------- | ---------------------------- |
+| `catalog:`            | 本仓钉死版本                 |
+| `release.config.json` | 本仓走 `publish-target.json` |
+| 改包名为 `@ccc`       | scope 即仓身份               |
+
+## 验证
+
+```bash
+pnpm --filter @hzab/vite-config typecheck
+pnpm --filter @hzab/vite-config test
+pnpm --filter @hzab/vite-config api-report
+pnpm --filter @hzab/vite-config pack --dry-run
+```
+
+确认 `exports` 含 `./client`（仅 types）与既有 `./svg-react` runtime。默认入口仍是 `dist/`。