kitfly 0.1.2 → 0.2.1

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 (209) hide show
  1. package/CHANGELOG.md +46 -0
  2. package/README.md +63 -16
  3. package/VERSION +1 -1
  4. package/dist/_raw/content/deployment/preflight.md +134 -0
  5. package/dist/_raw/content/deployment/recipes/aws-s3.md +128 -0
  6. package/dist/_raw/content/deployment/recipes/cloudflare-pages.md +73 -0
  7. package/dist/_raw/content/deployment/recipes/cloudflare-r2.md +156 -0
  8. package/dist/_raw/content/deployment/recipes/fly-io.md +57 -0
  9. package/dist/_raw/content/deployment/recipes/github-pages.md +112 -0
  10. package/dist/_raw/content/deployment/recipes/netlify.md +99 -0
  11. package/dist/_raw/content/deployment/recipes/vercel.md +88 -0
  12. package/dist/_raw/content/deployment/secrets-and-env-vars.md +75 -0
  13. package/dist/_raw/content/deployment.md +128 -0
  14. package/dist/_raw/content/guide/approaches.md +182 -0
  15. package/dist/_raw/content/guide/features.md +121 -0
  16. package/dist/_raw/content/guide/getting-started.md +112 -0
  17. package/dist/_raw/content/guide/kitfly-overview.md +209 -0
  18. package/dist/_raw/content/reference/configuration.md +259 -0
  19. package/dist/_raw/content/reference/design-catalog.md +167 -0
  20. package/dist/_raw/content/reference/environment-variables.md +66 -0
  21. package/dist/_raw/content/reference/glossary.md +92 -0
  22. package/dist/_raw/content/reference/key-concepts.md +118 -0
  23. package/dist/_raw/content/reference/plugins.md +220 -0
  24. package/dist/_raw/content/reference/slides-authoring-guidelines.md +129 -0
  25. package/dist/_raw/content/reference/structure.md +166 -0
  26. package/dist/_raw/content/reference.md +20 -0
  27. package/dist/_raw/content/templates/crucible.md +192 -0
  28. package/dist/_raw/content/templates/handbook.md +83 -0
  29. package/dist/_raw/content/templates/minimal.md +138 -0
  30. package/dist/_raw/content/templates/overview.md +187 -0
  31. package/dist/_raw/content/templates/pipeline.md +151 -0
  32. package/dist/_raw/content/templates/productbook.md +187 -0
  33. package/dist/_raw/content/templates/runbook.md +193 -0
  34. package/dist/_raw/content/templates/servicebook.md +163 -0
  35. package/dist/_raw/docs/decisions/ADR-0001-minimalist-site-code.md +118 -0
  36. package/dist/_raw/docs/decisions/ADR-0002-ai-accessibility.md +153 -0
  37. package/dist/_raw/docs/decisions/ADR-0003-single-file-bundle.md +93 -0
  38. package/dist/_raw/docs/decisions/ADR-0004-bun-runtime.md +98 -0
  39. package/dist/_raw/docs/decisions/ADR-0005-plugin-contract-and-distribution.md +110 -0
  40. package/dist/_raw/docs/decisions/DDR-0001-viewport-locked-layout.md +111 -0
  41. package/dist/_raw/docs/decisions/DDR-0002-theme-system.md +131 -0
  42. package/dist/_raw/docs/decisions/DDR-0003-bounded-logo-slot.md +106 -0
  43. package/dist/_raw/docs/decisions/DDR-0004-slides-rendering-model.md +113 -0
  44. package/dist/_raw/docs/decisions/DDR-0005-deterministic-layout-boundary.md +107 -0
  45. package/dist/_raw/docs/userguide/cli/build.md +85 -0
  46. package/dist/_raw/docs/userguide/cli/bundle.md +81 -0
  47. package/dist/_raw/docs/userguide/cli/dev.md +92 -0
  48. package/dist/_raw/docs/userguide/cli/init.md +116 -0
  49. package/dist/_raw/docs/userguide/cli/servers.md +69 -0
  50. package/dist/_raw/docs/userguide/cli/stop.md +76 -0
  51. package/dist/_raw/docs/userguide/cli/update.md +78 -0
  52. package/dist/_raw/docs/userguide/cli/version.md +65 -0
  53. package/dist/_raw/docs/userguide/cli.md +34 -0
  54. package/dist/_raw/docs/userguide/sharing.md +94 -0
  55. package/dist/_raw/schemas/plugin-schemas-notes.md +71 -0
  56. package/dist/_raw/schemas.md +42 -0
  57. package/dist/assets/brand/kitfly-favicon-32.png +0 -0
  58. package/dist/assets/brand/kitfly-icon-64.png +0 -0
  59. package/dist/assets/brand/kitfly-logo-128.png +0 -0
  60. package/dist/assets/brand/kitfly-logo-512.png +0 -0
  61. package/dist/assets/brand/kitfly-logo.svg +12132 -0
  62. package/dist/assets/brand/kitfly-neon-128.png +0 -0
  63. package/dist/assets/brand/kitfly-neon-192.png +0 -0
  64. package/dist/assets/brand/kitfly-neon-256.png +0 -0
  65. package/dist/assets/brand/kitfly-neon.png +0 -0
  66. package/dist/assets/brand/palette.md +75 -0
  67. package/dist/content/deployment/index.html +11 -0
  68. package/dist/content/deployment/preflight.html +418 -0
  69. package/dist/content/deployment/recipes/aws-s3.html +421 -0
  70. package/dist/content/deployment/recipes/cloudflare-pages.html +372 -0
  71. package/dist/content/deployment/recipes/cloudflare-r2.html +443 -0
  72. package/dist/content/deployment/recipes/fly-io.html +356 -0
  73. package/dist/content/deployment/recipes/github-pages.html +414 -0
  74. package/dist/content/deployment/recipes/index.html +11 -0
  75. package/dist/content/deployment/recipes/netlify.html +394 -0
  76. package/dist/content/deployment/recipes/vercel.html +382 -0
  77. package/dist/content/deployment/secrets-and-env-vars.html +380 -0
  78. package/dist/content/deployment.html +426 -0
  79. package/dist/content/guide/approaches.html +501 -0
  80. package/dist/content/guide/features.html +436 -0
  81. package/dist/content/guide/getting-started.html +403 -0
  82. package/dist/content/guide/index.html +11 -0
  83. package/dist/content/guide/kitfly-overview.html +544 -0
  84. package/dist/content/index.html +11 -0
  85. package/dist/content/reference/configuration.html +580 -0
  86. package/dist/content/reference/design-catalog.html +449 -0
  87. package/dist/content/reference/environment-variables.html +367 -0
  88. package/dist/content/reference/glossary.html +368 -0
  89. package/dist/content/reference/index.html +11 -0
  90. package/dist/content/reference/key-concepts.html +399 -0
  91. package/dist/content/reference/plugins.html +491 -0
  92. package/dist/content/reference/slides-authoring-guidelines.html +418 -0
  93. package/dist/content/reference/structure.html +463 -0
  94. package/dist/content/reference.html +335 -0
  95. package/dist/content/templates/crucible.html +546 -0
  96. package/dist/content/templates/handbook.html +405 -0
  97. package/dist/content/templates/index.html +11 -0
  98. package/dist/content/templates/minimal.html +447 -0
  99. package/dist/content/templates/overview.html +558 -0
  100. package/dist/content/templates/pipeline.html +494 -0
  101. package/dist/content/templates/productbook.html +540 -0
  102. package/dist/content/templates/runbook.html +543 -0
  103. package/dist/content/templates/servicebook.html +523 -0
  104. package/dist/content-index.json +549 -0
  105. package/dist/docs/decisions/ADR-0001-minimalist-site-code.html +491 -0
  106. package/dist/docs/decisions/ADR-0002-ai-accessibility.html +434 -0
  107. package/dist/docs/decisions/ADR-0003-single-file-bundle.html +412 -0
  108. package/dist/docs/decisions/ADR-0004-bun-runtime.html +409 -0
  109. package/dist/docs/decisions/ADR-0005-plugin-contract-and-distribution.html +402 -0
  110. package/dist/docs/decisions/DDR-0001-viewport-locked-layout.html +459 -0
  111. package/dist/docs/decisions/DDR-0002-theme-system.html +452 -0
  112. package/dist/docs/decisions/DDR-0003-bounded-logo-slot.html +423 -0
  113. package/dist/docs/decisions/DDR-0004-slides-rendering-model.html +399 -0
  114. package/dist/docs/decisions/DDR-0005-deterministic-layout-boundary.html +422 -0
  115. package/dist/docs/decisions/index.html +11 -0
  116. package/dist/docs/userguide/cli/build.html +408 -0
  117. package/dist/docs/userguide/cli/bundle.html +419 -0
  118. package/dist/docs/userguide/cli/dev.html +428 -0
  119. package/dist/docs/userguide/cli/index.html +11 -0
  120. package/dist/docs/userguide/cli/init.html +436 -0
  121. package/dist/docs/userguide/cli/servers.html +393 -0
  122. package/dist/docs/userguide/cli/stop.html +408 -0
  123. package/dist/docs/userguide/cli/update.html +406 -0
  124. package/dist/docs/userguide/cli/version.html +406 -0
  125. package/dist/docs/userguide/cli.html +386 -0
  126. package/dist/docs/userguide/index.html +11 -0
  127. package/dist/docs/userguide/sharing.html +465 -0
  128. package/dist/index.html +387 -0
  129. package/dist/llms.txt +18 -0
  130. package/dist/provenance.json +7 -0
  131. package/dist/schemas/index.html +11 -0
  132. package/dist/schemas/plugin-registry.schema.html +327 -0
  133. package/dist/schemas/plugin-schemas-notes.html +364 -0
  134. package/dist/schemas/plugin.schema.html +327 -0
  135. package/dist/schemas/plugins.schema.html +327 -0
  136. package/dist/schemas/v0/common.schema.html +386 -0
  137. package/dist/schemas/v0/index.html +11 -0
  138. package/dist/schemas/v0/plugin-registry.schema.html +547 -0
  139. package/dist/schemas/v0/plugin.schema.html +497 -0
  140. package/dist/schemas/v0/plugins.schema.html +406 -0
  141. package/dist/schemas/v0/site.schema.html +541 -0
  142. package/dist/schemas/v0/theme.schema.html +615 -0
  143. package/dist/schemas.html +351 -0
  144. package/dist/styles.css +1262 -0
  145. package/package.json +4 -2
  146. package/plugins-dist/callouts.css +32 -0
  147. package/plugins-dist/callouts.js +46 -0
  148. package/plugins-dist/slides-visuals.css +390 -0
  149. package/plugins-dist/slides-visuals.js +689 -0
  150. package/registry/plugins.yaml +35 -0
  151. package/schemas/README.md +10 -0
  152. package/schemas/plugin-registry.schema.json +5 -0
  153. package/schemas/plugin-schemas-notes.md +71 -0
  154. package/schemas/plugin.schema.json +5 -0
  155. package/schemas/plugins.schema.json +5 -0
  156. package/schemas/v0/common.schema.json +64 -0
  157. package/schemas/v0/plugin-registry.schema.json +225 -0
  158. package/schemas/v0/plugin.schema.json +175 -0
  159. package/schemas/v0/plugins.schema.json +84 -0
  160. package/schemas/v0/site.schema.json +56 -9
  161. package/schemas/v0/theme.schema.json +105 -22
  162. package/scripts/build.ts +158 -3
  163. package/scripts/bundle.ts +261 -95
  164. package/scripts/dev.ts +301 -11
  165. package/src/__tests__/build.test.ts +220 -1
  166. package/src/__tests__/bundle.test.ts +31 -0
  167. package/src/__tests__/cli.test.ts +14 -3
  168. package/src/__tests__/dev-plugin-errors.test.ts +20 -0
  169. package/src/__tests__/fixtures/fences/slides-visuals/invalid/bad-list-indent.md +5 -0
  170. package/src/__tests__/fixtures/fences/slides-visuals/invalid/blank-line.md +5 -0
  171. package/src/__tests__/fixtures/fences/slides-visuals/invalid/compare-object-items.md +9 -0
  172. package/src/__tests__/fixtures/fences/slides-visuals/invalid/flow-branching-no-source.md +5 -0
  173. package/src/__tests__/fixtures/fences/slides-visuals/invalid/flow-converging-no-target.md +6 -0
  174. package/src/__tests__/fixtures/fences/slides-visuals/invalid/indented-fence.md +4 -0
  175. package/src/__tests__/fixtures/fences/slides-visuals/invalid/staircase-empty-steps.md +3 -0
  176. package/src/__tests__/fixtures/fences/slides-visuals/invalid/stat-grid-missing-fields.md +5 -0
  177. package/src/__tests__/fixtures/fences/slides-visuals/invalid/timeline-horizontal-no-events.md +2 -0
  178. package/src/__tests__/fixtures/fences/slides-visuals/invalid/unknown-type.md +3 -0
  179. package/src/__tests__/fixtures/fences/slides-visuals/valid/compare.md +10 -0
  180. package/src/__tests__/fixtures/fences/slides-visuals/valid/comparison-table.md +14 -0
  181. package/src/__tests__/fixtures/fences/slides-visuals/valid/flow-branching-no-split.md +7 -0
  182. package/src/__tests__/fixtures/fences/slides-visuals/valid/flow-branching.md +8 -0
  183. package/src/__tests__/fixtures/fences/slides-visuals/valid/flow-converging-no-merge.md +7 -0
  184. package/src/__tests__/fixtures/fences/slides-visuals/valid/flow-converging.md +8 -0
  185. package/src/__tests__/fixtures/fences/slides-visuals/valid/funnel.md +7 -0
  186. package/src/__tests__/fixtures/fences/slides-visuals/valid/kpi.md +5 -0
  187. package/src/__tests__/fixtures/fences/slides-visuals/valid/layer-cake.md +6 -0
  188. package/src/__tests__/fixtures/fences/slides-visuals/valid/pyramid.md +6 -0
  189. package/src/__tests__/fixtures/fences/slides-visuals/valid/quadrant-grid.md +8 -0
  190. package/src/__tests__/fixtures/fences/slides-visuals/valid/scorecard.md +13 -0
  191. package/src/__tests__/fixtures/fences/slides-visuals/valid/staircase-down.md +7 -0
  192. package/src/__tests__/fixtures/fences/slides-visuals/valid/staircase.md +8 -0
  193. package/src/__tests__/fixtures/fences/slides-visuals/valid/stat-grid.md +8 -0
  194. package/src/__tests__/fixtures/fences/slides-visuals/valid/timeline-horizontal.md +9 -0
  195. package/src/__tests__/fixtures/fences/slides-visuals/valid/timeline-vertical.md +10 -0
  196. package/src/__tests__/init.test.ts +35 -0
  197. package/src/__tests__/plugin-loader.test.ts +221 -0
  198. package/src/__tests__/shared.test.ts +451 -0
  199. package/src/__tests__/slides-visuals-fence-contract.test.ts +28 -0
  200. package/src/__tests__/slides-visuals-runtime-regressions.bun.test.ts +147 -0
  201. package/src/__tests__/styles.test.ts +35 -0
  202. package/src/cli.ts +9 -4
  203. package/src/plugin-loader.ts +245 -0
  204. package/src/shared.ts +650 -7
  205. package/src/site/styles.css +331 -0
  206. package/src/site/template.html +66 -5
  207. package/src/templates/deck.ts +186 -0
  208. package/src/templates/driver.ts +11 -1
  209. package/src/templates/minimal.ts +1 -0
