@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.
Files changed (113) hide show
  1. package/CHANGELOG.md +109 -0
  2. package/README.md +189 -34
  3. package/assets/fonts/bricolage-grotesque/OFL.txt +93 -0
  4. package/assets/fonts/fraunces/OFL.txt +93 -0
  5. package/assets/fonts/geist/OFL.txt +93 -0
  6. package/assets/fonts/inter-tight/OFL.txt +93 -0
  7. package/assets/fonts/jetbrains-mono/OFL.txt +93 -0
  8. package/assets/fonts/plus-jakarta-sans/OFL.txt +93 -0
  9. package/dist/cli.d.ts +2 -0
  10. package/dist/cli.d.ts.map +1 -1
  11. package/dist/cli.js +51 -10
  12. package/dist/cli.js.map +1 -1
  13. package/dist/mcp-server.d.ts +37 -0
  14. package/dist/mcp-server.d.ts.map +1 -0
  15. package/dist/mcp-server.js +274 -0
  16. package/dist/mcp-server.js.map +1 -0
  17. package/dist/registry/roster.d.ts +1 -1
  18. package/dist/registry/roster.d.ts.map +1 -1
  19. package/dist/registry/roster.js +222 -6
  20. package/dist/registry/roster.js.map +1 -1
  21. package/dist/render/block-helpers.d.ts +52 -0
  22. package/dist/render/block-helpers.d.ts.map +1 -0
  23. package/dist/render/block-helpers.js +113 -0
  24. package/dist/render/block-helpers.js.map +1 -0
  25. package/dist/render/blocks.d.ts +3 -4
  26. package/dist/render/blocks.d.ts.map +1 -1
  27. package/dist/render/blocks.js +126 -121
  28. package/dist/render/blocks.js.map +1 -1
  29. package/dist/render/charts.d.ts +5 -0
  30. package/dist/render/charts.d.ts.map +1 -1
  31. package/dist/render/charts.js +205 -90
  32. package/dist/render/charts.js.map +1 -1
  33. package/dist/render/derived-variables.d.ts +17 -0
  34. package/dist/render/derived-variables.d.ts.map +1 -0
  35. package/dist/render/derived-variables.js +17 -0
  36. package/dist/render/derived-variables.js.map +1 -0
  37. package/dist/render/diagram-fallback.d.ts +25 -0
  38. package/dist/render/diagram-fallback.d.ts.map +1 -0
  39. package/dist/render/diagram-fallback.js +86 -0
  40. package/dist/render/diagram-fallback.js.map +1 -0
  41. package/dist/render/document.d.ts +4 -0
  42. package/dist/render/document.d.ts.map +1 -1
  43. package/dist/render/document.js +34 -6
  44. package/dist/render/document.js.map +1 -1
  45. package/dist/render/effects-styles.d.ts +14 -0
  46. package/dist/render/effects-styles.d.ts.map +1 -0
  47. package/dist/render/effects-styles.js +39 -0
  48. package/dist/render/effects-styles.js.map +1 -0
  49. package/dist/render/embedded-fonts.generated.d.ts +22 -0
  50. package/dist/render/embedded-fonts.generated.d.ts.map +1 -0
  51. package/dist/render/embedded-fonts.generated.js +59 -0
  52. package/dist/render/embedded-fonts.generated.js.map +1 -0
  53. package/dist/render/feature-styles.d.ts +14 -0
  54. package/dist/render/feature-styles.d.ts.map +1 -0
  55. package/dist/render/feature-styles.js +161 -0
  56. package/dist/render/feature-styles.js.map +1 -0
  57. package/dist/render/font-faces.d.ts +22 -0
  58. package/dist/render/font-faces.d.ts.map +1 -0
  59. package/dist/render/font-faces.js +60 -0
  60. package/dist/render/font-faces.js.map +1 -0
  61. package/dist/render/outline.d.ts +21 -0
  62. package/dist/render/outline.d.ts.map +1 -0
  63. package/dist/render/outline.js +44 -0
  64. package/dist/render/outline.js.map +1 -0
  65. package/dist/render/render.d.ts.map +1 -1
  66. package/dist/render/render.js +53 -10
  67. package/dist/render/render.js.map +1 -1
  68. package/dist/render/runtime.d.ts.map +1 -1
  69. package/dist/render/runtime.js +184 -10
  70. package/dist/render/runtime.js.map +1 -1
  71. package/dist/render/showcase-blocks.d.ts +47 -0
  72. package/dist/render/showcase-blocks.d.ts.map +1 -0
  73. package/dist/render/showcase-blocks.js +349 -0
  74. package/dist/render/showcase-blocks.js.map +1 -0
  75. package/dist/render/showcase-styles.d.ts +15 -0
  76. package/dist/render/showcase-styles.d.ts.map +1 -0
  77. package/dist/render/showcase-styles.js +217 -0
  78. package/dist/render/showcase-styles.js.map +1 -0
  79. package/dist/render/signature-styles.d.ts +18 -0
  80. package/dist/render/signature-styles.d.ts.map +1 -0
  81. package/dist/render/signature-styles.js +41 -0
  82. package/dist/render/signature-styles.js.map +1 -0
  83. package/dist/render/styles.d.ts +18 -9
  84. package/dist/render/styles.d.ts.map +1 -1
  85. package/dist/render/styles.js +224 -128
  86. package/dist/render/styles.js.map +1 -1
  87. package/dist/render/surface-styles.d.ts +24 -0
  88. package/dist/render/surface-styles.d.ts.map +1 -0
  89. package/dist/render/surface-styles.js +41 -0
  90. package/dist/render/surface-styles.js.map +1 -0
  91. package/dist/render/verify.d.ts.map +1 -1
  92. package/dist/render/verify.js +30 -0
  93. package/dist/render/verify.js.map +1 -1
  94. package/dist/spec/normalize.d.ts.map +1 -1
  95. package/dist/spec/normalize.js +32 -0
  96. package/dist/spec/normalize.js.map +1 -1
  97. package/dist/theme/load-theme.d.ts +2 -2
  98. package/dist/theme/load-theme.d.ts.map +1 -1
  99. package/dist/theme/load-theme.js +46 -10
  100. package/dist/theme/load-theme.js.map +1 -1
  101. package/dist/theme/presets.d.ts +4 -3
  102. package/dist/theme/presets.d.ts.map +1 -1
  103. package/dist/theme/presets.js +35 -18
  104. package/dist/theme/presets.js.map +1 -1
  105. package/dist/theme/tokens.d.ts.map +1 -1
  106. package/dist/theme/tokens.js +4 -4
  107. package/dist/theme/tokens.js.map +1 -1
  108. package/dist/version.d.ts +1 -1
  109. package/dist/version.d.ts.map +1 -1
  110. package/dist/version.js +1 -1
  111. package/dist/version.js.map +1 -1
  112. package/llms.txt +25 -0
  113. package/package.json +9 -3
@@ -1 +1 @@
1
- {"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO,iBAAiB,CAAC;AAEtC,sEAAsE;AACtE,eAAO,MAAM,YAAY,0BAA0B,CAAC"}
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.1.1-next.1';
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
@@ -1 +1 @@
1
- {"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,cAAc,CAAC;AAEtC,sEAAsE;AACtE,MAAM,CAAC,MAAM,YAAY,GAAG,uBAAuB,CAAC"}
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.1.1-next.1",
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
- "verify": "pnpm lint && pnpm typecheck && pnpm test && pnpm build"
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",