kitfly 0.2.1 → 0.2.4

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 (132) hide show
  1. package/CHANGELOG.md +79 -0
  2. package/README.md +38 -21
  3. package/VERSION +1 -1
  4. package/dist/_raw/content/guide/branding.md +146 -0
  5. package/dist/_raw/content/guide/data-driven-content.md +204 -0
  6. package/dist/_raw/content/reference/configuration.md +145 -7
  7. package/dist/_raw/content/reference/environment-variables.md +26 -1
  8. package/dist/_raw/content/reference/gantt-widget.md +468 -0
  9. package/dist/_raw/content/reference/glossary.md +25 -1
  10. package/dist/_raw/content/reference/key-concepts.md +30 -2
  11. package/dist/_raw/content/reference/plugins.md +170 -1
  12. package/dist/_raw/docs/decisions/ADR-0006-data-driven-content.md +350 -0
  13. package/dist/content/deployment/preflight.html +11 -8
  14. package/dist/content/deployment/recipes/aws-s3.html +11 -8
  15. package/dist/content/deployment/recipes/cloudflare-pages.html +11 -8
  16. package/dist/content/deployment/recipes/cloudflare-r2.html +11 -8
  17. package/dist/content/deployment/recipes/fly-io.html +11 -8
  18. package/dist/content/deployment/recipes/github-pages.html +11 -8
  19. package/dist/content/deployment/recipes/netlify.html +11 -8
  20. package/dist/content/deployment/recipes/vercel.html +11 -8
  21. package/dist/content/deployment/secrets-and-env-vars.html +11 -8
  22. package/dist/content/deployment.html +11 -8
  23. package/dist/content/guide/approaches.html +11 -8
  24. package/dist/content/guide/branding.html +509 -0
  25. package/dist/content/guide/data-driven-content.html +542 -0
  26. package/dist/content/guide/features.html +11 -8
  27. package/dist/content/guide/getting-started.html +11 -8
  28. package/dist/content/guide/kitfly-overview.html +11 -8
  29. package/dist/content/reference/configuration.html +136 -11
  30. package/dist/content/reference/design-catalog.html +11 -8
  31. package/dist/content/reference/environment-variables.html +51 -10
  32. package/dist/content/reference/gantt-widget.html +899 -0
  33. package/dist/content/reference/glossary.html +25 -10
  34. package/dist/content/reference/key-concepts.html +34 -11
  35. package/dist/content/reference/plugins.html +261 -10
  36. package/dist/content/reference/slides-authoring-guidelines.html +11 -8
  37. package/dist/content/reference/structure.html +11 -8
  38. package/dist/content/reference.html +11 -8
  39. package/dist/content/templates/crucible.html +11 -8
  40. package/dist/content/templates/handbook.html +11 -8
  41. package/dist/content/templates/minimal.html +11 -8
  42. package/dist/content/templates/overview.html +11 -8
  43. package/dist/content/templates/pipeline.html +11 -8
  44. package/dist/content/templates/productbook.html +11 -8
  45. package/dist/content/templates/runbook.html +11 -8
  46. package/dist/content/templates/servicebook.html +11 -8
  47. package/dist/content-index.json +37 -2
  48. package/dist/docs/decisions/ADR-0001-minimalist-site-code.html +11 -8
  49. package/dist/docs/decisions/ADR-0002-ai-accessibility.html +11 -8
  50. package/dist/docs/decisions/ADR-0003-single-file-bundle.html +11 -8
  51. package/dist/docs/decisions/ADR-0004-bun-runtime.html +11 -8
  52. package/dist/docs/decisions/ADR-0005-plugin-contract-and-distribution.html +11 -8
  53. package/dist/docs/decisions/ADR-0006-data-driven-content.html +751 -0
  54. package/dist/docs/decisions/DDR-0001-viewport-locked-layout.html +11 -8
  55. package/dist/docs/decisions/DDR-0002-theme-system.html +11 -8
  56. package/dist/docs/decisions/DDR-0003-bounded-logo-slot.html +11 -8
  57. package/dist/docs/decisions/DDR-0004-slides-rendering-model.html +11 -8
  58. package/dist/docs/decisions/DDR-0005-deterministic-layout-boundary.html +11 -8
  59. package/dist/docs/userguide/cli/build.html +11 -8
  60. package/dist/docs/userguide/cli/bundle.html +11 -8
  61. package/dist/docs/userguide/cli/dev.html +11 -8
  62. package/dist/docs/userguide/cli/init.html +11 -8
  63. package/dist/docs/userguide/cli/servers.html +11 -8
  64. package/dist/docs/userguide/cli/stop.html +11 -8
  65. package/dist/docs/userguide/cli/update.html +11 -8
  66. package/dist/docs/userguide/cli/version.html +11 -8
  67. package/dist/docs/userguide/cli.html +11 -8
  68. package/dist/docs/userguide/sharing.html +11 -8
  69. package/dist/index.html +11 -8
  70. package/dist/llms.txt +3 -3
  71. package/dist/provenance.json +4 -5
  72. package/dist/reports/license-inventory.csv +199 -0
  73. package/dist/schemas/plugin-registry.schema.html +11 -8
  74. package/dist/schemas/plugin-schemas-notes.html +11 -8
  75. package/dist/schemas/plugin.schema.html +11 -8
  76. package/dist/schemas/plugins.schema.html +11 -8
  77. package/dist/schemas/v0/common.schema.html +15 -12
  78. package/dist/schemas/v0/plugin-registry.schema.html +14 -11
  79. package/dist/schemas/v0/plugin.schema.html +14 -11
  80. package/dist/schemas/v0/plugins.schema.html +14 -11
  81. package/dist/schemas/v0/site.schema.html +68 -9
  82. package/dist/schemas/v0/theme.schema.html +22 -19
  83. package/dist/schemas.html +11 -8
  84. package/dist/styles.css +39 -4
  85. package/package.json +1 -1
  86. package/plugins-dist/latex-runtime.js +140 -0
  87. package/plugins-dist/latex.js +178 -0
  88. package/plugins-dist/planning-visuals.css +261 -0
  89. package/plugins-dist/planning-visuals.js +669 -0
  90. package/plugins-dist/slides-charts-lite-runtime.js +179 -0
  91. package/plugins-dist/slides-charts-lite.js +198 -0
  92. package/registry/plugins.yaml +40 -1
  93. package/schemas/v0/site.schema.json +56 -0
  94. package/scripts/build-all.ts +5 -0
  95. package/scripts/build.ts +264 -80
  96. package/scripts/bundle.ts +188 -17
  97. package/scripts/dev.ts +294 -171
  98. package/scripts/embed-docs.ts +119 -0
  99. package/src/__tests__/brief.test.ts +151 -0
  100. package/src/__tests__/build.test.ts +293 -1
  101. package/src/__tests__/bundle.test.ts +195 -0
  102. package/src/__tests__/docs.test.ts +117 -0
  103. package/src/__tests__/fixtures/fences/planning-visuals/invalid/bad-month-format.md +10 -0
  104. package/src/__tests__/fixtures/fences/planning-visuals/invalid/marker-format-mismatch.md +13 -0
  105. package/src/__tests__/fixtures/fences/planning-visuals/invalid/milestone-format-mismatch.md +13 -0
  106. package/src/__tests__/fixtures/fences/planning-visuals/invalid/missing-tracks.md +5 -0
  107. package/src/__tests__/fixtures/fences/planning-visuals/invalid/track-reversed.md +10 -0
  108. package/src/__tests__/fixtures/fences/planning-visuals/valid/markers-basic.md +15 -0
  109. package/src/__tests__/fixtures/fences/planning-visuals/valid/markers-no-milestones.md +13 -0
  110. package/src/__tests__/fixtures/fences/planning-visuals/valid/month-basic.md +16 -0
  111. package/src/__tests__/fixtures/fences/planning-visuals/valid/no-milestones.md +10 -0
  112. package/src/__tests__/fixtures/fences/planning-visuals/valid/week-basic.md +20 -0
  113. package/src/__tests__/init.test.ts +51 -2
  114. package/src/__tests__/latex-runtime.bun.test.ts +35 -0
  115. package/src/__tests__/planning-visuals-fence-contract.test.ts +28 -0
  116. package/src/__tests__/planning-visuals-runtime-regressions.bun.test.ts +68 -0
  117. package/src/__tests__/planning-visuals-runtime.bun.test.ts +192 -0
  118. package/src/__tests__/shared.test.ts +719 -1
  119. package/src/__tests__/slides-charts-lite-runtime.bun.test.ts +45 -0
  120. package/src/cli.ts +124 -22
  121. package/src/commands/docs.ts +71 -0
  122. package/src/commands/init.ts +1 -1
  123. package/src/generated/embedded-docs.ts +2384 -0
  124. package/src/server-registry.ts +50 -10
  125. package/src/shared.ts +1174 -43
  126. package/src/site/styles.css +39 -4
  127. package/src/site/template.html +5 -2
  128. package/src/templates/brief.ts +486 -0
  129. package/src/templates/deck.ts +59 -0
  130. package/src/templates/driver.ts +46 -13
  131. package/src/templates/handbook.ts +32 -0
  132. package/src/templates/runbook.ts +32 -0