@@ -0,0 +1,547 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>plugin-registry.schema - Kitfly Docs</title>
7
+ <link rel="icon" type="image/png" sizes="32x32" href="../../assets/brand/kitfly-favicon-32.png">
8
+ <link rel="icon" type="image/png" sizes="64x64" href="../../assets/brand/kitfly-neon-256.png">
9
+ <link rel="stylesheet" href="../../styles.css">
10
+ <style id="kitfly-theme">
11
+ :root { --color-bg: #ffffff;
12
+ --color-bg-sidebar: #f5f7f8;
13
+ --color-text: #374151;
14
+ --color-text-muted: #6b7280;
15
+ --color-border: #e5e7eb;
16
+ --color-link: #007182;
17
+ --color-link-hover: #0a6172;
18
+ --color-accent: #152F46;
19
+ --color-code-bg: #f5f7f8;
20
+ --color-logo: #152F46;
21
+ --sidebar-width: 280px;
22
+ --font-sans: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
23
+ --font-headings: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
24
+ --font-mono: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace; }
25
+ html { font-size: 16px; }
26
+ @media (prefers-color-scheme: dark) {
27
+ :root:not([data-theme="light"]) { --color-bg: #0d1117;
28
+ --color-bg-sidebar: #152F46;
29
+ --color-text: #e5e7eb;
30
+ --color-text-muted: #9ca3af;
31
+ --color-border: #374151;
32
+ --color-link: #709EA6;
33
+ --color-link-hover: #8fb5bc;
34
+ --color-accent: #f9fafb;
35
+ --color-code-bg: #152F46;
36
+ --color-logo: #f9fafb; }
37
+ }
38
+ [data-theme="dark"] { --color-bg: #0d1117;
39
+ --color-bg-sidebar: #152F46;
40
+ --color-text: #e5e7eb;
41
+ --color-text-muted: #9ca3af;
42
+ --color-border: #374151;
43
+ --color-link: #709EA6;
44
+ --color-link-hover: #8fb5bc;
45
+ --color-accent: #f9fafb;
46
+ --color-code-bg: #152F46;
47
+ --color-logo: #f9fafb; }
48
+ [data-theme="light"] { --color-bg: #ffffff;
49
+ --color-bg-sidebar: #f5f7f8;
50
+ --color-text: #374151;
51
+ --color-text-muted: #6b7280;
52
+ --color-border: #e5e7eb;
53
+ --color-link: #007182;
54
+ --color-link-hover: #0a6172;
55
+ --color-accent: #152F46;
56
+ --color-code-bg: #f5f7f8;
57
+ --color-logo: #152F46;
58
+ --sidebar-width: 280px;
59
+ --font-sans: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
60
+ --font-headings: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
61
+ --font-mono: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace; }
62
+ </style>
63
+ <!-- Syntax highlighting - Prism.js -->
64
+ <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/prismjs@1/themes/prism.min.css" id="prism-light">
65
+ <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/prismjs@1/themes/prism-okaidia.min.css" id="prism-dark" disabled>
66
+
67
+ <script>
68
+ // Apply saved theme immediately to prevent flash
69
+ (function() {
70
+ const saved = localStorage.getItem('theme');
71
+ if (saved) {
72
+ document.documentElement.setAttribute('data-theme', saved);
73
+ }
74
+ // Set Prism theme based on saved or system preference
75
+ const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
76
+ const isDark = saved === 'dark' || (!saved && prefersDark);
77
+ if (isDark) {
78
+ document.getElementById('prism-light')?.setAttribute('disabled', '');
79
+ document.getElementById('prism-dark')?.removeAttribute('disabled');
80
+ }
81
+ })();
82
+ </script>
83
+ </head>
84
+ <body class="mode-docs">
85
+ <div class="mobile-header">
86
+ <button class="nav-toggle" onclick="toggleNav()" aria-label="Toggle navigation">
87
+ <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
88
+ <path d="M3 12h18M3 6h18M3 18h18"/>
89
+ </svg>
90
+ </button>
91
+ <a href="../../" class="mobile-logo" title="Home" data-initial="K">
92
+ <img src="../../assets/brand/kitfly-neon-256.png" alt="Kitfly" class="logo-img logo-icon" onerror="this.onerror=null;this.style.display='none';this.parentElement.classList.add('logo-fallback')"/>
93
+ </a>
94
+ <button class="mobile-theme-toggle" onclick="toggleTheme()" title="Toggle theme" aria-label="Toggle theme">
95
+ <svg class="icon-sun" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
96
+ <circle cx="12" cy="12" r="5"/>
97
+ <path d="M12 1v2M12 21v2M4.22 4.22l1.42 1.42M18.36 18.36l1.42 1.42M1 12h2M21 12h2M4.22 19.78l1.42-1.42M18.36 5.64l1.42-1.42"/>
98
+ </svg>
99
+ <svg class="icon-moon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
100
+ <path d="M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79z"/>
101
+ </svg>
102
+ </button>
103
+ </div>
104
+ <div class="layout">
105
+ <nav class="sidebar">
106
+ <div class="sidebar-header">
107
+ <div class="logo logo-icon">
108
+ <a href="/" class="logo-icon" data-initial="K">
109
+ <img src="../../assets/brand/kitfly-neon-256.png" alt="Kitfly" class="logo-img" onerror="this.onerror=null;this.style.display='none';this.parentElement.classList.add('logo-fallback')"/>
110
+ </a>
111
+ <span class="logo-text">
112
+ <a href="/" class="brand">Kitfly</a>
113
+ <a href="../../" class="product">Kitfly Docs</a>
114
+ </span>
115
+ </div>
116
+ <div class="header-tools">
117
+ <button class="theme-toggle" onclick="toggleTheme()" title="Toggle theme" aria-label="Toggle theme">
118
+ <svg class="icon-sun" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
119
+ <circle cx="12" cy="12" r="5"/>
120
+ <path d="M12 1v2M12 21v2M4.22 4.22l1.42 1.42M18.36 18.36l1.42 1.42M1 12h2M21 12h2M4.22 19.78l1.42-1.42M18.36 5.64l1.42-1.42"/>
121
+ </svg>
122
+ <svg class="icon-moon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
123
+ <path d="M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79z"/>
124
+ </svg>
125
+ </button>
126
+ <div class="sidebar-meta">
127
+ <span class="meta-version">v0.2.1</span>
128
+ <span class="meta-branch">HEAD</span>
129
+ </div>
130
+ </div>
131
+ </div>
132
+ <div class="sidebar-nav">
133
+ <ul><li><a href="../../index.html" class="nav-home">Home</a></li><li><span class="nav-section">Guide</span><ul><li><a href="../../content/guide/approaches.html">approaches</a></li><li><a href="../../content/guide/features.html">features</a></li><li><a href="../../content/guide/getting-started.html">getting-started</a></li><li><a href="../../content/guide/kitfly-overview.html">kitfly-overview</a></li></ul></li><li><span class="nav-section">Templates</span><ul><li><a href="../../content/templates/crucible.html">crucible</a></li><li><a href="../../content/templates/handbook.html">handbook</a></li><li><a href="../../content/templates/minimal.html">minimal</a></li><li><a href="../../content/templates/overview.html">overview</a></li><li><a href="../../content/templates/pipeline.html">pipeline</a></li><li><a href="../../content/templates/productbook.html">productbook</a></li><li><a href="../../content/templates/runbook.html">runbook</a></li><li><a href="../../content/templates/servicebook.html">servicebook</a></li></ul></li><li><a href="../../content/reference.html" class="nav-section">Reference</a><ul><li><a href="../../content/reference/configuration.html">configuration</a></li><li><a href="../../content/reference/design-catalog.html">design-catalog</a></li><li><a href="../../content/reference/environment-variables.html">environment-variables</a></li><li><a href="../../content/reference/glossary.html">glossary</a></li><li><a href="../../content/reference/key-concepts.html">key-concepts</a></li><li><a href="../../content/reference/plugins.html">plugins</a></li><li><a href="../../content/reference/slides-authoring-guidelines.html">slides-authoring-guidelines</a></li><li><a href="../../content/reference/structure.html">structure</a></li></ul></li><li><a href="../../content/deployment.html" class="nav-section">Deployment</a><ul><li><a href="../../content/deployment/preflight.html">preflight</a></li><li><details><summary class="nav-group">recipes</summary><ul><li><a href="../../content/deployment/recipes/aws-s3.html">aws-s3</a></li><li><a href="../../content/deployment/recipes/cloudflare-pages.html">cloudflare-pages</a></li><li><a href="../../content/deployment/recipes/cloudflare-r2.html">cloudflare-r2</a></li><li><a href="../../content/deployment/recipes/fly-io.html">fly-io</a></li><li><a href="../../content/deployment/recipes/github-pages.html">github-pages</a></li><li><a href="../../content/deployment/recipes/netlify.html">netlify</a></li><li><a href="../../content/deployment/recipes/vercel.html">vercel</a></li></ul></details></li><li><a href="../../content/deployment/secrets-and-env-vars.html">secrets-and-env-vars</a></li></ul></li><li><span class="nav-section">User Guide</span><ul><li><details><summary class="nav-group"><a href="../../docs/userguide/cli.html">cli</a></summary><ul><li><a href="../../docs/userguide/cli/build.html">build</a></li><li><a href="../../docs/userguide/cli/bundle.html">bundle</a></li><li><a href="../../docs/userguide/cli/dev.html">dev</a></li><li><a href="../../docs/userguide/cli/init.html">init</a></li><li><a href="../../docs/userguide/cli/servers.html">servers</a></li><li><a href="../../docs/userguide/cli/stop.html">stop</a></li><li><a href="../../docs/userguide/cli/update.html">update</a></li><li><a href="../../docs/userguide/cli/version.html">version</a></li></ul></details></li><li><a href="../../docs/userguide/sharing.html">sharing</a></li></ul></li><li><span class="nav-section">Decisions</span><ul><li><a href="../../docs/decisions/ADR-0001-minimalist-site-code.html">ADR-0001-minimalist-site-code</a></li><li><a href="../../docs/decisions/ADR-0002-ai-accessibility.html">ADR-0002-ai-accessibility</a></li><li><a href="../../docs/decisions/ADR-0003-single-file-bundle.html">ADR-0003-single-file-bundle</a></li><li><a href="../../docs/decisions/ADR-0004-bun-runtime.html">ADR-0004-bun-runtime</a></li><li><a href="../../docs/decisions/ADR-0005-plugin-contract-and-distribution.html">ADR-0005-plugin-contract-and-distribution</a></li><li><a href="../../docs/decisions/DDR-0001-viewport-locked-layout.html">DDR-0001-viewport-locked-layout</a></li><li><a href="../../docs/decisions/DDR-0002-theme-system.html">DDR-0002-theme-system</a></li><li><a href="../../docs/decisions/DDR-0003-bounded-logo-slot.html">DDR-0003-bounded-logo-slot</a></li><li><a href="../../docs/decisions/DDR-0004-slides-rendering-model.html">DDR-0004-slides-rendering-model</a></li><li><a href="../../docs/decisions/DDR-0005-deterministic-layout-boundary.html">DDR-0005-deterministic-layout-boundary</a></li></ul></li><li><a href="../../schemas.html" class="nav-section">Schemas</a><ul><li><a href="../../schemas/plugin-registry.schema.html">plugin-registry.schema</a></li><li><a href="../../schemas/plugin-schemas-notes.html">plugin-schemas-notes</a></li><li><a href="../../schemas/plugin.schema.html">plugin.schema</a></li><li><a href="../../schemas/plugins.schema.html">plugins.schema</a></li><li><details open><summary class="nav-group">v0</summary><ul><li><a href="../../schemas/v0/common.schema.html">common.schema</a></li><li><a href="../../schemas/v0/plugin-registry.schema.html" class="active">plugin-registry.schema</a></li><li><a href="../../schemas/v0/plugin.schema.html">plugin.schema</a></li><li><a href="../../schemas/v0/plugins.schema.html">plugins.schema</a></li><li><a href="../../schemas/v0/site.schema.html">site.schema</a></li><li><a href="../../schemas/v0/theme.schema.html">theme.schema</a></li></ul></details></li></ul></li></ul>
134
+ </div>
135
+ </nav>
136
+ <main class="content">
137
+ <article class="prose">
138
+ <nav class="breadcrumbs"><a href="../../schemas/plugin-registry.schema.html">Schemas</a><span class="separator">›</span><a href="../../schemas/v0/common.schema.html">V0</a><span class="separator">›</span><span>plugin-registry.schema</span></nav>
139
+
140
+ <h1>plugin-registry.schema</h1>
141
+ <pre><code class="language-json">{
142
+ &quot;$schema&quot;: &quot;https://json-schema.org/draft/2020-12/schema&quot;,
143
+ &quot;$id&quot;: &quot;https://kitfly.app/schemas/v0/plugin-registry.schema.json&quot;,
144
+ &quot;$version&quot;: &quot;0.2.0&quot;,
145
+ &quot;title&quot;: &quot;Plugin Registry&quot;,
146
+ &quot;description&quot;: &quot;Schema for kitfly canonical plugin registry (registry/plugins.yaml).&quot;,
147
+ &quot;type&quot;: &quot;object&quot;,
148
+ &quot;required&quot;: [
149
+ &quot;version&quot;,
150
+ &quot;updated&quot;,
151
+ &quot;baseUrl&quot;,
152
+ &quot;plugins&quot;
153
+ ],
154
+ &quot;properties&quot;: {
155
+ &quot;$schema&quot;: {
156
+ &quot;type&quot;: &quot;string&quot;,
157
+ &quot;description&quot;: &quot;Schema reference for validation&quot;
158
+ },
159
+ &quot;version&quot;: {
160
+ &quot;type&quot;: &quot;integer&quot;,
161
+ &quot;description&quot;: &quot;Registry schema version&quot;,
162
+ &quot;minimum&quot;: 1,
163
+ &quot;examples&quot;: [
164
+ 1
165
+ ]
166
+ },
167
+ &quot;updated&quot;: {
168
+ &quot;type&quot;: &quot;string&quot;,
169
+ &quot;description&quot;: &quot;Last update date (YYYY-MM-DD)&quot;,
170
+ &quot;pattern&quot;: &quot;^[0-9]{4}-[0-9]{2}-[0-9]{2}{{CONTENT}}quot;,
171
+ &quot;examples&quot;: [
172
+ &quot;2026-02-04&quot;
173
+ ]
174
+ },
175
+ &quot;baseUrl&quot;: {
176
+ &quot;type&quot;: &quot;string&quot;,
177
+ &quot;description&quot;: &quot;Base URL used for templating plugin asset URLs via ${baseUrl}&quot;,
178
+ &quot;minLength&quot;: 0,
179
+ &quot;maxLength&quot;: 200,
180
+ &quot;examples&quot;: [
181
+ &quot;https://github.com/3leaps/kitfly/releases/download&quot;
182
+ ]
183
+ },
184
+ &quot;plugins&quot;: {
185
+ &quot;type&quot;: &quot;object&quot;,
186
+ &quot;description&quot;: &quot;Plugin entries keyed by plugin id&quot;,
187
+ &quot;minProperties&quot;: 0,
188
+ &quot;patternProperties&quot;: {
189
+ &quot;^[a-z][a-z0-9-]*{{CONTENT}}quot;: {
190
+ &quot;$ref&quot;: &quot;#/$defs/registryPlugin&quot;
191
+ }
192
+ },
193
+ &quot;additionalProperties&quot;: false
194
+ }
195
+ },
196
+ &quot;additionalProperties&quot;: false,
197
+ &quot;$defs&quot;: {
198
+ &quot;registryAssets&quot;: {
199
+ &quot;type&quot;: &quot;object&quot;,
200
+ &quot;description&quot;: &quot;Plugin asset URLs. Strings may include ${baseUrl} templating.&quot;,
201
+ &quot;required&quot;: [
202
+ &quot;assetSha256&quot;
203
+ ],
204
+ &quot;properties&quot;: {
205
+ &quot;js&quot;: {
206
+ &quot;type&quot;: &quot;string&quot;,
207
+ &quot;description&quot;: &quot;JavaScript bundle URL (may include ${baseUrl})&quot;,
208
+ &quot;minLength&quot;: 1
209
+ },
210
+ &quot;css&quot;: {
211
+ &quot;type&quot;: &quot;string&quot;,
212
+ &quot;description&quot;: &quot;CSS bundle URL (may include ${baseUrl})&quot;,
213
+ &quot;minLength&quot;: 1
214
+ },
215
+ &quot;assetSha256&quot;: {
216
+ &quot;type&quot;: &quot;object&quot;,
217
+ &quot;description&quot;: &quot;Per-asset SHA256 checksums (sha256:&lt;hex&gt;) keyed by asset type.&quot;,
218
+ &quot;properties&quot;: {
219
+ &quot;js&quot;: {
220
+ &quot;$ref&quot;: &quot;./common.schema.json#/$defs/checksumSha256&quot;
221
+ },
222
+ &quot;css&quot;: {
223
+ &quot;$ref&quot;: &quot;./common.schema.json#/$defs/checksumSha256&quot;
224
+ }
225
+ },
226
+ &quot;additionalProperties&quot;: false
227
+ }
228
+ },
229
+ &quot;additionalProperties&quot;: false,
230
+ &quot;allOf&quot;: [
231
+ {
232
+ &quot;anyOf&quot;: [
233
+ {
234
+ &quot;required&quot;: [
235
+ &quot;js&quot;
236
+ ]
237
+ },
238
+ {
239
+ &quot;required&quot;: [
240
+ &quot;css&quot;
241
+ ]
242
+ }
243
+ ]
244
+ },
245
+ {
246
+ &quot;if&quot;: {
247
+ &quot;required&quot;: [
248
+ &quot;js&quot;
249
+ ]
250
+ },
251
+ &quot;then&quot;: {
252
+ &quot;properties&quot;: {
253
+ &quot;assetSha256&quot;: {
254
+ &quot;required&quot;: [
255
+ &quot;js&quot;
256
+ ]
257
+ }
258
+ }
259
+ }
260
+ },
261
+ {
262
+ &quot;if&quot;: {
263
+ &quot;required&quot;: [
264
+ &quot;css&quot;
265
+ ]
266
+ },
267
+ &quot;then&quot;: {
268
+ &quot;properties&quot;: {
269
+ &quot;assetSha256&quot;: {
270
+ &quot;required&quot;: [
271
+ &quot;css&quot;
272
+ ]
273
+ }
274
+ }
275
+ }
276
+ }
277
+ ]
278
+ },
279
+ &quot;registryPlugin&quot;: {
280
+ &quot;type&quot;: &quot;object&quot;,
281
+ &quot;required&quot;: [
282
+ &quot;name&quot;,
283
+ &quot;description&quot;,
284
+ &quot;version&quot;,
285
+ &quot;contract&quot;,
286
+ &quot;kitfly&quot;,
287
+ &quot;license&quot;,
288
+ &quot;verified&quot;,
289
+ &quot;assets&quot;
290
+ ],
291
+ &quot;properties&quot;: {
292
+ &quot;name&quot;: {
293
+ &quot;type&quot;: &quot;string&quot;,
294
+ &quot;description&quot;: &quot;Human-readable plugin name&quot;,
295
+ &quot;minLength&quot;: 1,
296
+ &quot;maxLength&quot;: 80
297
+ },
298
+ &quot;description&quot;: {
299
+ &quot;type&quot;: &quot;string&quot;,
300
+ &quot;description&quot;: &quot;Short description used in listing/help output&quot;,
301
+ &quot;minLength&quot;: 1,
302
+ &quot;maxLength&quot;: 160
303
+ },
304
+ &quot;version&quot;: {
305
+ &quot;$ref&quot;: &quot;./common.schema.json#/$defs/semver&quot;
306
+ },
307
+ &quot;contract&quot;: {
308
+ &quot;type&quot;: &quot;string&quot;,
309
+ &quot;description&quot;: &quot;Plugin contract version this plugin implements (stringified integer)&quot;,
310
+ &quot;pattern&quot;: &quot;^[0-9]+{{CONTENT}}quot;,
311
+ &quot;examples&quot;: [
312
+ &quot;1&quot;
313
+ ]
314
+ },
315
+ &quot;kitfly&quot;: {
316
+ &quot;$ref&quot;: &quot;./common.schema.json#/$defs/semverRange&quot;
317
+ },
318
+ &quot;license&quot;: {
319
+ &quot;type&quot;: &quot;string&quot;,
320
+ &quot;description&quot;: &quot;License identifier (typically SPDX, e.g. MIT)&quot;,
321
+ &quot;minLength&quot;: 1,
322
+ &quot;maxLength&quot;: 50
323
+ },
324
+ &quot;verified&quot;: {
325
+ &quot;type&quot;: &quot;boolean&quot;,
326
+ &quot;description&quot;: &quot;If true, plugin is first-party / reviewed (canonical registry)&quot;
327
+ },
328
+ &quot;modes&quot;: {
329
+ &quot;$ref&quot;: &quot;./common.schema.json#/$defs/kitflyModesAllowlist&quot;
330
+ },
331
+ &quot;assets&quot;: {
332
+ &quot;$ref&quot;: &quot;#/$defs/registryAssets&quot;
333
+ }
334
+ },
335
+ &quot;additionalProperties&quot;: false
336
+ }
337
+ },
338
+ &quot;examples&quot;: [
339
+ {
340
+ &quot;$schema&quot;: &quot;./schemas/v0/plugin-registry.schema.json&quot;,
341
+ &quot;version&quot;: 1,
342
+ &quot;updated&quot;: &quot;2026-02-04&quot;,
343
+ &quot;baseUrl&quot;: &quot;https://github.com/3leaps/kitfly/releases/download&quot;,
344
+ &quot;plugins&quot;: {
345
+ &quot;latex&quot;: {
346
+ &quot;name&quot;: &quot;LaTeX/KaTeX Math Rendering&quot;,
347
+ &quot;description&quot;: &quot;Render LaTeX math expressions with KaTeX&quot;,
348
+ &quot;version&quot;: &quot;1.0.0&quot;,
349
+ &quot;contract&quot;: &quot;1&quot;,
350
+ &quot;kitfly&quot;: &quot;&gt;=0.2.0 &lt;1.0.0&quot;,
351
+ &quot;license&quot;: &quot;MIT&quot;,
352
+ &quot;verified&quot;: true,
353
+ &quot;assets&quot;: {
354
+ &quot;js&quot;: &quot;${baseUrl}/v1.0.0/latex.js&quot;,
355
+ &quot;css&quot;: &quot;${baseUrl}/v1.0.0/latex.css&quot;,
356
+ &quot;assetSha256&quot;: {
357
+ &quot;js&quot;: &quot;sha256:0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef&quot;,
358
+ &quot;css&quot;: &quot;sha256:0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef&quot;
359
+ }
360
+ }
361
+ }
362
+ }
363
+ }
364
+ ]
365
+ }</code></pre>
366
+ </article>
367
+
368
+ </main>
369
+ </div>
370
+
371
+ <footer class="site-footer">
372
+ <div class="footer-content">
373
+ <div class="footer-left">
374
+ <span class="footer-version">v0.2.1</span>
375
+ <span class="footer-separator">·</span>
376
+ <span class="footer-commit" title="Commit: 30dfc01">Published 2026-02-15</span>
377
+ </div>
378
+ <div class="footer-center">
379
+ <span class="footer-copyright"><a href="https://3leaps.net" class="footer-link">© 2026 3 Leaps, LLC</a></span>
380
+ <span class="footer-separator">·</span><a href="/" class="footer-link">Kitfly</a>
381
+ </div>
382
+ <div class="footer-right">
383
+ <a href="https://kitfly.dev" class="footer-link">Built with Kitfly</a>
384
+ </div>
385
+ </div>
386
+ </footer>
387
+ <!-- Syntax highlighting - Prism.js -->
388
+ <script src="https://cdn.jsdelivr.net/npm/prismjs@1/components/prism-core.min.js"></script>
389
+ <script src="https://cdn.jsdelivr.net/npm/prismjs@1/plugins/autoloader/prism-autoloader.min.js"></script>
390
+ <!-- Mermaid diagram support -->
391
+ <script type="module">
392
+ import mermaid from 'https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.esm.min.mjs';
393
+
394
+ function getMermaidTheme() {
395
+ const theme = document.documentElement.getAttribute('data-theme');
396
+ const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
397
+ const isDark = theme === 'dark' || (!theme && prefersDark);
398
+ return isDark ? 'dark' : 'neutral';
399
+ }
400
+
401
+ mermaid.initialize({
402
+ startOnLoad: true,
403
+ theme: getMermaidTheme()
404
+ });
405
+
406
+ // Re-render mermaid diagrams when theme changes
407
+ window.reinitMermaid = async function() {
408
+ mermaid.initialize({ startOnLoad: false, theme: getMermaidTheme() });
409
+ const diagrams = document.querySelectorAll('.mermaid');
410
+ for (const el of diagrams) {
411
+ const code = el.getAttribute('data-mermaid-source');
412
+ if (code) {
413
+ el.innerHTML = code;
414
+ el.removeAttribute('data-processed');
415
+ }
416
+ }
417
+ await mermaid.run({ nodes: diagrams });
418
+ };
419
+ </script>
420
+
421
+ <script>
422
+ function toggleTheme() {
423
+ const html = document.documentElement;
424
+ const current = html.getAttribute('data-theme');
425
+ const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
426
+
427
+ let next;
428
+ if (current === 'dark') {
429
+ next = 'light';
430
+ } else if (current === 'light') {
431
+ next = 'dark';
432
+ } else {
433
+ // No explicit theme set, toggle from system preference
434
+ next = prefersDark ? 'light' : 'dark';
435
+ }
436
+
437
+ html.setAttribute('data-theme', next);
438
+ localStorage.setItem('theme', next);
439
+
440
+ // Switch Prism theme
441
+ const prismLight = document.getElementById('prism-light');
442
+ const prismDark = document.getElementById('prism-dark');
443
+ if (next === 'dark') {
444
+ prismLight?.setAttribute('disabled', '');
445
+ prismDark?.removeAttribute('disabled');
446
+ } else {
447
+ prismLight?.removeAttribute('disabled');
448
+ prismDark?.setAttribute('disabled', '');
449
+ }
450
+
451
+ // Re-render mermaid diagrams with new theme
452
+ if (window.reinitMermaid) {
453
+ window.reinitMermaid();
454
+ }
455
+ }
456
+
457
+ // Slides mode hash routing
458
+ (function initSlidesMode() {
459
+ const shell = document.querySelector('.slides-shell');
460
+ if (!shell) return;
461
+
462
+ const slides = Array.from(document.querySelectorAll('.slide'));
463
+ if (!slides.length) return;
464
+
465
+ const prevBtn = document.querySelector('.slide-prev');
466
+ const nextBtn = document.querySelector('.slide-next');
467
+ const counter = document.querySelector('.slide-counter');
468
+ const progressBar = document.querySelector('.slide-progress-bar');
469
+ const navLinks = Array.from(document.querySelectorAll('.sidebar-nav a[href^="#slide-"]'));
470
+ let current = 0;
471
+
472
+ function setActive(n) {
473
+ current = Math.max(0, Math.min(n, slides.length - 1));
474
+ slides.forEach((slide, idx) => slide.classList.toggle('active', idx === current));
475
+ navLinks.forEach((link) => {
476
+ const active = link.getAttribute('href') === '#' + slides[current].id;
477
+ link.classList.toggle('active', active);
478
+ });
479
+ if (counter) counter.textContent = (current + 1) + ' / ' + slides.length;
480
+ if (progressBar) progressBar.style.width = (((current + 1) / slides.length) * 100) + '%';
481
+ if (prevBtn) prevBtn.disabled = current === 0;
482
+ if (nextBtn) nextBtn.disabled = current === slides.length - 1;
483
+ history.replaceState(null, '', '#' + slides[current].id);
484
+ }
485
+
486
+ function setFromHash() {
487
+ const hash = window.location.hash || '';
488
+ const idx = slides.findIndex((s) => '#' + s.id === hash);
489
+ if (idx >= 0) setActive(idx);
490
+ else setActive(0);
491
+ }
492
+
493
+ prevBtn?.addEventListener('click', () => setActive(current - 1));
494
+ nextBtn?.addEventListener('click', () => setActive(current + 1));
495
+
496
+ document.addEventListener('keydown', (e) => {
497
+ if (e.key === 'ArrowRight' || e.key === ' ') {
498
+ e.preventDefault();
499
+ setActive(current + 1);
500
+ } else if (e.key === 'ArrowLeft') {
501
+ e.preventDefault();
502
+ setActive(current - 1);
503
+ } else if (e.key === 'Home') {
504
+ e.preventDefault();
505
+ setActive(0);
506
+ } else if (e.key === 'End') {
507
+ e.preventDefault();
508
+ setActive(slides.length - 1);
509
+ }
510
+ });
511
+
512
+ window.addEventListener('hashchange', setFromHash);
513
+ setFromHash();
514
+ })();
515
+
516
+ // Copy code button
517
+ document.querySelectorAll('.prose pre code').forEach(block => {
518
+ const button = document.createElement('button');
519
+ button.className = 'copy-button';
520
+ button.textContent = 'Copy';
521
+ button.onclick = async () => {
522
+ await navigator.clipboard.writeText(block.textContent);
523
+ button.textContent = 'Copied!';
524
+ setTimeout(() => button.textContent = 'Copy', 2000);
525
+ };
526
+ block.parentElement.appendChild(button);
527
+ });
528
+
529
+ // Mobile nav toggle
530
+ function toggleNav() {
531
+ document.querySelector('.sidebar').classList.toggle('open');
532
+ }
533
+
534
+ // Close nav when clicking outside on mobile
535
+ document.addEventListener('click', (e) => {
536
+ const sidebar = document.querySelector('.sidebar');
537
+ const toggle = document.querySelector('.nav-toggle');
538
+ if (sidebar.classList.contains('open') &&
539
+ !sidebar.contains(e.target) &&
540
+ !toggle.contains(e.target)) {
541
+ sidebar.classList.remove('open');
542
+ }
543
+ });
544
+ </script>
545
+
546
+ </body>
547
+ </html>