@bestcss/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yuta Ura
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/class-name.d.ts

@@ -0,0 +1,4 @@
+/** 内容から決定的な短いハッシュ文字列を作る（クラス名・keyframes 名で共用） */
+export declare function contentHash(text: string): string;
+export declare function generateClassName(cssText: string): string;
+//# sourceMappingURL=class-name.d.ts.map

package/dist/class-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"class-name.d.ts","sourceRoot":"","sources":["../src/class-name.ts"],"names":[],"mappings":"AAaA,gDAAgD;AAChD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOhD;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGzD"}

package/dist/class-name.js

@@ -0,0 +1,26 @@
+/**
+ * css`` の中身（生 CSS テキスト）からスコープ用クラス名を生成する。
+ *
+ * 入力を CSS 内容のみとし、ファイル名を混ぜていない理由:
+ * 同一内容の css`` がファイルを跨いで存在するとき同一クラス名に収束させ、
+ * Phase 2 の重複排除（同一ルールの共有）の基盤にするため。
+ */
+// FNV-1a を使う理由: 依存ゼロ・数行で書け、ビルド毎に決定的。
+// 暗号学的強度は不要（衝突時はビルド時に検出して対処できる）で、
+// crypto.createHash より高速なため。
+const FNV_OFFSET_BASIS = 0x811c9dc5;
+const FNV_PRIME = 0x01000193;
+/** 内容から決定的な短いハッシュ文字列を作る（クラス名・keyframes 名で共用） */
+export function contentHash(text) {
+    let hash = FNV_OFFSET_BASIS;
+    for (let i = 0; i < text.length; i++) {
+        hash ^= text.charCodeAt(i);
+        hash = Math.imul(hash, FNV_PRIME);
+    }
+    return (hash >>> 0).toString(36);
+}
+export function generateClassName(cssText) {
+    // CSS クラス名は数字始まりが許されないため "bc" プレフィックスで保証する
+    return `bc${contentHash(cssText)}`;
+}
+//# sourceMappingURL=class-name.js.map

package/dist/class-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"class-name.js","sourceRoot":"","sources":["../src/class-name.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,qCAAqC;AACrC,kCAAkC;AAClC,6BAA6B;AAC7B,MAAM,gBAAgB,GAAG,UAAU,CAAC;AACpC,MAAM,SAAS,GAAG,UAAU,CAAC;AAE7B,gDAAgD;AAChD,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,IAAI,IAAI,GAAG,gBAAgB,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,2CAA2C;IAC3C,OAAO,KAAK,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;AACrC,CAAC"}

package/dist/class-rename.d.ts

@@ -0,0 +1,18 @@
+/**
+ * ビルド時のクラス名短縮。
+ *
+ * 内容ハッシュ（bc 接頭辞）は「全クラスが揃う前に衝突なく名前を決める」ための
+ * 長さを持つが、ビルド最終段階では全クラスの一覧が確定しているため、
+ * 全単射の短い名前（a, b, ..., z, aa, ...）に振り直せる。
+ * 名前の長さ × 出現回数が出力サイズを決めるので、頻度の高い順に短い名前を
+ * 割り当てる（Huffman 符号と同じ発想）。
+ */
+/** 使用頻度の高い順に短い名前を割り当てたリネーム表を作る */
+export declare function createRenameMap(frequencies: Map<string, number>): Map<string, string>;
+/**
+ * テキスト（JS チャンク / CSS アセット）内のクラス名をリネーム表に従って置換する。
+ * bc 接頭辞の生成名だけを対象にするため、ユーザーコードの他の文字列を
+ * 誤って書き換えることはない
+ */
+export declare function applyRename(text: string, renameMap: Map<string, string>): string;
+//# sourceMappingURL=class-rename.d.ts.map

package/dist/class-rename.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"class-rename.d.ts","sourceRoot":"","sources":["../src/class-rename.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAiBH,kCAAkC;AAClC,wBAAgB,eAAe,CAC7B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAOrB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,MAAM,CAKR"}

package/dist/class-rename.js

