@bestagentkits/render 0.1.1-next.1 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +109 -0
- package/README.md +189 -34
- package/assets/fonts/bricolage-grotesque/OFL.txt +93 -0
- package/assets/fonts/fraunces/OFL.txt +93 -0
- package/assets/fonts/geist/OFL.txt +93 -0
- package/assets/fonts/inter-tight/OFL.txt +93 -0
- package/assets/fonts/jetbrains-mono/OFL.txt +93 -0
- package/assets/fonts/plus-jakarta-sans/OFL.txt +93 -0
- package/dist/cli.d.ts +2 -0
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +51 -10
- package/dist/cli.js.map +1 -1
- package/dist/mcp-server.d.ts +37 -0
- package/dist/mcp-server.d.ts.map +1 -0
- package/dist/mcp-server.js +274 -0
- package/dist/mcp-server.js.map +1 -0
- package/dist/registry/roster.d.ts +1 -1
- package/dist/registry/roster.d.ts.map +1 -1
- package/dist/registry/roster.js +222 -6
- package/dist/registry/roster.js.map +1 -1
- package/dist/render/block-helpers.d.ts +52 -0
- package/dist/render/block-helpers.d.ts.map +1 -0
- package/dist/render/block-helpers.js +113 -0
- package/dist/render/block-helpers.js.map +1 -0
- package/dist/render/blocks.d.ts +3 -4
- package/dist/render/blocks.d.ts.map +1 -1
- package/dist/render/blocks.js +126 -121
- package/dist/render/blocks.js.map +1 -1
- package/dist/render/charts.d.ts +5 -0
- package/dist/render/charts.d.ts.map +1 -1
- package/dist/render/charts.js +205 -90
- package/dist/render/charts.js.map +1 -1
- package/dist/render/derived-variables.d.ts +17 -0
- package/dist/render/derived-variables.d.ts.map +1 -0
- package/dist/render/derived-variables.js +17 -0
- package/dist/render/derived-variables.js.map +1 -0
- package/dist/render/diagram-fallback.d.ts +25 -0
- package/dist/render/diagram-fallback.d.ts.map +1 -0
- package/dist/render/diagram-fallback.js +86 -0
- package/dist/render/diagram-fallback.js.map +1 -0
- package/dist/render/document.d.ts +4 -0
- package/dist/render/document.d.ts.map +1 -1
- package/dist/render/document.js +34 -6
- package/dist/render/document.js.map +1 -1
- package/dist/render/effects-styles.d.ts +14 -0
- package/dist/render/effects-styles.d.ts.map +1 -0
- package/dist/render/effects-styles.js +39 -0
- package/dist/render/effects-styles.js.map +1 -0
- package/dist/render/embedded-fonts.generated.d.ts +22 -0
- package/dist/render/embedded-fonts.generated.d.ts.map +1 -0
- package/dist/render/embedded-fonts.generated.js +59 -0
- package/dist/render/embedded-fonts.generated.js.map +1 -0
- package/dist/render/feature-styles.d.ts +14 -0
- package/dist/render/feature-styles.d.ts.map +1 -0
- package/dist/render/feature-styles.js +161 -0
- package/dist/render/feature-styles.js.map +1 -0
- package/dist/render/font-faces.d.ts +22 -0
- package/dist/render/font-faces.d.ts.map +1 -0
- package/dist/render/font-faces.js +60 -0
- package/dist/render/font-faces.js.map +1 -0
- package/dist/render/outline.d.ts +21 -0
- package/dist/render/outline.d.ts.map +1 -0
- package/dist/render/outline.js +44 -0
- package/dist/render/outline.js.map +1 -0
- package/dist/render/render.d.ts.map +1 -1
- package/dist/render/render.js +53 -10
- package/dist/render/render.js.map +1 -1
- package/dist/render/runtime.d.ts.map +1 -1
- package/dist/render/runtime.js +184 -10
- package/dist/render/runtime.js.map +1 -1
- package/dist/render/showcase-blocks.d.ts +47 -0
- package/dist/render/showcase-blocks.d.ts.map +1 -0
- package/dist/render/showcase-blocks.js +349 -0
- package/dist/render/showcase-blocks.js.map +1 -0
- package/dist/render/showcase-styles.d.ts +15 -0
- package/dist/render/showcase-styles.d.ts.map +1 -0
- package/dist/render/showcase-styles.js +217 -0
- package/dist/render/showcase-styles.js.map +1 -0
- package/dist/render/signature-styles.d.ts +18 -0
- package/dist/render/signature-styles.d.ts.map +1 -0
- package/dist/render/signature-styles.js +41 -0
- package/dist/render/signature-styles.js.map +1 -0
- package/dist/render/styles.d.ts +18 -9
- package/dist/render/styles.d.ts.map +1 -1
- package/dist/render/styles.js +224 -128
- package/dist/render/styles.js.map +1 -1
- package/dist/render/surface-styles.d.ts +24 -0
- package/dist/render/surface-styles.d.ts.map +1 -0
- package/dist/render/surface-styles.js +41 -0
- package/dist/render/surface-styles.js.map +1 -0
- package/dist/render/verify.d.ts.map +1 -1
- package/dist/render/verify.js +30 -0
- package/dist/render/verify.js.map +1 -1
- package/dist/spec/normalize.d.ts.map +1 -1
- package/dist/spec/normalize.js +32 -0
- package/dist/spec/normalize.js.map +1 -1
- package/dist/theme/load-theme.d.ts +2 -2
- package/dist/theme/load-theme.d.ts.map +1 -1
- package/dist/theme/load-theme.js +46 -10
- package/dist/theme/load-theme.js.map +1 -1
- package/dist/theme/presets.d.ts +4 -3
- package/dist/theme/presets.d.ts.map +1 -1
- package/dist/theme/presets.js +35 -18
- package/dist/theme/presets.js.map +1 -1
- package/dist/theme/tokens.d.ts.map +1 -1
- package/dist/theme/tokens.js +4 -4
- package/dist/theme/tokens.js.map +1 -1
- package/dist/version.d.ts +1 -1
- package/dist/version.d.ts.map +1 -1
- package/dist/version.js +1 -1
- package/dist/version.js.map +1 -1
- package/llms.txt +25 -0
- package/package.json +9 -3
package/dist/version.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO,
|
|
1
|
+
{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B,sEAAsE;AACtE,eAAO,MAAM,YAAY,0BAA0B,CAAC"}
|
package/dist/version.js
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
* asserts that it stays equal to the `version` field in `package.json`, so a
|
|
7
7
|
* release that forgets one of them fails fast.
|
|
8
8
|
*/
|
|
9
|
-
export const VERSION = '0.
|
|
9
|
+
export const VERSION = '0.2.0';
|
|
10
10
|
/** Published package name, used by CLI output and release tooling. */
|
|
11
11
|
export const PACKAGE_NAME = '@bestagentkits/render';
|
|
12
12
|
//# sourceMappingURL=version.js.map
|
package/dist/version.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,
|
|
1
|
+
{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,sEAAsE;AACtE,MAAM,CAAC,MAAM,YAAY,GAAG,uBAAuB,CAAC"}
|
package/llms.txt
ADDED
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
# AK Render
|
|
2
|
+
|
|
3
|
+
> Declarative page compiler for coding agents: a short YAML or JSON Page Spec in, one deterministic, offline, self-contained HTML file out. The agent describes meaning; the compiler owns layout, colour, typography, motion, accessibility and security. npm package: `@bestagentkits/render`, CLI: `ak-render`.
|
|
4
|
+
|
|
5
|
+
Agent loop: `ak-render catalog` once, `ak-render describe <type> --json` for each block you use, `ak-render validate <spec|-> --json` and fix every diagnostic by its JSON path, then `ak-render <spec|-> --out page.html`. Pass `-` to read the spec from stdin. `ak-render mcp` exposes the same loop as MCP tools over stdio (`catalog`, `describe`, `validate`, `render`, `themes`); `render` writes the file and returns only a summary.
|
|
6
|
+
|
|
7
|
+
Do not write HTML, CSS or inline scripts: the spec has no field for them. Output makes no network request unless the spec opts in under `policy.network`.
|
|
8
|
+
|
|
9
|
+
## Docs
|
|
10
|
+
|
|
11
|
+
- [Agent guide](https://github.com/bestagentkits/ak-render/blob/main/docs/agent-guide.md): the loop, a minimal spec, MCP setup, and rules that save retries
|
|
12
|
+
- [README](https://github.com/bestagentkits/ak-render/blob/main/README.md): install, library API and CLI
|
|
13
|
+
- [Themes](https://github.com/bestagentkits/ak-render/blob/main/docs/themes.md): built-in presets, custom presets and embedded fonts
|
|
14
|
+
- [Media and network policy](https://github.com/bestagentkits/ak-render/blob/main/docs/media-policy.md): what loads offline and how to opt in
|
|
15
|
+
|
|
16
|
+
## Reference
|
|
17
|
+
|
|
18
|
+
- [Page Spec JSON Schema](https://github.com/bestagentkits/ak-render/blob/main/schema/page-spec.v1.json): machine-readable schema for editors and validators
|
|
19
|
+
- [Example specs](https://github.com/bestagentkits/ak-render/tree/main/fixtures/pages): plan, explain, recap, diff, dashboard, media, interactive and showcase pages
|
|
20
|
+
|
|
21
|
+
## Optional
|
|
22
|
+
|
|
23
|
+
- [Design system](https://github.com/bestagentkits/ak-render/blob/main/DESIGN.md): how the emitted pages look and why
|
|
24
|
+
- [ADR 0001](https://github.com/bestagentkits/ak-render/blob/main/docs/adr/0001-page-spec-compiler-boundary.md): the compiler boundary
|
|
25
|
+
- [Changelog](https://github.com/bestagentkits/ak-render/blob/main/CHANGELOG.md)
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@bestagentkits/render",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.2.0",
|
|
4
4
|
"private": false,
|
|
5
5
|
"description": "Declarative Page Spec compiler: deterministic, offline, interactive standalone HTML from JSON/YAML.",
|
|
6
6
|
"keywords": [
|
|
@@ -42,7 +42,9 @@
|
|
|
42
42
|
"dist",
|
|
43
43
|
"LICENSE",
|
|
44
44
|
"README.md",
|
|
45
|
-
"CHANGELOG.md"
|
|
45
|
+
"CHANGELOG.md",
|
|
46
|
+
"llms.txt",
|
|
47
|
+
"assets/fonts/*/OFL.txt"
|
|
46
48
|
],
|
|
47
49
|
"sideEffects": false,
|
|
48
50
|
"scripts": {
|
|
@@ -60,11 +62,15 @@
|
|
|
60
62
|
"bench:render": "node benchmarks/render-benchmark.mjs",
|
|
61
63
|
"bench:browser": "playwright test tests/browser/benchmark.spec.ts",
|
|
62
64
|
"bench": "pnpm build && pnpm bench:render && pnpm bench:browser",
|
|
65
|
+
"fonts:generate": "node scripts/generate-embedded-fonts.mjs",
|
|
66
|
+
"fonts:check": "node scripts/generate-embedded-fonts.mjs --check",
|
|
63
67
|
"schema:generate": "node scripts/generate-json-schema.mjs",
|
|
64
68
|
"schema:check": "node scripts/generate-json-schema.mjs --check",
|
|
65
69
|
"snapshots:generate": "node scripts/generate-theme-snapshots.mjs",
|
|
66
70
|
"snapshots:check": "node scripts/generate-theme-snapshots.mjs --check",
|
|
67
|
-
"
|
|
71
|
+
"site:build": "pnpm build && node scripts/build-site.mjs",
|
|
72
|
+
"site:deploy": "pnpm site:build && wrangler deploy --config site/wrangler.jsonc",
|
|
73
|
+
"verify": "pnpm lint && pnpm typecheck && pnpm fonts:check && pnpm test && pnpm build"
|
|
68
74
|
},
|
|
69
75
|
"devDependencies": {
|
|
70
76
|
"@biomejs/biome": "^2.4.12",
|