@@ -1,6 +1,6 @@
1
1
  # yaml-language-server: $schema=../schemas/v0/plugin-registry.schema.json
2
2
  version: 1
3
- updated: "2026-02-15"
3
+ updated: "2026-03-03"
4
4
  baseUrl: "https://github.com/3leaps/kitfly/releases/download"
5
5
  # Canonical plugin registry (v0.2.1)
6
6
  plugins:
@@ -33,3 +33,42 @@ plugins:
33
33
  assetSha256:
34
34
  js: "sha256:716059fbb0045af5305e552557368fe812569121986e0ce533f96753197c6ee1"
35
35
  css: "sha256:dae86214e5f3f628deb6fec3f7bd871fa419f0310993cde9e845392ac16d9ec1"
36
+ latex:
37
+ name: "LaTeX/KaTeX Math Rendering"
38
+ description: "LaTeX math rendering via KaTeX ($...$ inline, $$...$$ display, fenced math)"
39
+ version: "0.2.2"
40
+ contract: "1"
41
+ kitfly: ">=0.2.0 <1.0.0"
42
+ license: MIT
43
+ verified: true
44
+ assets:
45
+ js: "plugins-dist/latex.js"
46
+ assetSha256:
47
+ js: "sha256:5475e344dc424e3015c3a8b2fd8152101354fe2622d322a0fa4f73d1335b4232"
48
+ slides-charts-lite:
49
+ name: "Slides Charts Lite"
50
+ description: "Simple charts for Kitfly slides (bar, line, pie)"
51
+ version: "0.2.2"
52
+ contract: "1"
53
+ kitfly: ">=0.2.0 <1.0.0"
54
+ license: MIT
55
+ verified: true
56
+ modes: ["slides"]
57
+ assets:
58
+ js: "plugins-dist/slides-charts-lite.js"
59
+ assetSha256:
60
+ js: "sha256:ea1afbe48bc94c617af1ee2d53febcaa8d48e83253094a1cbef598f77ec15013"
61
+ planning-visuals:
62
+ name: "Planning Visuals"
63
+ description: "Planning and timeline widgets for Kitfly (gantt charts, roadmaps)"
64
+ version: "0.2.4"
65
+ contract: "1"
66
+ kitfly: ">=0.2.4 <1.0.0"
67
+ license: MIT
68
+ verified: true
69
+ assets:
70
+ js: "plugins-dist/planning-visuals.js"
71
+ css: "plugins-dist/planning-visuals.css"
72
+ assetSha256:
73
+ js: "sha256:76d65904bb192ce6f0561a477b76fb31075d917b42217c649db66ccb73627463"
74
+ css: "sha256:97d8a2e606d10a4814037cea7ea032e5af83a656f2e6203291add8c8cd819aea"
@@ -22,6 +22,11 @@
22
22
  "description": "Root directory for content (relative to repo root)",