@@ -0,0 +1,37 @@
+/**
+ * ビルド時のクラス名短縮。
+ *
+ * 内容ハッシュ（bc 接頭辞）は「全クラスが揃う前に衝突なく名前を決める」ための
+ * 長さを持つが、ビルド最終段階では全クラスの一覧が確定しているため、
+ * 全単射の短い名前（a, b, ..., z, aa, ...）に振り直せる。
+ * 名前の長さ × 出現回数が出力サイズを決めるので、頻度の高い順に短い名前を
+ * 割り当てる（Huffman 符号と同じ発想）。
+ */
+const FIRST_CHARS = "abcdefghijklmnopqrstuvwxyz";
+const REST_CHARS = "abcdefghijklmnopqrstuvwxyz0123456789";
+/** index 番目の短縮名（bijective 進法。CSS クラス名は英字始まりが必要） */
+function shortName(index) {
+    let name = FIRST_CHARS[index % FIRST_CHARS.length];
+    let rest = Math.floor(index / FIRST_CHARS.length);
+    while (rest > 0) {
+        rest -= 1;
+        name += REST_CHARS[rest % REST_CHARS.length];
+        rest = Math.floor(rest / REST_CHARS.length);
+    }
+    return name;
+}
+/** 使用頻度の高い順に短い名前を割り当てたリネーム表を作る */
+export function createRenameMap(frequencies) {
+    // 同頻度は元の名前順で割り当て、入力順に依存しない決定的なビルドにする
+    const sorted = [...frequencies.entries()].sort(([nameA, countA], [nameB, countB]) => countB - countA || nameA.localeCompare(nameB));
+    return new Map(sorted.map(([name], index) => [name, shortName(index)]));
+}
+/**
+ * テキスト（JS チャンク / CSS アセット）内のクラス名をリネーム表に従って置換する。
+ * bc 接頭辞の生成名だけを対象にするため、ユーザーコードの他の文字列を
+ * 誤って書き換えることはない
+ */
+export function applyRename(text, renameMap) {
+    return text.replace(/\bbc[a-z0-9]+\b/g, (matched) => renameMap.get(matched) ?? matched);
+}
+//# sourceMappingURL=class-rename.js.map

package/dist/class-rename.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"class-rename.js","sourceRoot":"","sources":["../src/class-rename.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,GAAG,4BAA4B,CAAC;AACjD,MAAM,UAAU,GAAG,sCAAsC,CAAC;AAE1D,mDAAmD;AACnD,SAAS,SAAS,CAAC,KAAa;IAC9B,IAAI,IAAI,GAAG,WAAW,CAAC,KAAK,GAAG,WAAW,CAAC,MAAM,CAAW,CAAC;IAC7D,IAAI,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IAClD,OAAO,IAAI,GAAG,CAAC,EAAE,CAAC;QAChB,IAAI,IAAI,CAAC,CAAC;QACV,IAAI,IAAI,UAAU,CAAC,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,kCAAkC;AAClC,MAAM,UAAU,eAAe,CAC7B,WAAgC;IAEhC,qCAAqC;IACrC,MAAM,MAAM,GAAG,CAAC,GAAG,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAC5C,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE,CACnC,MAAM,GAAG,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAChD,CAAC;IACF,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CACzB,IAAY,EACZ,SAA8B;IAE9B,OAAO,IAAI,CAAC,OAAO,CACjB,kBAAkB,EAClB,CAAC,OAAO,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,OAAO,CAC/C,CAAC;AACJ,CAAC"}

package/dist/css.d.ts

@@ -0,0 +1,8 @@
+/**
+ * css`` タグ。ビルド時に変換で消えるため、ランタイムでは決して実行されない。
+ *
+ * values を never[] にしている理由: `${}` 補間を型レベルでも拒否し、
+ * ビルドエラーより手前（エディタ上）で気付けるようにするため。
+ */
+export declare function css(_strings: TemplateStringsArray, ..._values: never[]): string;
+//# sourceMappingURL=css.d.ts.map

package/dist/css.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"css.d.ts","sourceRoot":"","sources":["../src/css.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,QAAQ,EAAE,oBAAoB,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,CAK/E"}

package/dist/css.js

@@ -0,0 +1,11 @@
+/**
+ * css`` タグ。ビルド時に変換で消えるため、ランタイムでは決して実行されない。
+ *
+ * values を never[] にしている理由: `${}` 補間を型レベルでも拒否し、
+ * ビルドエラーより手前（エディタ上）で気付けるようにするため。
+ */
+export function css(_strings, ..._values) {
+    throw new Error("bestcss: css`` が実行時に呼ばれました。" +
+        "ビルド時に変換されるはずなので、@bestcss/vite-plugin が設定されているか確認してください。");
+}
+//# sourceMappingURL=css.js.map

package/dist/css.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"css.js","sourceRoot":"","sources":["../src/css.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,GAAG,CAAC,QAA8B,EAAE,GAAG,OAAgB;IACrE,MAAM,IAAI,KAAK,CACb,6BAA6B;QAC3B,yDAAyD,CAC5D,CAAC;AACJ,CAAC"}

package/dist/dedupe.d.ts

@@ -0,0 +1,12 @@
+/**
+ * CSS のトップレベル文（ルール / @media ブロック / @import など）を単位に
+ * 完全一致の重複を取り除く。
+ *
+ * ルール単位の AST 比較ではなくトップレベル文のテキスト比較にしている理由:
+ * 重複は同一の変換パイプラインが生成した同一 css`` ブロック由来であり
+ * バイト単位で一致することが保証される。また @media を丸ごと 1 単位と
+ * みなすことで「異なるメディアクエリ内の同一ルール」を誤って統合する
+ * 事故が構造的に起きない。
+ */
+export declare function dedupeCss(css: string): string;
+//# sourceMappingURL=dedupe.d.ts.map

package/dist/dedupe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedupe.d.ts","sourceRoot":"","sources":["../src/dedupe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAgB7C"}

package/dist/dedupe.js

