cirrojs 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 osawa-naotaka
+
+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/README.md

@@ -0,0 +1,82 @@
+# cirro
+
+React の島（islands）アーキテクチャによる、CSP 厳格（`unsafe-inline` 不要）を実現する軽量 static site generator。
+
+## 特徴
+
+- **インラインスクリプトを一切生成しない** → `script-src 'self'` の厳格な CSP で動作する（Astro 等が残しがちな少量のインラインを排除）
+- 本文は**純粋な静的 HTML**、インタラクティブな箇所だけを**島**としてハイドレート（MPA）
+- **Config Base Routing**: `.ts` に型付きオブジェクトでルート定義。動的ルートは `params → URL` の関数 + `getStaticPaths`
+- **React のみ**（独自テンプレート構文の学習が不要）
+
+## 使い方
+
+```ts
+// vite.config.ts
+import react from "@vitejs/plugin-react";
+import { cirro } from "cirro/vite";
+import { defineConfig } from "vite";
+
+// React プラグインは利用者が明示的に追加する（cirro は内包しない）。
+export default defineConfig({
+    plugins: [react(), cirro({ routes: "./src/routes.ts", islands: "./src/islands/registry.ts" })],
+});
+```
+
+```jsonc
+// package.json
+"scripts": { "dev": "cirro dev", "build": "tsc && cirro build", "preview": "vite preview" }
+```
+
+CLI は `cirro dev`（SSR + ルーティング + HMR の開発サーバー）と `cirro build`（静的サイトを `dist/` へ生成）の 2 つ。プレビューは `vite preview` を使う。
+
+```ts
+// src/islands/registry.ts — 島を登録（純データ）
+import { Counter } from "./Counter";
+export const islands = { counter: Counter } as const;
+```
+
+```ts
+// src/islands/Island.ts — 型安全な <Island> を生成
+import { createIsland } from "cirro";
+import { islands } from "./registry";
+export const Island = createIsland(islands);
+```
+
+```tsx
+// src/routes.ts — ルート定義
+import { route, type AnyRoute } from "cirro";
+import { HomePage } from "./pages/home";
+import { PostPage } from "./pages/post";
+
+export const routes: AnyRoute[] = [
+    { path: "/", component: HomePage },
+    route({
+        path: ({ slug }) => `/posts/${slug}`,
+        getStaticPaths: () => [{ slug: "hello" }],
+        component: PostPage,
+    }),
+];
+```
+
+ページは完全な HTML 文書を返し、島は `<Island name="counter" props={{ initial: 3 }} />` のように型安全に配置する。
+
+## Markdown
+
+`createMarkdown()` でビルド時に Markdown を HTML 化する。`rehype-sanitize` を固定で強制し（ユーザープラグインは「サニタイズの上流」に積む）、目次抽出（`toc`）やクラスベースのシンタックスハイライト（`highlight`、インラインスタイルを出さず `style-src 'self'` と両立）に対応する。unified 一式はクライアントへ送られない。
+
+```ts
+import { createMarkdown } from "cirro";
+import remarkGfm from "remark-gfm";
+
+const { render } = createMarkdown({ remarkPlugins: [remarkGfm], toc: true, highlight: true });
+const { body, toc } = render(markdownSource); // body: サニタイズ済み HTML の React 要素 / toc: 目次
+```
+
+## ドキュメント
+
+使い方の詳細は [`doc/04_USAGE.md`](../../doc/04_USAGE.md) を参照（セットアップ、ルーティング、dev / build、島、Markdown、Panda CSS によるデザイン、CSP まで網羅）。島システムの仕組みは [`doc/03_ISLAND_SYSTEM.md`](../../doc/03_ISLAND_SYSTEM.md)、設計の背景は [`doc/01_CHARTER.md`](../../doc/01_CHARTER.md) を参照。
+
+## ライセンス
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,4 @@
+//#region src/cli.d.ts
+declare function main(args: string[]): Promise<void>;
+//#endregion
+export { main };

