@jskit-ai/agent-docs 0.1.131 → 0.1.133

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 (171) hide show
  1. package/guide/agent/app-extras/assistant.md +29 -605
  2. package/guide/agent/app-extras/mobile-capacitor.md +29 -362
  3. package/guide/agent/app-extras/realtime.md +29 -277
  4. package/guide/agent/app-setup/a-more-interesting-shell.md +44 -815
  5. package/guide/agent/app-setup/authentication.md +43 -1073
  6. package/guide/agent/app-setup/console.md +26 -298
  7. package/guide/agent/app-setup/database-layer.md +110 -790
  8. package/guide/agent/app-setup/existing-application-migration.md +273 -0
  9. package/guide/agent/app-setup/initial-scaffolding.md +50 -784
  10. package/guide/agent/app-setup/multi-homing.md +39 -712
  11. package/guide/agent/app-setup/quickstart.md +43 -179
  12. package/guide/agent/app-setup/users.md +34 -353
  13. package/guide/agent/index.md +17 -23
  14. package/package.json +2 -2
  15. package/patterns/INDEX.md +7 -7
  16. package/patterns/child-cruds.md +3 -3
  17. package/patterns/client-requests.md +6 -6
  18. package/patterns/crud-authoring.md +94 -0
  19. package/patterns/crud-links.md +1 -1
  20. package/patterns/feature-package/PATTERN.md +108 -0
  21. package/patterns/feature-package/example/booking-engine/package.json +48 -0
  22. package/patterns/feature-package/example/booking-engine/src/server/BookingEngineProvider.js +33 -0
  23. package/patterns/feature-package/example/booking-engine/src/server/actions.js +26 -0
  24. package/patterns/feature-package/example/booking-engine/src/server/inputSchemas.js +19 -0
  25. package/patterns/feature-package/example/variations/AvailabilityEngineProvider.js +31 -0
  26. package/patterns/feature-package/example/variations/InvoiceRollupProvider.js +36 -0
  27. package/patterns/feature-package/example/variations/customKnexRepository.js +34 -0
  28. package/patterns/feature-package/example/variations/orchestratorService.js +23 -0
  29. package/patterns/filters.md +8 -8
  30. package/patterns/live-actions.md +5 -18
  31. package/patterns/minimal-foundation/PATTERN.md +98 -0
  32. package/patterns/minimal-foundation/example/.nvmrc +1 -0
  33. package/patterns/minimal-foundation/example/AGENTS.md +17 -0
  34. package/patterns/minimal-foundation/example/Procfile +2 -0
  35. package/patterns/minimal-foundation/example/app.json +14 -0
  36. package/patterns/minimal-foundation/example/bin/develop.js +71 -0
  37. package/patterns/minimal-foundation/example/bin/server.js +8 -0
  38. package/patterns/minimal-foundation/example/config/public.js +40 -0
  39. package/patterns/minimal-foundation/example/config/server.js +1 -0
  40. package/patterns/minimal-foundation/example/config/surfaceAccessPolicies.js +3 -0
  41. package/patterns/minimal-foundation/example/eslint.config.mjs +19 -0
  42. package/patterns/minimal-foundation/example/favicon.svg +7 -0
  43. package/patterns/minimal-foundation/example/gitignore +9 -0
  44. package/patterns/minimal-foundation/example/index.html +13 -0
  45. package/patterns/minimal-foundation/example/jsconfig.json +8 -0
  46. package/patterns/minimal-foundation/example/package.json +57 -0
  47. package/patterns/minimal-foundation/example/packages/main/package.json +42 -0
  48. package/patterns/minimal-foundation/example/packages/main/src/shared/index.js +10 -0
  49. package/patterns/minimal-foundation/example/packages/main/src/shared/schemas/index.js +22 -0
  50. package/patterns/minimal-foundation/example/playwright.config.mjs +31 -0
  51. package/patterns/minimal-foundation/example/server/lib/runtimeEnv.js +45 -0
  52. package/patterns/minimal-foundation/example/server/lib/surfaceRuntime.js +10 -0
  53. package/patterns/minimal-foundation/example/server.js +195 -0
  54. package/patterns/minimal-foundation/example/src/App.vue +13 -0
  55. package/patterns/minimal-foundation/example/src/main.js +85 -0
  56. package/patterns/minimal-foundation/example/src/pages/home/index.vue +48 -0
  57. package/patterns/minimal-foundation/example/src/pages/home.vue +13 -0
  58. package/patterns/minimal-foundation/example/src/views/NotFound.vue +13 -0
  59. package/patterns/minimal-foundation/example/tests/client/smoke.vitest.js +7 -0
  60. package/patterns/minimal-foundation/example/tests/e2e/base-shell.spec.ts +23 -0
  61. package/patterns/minimal-foundation/example/tests/server/smoke.test.js +16 -0
  62. package/patterns/minimal-foundation/example/vite.config.mjs +81 -0
  63. package/patterns/page-scaffolding.md +20 -17
  64. package/patterns/placements.md +17 -15
  65. package/patterns/row-policies.md +4 -5
  66. package/patterns/server-search.md +3 -3
  67. package/patterns/shell-foundation/PATTERN.md +104 -0
  68. package/patterns/shell-foundation/example/.nvmrc +1 -0
  69. package/patterns/shell-foundation/example/AGENTS.md +17 -0
  70. package/patterns/shell-foundation/example/Procfile +2 -0
  71. package/patterns/shell-foundation/example/app.json +14 -0
  72. package/patterns/shell-foundation/example/bin/develop.js +71 -0
  73. package/patterns/shell-foundation/example/bin/server.js +8 -0
  74. package/patterns/shell-foundation/example/config/public.js +40 -0
  75. package/patterns/shell-foundation/example/config/server.js +1 -0
  76. package/patterns/shell-foundation/example/config/surfaceAccessPolicies.js +3 -0
  77. package/patterns/shell-foundation/example/eslint.config.mjs +19 -0
  78. package/patterns/shell-foundation/example/favicon.svg +7 -0
  79. package/patterns/shell-foundation/example/gitignore +9 -0
  80. package/patterns/shell-foundation/example/index.html +13 -0
  81. package/patterns/shell-foundation/example/jsconfig.json +8 -0
  82. package/patterns/shell-foundation/example/package.json +59 -0
  83. package/patterns/shell-foundation/example/packages/main/package.json +56 -0
  84. package/patterns/shell-foundation/example/packages/main/src/client/index.js +9 -0
  85. package/patterns/shell-foundation/example/packages/main/src/client/providers/MainClientProvider.js +18 -0
  86. package/patterns/shell-foundation/example/packages/main/src/shared/index.js +10 -0
  87. package/patterns/shell-foundation/example/packages/main/src/shared/schemas/index.js +22 -0
  88. package/patterns/shell-foundation/example/playwright.config.mjs +31 -0
  89. package/patterns/shell-foundation/example/server/lib/runtimeEnv.js +45 -0
  90. package/patterns/shell-foundation/example/server/lib/surfaceRuntime.js +10 -0
  91. package/patterns/shell-foundation/example/server.js +195 -0
  92. package/patterns/shell-foundation/example/src/App.vue +11 -0
  93. package/patterns/shell-foundation/example/src/components/ShellLayout.vue +12 -0
  94. package/patterns/shell-foundation/example/src/components/menus/MenuLinkItem.vue +30 -0
  95. package/patterns/shell-foundation/example/src/components/menus/SurfaceAwareMenuLinkItem.vue +42 -0
  96. package/patterns/shell-foundation/example/src/components/menus/TabLinkItem.vue +42 -0
  97. package/patterns/shell-foundation/example/src/error.js +19 -0
  98. package/patterns/shell-foundation/example/src/main.js +85 -0
  99. package/patterns/shell-foundation/example/src/pages/home/index.vue +116 -0
  100. package/patterns/shell-foundation/example/src/pages/home/settings/general/index.vue +40 -0
  101. package/patterns/shell-foundation/example/src/pages/home/settings/index.vue +7 -0
  102. package/patterns/shell-foundation/example/src/pages/home/settings.vue +109 -0
  103. package/patterns/shell-foundation/example/src/pages/home.vue +20 -0
  104. package/patterns/shell-foundation/example/src/placement.js +56 -0
  105. package/patterns/shell-foundation/example/src/placementTopology.js +149 -0
  106. package/patterns/shell-foundation/example/src/views/NotFound.vue +13 -0
  107. package/patterns/shell-foundation/example/tests/client/smoke.vitest.js +7 -0
  108. package/patterns/shell-foundation/example/tests/e2e/adaptive-shell.spec.ts +10 -0
  109. package/patterns/shell-foundation/example/tests/e2e/base-shell.spec.ts +23 -0
  110. package/patterns/shell-foundation/example/tests/server/smoke.test.js +16 -0
  111. package/patterns/shell-foundation/example/vite.config.mjs +81 -0
  112. package/patterns/ui-contract.md +56 -0
  113. package/patterns/ui-testing.md +10 -12
  114. package/reference/autogen/KERNEL_MAP.md +29 -107
  115. package/reference/autogen/PATTERN_INDEX.md +230 -0
  116. package/reference/autogen/README.md +4 -8
  117. package/reference/autogen/packages/agent-docs.md +259 -0
  118. package/reference/autogen/packages/assistant-core.md +3 -3
  119. package/reference/autogen/packages/assistant-runtime.md +32 -17
  120. package/reference/autogen/packages/auth-core.md +31 -33
  121. package/reference/autogen/packages/auth-provider-local-core.md +4 -12
  122. package/reference/autogen/packages/auth-provider-local-db-core.md +4 -4
  123. package/reference/autogen/packages/auth-provider-supabase-core.md +14 -18
  124. package/reference/autogen/packages/auth-web.md +42 -22
  125. package/reference/autogen/packages/console-core.md +8 -25
  126. package/reference/autogen/packages/console-web.md +5 -5
  127. package/reference/autogen/packages/crud-core.md +61 -17
  128. package/reference/autogen/packages/database-runtime-mysql.md +12 -2
  129. package/reference/autogen/packages/database-runtime-postgres.md +12 -2
  130. package/reference/autogen/packages/database-runtime.md +26 -25
  131. package/reference/autogen/packages/google-rewarded-core.md +19 -104
  132. package/reference/autogen/packages/http-runtime.md +4 -8
  133. package/reference/autogen/packages/http-web.md +32 -0
  134. package/reference/autogen/packages/json-rest-api-core.md +4 -6
  135. package/reference/autogen/packages/kernel.md +109 -390
  136. package/reference/autogen/packages/mobile-capacitor.md +2 -13
  137. package/reference/autogen/packages/realtime.md +29 -26
  138. package/reference/autogen/packages/resource-crud-core.md +6 -0
  139. package/reference/autogen/packages/shell-web.md +69 -54
  140. package/reference/autogen/packages/storage-runtime.md +3 -3
  141. package/reference/autogen/packages/uploads-image-web.md +0 -1
  142. package/reference/autogen/packages/uploads-runtime.md +3 -3
  143. package/reference/autogen/packages/users-core.md +45 -90
  144. package/reference/autogen/packages/users-web.md +5 -7
  145. package/reference/autogen/packages/workspaces-core.md +53 -74
  146. package/reference/autogen/packages/workspaces-web.md +15 -16
  147. package/reference/autogen/tooling/jskit-catalog.md +34 -0
  148. package/reference/autogen/tooling/testUtils.md +4 -4
  149. package/skills/jskit/SKILL.md +38 -31
  150. package/skills/jskit/references/app-operations.md +68 -53
  151. package/skills/jskit/references/crud-operations.md +58 -106
  152. package/skills/jskit/references/material-3.md +1 -1
  153. package/skills/jskit/references/ui-operations.md +41 -44
  154. package/templates/app/AGENTS.md +7 -3
  155. package/guide/agent/app-setup/upgrade-beta-1-to-final.md +0 -252
  156. package/guide/agent/app-setup/working-with-the-jskit-cli.md +0 -325
  157. package/guide/agent/generators/advanced-cruds.md +0 -1935
  158. package/guide/agent/generators/crud-generators.md +0 -948
  159. package/guide/agent/generators/intro.md +0 -65
  160. package/guide/agent/generators/row-policies.md +0 -537
  161. package/guide/agent/generators/ui-generators.md +0 -690
  162. package/patterns/crud-scaffolding.md +0 -198
  163. package/patterns/generated-ui-contract-tracking.md +0 -66
  164. package/reference/autogen/packages/assistant.md +0 -68
  165. package/reference/autogen/packages/crud-server-generator.md +0 -215
  166. package/reference/autogen/packages/crud-ui-generator.md +0 -192
  167. package/reference/autogen/packages/feature-server-generator.md +0 -65
  168. package/reference/autogen/packages/ui-generator.md +0 -127
  169. package/reference/autogen/tooling/create-app.md +0 -317
  170. package/reference/autogen/tooling/jskit-cli.md +0 -933
  171. package/reference/autogen/tooling/test-support.md +0 -27
