@b4moss/hyogen-md 0.12.0 → 0.13.0

package/README.md

@@ -40,6 +40,27 @@ Requires **Node.js >= 24**.
 
 ## Quick start
 
+### CLI (`hyogen-md`)
+
+```bash
+npx hyogen-md create my-site
+cd my-site
+npm install
+npm run dev    # preview with file tree + HMR (default http://127.0.0.1:4173)
+npm run build  # write Markdown to outDir (default ./out)
+```
+
+`hyogen.config.js` (or `.ts`):
+
+```js
+import { defineConfig } from "@b4moss/hyogen-md/config";
+
+export default defineConfig({
+  input: "./src/**/*.md",
+  // outDir: "./out",
+});
+```
+
 ### Client / CSR (`@b4moss/hyogen-md/client`)
 
 ```ts
@@ -119,9 +140,9 @@ Open `http://localhost:3000` (docs) and `/playground`. Uses `../app` via Vite al
 ## Status
 
 This is **0.x**. APIs and output may change until `1.0.0`.  
-Published: **`@b4moss/hyogen-md@0.10.0`** (git tag `v0.10.0`).
+Published: **`@b4moss/hyogen-md@0.13.0`** (git tag `v0.13.0`).
 
-Playground UX is part of the **v0.10.0** product milestone but is **not** included in the npm tarball.
+Playground UX ships with the documentation site and is **not** included in the npm tarball.
 
 The coverage badge reflects approximate **statement coverage for `app/`** (library) from Vitest (~84%). Initial release goal is ≥50%. Coverage is uploaded to Codecov from `.github/workflows/quality.yml` on pushes to `main`.
 

package/README_ja.md

@@ -40,6 +40,27 @@ npm install @b4moss/hyogen-md
 
 ## クイックスタート
 
+### CLI（`hyogen-md`）
+
+```bash
+npx hyogen-md create my-site
+cd my-site
+npm install
+npm run dev    # ファイルツリー + HMR プレビュー（既定 http://127.0.0.1:4173）
+npm run build  # Markdown を outDir へ出力（既定 ./out）
+```
+
+`hyogen.config.js`（または `.ts`）:
+
+```js
+import { defineConfig } from "@b4moss/hyogen-md/config";
+
+export default defineConfig({
+  input: "./src/**/*.md",
+  // outDir: "./out",
+});
+```
+
 ### クライアント / CSR（`@b4moss/hyogen-md/client`）
 
 ```ts
@@ -119,9 +140,9 @@ make dev-docs
 ## ステータス
 
 **0.x** です。`1.0.0` まで API・出力は変わりえます。  
-公開済み: **`@b4moss/hyogen-md@0.10.0`**（git tag `v0.10.0`）。
+公開済み: **`@b4moss/hyogen-md@0.13.0`**（git tag `v0.13.0`）。
 
-Playground UX は **v0.10.0** マイルストーンに含まれますが、**npm の tarball には入りません**。
+Playground UX はドキュメントサイトに含まれ、**npm の tarball には入りません**。
 
 coverage バッジはライブラリ（`app/`）の Vitest **statement カバレッジ概算（約 84%）**です。初期リリース目標は 50% 以上。カバレッジは `main` への push 時に `.github/workflows/quality.yml` から Codecov へアップロードされます。
 

package/dist/build/build.d.ts

@@ -0,0 +1,2 @@
+import { BuildOptions, BuildResult } from '../types.js';
+export declare function build(options: BuildOptions): Promise<BuildResult>;

package/dist/build/buildDependencyGraph.d.ts

@@ -0,0 +1,22 @@
+import { Loader } from '../types.js';
+import { DependencyRef } from './collectDependencies.js';
+export type DependencyEdge = {
+    from: string;
+    to: string;
+    kind: DependencyRef["kind"];
+};
+export type DependencyGraph = {
+    entries: string[];
+    dependencies: string[];
+    nodes: string[];
+    edges: DependencyEdge[];
+};
+export type BuildDependencyGraphOptions = {
+    root?: string;
+    constrainToRoot?: boolean;
+};
+/**
+ * Walk entries BFS collecting include/component/extend dependencies.
+ * Missing deps throw via loader (`file_not_found`).
+ */
+export declare function buildDependencyGraph(entries: string[], loader: Loader, options?: BuildDependencyGraphOptions): Promise<DependencyGraph>;

package/dist/build/collectDependencies.d.ts

@@ -0,0 +1,8 @@
+export type DependencyRef = {
+    kind: "include" | "component" | "extend";
+    path: string;
+};
+/**
+ * Statically collect include / component / extend paths from a source string.
+ */
+export declare function collectDependencies(source: string, fromPath?: string): DependencyRef[];

package/dist/build/collectEntryPaths.d.ts

@@ -0,0 +1,10 @@
+export type CollectEntryPathsOptions = {
+    root?: string;
+    includeUnderscoreEntries?: boolean;
+    cwd?: string;
+};
+/**
+ * Expand input paths/globs and apply `_` partial filtering.
+ * Duplicate relative paths: last wins (no warning).
+ */
+export declare function collectEntryPaths(input: string | string[], options?: CollectEntryPathsOptions): Promise<string[]>;

package/dist/build/isUnderscorePartial.d.ts

@@ -0,0 +1,4 @@
+/**
+ * True when the basename starts with `_`, or any directory segment starts with `_`.
+ */
+export declare function isUnderscorePartial(filePath: string): boolean;