23
23
  "default": "."
24
24
  },
25
+ "dataroot": {
26
+ "type": "string",
27
+ "description": "Root directory for data binding files (relative to repo root)",
28
+ "default": "data"
29
+ },
25
30
  "title": {
26
31
  "type": "string",
27
32
  "description": "Site title shown in browser tab and header",
@@ -90,6 +95,10 @@
90
95
  "description": "Path to logo image (relative to site root)",
91
96
  "default": "assets/brand/logo.png"
92
97
  },
98
+ "logoDark": {
99
+ "type": "string",
100
+ "description": "Path to dark mode logo image (relative to site root). Shown when dark theme is active."
101
+ },
93
102
  "favicon": {
94
103
  "type": "string",
95
104
  "description": "Path to favicon image (relative to site root)",
@@ -191,6 +200,29 @@
191
200
  "type": "boolean",
192
201
  "description": "Show Built with Kitfly attribution",
193
202
  "default": true
203
+ },
204
+ "logo": {
205
+ "type": "string",
206
+ "description": "Path to footer logo image (relative to site root)"
207
+ },
208
+ "logoDark": {
209
+ "type": "string",
210
+ "description": "Path to dark mode footer logo image (relative to site root)"
211
+ },
212
+ "logoUrl": {
213
+ "type": "string",
214
+ "description": "Make footer logo a clickable link to this URL"
215
+ },
216
+ "logoAlt": {
217
+ "type": "string",
218
+ "description": "Alt text for footer logo (defaults to copyright text if set, brand name otherwise)"
219
+ },
220
+ "logoHeight": {
221
+ "type": "integer",
222
+ "description": "Max height of footer logo in pixels",
223
+ "minimum": 10,
224
+ "maximum": 40,
225
+ "default": 20
194
226
  }