@@ -0,0 +1,81 @@
+/**
+ * CSS のトップレベル文（ルール / @media ブロック / @import など）を単位に
+ * 完全一致の重複を取り除く。
+ *
+ * ルール単位の AST 比較ではなくトップレベル文のテキスト比較にしている理由:
+ * 重複は同一の変換パイプラインが生成した同一 css`` ブロック由来であり
+ * バイト単位で一致することが保証される。また @media を丸ごと 1 単位と
+ * みなすことで「異なるメディアクエリ内の同一ルール」を誤って統合する
+ * 事故が構造的に起きない。
+ */
+export function dedupeCss(css) {
+    const statements = splitTopLevelStatements(css);
+    const lastIndexByKey = new Map();
+    statements.forEach((statement, index) => {
+        lastIndexByKey.set(statement.trim(), index);
+    });
+    // 最後の出現を残す理由: 複数クラスを併用した要素では同一詳細度の
+    // ルール間で後方が勝つため、前方を残すと間に挟まったルールとの
+    // 勝敗が元の CSS と変わってしまう
+    const deduped = statements.filter((statement, index) => lastIndexByKey.get(statement.trim()) === index);
+    return deduped.join("\n");
+}
+/** 波括弧の深さ 0 で CSS をトップレベル文に分割する */
+function splitTopLevelStatements(css) {
+    const statements = [];
+    let depth = 0;
+    let start = 0;
+    let inString = null;
+    let inComment = false;
+    for (let i = 0; i < css.length; i++) {
+        const char = css[i];
+        if (inComment) {
+            if (char === "*" && css[i + 1] === "/") {
+                inComment = false;
+                i++;
+            }
+            continue;
+        }
+        if (inString !== null) {
+            if (char === "\\") {
+                i++;
+            }
+            else if (char === inString) {
+                inString = null;
+            }
+            continue;
+        }
+        if (char === "/" && css[i + 1] === "*") {
+            inComment = true;
+            i++;
+            continue;
+        }
+        if (char === '"' || char === "'") {
+            inString = char;
+            continue;
+        }
+        if (char === "{") {
+            depth++;
+            continue;
+        }
+        if (char === "}") {
+            depth--;
+            if (depth === 0) {
+                statements.push(css.slice(start, i + 1));
+                start = i + 1;
+            }
+            continue;
+        }
+        // @import / @charset のようなブロックを持たない文はセミコロンで終わる
+        if (char === ";" && depth === 0) {
+            statements.push(css.slice(start, i + 1));
+            start = i + 1;
+        }
+    }
+    const rest = css.slice(start).trim();
+    if (rest !== "") {
+        statements.push(rest);
+    }
+    return statements.filter((s) => s.trim() !== "");
+}
+//# sourceMappingURL=dedupe.js.map

package/dist/dedupe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedupe.js","sourceRoot":"","sources":["../src/dedupe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,MAAM,UAAU,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC;IAEhD,MAAM,cAAc,GAAG,IAAI,GAAG,EAAkB,CAAC;IACjD,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE;QACtC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,mCAAmC;IACnC,iCAAiC;IACjC,qBAAqB;IACrB,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAC/B,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,KAAK,KAAK,CACrE,CAAC;IAEF,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,mCAAmC;AACnC,SAAS,uBAAuB,CAAC,GAAW;IAC1C,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,QAAQ,GAAqB,IAAI,CAAC;IACtC,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QAEpB,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,IAAI,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;gBACvC,SAAS,GAAG,KAAK,CAAC;gBAClB,CAAC,EAAE,CAAC;YACN,CAAC;YACD,SAAS;QACX,CAAC;QACD,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAClB,CAAC,EAAE,CAAC;YACN,CAAC;iBAAM,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC7B,QAAQ,GAAG,IAAI,CAAC;YAClB,CAAC;YACD,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YACvC,SAAS,GAAG,IAAI,CAAC;YACjB,CAAC,EAAE,CAAC;YACJ,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjC,QAAQ,GAAG,IAAI,CAAC;YAChB,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,KAAK,EAAE,CAAC;YACR,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,KAAK,EAAE,CAAC;YACR,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;gBAChB,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBACzC,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC;YAChB,CAAC;YACD,SAAS;QACX,CAAC;QACD,8CAA8C;QAC9C,IAAI,IAAI,KAAK,GAAG,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAChC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACzC,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC;QAChB,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IACrC,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;QAChB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AACnD,CAAC"}

package/dist/imports.d.ts

@@ -0,0 +1,9 @@
+/**
+ * ソースコードから import / export-from / 動的 import の指定子を列挙する。
+ *
+ * ルート単位の CSS 収集（routeStyles）で import グラフを辿るための部品。
+ * 依存の解決（相対パス → 実ファイル）はバンドラー側の resolver に任せ、
+ * ここは指定子の抽出だけを担う
+ */
+export declare function collectImportSources(code: string, filename: string): string[];
+//# sourceMappingURL=imports.d.ts.map

package/dist/imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imports.d.ts","sourceRoot":"","sources":["../src/imports.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAkC7E"}