package/dist/cli.js

@@ -0,0 +1 @@
+import{r as e,t}from"./router-CJ9aQRbJ.js";import{Fragment as n,createElement as r}from"react";import{renderToStaticMarkup as i}from"react-dom/server";import{dirname as a,join as o,resolve as s}from"node:path";import{mkdir as c,readFile as l,writeFile as u}from"node:fs/promises";import{build as d,createServer as f,createServerModuleRunner as p}from"vite";import{createServer as m}from"node:http";function h(e,t){return r(n,null,e,r(`script`,{async:!0,type:`module`,src:t,key:`cirro-client`}))}function g(e){for(let t of e.plugins){let e=t.api;if(t.name===`cirro`&&e?.options)return e.options}throw Error(`cirro: plugin not found in Vite config (did you add cirro() to plugins?)`)}async function _(){await d();let n=await f({server:{middlewareMode:!0,hmr:!1},appType:`custom`}),r=p(n.environments.ssr);try{let d=n.config,f=g(d),p=d.root,m=s(p,d.build.outDir),_=s(p,f.routes),v=JSON.parse(await l(o(m,`.vite/manifest.json`),`utf-8`))[`virtual:cirro/client`];if(!v)throw Error(`cirro: manifest entry "virtual:cirro/client" not found`);let y=`/${v.file}`,{routes:b}=await r.import(_);for(let n of t(b)){let t=`<!DOCTYPE html>${i(h(n.render(),y))}`,r=o(m,e(n.url));await c(a(r),{recursive:!0}),await u(r,t),console.log(`wrote ${r} (url: ${n.url})`)}}finally{await n.close()}}function v(e,t){let n=[t,t.replaceAll(`\\`,`/`)];for(let t of Object.values(e.environments)){let e=t.moduleGraph;if(!e)continue;let r=new Set,i=t=>{if(!r.has(t)){r.add(t),e.invalidateModule(t);for(let e of t.importers)i(e)}};for(let t of n){let n=e.getModulesByFile(t);if(n)for(let e of n)i(e)}}}async function y(e=5173){let n=await f({server:{middlewareMode:!0},appType:`custom`}),r=p(n.environments.ssr),o=g(n.config),c=n.config.root,l=s(c,o.routes),u=a(s(c,o.islands)).replaceAll(`\\`,`/`),d=m((e,a)=>{n.middlewares(e,a,async()=>{let o=e.url??`/`;try{let{routes:e}=await r.import(l),s=t(e),c=new URL(o,`http://localhost`).pathname.replace(/\/+$/,``)||`/`,u=s.find(e=>(e.url.replace(/\/+$/,``)||`/`)===c);if(!u){a.statusCode=404,a.setHeader(`Content-Type`,`text/html; charset=utf-8`),a.end(`<!DOCTYPE html><meta charset="utf-8"><h1>404 Not Found</h1>`);return}let d=`<!DOCTYPE html>${i(h(u.render(),`/@id/__x00__virtual:cirro/client`))}`;d=await n.transformIndexHtml(o,d),a.statusCode=200,a.setHeader(`Content-Type`,`text/html; charset=utf-8`),a.end(d)}catch(e){a.statusCode=500,a.end(String(e))}})}),_=`${s(c,o.watchDir??`./src`).replaceAll(`\\`,`/`).replace(/\/+$/,``)}/`;n.watcher.on(`change`,e=>{let t=e.replaceAll(`\\`,`/`);t.startsWith(u)||t.startsWith(_)&&(v(n,e),n.ws.send({type:`full-reload`}))}),d.listen(e,()=>{console.log(`cirro dev: http://localhost:${e}`)})}async function b(e){let t=e[0];t===`dev`?await y():t===`build`?await _():(console.error(`usage: cirro <dev|build>`),process.exit(1))}export{b as main};