195
227
  },
196
228
  "additionalProperties": false
@@ -213,6 +245,30 @@
213
245
  }
214
246
  },
215
247
  "additionalProperties": false
248
+ },
249
+ "prebuild": {
250
+ "type": "array",
251
+ "description": "Commands to run before dev/build/bundle",
252
+ "items": {
253
+ "type": "object",
254
+ "required": [
255
+ "command"
256
+ ],
257
+ "properties": {
258
+ "command": {
259
+ "type": "string",
260
+ "description": "Shell command to execute"
261
+ },
262
+ "watch": {
263
+ "type": "array",
264
+ "description": "File patterns that re-run this hook in dev mode",
265
+ "items": {
266
+ "type": "string"
267
+ }
268
+ }
269
+ },
270
+ "additionalProperties": false
271
+ }
216
272
  }
217
273
  },
218
274
  "additionalProperties": false
@@ -70,6 +70,11 @@ function getVersion(): string {
70
70
  function main(): void {
71
71
  const version = getVersion();
72
72
 
73
+ // Generate embedded docs before compiling binaries
74
+ console.log("Generating embedded documentation...");
75
+ execSync("bun scripts/embed-docs.ts", { stdio: "inherit" });
76
+ console.log();
77
+
73
78
  console.log(`Building ${TARGETS.length} binaries for '${BINARY_NAME}' v${version}`);
74
79
  console.log(` Entry point: ${ENTRY_POINT}`);
75
80
  console.log(` Output dir: ${OUT_DIR}`);