package/dist/imports.js

@@ -0,0 +1,37 @@
+import { parseSync } from "oxc-parser";
+/**
+ * ソースコードから import / export-from / 動的 import の指定子を列挙する。
+ *
+ * ルート単位の CSS 収集（routeStyles）で import グラフを辿るための部品。
+ * 依存の解決（相対パス → 実ファイル）はバンドラー側の resolver に任せ、
+ * ここは指定子の抽出だけを担う
+ */
+export function collectImportSources(code, filename) {
+    const parsed = parseSync(filename, code);
+    const sources = [];
+    const visit = (node) => {
+        if (Array.isArray(node)) {
+            for (const child of node) {
+                visit(child);
+            }
+            return;
+        }
+        if (node === null || typeof node !== "object") {
+            return;
+        }
+        const candidate = node;
+        if ((candidate.type === "ImportDeclaration" ||
+            candidate.type === "ExportNamedDeclaration" ||
+            candidate.type === "ExportAllDeclaration" ||
+            candidate.type === "ImportExpression") &&
+            typeof candidate.source?.value === "string") {
+            sources.push(candidate.source.value);
+        }
+        for (const value of Object.values(node)) {
+            visit(value);
+        }
+    };
+    visit(parsed.program.body);
+    return sources;
+}
+//# sourceMappingURL=imports.js.map

package/dist/imports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imports.js","sourceRoot":"","sources":["../src/imports.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,QAAgB;IACjE,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACzC,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,MAAM,KAAK,GAAG,CAAC,IAAa,EAAQ,EAAE;QACpC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,KAAK,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC;gBACzB,KAAK,CAAC,KAAK,CAAC,CAAC;YACf,CAAC;YACD,OAAO;QACT,CAAC;QACD,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC9C,OAAO;QACT,CAAC;QACD,MAAM,SAAS,GAAG,IAGjB,CAAC;QACF,IACE,CAAC,SAAS,CAAC,IAAI,KAAK,mBAAmB;YACrC,SAAS,CAAC,IAAI,KAAK,wBAAwB;YAC3C,SAAS,CAAC,IAAI,KAAK,sBAAsB;YACzC,SAAS,CAAC,IAAI,KAAK,kBAAkB,CAAC;YACxC,OAAO,SAAS,CAAC,MAAM,EAAE,KAAK,KAAK,QAAQ,EAC3C,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvC,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACxC,KAAK,CAAC,KAAK,CAAC,CAAC;QACf,CAAC;IACH,CAAC,CAAC;IAEF,KAAK,CAAE,MAAM,CAAC,OAA0C,CAAC,IAAI,CAAC,CAAC;IAC/D,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { generateClassName } from "./class-name.js";
+export { applyRename, createRenameMap } from "./class-rename.js";
+export { dedupeCss } from "./dedupe.js";
+export { collectImportSources } from "./imports.js";
+export { css } from "./css.js";
+export { transform, type TransformOptions, type TransformResult, } from "./transform.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EACL,SAAS,EACT,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { generateClassName } from "./class-name.js";
+export { applyRename, createRenameMap } from "./class-rename.js";
+export { dedupeCss } from "./dedupe.js";
+export { collectImportSources } from "./imports.js";
+export { css } from "./css.js";
+export { transform, } from "./transform.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EACL,SAAS,GAGV,MAAM,gBAAgB,CAAC"}

package/dist/keyframes.d.ts

@@ -0,0 +1,32 @@
+/**
+ * css`` ブロック内の @keyframes のスコープ化。
+ *
+ * keyframes 名は CSS 上グローバルなので、クラス名と同様に内容ハッシュで
+ * 命名し直す（"bk" プレフィックス）。内容ハッシュにすることで、同一の
+ * keyframes がファイルを跨いで同一名に収束し、重複排除にそのまま乗る。
+ * "bc"（クラス）と接頭辞を分けているのは、ビルド時クラス名短縮
+ * （ADR-0004）の置換対象と名前空間を衝突させないため。
+ */
+export interface ExtractedKeyframes {
+    /** ユーザーが書いた元の名前 */
+    name: string;
+    /** 内容ハッシュによるスコープ名 */
+    scopedName: string;
+    /** ブロック本体（波括弧の中身） */
+    body: string;
+}
+/**
+ * css`` の生テキストから、ブロック直下（ネスト深さ 0）の @keyframes を
+ * 取り出し、残りの CSS と分離する
+ */
+export declare function extractKeyframes(rawCss: string): {
+    css: string;
+    keyframes: ExtractedKeyframes[];
+};
+/**
+ * animation / animation-name 宣言の値に現れる keyframes 名をスコープ名へ
+ * 書き換える。宣言値に限定するのは、"block" のような CSS キーワードと
+ * 同名の keyframes が無関係な宣言（display: block 等）を壊さないため
+ */
+export declare function rewriteAnimationNames(css: string, renames: Map<string, string>): string;
+//# sourceMappingURL=keyframes.d.ts.map