@@ -1,317 +0,0 @@
1
- # tooling/create-app
2
-
3
- Generated by `npm run agent-docs:build`.
4
- Do not edit manually.
5
-
6
- Generated inventory for `tooling/create-app`.
7
- Use this on demand; do not load the full index at startup.
8
-
9
- ## Scope
10
- - Source: `tooling/create-app/**/*{.js,.mjs,.cjs,.vue}`
11
- - Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
12
-
13
- ## Sections
14
-
15
- ### src
16
-
17
- ### `src/client/index.js`
18
- Exports
19
- - None
20
-
21
- ### `src/index.js`
22
- Exports
23
- - None
24
-
25
- ### `src/server/cliEntrypoint.js`
26
- Exports
27
- - `shellQuote(value)`
28
- - `runCliEntrypoint(runCli, argv = process.argv.slice(2))`
29
-
30
- ### `src/server/cliError.js`
31
- Exports
32
- - `createCliError(message, { showUsage = false, exitCode = 1 } = {})`
33
-
34
- ### `src/server/index.js`
35
- Exports
36
- - `createApp({ appName, appTitle = null, template = DEFAULT_TEMPLATE, target = null, initialBundles = DEFAULT_INITIAL_BUNDLES, playwrightVersion = DEFAULT_PLAYWRIGHT_VERSION, tenancyMode = null, force = false, dryRun = false, cwd = process.cwd() })`
37
- - `runCli(argv, { stdout = process.stdout, stderr = process.stderr, stdin = process.stdin, cwd = process.cwd(), readlineFactory = createReadlineInterface } = {})`
38
- Local functions
39
- - `toAppTitle(appName)`
40
- - `normalizeInitialBundlesPreset(value, { showUsage = true } = {})`
41
- - `normalizeTenancyMode(value, { showUsage = true } = {})`
42
- - `normalizePlaywrightVersion(value, { showUsage = true } = {})`
43
- - `buildInitialSetupCommands(initialBundles)`
44
- - `validateAppName(appName, { showUsage = true } = {})`
45
- - `parseOptionWithValue(argv, index, optionName)`
46
- - `parseCliArgs(argv)`
47
- - `printUsage(stream = process.stderr)`
48
- - `applyPlaceholders(source, replacements)`
49
- - `isPathWithinRoot(rootPath, candidatePath)`
50
- - `normalizeTemplatePathSegments(templateName)`
51
- - `resolveTemplateDirectory(templateName)`
52
- - `ensureTargetDirectoryState(targetDirectory, { force = false, dryRun = false } = {})`
53
- - `sortEntriesByName(entries)`
54
- - `mapTemplatePathToTargetPath(relativePath)`
55
- - `writeTemplateFile(sourcePath, targetPath, replacements)`
56
- - `copyTemplateDirectory({ templateDirectory, targetDirectory, replacements, dryRun })`
57
- - `toRelativeTargetLabel(cwd, targetDirectory)`
58
- - `askQuestion(readline, label, defaultValue)`
59
- - `askYesNoQuestion(readline, label, defaultValue)`
60
- - `createReadlineInterface({ stdin = process.stdin, stdout = process.stdout } = {})`
61
- - `collectInteractiveOptions({ parsed, stdout = process.stdout, stderr = process.stderr, stdin = process.stdin, readlineFactory = createReadlineInterface })`
62
-
63
- ### templates
64
-
65
- ### `templates/base-shell/bin/server.js`
66
- Exports
67
- - None
68
-
69
- ### `templates/base-shell/config/public.js`
70
- Exports
71
- - `config`
72
-
73
- ### `templates/base-shell/config/server.js`
74
- Exports
75
- - `config`
76
-
77
- ### `templates/base-shell/config/surfaceAccessPolicies.js`
78
- Exports
79
- - `surfaceAccessPolicies`
80
-
81
- ### `templates/base-shell/eslint.config.mjs`
82
- Exports
83
- - None
84
-
85
- ### `templates/base-shell/packages/main/src/client/index.js`
86
- Exports
87
- - `MainClientProvider`
88
- - `registerMainClientComponent`
89
-
90
- ### `templates/base-shell/packages/main/src/client/providers/MainClientProvider.js`
91
- Exports
92
- - `MainClientProvider`
93
- - `registerMainClientComponent(token, resolveComponent)`
94
-
95
- ### `templates/base-shell/packages/main/src/server/index.js`
96
- Exports
97
- - `MainServiceProvider`
98
-
99
- ### `templates/base-shell/packages/main/src/server/loadAppConfig.js`
100
- Exports
101
- - `loadAppConfig({ moduleUrl = import.meta.url } = {})`
102
-
103
- ### `templates/base-shell/packages/main/src/server/MainServiceProvider.js`
104
- Exports
105
- - `MainServiceProvider`
106
-
107
- ### `templates/base-shell/packages/main/src/shared/index.js`
108
- Exports
109
- - None
110
-
111
- ### `templates/base-shell/packages/main/src/shared/schemas/index.js`
112
- Exports
113
- - None
114
-
115
- ### `templates/base-shell/playwright.config.mjs`
116
- Exports
117
- - None
118
-
119
- ### `templates/base-shell/server.js`
120
- Exports
121
- - `createServer()`
122
- - `startServer(options = {})`
123
- Local functions
124
- - `toRequestPathname(urlValue)`
125
- - `isApiPath(pathname)`
126
- - `hasFileExtension(pathname)`
127
- - `resolveGlobalUiPaths(runtimeGlobalUiPaths = [])`
128
- - `resolveStaticFilePath(pathname)`
129
- - `canServeStaticFile(distRoot, relativePath)`
130
-
131
- ### `templates/base-shell/server/lib/runtimeEnv.js`
132
- Exports
133
- - `resolveRuntimeEnv()`
134
- Local functions
135
- - `toPort(value, fallback = 3000)`
136
- - `ensureRuntimeEnvLoaded()`
137
-
138
- ### `templates/base-shell/server/lib/surfaceRuntime.js`
139
- Exports
140
- - `surfaceRuntime`
141
-
142
- ### `templates/base-shell/src/App.vue`
143
- Exports
144
- - None
145
-
146
- ### `templates/base-shell/src/components/menus/MenuLinkItem.vue`
147
- Exports
148
- - None
149
-
150
- ### `templates/base-shell/src/components/menus/SurfaceAwareMenuLinkItem.vue`
151
- Exports
152
- - None
153
-
154
- ### `templates/base-shell/src/components/menus/TabLinkItem.vue`
155
- Exports
156
- - None
157
-
158
- ### `templates/base-shell/src/components/ShellLayout.vue`
159
- Exports
160
- - `default`
161
-
162
- ### `templates/base-shell/src/error.js`
163
- Exports
164
- - None
165
-
166
- ### `templates/base-shell/src/main.js`
167
- Exports
168
- - None
169
-
170
- ### `templates/base-shell/src/pages/home.vue`
171
- Exports
172
- - None
173
-
174
- ### `templates/base-shell/src/pages/home/index.vue`
175
- Exports
176
- - None
177
-
178
- ### `templates/base-shell/src/pages/home/settings.vue`
179
- Exports
180
- - None
181
-
182
- ### `templates/base-shell/src/pages/home/settings/general/index.vue`
183
- Exports
184
- - None
185
-
186
- ### `templates/base-shell/src/pages/home/settings/index.vue`
187
- Exports
188
- - None
189
-
190
- ### `templates/base-shell/src/placement.js`
191
- Exports
192
- - `addPlacement`
193
- - `getPlacements()`
194
-
195
- ### `templates/base-shell/src/placementTopology.js`
196
- Exports
197
- - `addPlacementTopology(value = {})`
198
- - `default`
199
-
200
- ### `templates/base-shell/src/views/NotFound.vue`
201
- Exports
202
- - None
203
-
204
- ### `templates/base-shell/vite.config.mjs`
205
- Exports
206
- - None
207
- Local functions
208
- - `clientEntry(()`
209
-
210
- ### `templates/minimal-shell/bin/server.js`
211
- Exports
212
- - None
213
-
214
- ### `templates/minimal-shell/config/public.js`
215
- Exports
216
- - `config`
217
-
218
- ### `templates/minimal-shell/config/server.js`
219
- Exports
220
- - `config`
221
-
222
- ### `templates/minimal-shell/config/surfaceAccessPolicies.js`
223
- Exports
224
- - `surfaceAccessPolicies`
225
-
226
- ### `templates/minimal-shell/eslint.config.mjs`
227
- Exports
228
- - None
229
-
230
- ### `templates/minimal-shell/packages/main/src/client/index.js`
231
- Exports
232
- - `MainClientProvider`
233
- - `registerMainClientComponent`
234
-
235
- ### `templates/minimal-shell/packages/main/src/client/providers/MainClientProvider.js`
236
- Exports
237
- - `MainClientProvider`
238
- - `registerMainClientComponent(token, resolveComponent)`
239
-
240
- ### `templates/minimal-shell/packages/main/src/server/index.js`
241
- Exports
242
- - `MainServiceProvider`
243
-
244
- ### `templates/minimal-shell/packages/main/src/server/loadAppConfig.js`
245
- Exports
246
- - `loadAppConfig({ moduleUrl = import.meta.url } = {})`
247
-
248
- ### `templates/minimal-shell/packages/main/src/server/MainServiceProvider.js`
249
- Exports
250
- - `MainServiceProvider`
251
-
252
- ### `templates/minimal-shell/packages/main/src/shared/index.js`
253
- Exports
254
- - None
255
-
256
- ### `templates/minimal-shell/packages/main/src/shared/schemas/index.js`
257
- Exports
258
- - None
259
-
260
- ### `templates/minimal-shell/playwright.config.mjs`
261
- Exports
262
- - None
263
-
264
- ### `templates/minimal-shell/server.js`
265
- Exports
266
- - `createServer()`
267
- - `startServer(options = {})`
268
- Local functions
269
- - `toRequestPathname(urlValue)`
270
- - `isApiPath(pathname)`
271
- - `hasFileExtension(pathname)`
272
- - `resolveGlobalUiPaths(runtimeGlobalUiPaths = [])`
273
- - `resolveStaticFilePath(pathname)`
274
- - `canServeStaticFile(distRoot, relativePath)`
275
-
276
- ### `templates/minimal-shell/server/lib/runtimeEnv.js`
277
- Exports
278
- - `resolveRuntimeEnv()`
279
- Local functions
280
- - `toPort(value, fallback = 3000)`
281
- - `ensureRuntimeEnvLoaded()`
282
-
283
- ### `templates/minimal-shell/server/lib/surfaceRuntime.js`
284
- Exports
285
- - `surfaceRuntime`
286
-
287
- ### `templates/minimal-shell/src/App.vue`
288
- Exports
289
- - None
290
-
291
- ### `templates/minimal-shell/src/main.js`
292
- Exports
293
- - None
294
-
295
- ### `templates/minimal-shell/src/pages/home.vue`
296
- Exports
297
- - None
298
-
299
- ### `templates/minimal-shell/src/pages/home/index.vue`
300
- Exports
301
- - None
302
-
303
- ### `templates/minimal-shell/src/views/NotFound.vue`
304
- Exports
305
- - None
306
-
307
- ### `templates/minimal-shell/vite.config.mjs`
308
- Exports
309
- - None
310
- Local functions
311
- - `clientEntry(()`
312
-
313
- ### bin
314
-
315
- ### `bin/jskit-create-app.js`
316
- Exports
317
- - None