@askrjs/askr 0.0.27 → 0.0.29

package/README.md

@@ -1,187 +1,95 @@
 # Askr
 
-Deterministic UI runtime with runtime enforcement.
+Askr is an actor-backed UI runtime for TypeScript applications.
+It provides explicit reactivity, routed application startup, server-side rendering,
+and static-site generation entrypoints.
 
 ## Quick Start
 
-```typescript
+```ts
 import { createIsland, state } from '@askrjs/askr';
 
 function Counter() {
   const [count, setCount] = state(0);
-  return <button onClick={() => setCount(count() + 1)}>{count()}</button>;
-}
-
-createIsland({ root: document.body, component: Counter });
-```
-
----
-
-## Core Features
-
-### Runtime Enforcement
-
-Askr validates component structure as it runs, catching mistakes with clear error messages.
-
-```typescript
-// This error is caught immediately:
-if (condition) {
-  const [x, setX] = state(0); // ❌ Hook order violation
-}
-
-// Error shows the fix:
-const [x, setX] = state(0);
-if (condition) {
-  setX(newValue); // ✅ Correct
-}
-```
 
-### Deterministic Execution
-
-Events serialize through a scheduler. State updates are atomic. Renders follow strict ordering.
-
-```typescript
-// Event 1 completes (handler + state + DOM)
-// Then Event 2 starts
-// No race conditions
-```
-
-Proven with 133 tests covering:
-
-- Event ordering (12 tests)
-- State atomicity (12 tests)
-- Transaction semantics (30 tests)
-
-### Automatic Cleanup
-
-Every component gets an AbortSignal for automatic cancellation.
-
-```typescript
-import { resource, getSignal } from '@askrjs/askr/resources';
-
-function Data({ id }) {
-  const data = resource(async () => {
-    const res = await fetch(`/api/${id}`, { signal: getSignal() });
-    return res.json();
-  }, [id]);
-
-  if (!data) return <div>Loading...</div>;
-  return <div>{data.name}</div>;
+  return <button onClick={() => setCount((value) => value + 1)}>{count()}</button>;
 }
-// Async work is cancelled automatically on unmount/navigation
-```
-
-### Explicit Reactivity
 
-Getters and setters are functions. Call the getter to read and the setter to update — this makes reactivity explicit in your code.
-
-```typescript
-const [count, setCount] = state(0);
-console.log(count()); // getter: read
-setCount(1); // setter: write
+createIsland({ root: document.body, component: Counter });
 ```
 
-Clear data flow. No hidden subscriptions.
-
----
+## What It Provides
 
-## API
+### Runtime
 
-### State
+`@askrjs/askr` exports the core runtime primitives: `state()`, `derive()`,
+`selector()`, `resource()`, routing helpers, JSX control-flow helpers, and SSR/SSG
+entrypoints.
 
-```typescript
-const [value, setValue] = state(initialValue);
+### Explicit reactivity
 
-// Read
-value();
-
-// Write
-setValue(newValue);
-
-// Update
-setValue((prev) => prev + 1);
-```
+State is read through getter functions and updated through setter functions.
 
-### Derived State
-
-```typescript
+```ts
 const [count, setCount] = state(0);
-const doubled = derive(() => count() * 2);
-
-console.log(doubled()); // Automatically updates
+console.log(count());
+setCount(1);
 ```
 
-### Lists
-
-```typescript
-const [items, setItems] = state([...]);
+### Routing and app startup
 
-For(
-  items,
-  (item) => item.id,
-  (item) => <Item {...item} />
-)
-```
+Startup belongs in `@askrjs/askr/boot`. Routing helpers live in
+`@askrjs/askr/router`.
 
-### Apps
+```ts
+import { createIsland, createSPA } from '@askrjs/askr/boot';
+import { getRoutes, route } from '@askrjs/askr/router';
 
-```typescript
-// Single component
-createIsland({
-  root: document.body,
-  component: MyComponent,
-});
+route('/', () => <Home />);
+route('/about', () => <About />);
 