package/dist/keyframes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyframes.d.ts","sourceRoot":"","sources":["../src/keyframes.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,MAAM,WAAW,kBAAkB;IACjC,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,kBAAkB,EAAE,CAAC;CACjC,CAkDA;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,MAAM,CASR"}

package/dist/keyframes.js

@@ -0,0 +1,67 @@
+import { contentHash } from "./class-name.js";
+/**
+ * css`` の生テキストから、ブロック直下（ネスト深さ 0）の @keyframes を
+ * 取り出し、残りの CSS と分離する
+ */
+export function extractKeyframes(rawCss) {
+    const keyframes = [];
+    let css = "";
+    let segmentStart = 0;
+    let depth = 0;
+    let i = 0;
+    while (i < rawCss.length) {
+        const char = rawCss[i];
+        if (char === "{") {
+            depth++;
+            i++;
+            continue;
+        }
+        if (char === "}") {
+            depth--;
+            i++;
+            continue;
+        }
+        if (depth === 0 && rawCss.startsWith("@keyframes", i)) {
+            const head = /^@keyframes\s+([-\w]+)\s*\{/.exec(rawCss.slice(i));
+            if (head?.[1] !== undefined) {
+                css += rawCss.slice(segmentStart, i);
+                // 対応する閉じ括弧まで読み進めて本体を切り出す
+                let j = i + head[0].length;
+                let bodyDepth = 1;
+                while (j < rawCss.length && bodyDepth > 0) {
+                    if (rawCss[j] === "{") {
+                        bodyDepth++;
+                    }
+                    else if (rawCss[j] === "}") {
+                        bodyDepth--;
+                    }
+                    j++;
+                }
+                const body = rawCss.slice(i + head[0].length, j - 1);
+                keyframes.push({
+                    name: head[1],
+                    scopedName: `bk${contentHash(body)}`,
+                    body,
+                });
+                i = j;
+                segmentStart = j;
+                continue;
+            }
+        }
+        i++;
+    }
+    css += rawCss.slice(segmentStart);
+    return { css, keyframes };
+}
+/**
+ * animation / animation-name 宣言の値に現れる keyframes 名をスコープ名へ
+ * 書き換える。宣言値に限定するのは、"block" のような CSS キーワードと
+ * 同名の keyframes が無関係な宣言（display: block 等）を壊さないため
+ */
+export function rewriteAnimationNames(css, renames) {
+    if (renames.size === 0) {
+        return css;
+    }
+    return css.replace(/(animation(?:-name)?\s*:)([^;}]*)/g, (_match, property, value) => property + value.replace(/[-\w]+/g, (word) => renames.get(word) ?? word));
+}
+//# sourceMappingURL=keyframes.js.map

package/dist/keyframes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyframes.js","sourceRoot":"","sources":["../src/keyframes.ts"],"names":[],"mappings":"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"}

package/dist/transform.d.ts

@@ -0,0 +1,18 @@
+import { type SourceMap } from "magic-string";
+export interface TransformOptions {
+    filename: string;
+}
+export interface TransformResult {
+    /** css`` をクラス名リテラルに置換し、import を除去したコード */
+    code: string;
+    /** 抽出・スコープ化された CSS */
+    css: string;
+    /** このファイルから生成したクラス名（ビルド時の短縮リネームの対象特定に使う） */
+    classNames: string[];
+    /** 変換後コードから元ソースへのソースマップ */
+    map: SourceMap;
+    /** 出力 CSS から元ソース（css`` の位置）へのソースマップ（JSON 文字列） */
+    cssMap: string;
+}
+export declare function transform(code: string, options: TransformOptions): TransformResult | null;
+//# sourceMappingURL=transform.d.ts.map

package/dist/transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../src/transform.ts"],"names":[],"mappings":"AAEA,OAAoB,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAQ3D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,4CAA4C;IAC5C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,2BAA2B;IAC3B,GAAG,EAAE,SAAS,CAAC;IACf,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;CAChB;AAgFD,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,gBAAgB,GACxB,eAAe,GAAG,IAAI,CAyJxB"}

package/dist/transform.js