package/dist/cli.sh

@@ -0,0 +1,40 @@
+#!/usr/bin/env bash
+
+runtime=""
+script_args=()
+
+# 引数をループして実行環境とその他の引数を分離
+for arg in "$@"; do
+    case "$arg" in
+        --bun)  runtime="bun" ;;
+        --node) runtime="node" ;;
+        --deno) runtime="deno" ;;
+        *)      script_args+=("$arg") ;;
+    esac
+done
+
+# 実行環境が指定されていない場合、自動検出（優先順位: bun -> node -> deno）
+if [ -z "$runtime" ]; then
+    if command -v bun &> /dev/null; then
+        runtime="bun"
+    elif command -v node &> /dev/null; then
+        runtime="node"
+    elif command -v deno &> /dev/null; then
+        runtime="deno"
+    else
+        echo "Error: No JavaScript runtime found (bun, node, or deno)" >&2
+        exit 1
+    fi
+fi
+
+case "$runtime" in
+    bun)
+        exec bun -e='import { main } from "cirro/bin"; await main(process.argv.slice(1));' "${script_args[@]}"
+        ;;
+    node)
+        exec node --eval 'import { main } from "cirro/bin"; await main(process.argv.slice(1));' "${script_args[@]}"
+        ;;
+    deno)
+        exec deno eval 'import { main } from "cirro/bin"; await main(process.argv.slice(2));' "${script_args[@]}"
+        ;;
+esac

package/dist/index.d.ts

@@ -0,0 +1,75 @@
+import { ComponentProps, ComponentType, ReactElement } from "react";
+import { ToC, ToC as ToC$1 } from "remark-export-toc";
+import { PluggableList } from "unified";
+import { Schema } from "hast-util-sanitize";
+
+//#region src/island.d.ts
+type IslandRegistry = Record<string, ComponentType<any>>;
+declare function createIsland<R extends IslandRegistry>(islands: R): <K extends keyof R & string>({
+  name,
+  props
+}: {
+  name: K;
+  props: ComponentProps<R[K]>;
+}) => import("react").DetailedReactHTMLElement<{
+  "data-island": K;
+  "data-props": string;
+  dangerouslySetInnerHTML: {
+    __html: string;
+  };
+}, HTMLElement>;
+//#endregion
+//#region src/markdown.d.ts
+interface MarkdownConfig {
+  remarkPlugins?: PluggableList;
+  rehypePlugins?: PluggableList;
+  sanitizeSchema?: (defaults: Schema) => Schema;
+  toc?: boolean | {
+    prefix?: string;
+    startLevel?: number;
+  };
+  highlight?: boolean;
+}
+interface RenderResult {
+  body: ReactElement;
+  toc: ToC$1[];
+}
+declare function createMarkdown(config?: MarkdownConfig): {
+  Markdown: ({
+    source,
+    className
+  }: {
+    source: string;
+    className?: string;
+  }) => ReactElement;
+  render: (source: string, options?: {
+    className?: string;
+  }) => RenderResult;
+};
+//#endregion
+//#region src/router.d.ts
+type Params = Record<string, string>;
+type StaticRoute = {
+  path: string;
+  component: (props: {
+    params: Record<string, never>;
+  }) => ReactElement;
+};
+type DynamicRoute<P extends Params = Params> = {
+  path: (params: P) => string;
+  getStaticPaths: () => P[];
+  component: (props: {
+    params: P;
+  }) => ReactElement;
+};
+type AnyRoute = StaticRoute | DynamicRoute<any>;
+declare function route<P extends Params>(def: DynamicRoute<P>): DynamicRoute<P>;
+declare function route(def: StaticRoute): StaticRoute;
+type ResolvedPage = {
+  url: string;
+  render: () => ReactElement;
+};
+declare function expandRoutes(routes: AnyRoute[]): ResolvedPage[];
+declare function urlToFilePath(url: string): string;
+//#endregion
+export { type AnyRoute, type DynamicRoute, type MarkdownConfig, type Params, type RenderResult, type ResolvedPage, type StaticRoute, type ToC, createIsland, createMarkdown, expandRoutes, route, urlToFilePath };