-// Routed app
 createSPA({
   root: document.body,
-  component: Layout,
-  routes: [
-    { path: '/', component: Home },
-    { path: '/about', component: About },
-  ],
+  routes: getRoutes(),
 });
 ```
 
----
+### Async resources
 
-## Documentation
-
-- [Getting Started](docs/getting-started.md)
-- [State Management](docs/state.md)
-- [Runtime Enforcement](docs/enforcement.md)
-- [Deterministic Execution](docs/determinism.md)
-- [API Reference](docs/api.md)
-
----
-
-## Guarantees
-
-Askr provides provable guarantees, tested with 133 tests:
-
-- Hook order enforcement (12 tests)
-- Event serialization (12 tests)
-- Atomic transactions (30 tests)
-- Keyed reconciliation (12 tests)
-- Memory safety (8 tests)
+`resource()` manages async work with cancellation support.
 
-[See test suite →](tests/README.md)
+```ts
+import { resource } from '@askrjs/askr/resources';
 
----
-
-## Migration
-
-### Coming from React
+function Data({ id }: { id: string }) {
+  const data = resource(async ({ signal }) => {
+    const response = await fetch(`/api/${id}`, { signal });
+    return response.json();
+  }, [id]);
 
-| React                           | Askr                         |
-| ------------------------------- | ---------------------------- |
-| `const [x, setX] = useState(0)` | `const [x, setX] = state(0)` |
-| `x`                             | `x()`                        |
-| `setX(1)`                       | `setX(1)`                    |
+  if (data.pending) return <div>Loading...</div>;
+  if (data.error) return <div>Failed to load</div>;
+  return <div>{data.value.name}</div>;
+}
+```
 
-The main difference: values are functions that you call to read.
+## Documentation
 
----
+- [Documentation Index](docs/index.md)
+- [Installation](docs/getting-started/installation.md)
+- [Quick Start](docs/getting-started/quick-start.md)
+- [State Guide](docs/guides/state.md)
+- [Router Guide](docs/guides/router.md)
+- [Resources Guide](docs/guides/resources.md)
+- [SSG Guide](docs/guides/ssg.md)
+- [Runtime Enforcement](docs/concepts/runtime-enforcement.md)
+- [Determinism](docs/concepts/determinism.md)
+- [API Reference](docs/reference/api.md)
+
+## Release Notes
+
+The published package is versioned with the repository `package.json`.
+Release workflows validate the version tag before publishing.
 
 ## Install
 

package/dist/_virtual/_rolldown/runtime.js

@@ -0,0 +1,7 @@
+//#region \0rolldown/runtime.js
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, { get: (a, b) => (typeof require !== "undefined" ? require : a)[b] }) : x)(function(x) {
+	if (typeof require !== "undefined") return require.apply(this, arguments);
+	throw Error("Calling `require` for \"" + x + "\" in an environment that doesn't expose the `require` function. See https://rolldown.rs/in-depth/bundling-cjs#require-external-modules for more details.");
+});
+//#endregion
+export { __require };

package/dist/bench/components/benchmark-row.d.ts

@@ -0,0 +1,20 @@
+//#region src/bench/components/benchmark-row.d.ts
+interface BenchmarkRowData {
+  id: number;
+  label: string;
+}
+interface BenchmarkRowProps {
+  item: BenchmarkRowData;
+  isSelected: (id: number) => boolean;
+  onSelect: (id: number) => void;
+  onRemove: (id: number) => void;
+}
+declare function BenchmarkRow({
+  item,
+  isSelected,
+  onSelect,
+  onRemove
+}: BenchmarkRowProps): JSX.Element;
+//#endregion
+export { BenchmarkRowData };
+//# sourceMappingURL=benchmark-row.d.ts.map

package/dist/bench/components/benchmark-row.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"benchmark-row.d.ts","names":[],"sources":["../../../src/bench/components/benchmark-row.tsx"],"mappings":";UAAiB,gBAAA;EACf,EAAA;EACA,KAAA;AAAA;AAAA,UAGQ,iBAAA;EACR,IAAA,EAAM,gBAAA;EACN,UAAA,GAAa,EAAA;EACb,QAAA,GAAW,EAAA;EACX,QAAA,GAAW,EAAA;AAAA;AAAA,iBAGG,YAAA,CAAA;EACd,IAAA;EACA,UAAA;EACA,QAAA;EACA;AAAA,GACC,iBAAA,GAAiB,GAAA,CAAA,OAAA"}

package/dist/bench/components/benchmark-row.js

@@ -0,0 +1,42 @@
+import { jsx, jsxs } from "../../jsx-runtime.js";
+import "../../jsx-runtime2.js";
+//#region src/bench/components/benchmark-row.tsx
+function BenchmarkRow({ item, isSelected, onSelect, onRemove }) {
+	return /* @__PURE__ */ jsxs("tr", {
+		class: () => isSelected(item.id) ? "danger" : "",
+		children: [
+			/* @__PURE__ */ jsx("td", {
+				class: "col-md-1",
+				children: () => item.id
+			}, "id"),
+			/* @__PURE__ */ jsx("td", {
+				class: "col-md-4",
+				children: /* @__PURE__ */ jsx("a", {
+					onClick: (event) => {
+						event.preventDefault();
+						onSelect(item.id);
+					},
+					children: () => item.label
+				})
+			}, "label"),
+			/* @__PURE__ */ jsx("td", {
+				class: "col-md-1",
+				children: /* @__PURE__ */ jsx("a", {
+					onClick: (event) => {
+						event.preventDefault();
+						onRemove(item.id);
+					},
+					children: /* @__PURE__ */ jsx("span", {
+						class: "glyphicon glyphicon-remove",
+						"aria-hidden": "true"
+					})
+				})
+			}, "remove"),
+			/* @__PURE__ */ jsx("td", { class: "col-md-6" }, "spacer")
+		]
+	});
+}
+//#endregion
+export { BenchmarkRow };
+
+//# sourceMappingURL=benchmark-row.js.map

package/dist/bench/components/benchmark-row.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"benchmark-row.js","names":[],"sources":["../../../src/bench/components/benchmark-row.tsx"],"sourcesContent":["export interface BenchmarkRowData {\n  id: number;\n  label: string;\n}\n\ninterface BenchmarkRowProps {\n  item: BenchmarkRowData;\n  isSelected: (id: number) => boolean;\n  onSelect: (id: number) => void;\n  onRemove: (id: number) => void;\n}\n\nexport function BenchmarkRow({\n  item,\n  isSelected,\n  onSelect,\n  onRemove,\n}: BenchmarkRowProps) {\n  return (\n    <tr class={() => (isSelected(item.id) ? 'danger' : '')}>\n      <td key=\"id\" class=\"col-md-1\">\n        {() => item.id}\n      </td>\n      <td key=\"label\" class=\"col-md-4\">\n        <a\n          onClick={(event: MouseEvent) => {\n            event.preventDefault();\n            onSelect(item.id);\n          }}\n        >\n          {() => item.label}\n        </a>\n      </td>\n      <td key=\"remove\" class=\"col-md-1\">\n        <a\n          onClick={(event: MouseEvent) => {\n            event.preventDefault();\n            onRemove(item.id);\n          }}\n        >\n          <span class=\"glyphicon glyphicon-remove\" aria-hidden=\"true\" />\n        </a>\n      </td>\n      <td key=\"spacer\" class=\"col-md-6\" />\n    </tr>\n  );\n}\n"],"mappings":";;;AAYA,SAAgB,aAAa,EAC3B,MACA,YACA,UACA,YACoB;AACpB,QACE,qBAAC,MAAD;EAAI,aAAc,WAAW,KAAK,GAAG,GAAG,WAAW;YAAnD;GACE,oBAAC,MAAD;IAAa,OAAM;oBACV,KAAK;IACT,EAFG,KAEH;GACL,oBAAC,MAAD;IAAgB,OAAM;cACpB,oBAAC,KAAD;KACE,UAAU,UAAsB;AAC9B,YAAM,gBAAgB;AACtB,eAAS,KAAK,GAAG;;qBAGZ,KAAK;KACV,CAAA;IACD,EATG,QASH;GACL,oBAAC,MAAD;IAAiB,OAAM;cACrB,oBAAC,KAAD;KACE,UAAU,UAAsB;AAC9B,YAAM,gBAAgB;AACtB,eAAS,KAAK,GAAG;;eAGnB,oBAAC,QAAD;MAAM,OAAM;MAA6B,eAAY;MAAS,CAAA;KAC5D,CAAA;IACD,EATG,SASH;GACL,oBAAC,MAAD,EAAiB,OAAM,YAAa,EAA5B,SAA4B;GACjC"}

package/dist/bench/components/benchmark-table.js

@@ -0,0 +1,25 @@
+import { jsx } from "../../jsx-runtime.js";
+import "../../jsx-runtime2.js";
+import { For } from "../../control/for.js";
+import "../../index.js";
+import { BenchmarkRow } from "./benchmark-row.js";
+//#region src/bench/components/benchmark-table.tsx
+function BenchmarkTable({ rows, isSelected, onSelect, onRemove }) {
+	return /* @__PURE__ */ jsx("table", {
+		class: "table table-hover table-striped test-data",
+		children: /* @__PURE__ */ jsx("tbody", { children: /* @__PURE__ */ jsx(For, {
+			each: () => rows(),
+			by: (item) => item.id,
+			children: (item) => /* @__PURE__ */ jsx(BenchmarkRow, {
+				item,
+				isSelected,
+				onSelect,
+				onRemove
+			})
+		}) })
+	});
+}
+//#endregion
+export { BenchmarkTable };
+
+//# sourceMappingURL=benchmark-table.js.map

package/dist/bench/components/benchmark-table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"benchmark-table.js","names":[],"sources":["../../../src/bench/components/benchmark-table.tsx"],"sourcesContent":["import { For, type State } from '../../index';\nimport { BenchmarkRow, type BenchmarkRowData } from './benchmark-row';\n\ninterface BenchmarkTableProps {\n  rows: State<BenchmarkRowData[]>;\n  isSelected: (id: number) => boolean;\n  onSelect: (id: number) => void;\n  onRemove: (id: number) => void;\n}\n\nexport function BenchmarkTable({\n  rows,\n  isSelected,\n  onSelect,\n  onRemove,\n}: BenchmarkTableProps) {\n  return (\n    <table class=\"table table-hover table-striped test-data\">\n      <tbody>\n        {\n          <For each={() => rows()} by={(item) => item.id}>\n            {(item) => (\n              <BenchmarkRow\n                item={item}\n                isSelected={isSelected}\n                onSelect={onSelect}\n                onRemove={onRemove}\n              />\n            )}\n          </For>\n        }\n      </tbody>\n    </table>\n  );\n}\n"],"mappings":";;;;;;AAUA,SAAgB,eAAe,EAC7B,MACA,YACA,UACA,YACsB;AACtB,QACE,oBAAC,SAAD;EAAO,OAAM;YACX,oBAAC,SAAD,EAAA,UAEI,oBAAC,KAAD;GAAK,YAAY,MAAM;GAAE,KAAK,SAAS,KAAK;cACxC,SACA,oBAAC,cAAD;IACQ;IACM;IACF;IACA;IACV,CAAA;GAEA,CAAA,EAEF,CAAA;EACF,CAAA"}

package/dist/benchmark.d.ts

@@ -0,0 +1,22 @@
+import { BenchmarkRowData } from "./bench/components/benchmark-row.js";
+
+//#region src/bench/benchmark-entry.d.ts
+type RowData = BenchmarkRowData;
+interface BenchmarkMetadata {
+  packageName: string;
+  packageVersion: string;
+  buildLabel: string;
+}
+declare const benchmarkMetadata: BenchmarkMetadata;
+declare function getBenchmarkMetadata(): BenchmarkMetadata;
+declare function mountBenchmark(root: Element, initialRows?: RowData[]): {
+  setRows(rows: RowData[]): void;
+  setSelected(id: number | null): void;
+  cleanup(): void;
+};
+declare const _default: {
+  mountBenchmark: typeof mountBenchmark;
+};
+//#endregion
+export { BenchmarkMetadata, benchmarkMetadata, _default as default, getBenchmarkMetadata, mountBenchmark };
+//# sourceMappingURL=benchmark.d.ts.map

package/dist/benchmark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"benchmark.d.ts","names":[],"sources":["../src/bench/benchmark-entry.tsx"],"mappings":";;;KAWK,OAAA,GAAU,gBAAA;AAAA,UAEE,iBAAA;EACf,WAAA;EACA,cAAA;EACA,UAAA;AAAA;AAAA,cAYW,iBAAA,EAAmB,iBAAA;AAAA,iBAOhB,oBAAA,CAAA,GAAwB,iBAAA;AAAA,iBAIxB,cAAA,CAAe,IAAA,EAAM,OAAA,EAAS,WAAA,GAAc,OAAA;gBAmC1C,OAAA;;;;cAcjB,QAAA"}

package/dist/benchmark.js

@@ -1 +1,64 @@
-import"./index.js";import"./for/index.js";import{globalScheduler as n}from"./runtime/scheduler.js";import{state as s}from"./runtime/state.js";import{For as a}from"./for/for.js";import{createIsland as i}from"./boot/index.js";function h(c,o){const l=Array.isArray(o)?o:[];let t,p;return i({root:c,component:()=>{t=s([]),p=s(null);const r=e=>p.set(e);return{type:"div",props:{},children:[{type:"table",props:{},children:[{type:"tbody",props:{},children:[a(()=>t(),e=>e.id,e=>({type:"tr",props:{class:()=>p()===e.id?"danger":""},children:[{type:"td",props:{},children:[String(e.id)]},{type:"td",props:{},children:[{type:"a",props:{onClick:d=>{d.preventDefault(),r(e.id)}},children:[e.label]}]}]}))]}]}]}}}),l.length>0&&t&&t.set(l),{setRows(r){t.set(r),n.flush()},setSelected(r){p.set(r),n.flush()},cleanup(){}}}const A={mountBenchmark:h};export{A as default,h as mountBenchmark};
+import { globalScheduler } from "./runtime/scheduler.js";
+import { jsx } from "./jsx-runtime.js";
+import { installRendererBridge } from "./renderer/index.js";
+import { state } from "./runtime/state.js";
+import { selector } from "./runtime/selector.js";
+import { createIsland } from "./boot/index.js";
+import "./jsx-runtime2.js";
+import { BenchmarkTable } from "./bench/components/benchmark-table.js";
+//#region src/bench/benchmark-entry.tsx
+installRendererBridge();
+const benchmarkMetadata = {
+	packageName: "@askrjs/askr",
+	packageVersion: "0.0.29",
+	buildLabel: "0.0.29-local"
+};
+function getBenchmarkMetadata() {
+	return { ...benchmarkMetadata };
+}
+function mountBenchmark(root, initialRows) {
+	const initialRowsTyped = Array.isArray(initialRows) ? initialRows : [];
+	let dataState;
+	let selectedState;
+	const App = () => {
+		dataState = state(initialRowsTyped);
+		selectedState = state(null);
+		dataState._hasBeenRead = true;
+		const isSelected = selector(selectedState);
+		const select = (id) => selectedState.set(id);
+		const remove = (id) => {
+			dataState.set((rows) => rows.filter((item) => item.id !== id));
+			selectedState.set((selected) => selected === id ? null : selected);
+		};
+		return /* @__PURE__ */ jsx("div", {
+			class: "container",
+			children: /* @__PURE__ */ jsx(BenchmarkTable, {
+				rows: dataState,
+				isSelected,
+				onSelect: select,
+				onRemove: remove
+			})
+		});
+	};
+	createIsland({
+		root,
+		component: App
+	});
+	globalScheduler.flush();
+	return {
+		setRows(rows) {
+			dataState.set(rows);
+			globalScheduler.flush();
+		},
+		setSelected(id) {
+			selectedState.set(id);
+			globalScheduler.flush();
+		},
+		cleanup() {}
+	};
+}
+var benchmark_entry_default = { mountBenchmark };
+//#endregion
+export { benchmarkMetadata, benchmark_entry_default as default, getBenchmarkMetadata, mountBenchmark };
+
+//# sourceMappingURL=benchmark.js.map

package/dist/benchmark.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"benchmark.js","names":[],"sources":["../src/bench/benchmark-entry.tsx"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\nimport { createIsland } from '../boot';\nimport { installRendererBridge } from '../renderer';\nimport { selector } from '../runtime/selector';\nimport { state, State } from '../runtime/state';\nimport { globalScheduler } from '../runtime/scheduler';\nimport { BenchmarkTable } from './components/benchmark-table';\nimport type { BenchmarkRowData } from './components/benchmark-row';\n\ninstallRendererBridge();\n\ntype RowData = BenchmarkRowData;\n\nexport interface BenchmarkMetadata {\n  packageName: string;\n  packageVersion: string;\n  buildLabel: string;\n}\n\nconst packageName =\n  process.env.ASKR_PACKAGE_NAME ||\n  process.env.npm_package_name ||\n  '@askrjs/askr';\nconst packageVersion =\n  process.env.ASKR_PACKAGE_VERSION ||\n  process.env.npm_package_version ||\n  '0.0.0';\n\nexport const benchmarkMetadata: BenchmarkMetadata = {\n  packageName,\n  packageVersion,\n  buildLabel:\n    process.env.ASKR_BENCHMARK_BUILD_LABEL || `${packageVersion}-local`,\n};\n\nexport function getBenchmarkMetadata(): BenchmarkMetadata {\n  return { ...benchmarkMetadata };\n}\n\nexport function mountBenchmark(root: Element, initialRows?: RowData[]) {\n  const initialRowsTyped: RowData[] = Array.isArray(initialRows)\n    ? initialRows\n    : [];\n  let dataState!: State<RowData[]>;\n  let selectedState!: State<number | null>;\n\n  const App = () => {\n    dataState = state<RowData[]>(initialRowsTyped);\n    selectedState = state<number | null>(null);\n    dataState._hasBeenRead = true;\n    const isSelected = selector(selectedState);\n\n    const select = (id: number) => selectedState.set(id);\n    const remove = (id: number) => {\n      dataState.set((rows) => rows.filter((item) => item.id !== id));\n      selectedState.set((selected) => (selected === id ? null : selected));\n    };\n\n    return (\n      <div class=\"container\">\n        <BenchmarkTable\n          rows={dataState}\n          isSelected={isSelected}\n          onSelect={select}\n          onRemove={remove}\n        />\n      </div>\n    );\n  };\n\n  createIsland({ root, component: App as any });\n  globalScheduler.flush();\n\n  return {\n    setRows(rows: RowData[]) {\n      dataState.set(rows);\n      // Ensure work is flushed so external harnesses (like JFB) that check the DOM\n      // immediately after calling `setRows` observe the committed DOM.\n      globalScheduler.flush();\n    },\n    setSelected(id: number | null) {\n      selectedState.set(id);\n      globalScheduler.flush();\n    },\n    cleanup() {\n      // nothing to do; outer test may clean the container\n    },\n  };\n}\n\nexport default { mountBenchmark };\n"],"mappings":";;;;;;;;;AASA,uBAAuB;AAmBvB,MAAa,oBAAuC;CAClD;CACA;CACA,YAAA;CAED;AAED,SAAgB,uBAA0C;AACxD,QAAO,EAAE,GAAG,mBAAmB;;AAGjC,SAAgB,eAAe,MAAe,aAAyB;CACrE,MAAM,mBAA8B,MAAM,QAAQ,YAAY,GAC1D,cACA,EAAE;CACN,IAAI;CACJ,IAAI;CAEJ,MAAM,YAAY;AAChB,cAAY,MAAiB,iBAAiB;AAC9C,kBAAgB,MAAqB,KAAK;AAC1C,YAAU,eAAe;EACzB,MAAM,aAAa,SAAS,cAAc;EAE1C,MAAM,UAAU,OAAe,cAAc,IAAI,GAAG;EACpD,MAAM,UAAU,OAAe;AAC7B,aAAU,KAAK,SAAS,KAAK,QAAQ,SAAS,KAAK,OAAO,GAAG,CAAC;AAC9D,iBAAc,KAAK,aAAc,aAAa,KAAK,OAAO,SAAU;;AAGtE,SACE,oBAAC,OAAD;GAAK,OAAM;aACT,oBAAC,gBAAD;IACE,MAAM;IACM;IACZ,UAAU;IACV,UAAU;IACV,CAAA;GACE,CAAA;;AAIV,cAAa;EAAE;EAAM,WAAW;EAAY,CAAC;AAC7C,iBAAgB,OAAO;AAEvB,QAAO;EACL,QAAQ,MAAiB;AACvB,aAAU,IAAI,KAAK;AAGnB,mBAAgB,OAAO;;EAEzB,YAAY,IAAmB;AAC7B,iBAAc,IAAI,GAAG;AACrB,mBAAgB,OAAO;;EAEzB,UAAU;EAGX;;AAGH,IAAA,0BAAe,EAAE,gBAAgB"}

package/dist/bin/askr-ssg.d.ts

@@ -0,0 +1,28 @@
+import { createStaticGen } from "../ssg/create-static-gen.js";
+//#region src/bin/askr-ssg.d.ts
+interface ParsedCliArgs {
+  configPath: string;
+  outputDir: string;
+  workers: number | 'auto';
+  incremental: boolean;
+  changedKeys: string[];
+  changedRoutes: string[];
+  forceFull: boolean;
+  help: boolean;
+}
+interface CliIo {
+  log: (...args: unknown[]) => void;
+  error: (...args: unknown[]) => void;
+}
+interface CliDeps {
+  cwd: () => string;
+  now: () => number;
+  existsSync: (path: string) => boolean;
+  importConfig: (path: string) => Promise<Record<string, unknown>>;
+  createStaticGen: typeof createStaticGen;
+}
+declare function parseCliArgs(args: string[]): ParsedCliArgs;
+declare function runCli(args: string[], deps?: Partial<CliDeps>, io?: CliIo): Promise<number>;
+//#endregion
+export { ParsedCliArgs, parseCliArgs, runCli };
+//# sourceMappingURL=askr-ssg.d.ts.map

package/dist/bin/askr-ssg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"askr-ssg.d.ts","names":[],"sources":["../../src/bin/askr-ssg.ts"],"mappings":";;UAuBiB,aAAA;EACf,UAAA;EACA,SAAA;EACA,OAAA;EACA,WAAA;EACA,WAAA;EACA,aAAA;EACA,SAAA;EACA,IAAA;AAAA;AAAA,UAGQ,KAAA;EACR,GAAA,MAAS,IAAA;EACT,KAAA,MAAW,IAAA;AAAA;AAAA,UAGH,OAAA;EACR,GAAA;EACA,GAAA;EACA,UAAA,GAAa,IAAA;EACb,YAAA,GAAe,IAAA,aAAiB,OAAA,CAAQ,MAAA;EACxC,eAAA,SAAwB,eAAA;AAAA;AAAA,iBA2CV,YAAA,CAAa,IAAA,aAAiB,aAAA;AAAA,iBAqExB,MAAA,CACpB,IAAA,YACA,IAAA,GAAM,OAAA,CAAQ,OAAA,GACd,EAAA,GAAI,KAAA,GACH,OAAA"}

package/dist/bin/askr-ssg.js

@@ -0,0 +1,171 @@
+#!/usr/bin/env node
+import { createStaticGen } from "../ssg/create-static-gen.js";
+import "../ssg/index.js";
+import * as pathModule from "path";
+import * as fsModule from "fs";
+//#region src/bin/askr-ssg.ts
+/**
+* askr-ssg CLI
+*
+* Usage: askr-ssg --config path/to/config.ts --output dist/static
+*/
+const { resolve } = pathModule;
+const { existsSync } = fsModule;
+function toFileUrl(filePath) {
+	const normalized = resolve(filePath).replace(/\\/g, "/");
+	return `file://${normalized.startsWith("/") ? "" : "/"}${encodeURI(normalized)}`;
+}
+const defaultCliDeps = {
+	cwd: () => process.cwd(),
+	now: () => performance.now(),
+	existsSync,
+	importConfig: async (path) => await import(toFileUrl(path)),
+	createStaticGen
+};
+const helpText = `
+askr-ssg - Static Site Generation for Askr
+
+Usage:
+  askr-ssg --config <path> --output <dir> [--incremental]
+
+Options:
+  --config <path>         Path to SSG config file (TypeScript module)
+  --output <dir>          Output directory for generated HTML
+  --workers <n|auto>      Preferred render worker count for SSG throughput
+  --incremental           Use incremental generation if a manifest exists
+  --changed-key <key>     Mark an invalidation key as changed (repeatable)
+  --changed-route <path>  Mark a concrete route path as changed (repeatable)
+  --force-full            Force a full rebuild even with incremental flags
+  --help                  Show this help message
+
+Example:
+  askr-ssg --config ./ssg.config.ts --output ./dist/static --incremental --changed-key blog/post-123
+
+TypeScript config execution:
+  Use tsx to run the CLI with TS config loading:
+  tsx node_modules/@askrjs/askr/dist/bin/askr-ssg.js --config ./ssg.config.ts --output ./dist/static
+`;
+function parseCliArgs(args) {
+	const parsed = {
+		configPath: "",
+		outputDir: "",
+		workers: 1,
+		incremental: false,
+		changedKeys: [],
+		changedRoutes: [],
+		forceFull: false,
+		help: false
+	};
+	for (let i = 0; i < args.length; i++) if (args[i] === "--config" && i + 1 < args.length) {
+		parsed.configPath = args[i + 1];
+		i++;
+	} else if (args[i] === "--output" && i + 1 < args.length) {
+		parsed.outputDir = args[i + 1];
+		i++;
+	} else if (args[i] === "--workers" && i + 1 < args.length) {
+		parsed.workers = args[i + 1] === "auto" ? "auto" : Number(args[i + 1]);
+		i++;
+	} else if (args[i] === "--changed-key" && i + 1 < args.length) {
+		parsed.changedKeys.push(args[i + 1]);
+		i++;
+	} else if (args[i] === "--changed-route" && i + 1 < args.length) {
+		parsed.changedRoutes.push(args[i + 1]);
+		i++;
+	} else if (args[i] === "--incremental") parsed.incremental = true;
+	else if (args[i] === "--force-full") parsed.forceFull = true;
+	else if (args[i] === "--help" || args[i] === "-h") parsed.help = true;
+	return parsed;
+}
+function toGenerateOptions(args) {
+	return {
+		mode: args.incremental ? "incremental" : "full",
+		changedKeys: args.changedKeys,
+		changedRoutes: args.changedRoutes,
+		forceFull: args.forceFull
+	};
+}
+function printSummary(io, outputDir, durationSeconds, result) {
+	io.log("");
+	io.log(`Generation complete in ${durationSeconds}s`);
+	io.log(`   Mode:      ${result.mode}`);
+	io.log(`   Generated: ${result.successful}/${result.totalRoutes} routes`);
+	io.log(`   Failed:    ${result.failed} routes`);
+	io.log(`   Rebuilt:   ${result.rebuilt} routes`);
+	io.log(`   Skipped:   ${result.skipped} routes`);
+	io.log(`   Removed:   ${result.removed} routes`);
+	io.log(`   CacheHit:  ${result.cacheHits} routes`);
+	io.log(`   Output:    ${outputDir}`);
+	io.log(`   Metadata:  ${outputDir}/metadata.json`);
+	io.log("");
+}
+async function runCli(args, deps = {}, io = console) {
+	const parsed = parseCliArgs(args);
+	if (parsed.help) {
+		io.log(helpText);
+		return 0;
+	}
+	if (!parsed.configPath) {
+		io.error("Error: --config argument is required");
+		return 1;
+	}
+	if (!parsed.configPath.endsWith(".ts")) {
+		io.error("Error: --config must point to a TypeScript file (.ts)");
+		return 1;
+	}
+	if (!parsed.outputDir) {
+		io.error("Error: --output argument is required");
+		return 1;
+	}
+	const resolvedDeps = {
+		...defaultCliDeps,
+		...deps
+	};
+	const resolvedConfigPath = resolve(resolvedDeps.cwd(), parsed.configPath);
+	const resolvedOutputDir = resolve(resolvedDeps.cwd(), parsed.outputDir);
+	if (!resolvedDeps.existsSync(resolvedConfigPath)) {
+		io.error(`Error: Config file not found: ${resolvedConfigPath}`);
+		return 1;
+	}
+	try {
+		io.log(`Loading config: ${resolvedConfigPath}`);
+		const configModule = await resolvedDeps.importConfig(resolvedConfigPath);
+		const config = configModule.default || configModule;
+		if (!Array.isArray(config.routes)) {
+			io.error("Error: Config must export routes array");
+			return 1;
+		}
+		io.log(`Generating ${config.routes.length} routes...`);
+		const ssg = resolvedDeps.createStaticGen({
+			routes: config.routes,
+			outputDir: resolvedOutputDir,
+			seed: config.seed,
+			dataOverrides: config.dataOverrides,
+			concurrency: config.concurrency,
+			parallelism: parsed.workers
+		});
+		const startTime = resolvedDeps.now();
+		const result = await ssg.generate(toGenerateOptions(parsed));
+		printSummary(io, resolvedOutputDir, ((resolvedDeps.now() - startTime) / 1e3).toFixed(2), result);
+		if (result.failed > 0) {
+			io.log("Errors encountered:");
+			for (const route of result.routes) if (route.status === "error") io.log(`   ${route.path}: ${route.error}`);
+			io.log("");
+			return 1;
+		}
+		return 0;
+	} catch (error) {
+		io.error("Generation failed:");
+		io.error(error instanceof Error ? error.message : String(error));
+		if (error instanceof Error && error.stack) io.error(error.stack);
+		return 1;
+	}
+}
+async function main() {
+	const exitCode = await runCli(process.argv.slice(2));
+	process.exit(exitCode);
+}
+if (process.argv[1] && import.meta.url === toFileUrl(process.argv[1])) main();
+//#endregion
+export { parseCliArgs, runCli };
+
+//# sourceMappingURL=askr-ssg.js.map