@@ -0,0 +1,184 @@
+import { encode } from "@jridgewell/sourcemap-codec";
+import { transform as transformCss } from "lightningcss";
+import MagicString, {} from "magic-string";
+import { parseSync } from "oxc-parser";
+import { generateClassName } from "./class-name.js";
+import { extractKeyframes, rewriteAnimationNames } from "./keyframes.js";
+/** ユーザーが css をここから import したときだけ変換対象とする */
+const CSS_TAG_MODULE = "@bestcss/core";
+/** code 中のオフセットを 0-based の行番号に変換する */
+function lineNumberAt(code, offset) {
+    let line = 0;
+    for (let i = 0; i < offset && i < code.length; i++) {
+        if (code[i] === "\n") {
+            line++;
+        }
+    }
+    return line;
+}
+function walk(node, visit) {
+    if (Array.isArray(node)) {
+        for (const child of node) {
+            walk(child, visit);
+        }
+        return;
+    }
+    if (node !== null && typeof node === "object") {
+        const candidate = node;
+        if (typeof candidate.type === "string") {
+            visit(node);
+        }
+        for (const value of Object.values(node)) {
+            walk(value, visit);
+        }
+    }
+}
+/** import { css } from "@bestcss/core" のローカル名と import 文を探す */
+function findCssImport(body) {
+    for (const stmt of body) {
+        if (stmt.type !== "ImportDeclaration") {
+            continue;
+        }
+        const source = stmt["source"];
+        if (source.value !== CSS_TAG_MODULE) {
+            continue;
+        }
+        const specifiers = stmt["specifiers"];
+        for (const spec of specifiers) {
+            if (spec.type === "ImportSpecifier" &&
+                spec.imported?.name === "css" &&
+                spec.local?.name !== undefined) {
+                return { localName: spec.local.name, declaration: stmt };
+            }
+        }
+    }
+    return null;
+}
+export function transform(code, options) {
+    // パース前の文字列検索で早期リターンする理由:
+    // 変換対象は通常ごく一部のファイルであり、全ファイルの AST 構築を
+    // 避けることがビルド全体の速度に効くため。
+    if (!code.includes(CSS_TAG_MODULE)) {
+        return null;
+    }
+    const parsed = parseSync(options.filename, code);
+    if (parsed.errors.length > 0) {
+        const detail = parsed.errors.map((e) => e.message).join("\n");
+        throw new Error(`bestcss: ${options.filename} のパースに失敗しました:\n${detail}`);
+    }
+    const program = parsed.program;
+    const cssImport = findCssImport(program.body);
+    if (cssImport === null) {
+        return null;
+    }
+    const tags = [];
+    walk(program.body, (node) => {
+        if (node.type !== "TaggedTemplateExpression") {
+            return;
+        }
+        const tagged = node;
+        if (tagged.tag.type === "Identifier" &&
+            tagged.tag.name === cssImport.localName) {
+            tags.push(tagged);
+        }
+    });
+    if (tags.length === 0) {
+        return null;
+    }
+    const ms = new MagicString(code);
+    const classNames = [];
+    // 1 パス目: 全ブロックから @keyframes を抽出する。
+    // 参照の解決をファイル単位にする（CSS Modules と同じメンタルモデル）ため、
+    // クラス化より先に全ブロック分のリネーム表を確定させる必要がある
+    const blocks = [];
+    const keyframesRenames = new Map();
+    const keyframesStatements = new Map();
+    for (const tag of tags) {
+        if (tag.quasi.expressions.length > 0) {
+            throw new Error(`bestcss: ${options.filename} — css\`\` 内の \${} 補間は未サポートです。` +
+                `動的な値は CSS カスタムプロパティ（var(--x) + style 属性）を使ってください。`);
+        }
+        const rawCss = tag.quasi.quasis[0]?.value.raw ?? "";
+        const { css: blockCss, keyframes } = extractKeyframes(rawCss);
+        for (const kf of keyframes) {
+            keyframesRenames.set(kf.name, kf.scopedName);
+            // scopedName は内容ハッシュなので、同一内容はここで自然に 1 つに収束する
+            if (!keyframesStatements.has(kf.scopedName)) {
+                keyframesStatements.set(kf.scopedName, {
+                    statement: `@keyframes ${kf.scopedName} {${kf.body}}`,
+                    originLine: lineNumberAt(code, tag.start),
+                });
+            }
+        }
+        blocks.push({ tag, css: blockCss });
+    }
+    // 2 パス目: animation 参照を書き換えてからクラス化する。
+    // クラス名は書き換え後の CSS から生成し、意味的に同じブロックが
+    // ファイルを跨いで同一クラス名に収束するようにする。
+    // あわせて、合成 CSS の各行が元ソースのどの行由来かを記録し、
+    // 出力 CSS → tsx のソースマップの入力にする
+    const cssChunks = [];
+    const lineOrigins = [];
+    const pushChunk = (text, originLine, trackPerLine) => {
+        const lineCount = text.split("\n").length;
+        for (let i = 0; i < lineCount; i++) {
+            // trackPerLine 時はブロック内の行ずれを追う（ブロック先頭行 + i）。
+            // keyframes は抽出で行構造が変わるため定義ブロックの先頭行に丸める
+            lineOrigins.push(trackPerLine ? originLine + i : originLine);
+        }
+        cssChunks.push(text);
+    };
+    for (const kf of keyframesStatements.values()) {
+        pushChunk(kf.statement, kf.originLine, false);
+    }
+    for (const block of blocks) {
+        const rewritten = rewriteAnimationNames(block.css, keyframesRenames);
+        const className = generateClassName(rewritten);
+        classNames.push(className);
+        pushChunk(`.${className} {${rewritten}}`, lineNumberAt(code, block.tag.start), true);
+        ms.overwrite(block.tag.start, block.tag.end, JSON.stringify(className));
+    }
+    // 合成 CSS → 元 tsx の行マッピング。Lightning CSS に inputSourceMap として
+    // 渡すことで、出力 CSS のソースマップが元 tsx まで連鎖する
+    const inputSourceMap = JSON.stringify({
+        version: 3,
+        file: options.filename,
+        sources: [options.filename],
+        sourcesContent: [code],
+        names: [],
+        mappings: encode(lineOrigins.map((line) => [[0, 0, line, 0]])),
+    });
+    // 変換後は css の参照が残らないため import ごと除去する（ゼロランタイム）。
+    // 現状 core の公開 API は css のみなので、この import 文に他の specifier が
+    // 混在するケースは考慮しない
+    ms.remove(cssImport.declaration.start, cssImport.declaration.end);
+    let cssOutput;
+    let cssMap;
+    try {
+        const result = transformCss({
+            filename: options.filename,
+            code: Buffer.from(cssChunks.join("\n")),
+            minify: false,
+            sourceMap: true,
+            inputSourceMap,
+        });
+        cssOutput = result.code.toString();
+        // map が返らない場合は入力マップで代用する（行単位の近似としては有効）
+        cssMap = result.map?.toString() ?? inputSourceMap;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`bestcss: ${options.filename} の CSS の解析に失敗しました: ${message}`);
+    }
+    return {
+        code: ms.toString(),
+        css: cssOutput,
+        cssMap,
+        classNames,
+        // hires: "boundary" は行内のトークン境界単位でマッピングを出す。
+        // 置換箇所（css`` → 文字列リテラル）以外の行内位置も正確に保ち、
+        // ブレークポイントやスタックトレースのずれを防ぐため
+        map: ms.generateMap({ source: options.filename, hires: "boundary" }),
+    };
+}
+//# sourceMappingURL=transform.js.map