package/dist/index.js

@@ -0,0 +1 @@
+import{n as e,r as t,t as n}from"./router-CJ9aQRbJ.js";import{createElement as r}from"react";import{renderToString as i}from"react-dom/server";import a from"rehype-prism";import o,{defaultSchema as s}from"rehype-sanitize";import c from"rehype-stringify";import l from"remark-export-toc";import u from"remark-parse";import d from"remark-rehype";import{unified as f}from"unified";import{jsx as p}from"react/jsx-runtime";function m(e){return function({name:t,props:n}){let a=i(r(e[t],n));return r(`div`,{"data-island":t,"data-props":JSON.stringify(n),dangerouslySetInnerHTML:{__html:a}})}}function h(e={}){let t={prefix:`heading`,startLevel:2,...typeof e.toc==`object`?e.toc:{}},n={...s,clobber:(s.clobber??[]).filter(e=>e!==`id`)},r=e.sanitizeSchema?e.sanitizeSchema(n):n,i=f().use(u).use(e.remarkPlugins??[]).use(e.toc?[[l,t]]:[]).use(d).use(e.rehypePlugins??[]).use(o,r).use(e.highlight?[a]:[]).use(c).freeze();function m(e,t){return p(`div`,{className:t,dangerouslySetInnerHTML:{__html:e}})}function h(e,t){let n=i.processSync(e),r=n.data.toc??[];return{body:m(String(n),t?.className),toc:r}}function g({source:e,className:t}){return h(e,{className:t}).body}return{Markdown:g,render:h}}export{m as createIsland,h as createMarkdown,n as expandRoutes,e as route,t as urlToFilePath};

package/dist/router-CJ9aQRbJ.js

@@ -0,0 +1 @@
+function e(e){return e}function t(e){let t=[];for(let n of e)if(`getStaticPaths`in n)for(let e of n.getStaticPaths())t.push({url:n.path(e),render:()=>n.component({params:e})});else t.push({url:n.path,render:()=>n.component({params:{}})});return t}function n(e){return e===`/`?`index.html`:`${e.replace(/^\/+|\/+$/g,``)}/index.html`}export{e as n,n as r,t};

package/dist/vite.d.ts

@@ -0,0 +1,11 @@
+import { Plugin } from "vite";
+
+//#region src/vite.d.ts
+type CirroOptions = {
+  routes: string;
+  islands: string;
+  watchDir?: string;
+};
+declare function cirro(options: CirroOptions): Plugin;
+//#endregion
+export { CirroOptions, cirro };

package/dist/vite.js

@@ -0,0 +1,2 @@
+import{resolve as e}from"node:path";const t=`virtual:cirro/client`,n=`\0${t}`;function r(r){let i=r.islands;return{name:`cirro`,api:{options:r},config(){return{build:{manifest:!0,modulePreload:{polyfill:!1},assetsInlineLimit:0,rollupOptions:{input:{client:t}}}}},configResolved(t){if(i=e(t.root,r.islands),!t.plugins.some(e=>e.name?.startsWith(`vite:react`)))throw Error(`cirro: React プラグインが見つかりません。vite.config の plugins に react()（@vitejs/plugin-react）を cirro() より前に追加してください。`)},resolveId(e){if(e===t)return n},load(e){if(e===n)return[`import { createElement } from "react";`,`import { hydrateRoot } from "react-dom/client";`,`import { islands } from ${JSON.stringify(i)};`,``,`for (const el of document.querySelectorAll("[data-island]")) {`,`    const name = el.dataset.island;`,`    if (!name || !(name in islands)) continue;`,`    const props = el.dataset.props ? JSON.parse(el.dataset.props) : {};`,`    hydrateRoot(el, createElement(islands[name], props));`,`}`].join(`
+`)}}}export{r as cirro};

