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.
- package/CHANGELOG.md +79 -0
- package/README.md +38 -21
- package/VERSION +1 -1
- package/dist/_raw/content/guide/branding.md +146 -0
- package/dist/_raw/content/guide/data-driven-content.md +204 -0
- package/dist/_raw/content/reference/configuration.md +145 -7
- package/dist/_raw/content/reference/environment-variables.md +26 -1
- package/dist/_raw/content/reference/gantt-widget.md +468 -0
- package/dist/_raw/content/reference/glossary.md +25 -1
- package/dist/_raw/content/reference/key-concepts.md +30 -2
- package/dist/_raw/content/reference/plugins.md +170 -1
- package/dist/_raw/docs/decisions/ADR-0006-data-driven-content.md +350 -0
- package/dist/content/deployment/preflight.html +11 -8
- package/dist/content/deployment/recipes/aws-s3.html +11 -8
- package/dist/content/deployment/recipes/cloudflare-pages.html +11 -8
- package/dist/content/deployment/recipes/cloudflare-r2.html +11 -8
- package/dist/content/deployment/recipes/fly-io.html +11 -8
- package/dist/content/deployment/recipes/github-pages.html +11 -8
- package/dist/content/deployment/recipes/netlify.html +11 -8
- package/dist/content/deployment/recipes/vercel.html +11 -8
- package/dist/content/deployment/secrets-and-env-vars.html +11 -8
- package/dist/content/deployment.html +11 -8
- package/dist/content/guide/approaches.html +11 -8
- package/dist/content/guide/branding.html +509 -0
- package/dist/content/guide/data-driven-content.html +542 -0
- package/dist/content/guide/features.html +11 -8
- package/dist/content/guide/getting-started.html +11 -8
- package/dist/content/guide/kitfly-overview.html +11 -8
- package/dist/content/reference/configuration.html +136 -11
- package/dist/content/reference/design-catalog.html +11 -8
- package/dist/content/reference/environment-variables.html +51 -10
- package/dist/content/reference/gantt-widget.html +899 -0
- package/dist/content/reference/glossary.html +25 -10
- package/dist/content/reference/key-concepts.html +34 -11
- package/dist/content/reference/plugins.html +261 -10
- package/dist/content/reference/slides-authoring-guidelines.html +11 -8
- package/dist/content/reference/structure.html +11 -8
- package/dist/content/reference.html +11 -8
- package/dist/content/templates/crucible.html +11 -8
- package/dist/content/templates/handbook.html +11 -8
- package/dist/content/templates/minimal.html +11 -8
- package/dist/content/templates/overview.html +11 -8
- package/dist/content/templates/pipeline.html +11 -8
- package/dist/content/templates/productbook.html +11 -8
- package/dist/content/templates/runbook.html +11 -8
- package/dist/content/templates/servicebook.html +11 -8
- package/dist/content-index.json +37 -2
- package/dist/docs/decisions/ADR-0001-minimalist-site-code.html +11 -8
- package/dist/docs/decisions/ADR-0002-ai-accessibility.html +11 -8
- package/dist/docs/decisions/ADR-0003-single-file-bundle.html +11 -8
- package/dist/docs/decisions/ADR-0004-bun-runtime.html +11 -8
- package/dist/docs/decisions/ADR-0005-plugin-contract-and-distribution.html +11 -8
- package/dist/docs/decisions/ADR-0006-data-driven-content.html +751 -0
- package/dist/docs/decisions/DDR-0001-viewport-locked-layout.html +11 -8
- package/dist/docs/decisions/DDR-0002-theme-system.html +11 -8
- package/dist/docs/decisions/DDR-0003-bounded-logo-slot.html +11 -8
- package/dist/docs/decisions/DDR-0004-slides-rendering-model.html +11 -8
- package/dist/docs/decisions/DDR-0005-deterministic-layout-boundary.html +11 -8
- package/dist/docs/userguide/cli/build.html +11 -8
- package/dist/docs/userguide/cli/bundle.html +11 -8
- package/dist/docs/userguide/cli/dev.html +11 -8
- package/dist/docs/userguide/cli/init.html +11 -8
- package/dist/docs/userguide/cli/servers.html +11 -8
- package/dist/docs/userguide/cli/stop.html +11 -8
- package/dist/docs/userguide/cli/update.html +11 -8
- package/dist/docs/userguide/cli/version.html +11 -8
- package/dist/docs/userguide/cli.html +11 -8
- package/dist/docs/userguide/sharing.html +11 -8
- package/dist/index.html +11 -8
- package/dist/llms.txt +3 -3
- package/dist/provenance.json +4 -5
- package/dist/reports/license-inventory.csv +199 -0
- package/dist/schemas/plugin-registry.schema.html +11 -8
- package/dist/schemas/plugin-schemas-notes.html +11 -8
- package/dist/schemas/plugin.schema.html +11 -8
- package/dist/schemas/plugins.schema.html +11 -8
- package/dist/schemas/v0/common.schema.html +15 -12
- package/dist/schemas/v0/plugin-registry.schema.html +14 -11
- package/dist/schemas/v0/plugin.schema.html +14 -11
- package/dist/schemas/v0/plugins.schema.html +14 -11
- package/dist/schemas/v0/site.schema.html +68 -9
- package/dist/schemas/v0/theme.schema.html +22 -19
- package/dist/schemas.html +11 -8
- package/dist/styles.css +39 -4
- package/package.json +1 -1
- package/plugins-dist/latex-runtime.js +140 -0
- package/plugins-dist/latex.js +178 -0
- package/plugins-dist/planning-visuals.css +261 -0
- package/plugins-dist/planning-visuals.js +669 -0
- package/plugins-dist/slides-charts-lite-runtime.js +179 -0
- package/plugins-dist/slides-charts-lite.js +198 -0
- package/registry/plugins.yaml +40 -1
- package/schemas/v0/site.schema.json +56 -0
- package/scripts/build-all.ts +5 -0
- package/scripts/build.ts +264 -80
- package/scripts/bundle.ts +188 -17
- package/scripts/dev.ts +294 -171
- package/scripts/embed-docs.ts +119 -0
- package/src/__tests__/brief.test.ts +151 -0
- package/src/__tests__/build.test.ts +293 -1
- package/src/__tests__/bundle.test.ts +195 -0
- package/src/__tests__/docs.test.ts +117 -0
- package/src/__tests__/fixtures/fences/planning-visuals/invalid/bad-month-format.md +10 -0
- package/src/__tests__/fixtures/fences/planning-visuals/invalid/marker-format-mismatch.md +13 -0
- package/src/__tests__/fixtures/fences/planning-visuals/invalid/milestone-format-mismatch.md +13 -0
- package/src/__tests__/fixtures/fences/planning-visuals/invalid/missing-tracks.md +5 -0
- package/src/__tests__/fixtures/fences/planning-visuals/invalid/track-reversed.md +10 -0
- package/src/__tests__/fixtures/fences/planning-visuals/valid/markers-basic.md +15 -0
- package/src/__tests__/fixtures/fences/planning-visuals/valid/markers-no-milestones.md +13 -0
- package/src/__tests__/fixtures/fences/planning-visuals/valid/month-basic.md +16 -0
- package/src/__tests__/fixtures/fences/planning-visuals/valid/no-milestones.md +10 -0
- package/src/__tests__/fixtures/fences/planning-visuals/valid/week-basic.md +20 -0
- package/src/__tests__/init.test.ts +51 -2
- package/src/__tests__/latex-runtime.bun.test.ts +35 -0
- package/src/__tests__/planning-visuals-fence-contract.test.ts +28 -0
- package/src/__tests__/planning-visuals-runtime-regressions.bun.test.ts +68 -0
- package/src/__tests__/planning-visuals-runtime.bun.test.ts +192 -0
- package/src/__tests__/shared.test.ts +719 -1
- package/src/__tests__/slides-charts-lite-runtime.bun.test.ts +45 -0
- package/src/cli.ts +124 -22
- package/src/commands/docs.ts +71 -0
- package/src/commands/init.ts +1 -1
- package/src/generated/embedded-docs.ts +2384 -0
- package/src/server-registry.ts +50 -10
- package/src/shared.ts +1174 -43
- package/src/site/styles.css +39 -4
- package/src/site/template.html +5 -2
- package/src/templates/brief.ts +486 -0
- package/src/templates/deck.ts +59 -0
- package/src/templates/driver.ts +46 -13
- package/src/templates/handbook.ts +32 -0
- package/src/templates/runbook.ts +32 -0
package/registry/plugins.yaml
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# yaml-language-server: $schema=../schemas/v0/plugin-registry.schema.json
|
|
2
2
|
version: 1
|
|
3
|
-
updated: "2026-
|
|
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
|
package/scripts/build-all.ts
CHANGED
|
@@ -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}`);
|