package/dist/transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.js","sourceRoot":"","sources":["../src/transform.ts"],"names":[],"mappings":"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"}

package/docs/01-syntax.md

@@ -0,0 +1,80 @@
+# css`` の文法
+
+## 書けるもの
+
+生の CSS 宣言に加え、ネストと条件付き at-rules がそのまま書ける:
+
+```ts
+const card = css`
+  padding: 16px;
+
+  &:hover {
+    box-shadow: 0 2px 8px rgb(0 0 0 / 0.1);
+  }
+
+  @media (min-width: 600px) {
+    padding: 24px;
+  }
+
+  @supports (display: grid) {
+    display: grid;
+  }
+`;
+```
+
+## @keyframes はスコープ付きで書ける
+
+ブロック直下に書いた `@keyframes` は内容ハッシュで命名し直され、名前が衝突しない。参照（`animation` / `animation-name`）は**同一ファイル内**のブロック間で解決される:
+
+```ts
+const title = css`
+  animation: pulse 2s infinite;
+
+  @keyframes pulse {
+    50% { opacity: 0.5; }
+  }
+`;
+```
+
+## 書けないもの
+
+### `${}` 補間 — ビルドエラー
+
+```ts
+// ❌ 型エラー + ビルドエラーになる
+const bad = css`color: ${color};`;
+```
+
+ランタイム動的スタイルは設計上サポートしない。動的な値は CSS カスタムプロパティで表現する:
+
+```tsx
+const box = css`background: var(--box-color);`;
+
+<div className={box} style={{ "--box-color": color } as React.CSSProperties} />
+```
+
+### グローバルな定義 — 通常の CSS ファイルへ
+
+`:root` のデザイントークンや要素デフォルトはクラスにスコープできないため、通常の `.css` ファイルに書いて import する:
+
+```css
+/* global.css */
+:root {
+  --brand: #2563eb;
+}
+```
+
+```ts
+const title = css`color: var(--brand);`;
+```
+
+## クラス合成の注意（CSS の一般則）
+
+`` `${base} ${variant}` `` のような className 上の合成は可能だが、同一プロパティが衝突したときの勝敗は **className に並べた順ではなく、スタイルシート内でのルールの順** で決まる。ベースとバリアントで同じプロパティを両方に書かないこと。
+
+```tsx
+const base = css`padding: 8px 16px; border-radius: 6px;`;
+const primary = css`background: #2563eb; color: #fff;`;
+
+<button className={`${base} ${primary}`} />
+```

package/docs/02-how-it-works.md

@@ -0,0 +1,34 @@
+# 内部のしくみ
+
+デバッグや挙動の推論に必要な内部構造の要点。
+
+## 変換の流れ（ビルド時）
+
+```
+.tsx ソース
+  → css タグの検出（oxc-parser で AST 解析。@bestcss/core からの import のみ対象）
+  → 生 CSS のパース・正規化（Lightning CSS）・クラス名生成
+  → JS 側: css`` がクラス名文字列リテラルに置換され、import は除去される
+  → CSS 側: 「元ファイル名 + .bestcss.css」の仮想モジュールとしてバンドラーの CSS パイプラインへ
+```
+
+ランタイムの `css` 関数はビルドで消える前提のスタブで、実行されると「プラグイン未設定」を示すエラーを投げる。
+
+## クラス名
+
+- **内容ハッシュ**: クラス名は CSS 内容の FNV-1a ハッシュ（`bc` + base36）。同一内容はファイル・ビルド・バンドラーを跨いで**同一クラス名に収束**する。これが重複排除と SSR での HTML/CSS 一致の土台
+- **頻度順短縮**（本番ビルドのみ）: 全クラス確定後、使用頻度順に `a`, `b`, ... へ全単射リネームされる。HTML の class 属性が大幅に縮む（ベンチで -48%）
+- `@keyframes` の名前も内容ハッシュ（`bk` + base36）でスコープされる
+
+## CSS の重複排除
+
+同一内容の css`` が複数ファイルにあるとクラス名は収束するが、CSS 本文は各仮想モジュールから重複して出力される。最終アセット段階でトップレベル文単位の完全一致を検出して 1 つに畳む（カスケードを保つため最後の出現を残す）。
+
+## 意図的にやらないこと
+
+- ランタイム動的スタイル（`${}` 補間） — CSS カスタムプロパティで代替
+- コンポーネント生成 API（styled.div`` 風） — 責務は「CSS → クラス名」に限定
+- 独自プリプロセッサ構文 — 生 CSS（+ 標準のネスト仕様）に準拠し続ける
+- デザイントークン機構 — CSS カスタムプロパティに委ねる
+
+これらは設計上の決定であり、「対応してほしい」という要望に対しては上記の代替手段を案内すること。

package/docs/index.md

@@ -0,0 +1,33 @@
+# bestcss ドキュメント（@bestcss/core）
+
+このディレクトリは `@bestcss/core` パッケージに同梱されており、**インストールされているバージョンと常に一致する**。AI コーディングエージェントは、学習データではなくここにあるドキュメントを参照すること。
+
+bestcss は「ゼロランタイム × コロケーション × 生 CSS 文法 × サイズ最適化」の CSS ライブラリである。JSX 内に書いた `` css`...` `` をビルド時に抽出し、クラス名リテラルへ変換する。**ランタイムに CSS 生成コードは一切含まれない**。
+
+## 目次（core: バンドラー非依存の内容）
+
+1. [css`` の文法 — 書けるもの・書けないもの](./01-syntax.md)
+2. [内部のしくみ（クラス名・最適化・デバッグ）](./02-how-it-works.md)
+
+## バンドラー統合のドキュメント
+
+セットアップとビルド設定は各統合パッケージに同梱されている:
+
+- **Vite**: `node_modules/@bestcss/vite-plugin/docs/`（セットアップ・オプション・SSR / MPA 統合）
+- **webpack / Next.js（Turbopack）**: `node_modules/@bestcss/webpack-loader/docs/`
+
+## Reset CSS（opt-in）
+
+必要な場合のみ、エントリファイルで import する（中身は modern-normalize への委譲）:
+
+```ts
+import "@bestcss/core/reset.css";
+```
+
+自動注入ではないのは、reset がコンポーネントスタイルより前に読み込まれる必要があり、import 順 = カスケード順をユーザーが制御できるべきだからである。
+
+## エージェント向けの要点
+
+- `css` は `@bestcss/core` から import する。**`${}` 補間は使えない**（型レベル + ビルドエラーで拒否される）。動的な値は CSS カスタムプロパティ + style 属性で表現する
+- ゼロランタイムを崩す提案（実行時のスタイル生成など）はこのライブラリの設計上あり得ない
+- グローバルな定義（`:root` のトークン、要素デフォルト）は css`` ではなく通常の `.css` ファイルに書く

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@bestcss/core",
+  "version": "0.1.0",
+  "description": "ゼロランタイム CSS-in-JS のバンドラー非依存な変換コア。css`` タグをビルド時にクラス名と CSS へ変換する",
+  "keywords": [
+    "css",
+    "css-in-js",
+    "zero-runtime",
+    "bestcss"
+  ],
+  "license": "MIT",
+  "author": "Yuta Ura",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/YutaUra/bestcss.git",
+    "directory": "packages/core"
+  },
+  "type": "module",
+  "sideEffects": [
+    "*.css"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./reset.css": "./reset.css"
+  },
+  "files": [
+    "dist",
+    "docs",
+    "reset.css"
+  ],
+  "dependencies": {
+    "@jridgewell/sourcemap-codec": "^1.5.5",
+    "lightningcss": "^1.32.0",
+    "magic-string": "^0.30.21",
+    "modern-normalize": "^3.0.1",
+    "oxc-parser": "^0.138.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.1.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/reset.css

@@ -0,0 +1,11 @@
+/*
+ * bestcss opt-in reset。
+ * 使い方: エントリファイルで import "@bestcss/core/reset.css";
+ *
+ * 独自ルールを持たず modern-normalize に委譲する。リセットの中身は
+ * ブラウザ挙動への継続的な追従が必要で、bestcss の責務
+ * （CSS → クラス名の変換）の外にあるため、実績あるものに任せる。
+ * 別のリセットを使いたい場合は、これを import せず好きなものを
+ * 直接 import すればよい。
+ */
+@import "modern-normalize";