package/package.json

@@ -0,0 +1,65 @@
+{
+    "name": "cirrojs",
+    "version": "0.0.1",
+    "description": "React islands SSG with strict CSP (no unsafe-inline). Vite-based, MPA-first.",
+    "license": "MIT",
+    "type": "module",
+    "files": ["dist", "README.md", "LICENSE"],
+    "exports": {
+        ".": "./src/index.ts",
+        "./vite": "./src/vite.ts",
+        "./bin": "./src/cli.ts"
+    },
+    "bin": {
+        "cirro": "./public/cli.sh"
+    },
+    "publishConfig": {
+        "exports": {
+            ".": {
+                "types": "./dist/index.d.ts",
+                "default": "./dist/index.js"
+            },
+            "./vite": {
+                "types": "./dist/vite.d.ts",
+                "default": "./dist/vite.js"
+            },
+            "./bin": {
+                "types": "./dist/cli.d.ts",
+                "default": "./dist/cli.js"
+            }
+        },
+        "bin": {
+            "cirro": "./dist/cli.sh"
+        }
+    },
+    "scripts": {
+        "build": "tsdown",
+        "typecheck": "tsc -p tsconfig.build.json --noEmit",
+        "format": "biome check --write ./src"
+    },
+    "dependencies": {
+        "hast-util-sanitize": "^5.0.2",
+        "rehype-prism": "^2.3.3",
+        "rehype-sanitize": "^6.0.0",
+        "rehype-stringify": "^10.0.1",
+        "remark-export-toc": "0.1.0-alpha.2",
+        "remark-parse": "^11.0.0",
+        "remark-rehype": "^11.1.2",
+        "unified": "^11.0.5"
+    },
+    "peerDependencies": {
+        "@vitejs/plugin-react": "^6.0.2",
+        "react": "^19.2.7",
+        "react-dom": "^19.2.7",
+        "vite": "^8.0.0"
+    },
+    "devDependencies": {
+        "@biomejs/biome": "2.5.0",
+        "@types/node": "25.9.3",
+        "@types/react": "19.2.17",
+        "@types/react-dom": "19.2.3",
+        "tsdown": "^0.22.2",
+        "typescript": "6.0.3",
+        "vite": "8.0.16"
+    }
+}

package/public/cli.sh

@@ -0,0 +1,40 @@
+#!/usr/bin/env bash
+
+runtime=""
+script_args=()
+
+# 引数をループして実行環境とその他の引数を分離
+for arg in "$@"; do
+    case "$arg" in
+        --bun)  runtime="bun" ;;
+        --node) runtime="node" ;;
+        --deno) runtime="deno" ;;
+        *)      script_args+=("$arg") ;;
+    esac
+done
+
+# 実行環境が指定されていない場合、自動検出（優先順位: bun -> node -> deno）
+if [ -z "$runtime" ]; then
+    if command -v bun &> /dev/null; then
+        runtime="bun"
+    elif command -v node &> /dev/null; then
+        runtime="node"
+    elif command -v deno &> /dev/null; then
+        runtime="deno"
+    else
+        echo "Error: No JavaScript runtime found (bun, node, or deno)" >&2
+        exit 1
+    fi
+fi
+
+case "$runtime" in
+    bun)
+        exec bun -e='import { main } from "cirro/bin"; await main(process.argv.slice(1));' "${script_args[@]}"
+        ;;
+    node)
+        exec node --eval 'import { main } from "cirro/bin"; await main(process.argv.slice(1));' "${script_args[@]}"
+        ;;
+    deno)
+        exec deno eval 'import { main } from "cirro/bin"; await main(process.argv.slice(2));' "${script_args[@]}"
+        ;;
+esac