@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,933 +0,0 @@
1
- # tooling/jskit-cli
2
-
3
- Generated by `npm run agent-docs:build`.
4
- Do not edit manually.
5
-
6
- Generated inventory for `tooling/jskit-cli`.
7
- Use this on demand; do not load the full index at startup.
8
-
9
- ## Scope
10
- - Source: `tooling/jskit-cli/**/*{.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/appBlueprint.js`
26
- Exports
27
- - `APP_BLUEPRINT_RELATIVE_PATH`
28
- - `APP_BLUEPRINT_PROMPT_DIRECTORY`
29
- - `APP_PROMPT_OVERRIDE_RELATIVE_ROOT`
30
- - `extractAppBlueprintText(value = "")`
31
- - `readAppBlueprint({ targetRoot = process.cwd() } = {})`
32
- - `readTextInputFile(cwd, inputPath)`
33
- - `renderAppBlueprintPrompt({ targetRoot = process.cwd(), appBrief = "" } = {})`
34
- - `resolveAppBlueprintPaths(targetRoot = process.cwd())`
35
- - `writeAppBlueprint({ targetRoot = process.cwd(), appBlueprint = "" } = {})`
36
- Local functions
37
- - `normalizeText(value)`
38
- - `fileExists(filePath)`
39
- - `readTextIfExists(filePath)`
40
- - `writeTextFile(filePath, value)`
41
- - `renderTemplate(source, values = {})`
42
- - `readAppPromptTemplate(paths, templateName)`
43
-
44
- ### `src/server/cliEntrypoint.js`
45
- Exports
46
- - `runCliEntrypoint(runCli, argv = process.argv.slice(2))`
47
-
48
- ### `src/server/cliRuntime/appState.js`
49
- Exports
50
- - `directoryLooksLikeJskitAppRoot(directoryPath)`
51
- - `resolveAppRootFromCwd(cwd)`
52
- - `loadAppPackageJson(appRoot)`
53
- - `ensurePackageJsonSection(packageJson, sectionName)`
54
- - `applyPackageJsonField(packageJson, sectionName, key, value)`
55
- - `removePackageJsonField(packageJson, sectionName, key)`
56
- - `parseEnvLineValue(line, key)`
57
- - `upsertEnvValue(content, key, value)`
58
-
59
- ### `src/server/cliRuntime/capabilitySupport.js`
60
- Exports
61
- - `listDeclaredCapabilities(capabilitiesSection, fieldName)`
62
- - `buildCapabilityDetailsForPackage({ packageRegistry, packageId, dependencies = [], provides = [], requires = [] })`
63
- - `validatePlannedCapabilityClosure(plannedPackageIds, packageRegistry, actionLabel)`
64
- Local functions
65
- - `buildCapabilityGraph(packageRegistry)`
66
- - `createCapabilityPackageDetail(packageId, packageRegistry)`
67
- - `collectPlannedCapabilityIssues(plannedPackageIds, packageRegistry)`
68
- - `collectExclusiveCapabilityIssues(plannedPackageIds, packageRegistry)`
69
-
70
- ### `src/server/cliRuntime/ci/composer.js`
71
- Exports
72
- - `CiCompositionError`
73
- - `composeCiContributions(packageEntries = [])`
74
- Local functions
75
- - `canonicalValue(value)`
76
- - `valuesMatch(left, right)`
77
- - `formatConflictValue(value)`
78
- - `normalizePackageEntries(packageEntries = [])`
79
- - `appendSource(sourceMap, key, packageId)`
80
- - `conflict({ kind, id, existing, incoming, existingPackages, incomingPackage })`
81
- - `sourcesToObject(sourceMap)`
82
-
83
- ### `src/server/cliRuntime/ci/contract.js`
84
- Exports
85
- - `CI_STEP_PHASE_BEFORE_VERIFY`
86
- - `CI_STEP_PHASES`
87
- - `normalizeCiContribution(value, context = {})`
88
- Local functions
89
- - `isPlainObject(value)`
90
- - `invalidCiContract(message, { metadataPath = "", packageId = "" } = {})`
91
- - `requirePlainObject(value, label, context)`
92
- - `rejectUnknownKeys(value, allowedKeys, label, context)`
93
- - `normalizeCiScalar(value, label, context)`
94
- - `normalizeCiEnvironment(value, label, context)`
95
- - `normalizeCiPorts(value, label, context)`
96
- - `normalizeCiHealthCheck(value, label, context)`
97
- - `normalizeCiService(value, index, context)`
98
- - `normalizeCiStep(value, index, context)`
99
-
100
- ### `src/server/cliRuntime/ci/githubWorkflow.js`
101
- Exports
102
- - `GENERATED_WORKFLOW_HEADER`
103
- - `JSKIT_CI_WORKFLOW_RELATIVE_PATH`
104
- - `buildGithubWorkflowDocument(model = {})`
105
- - `parseGithubWorkflow(source = "")`
106
- - `renderGithubServiceOptions(service = {})`
107
- - `renderGithubWorkflow(model = {})`
108
- Local functions
109
- - `quoteDockerOptionValue(value)`
110
- - `renderGithubService(service = {})`
111
-
112
- ### `src/server/cliRuntime/ci/managedWorkflow.js`
113
- Exports
114
- - `composeInstalledPackageCi({ packageRegistry, installedPackageIds = null })`
115
- - `synchronizeAppCiWorkflow({ appRoot, dryRun = false })`
116
- - `synchronizeCiWorkflow({ appRoot, packageRegistry, installedPackageIds = null, touchedFiles = null, dryRun = false })`
117
- Local functions
118
- - `collectInstalledPackageEntries({ packageRegistry, installedPackageIds = null })`
119
- - `inspectCiFiles(appRoot)`
120
-
121
- ### `src/server/cliRuntime/completion.js`
122
- Exports
123
- - `discoverPlacementTargets(appRoot)`
124
- - `discoverResourceDisplayFields(appRoot, resourceFile = "")`
125
- - `discoverResourceFiles(appRoot)`
126
- - `discoverSurfaces(appRoot)`
127
- - `getCompletions({ appRoot = process.cwd(), words = [], cword = 0 } = {})`
128
- - `normalizeCompletionInvocation(words = [], cword = 0)`
129
- - `renderBashCompletionScript()`
130
- Local functions
131
- - `normalizeText(value = "")`
132
- - `toPosix(value = "")`
133
- - `uniqueSorted(values = [])`
134
- - `filterByPrefix(values = [], prefix = "")`
135
- - `resolveAllowedValues(schema = {})`
136
- - `ensureTrailingSlash(value = "")`
137
- - `pathExists(targetPath)`
138
- - `safeReaddir(directoryPath)`
139
- - `walkDirectory(rootPath, { includeDirectories = false, includeFiles = true, fileFilter = null } = {})`
140
- - `loadCommandCatalog()`
141
- - `isDirectoryLike(entry)`
142
- - `discoverJskitPackages(appRoot)`
143
- - `discoverBundleIds(appRoot)`
144
- - `toShortPackageId(packageId = "")`
145
- - `discoverGenerators(appRoot)`
146
- - `discoverRuntimePackages(appRoot)`
147
- - `extractMatches(source = "", patterns = [])`
148
- - `discoverSemanticPlacementTargets(appRoot)`
149
- - `discoverConcretePlacementTargets(appRoot)`
150
- - `discoverComponentTokens(appRoot)`
151
- - `isRouteLikeRelativePath(relativePath = "")`
152
- - `discoverPagesRelativeDirectories(appRoot)`
153
- - `discoverPagesRelativeFiles(appRoot)`
154
- - `discoverAppVueFiles(appRoot)`
155
- - `buildOptionSuggestions(optionNames = [], { current = "", seenOptionNames = new Set() } = {})`
156
- - `parseOptionToken(token = "")`
157
- - `parseContextTokens(tokens = [], optionMeta = {})`
158
- - `resolveCurrentOptionValueRequest({ currentToken = "", previousToken = "", optionMeta = {} } = {})`
159
- - `completeCommaSeparatedValues({ currentValue = "", allowedValues = [] } = {})`
160
- - `extractBracketParams(value = "")`
161
- - `completeOptionValue({ appRoot, optionName = "", valuePrefix = "", includeOptionPrefix = false, parseState, currentGenerator = "", optionMeta = {} } = {})`
162
- - `completeRelativeDirectoryRoot(appRoot, current = "")`
163
- - `completeRelativePageTargetFile(appRoot, current = "")`
164
- - `completeAppVueFile(appRoot, current = "")`
165
- - `buildTopLevelCommandMetadata(catalogModule)`
166
- - `buildCommandOptionMeta(command = "", catalogModule)`
167
- - `buildGeneratorLookup(generators = [])`
168
- - `buildGeneratorOptionMeta(generator = null, subcommandName = "")`
169
- - `resolveImplicitGeneratorSubcommand(generator = null, tokensAfterGenerator = [], currentToken = "")`
170
- - `completeGenericContext({ appRoot, currentToken = "", previousToken = "", optionMeta = {}, positionalArgs = [], tokensBeforeCurrent = [], optionNames = [], positionalCompleter = null, generatorName = "", subcommandName = "" } = {})`
171
- - `completeTopLevel({ currentToken = "", catalogModule })`
172
- - `completeGenerateCommand({ appRoot, words, cword, catalogModule })`
173
- - `completeCommand({ appRoot, words, cword, catalogModule })`
174
-
175
- ### `src/server/cliRuntime/ioAndMigrations.js`
176
- Exports
177
- - `buildFileWriteGroups(fileMutations, { packageId = "" } = {})`
178
- - `normalizeRelativePath(fromRoot, absolutePath)`
179
- - `hashBuffer(buffer)`
180
- - `normalizeMigrationExtension(value = "", fallback = ".cjs")`
181
- - `normalizeMigrationId(value, packageId)`
182
- - `resolveAppRelativePathWithinRoot(appRoot, relativePath, contextLabel = "path")`
183
- - `normalizeMigrationDirectory(value, packageId)`
184
- - `formatMigrationTimestamp(date = new Date())`
185
- - `buildManagedMigrationFileName({ packageId = "", migrationId = "", extension = ".cjs", timestamp = "" } = {})`
186
- - `buildManagedMigrationRelativePath({ toDir = "migrations", packageId = "", migrationId = "", extension = ".cjs", timestamp = "" } = {})`
187
- - `buildManagedMigrationRelativePathLabel({ toDir = "migrations", migrationId = "", extension = ".cjs" } = {})`
188
- - `findExistingManagedMigrationPathById({ appRoot, toDir = "migrations", packageId = "", migrationId = "", extension = ".cjs" } = {})`
189
- - `upsertManagedMigrationRecord(managedMigrations, record)`
190
- - `fileExists(absolutePath)`
191
- - `readJsonFile(absolutePath)`
192
- - `writeJsonFile(absolutePath, value)`
193
- - `readFileBufferIfExists(absolutePath)`
194
- - `loadAppConfigModuleConfig(appRoot, relativePath)`
195
- - `loadMutationWhenConfigContext(appRoot)`
196
- Local functions
197
- - `normalizeRelativePosixPath(pathValue)`
198
-
199
- ### `src/server/cliRuntime/localPackageSupport.js`
200
- Exports
201
- - `resolvePackageDependencySpecifier(packageEntry)`
202
- - `normalizePackageNameSegment(rawValue, { label = "package name" } = {})`
203
- - `normalizeScopeName(rawScope)`
204
- - `resolveDefaultLocalScopeFromAppName(appPackageName)`
205
- - `normalizeRelativePosixPath(pathValue)`
206
- - `toFileDependencySpecifier(relativePath)`
207
- - `resolveLocalPackageId({ rawName, appPackageName, inlineOptions })`
208
- - `createLocalPackageScaffoldFiles({ packageId, packageDescription })`
209
- Local functions
210
- - `normalizeJskitDependencySpecifier(packageId, dependencySpecifier)`
211
- - `createLocalPackageMetadata()`
212
-
213
- ### `src/server/cliRuntime/migrationSync.js`
214
- Exports
215
- - `packageHasInstallMigrations(packageEntry = {})`
216
- - `synchronizeInstalledMigrations(ctx = {}, { appRoot = "", check = false } = {})`
217
-
218
- ### `src/server/cliRuntime/mutationApplication.js`
219
- Exports
220
- - `applyFileMutations`
221
- - `prepareFileMutations`
222
- - `applyTextMutations`
223
- - `partitionPreFileConfigTextMutations`
224
- - `applySourceMutations`
225
- - `partitionPreFileConfigSourceMutations`
226
-
227
- ### `src/server/cliRuntime/mutations/fileMutations.js`
228
- Exports
229
- - `applyFileMutations(packageEntry, appRoot, preparedMutations, fileChanges, migrationChanges, touchedFiles, warnings = [], { dryRun = false } = {})`
230
- - `prepareFileMutations(packageEntry, options, appRoot, fileMutations)`
231
-
232
- ### `src/server/cliRuntime/mutations/installMigrationMutation.js`
233
- Exports
234
- - `applyInstallMigrationMutation({ packageEntry, preparedMutation, appRoot, managedMigrations, managedMigrationById, touchedFiles, warnings, dryRun = false } = {})`
235
-
236
- ### `src/server/cliRuntime/mutations/mutationPathUtils.js`
237
- Exports
238
- - `normalizeMutationRelativeFilePath(value = "")`
239
-
240
- ### `src/server/cliRuntime/mutations/sourceMutations.js`
241
- Exports
242
- - `applySourceMutations(packageEntry, appRoot, sourceMutations, options, managedSource, touchedFiles, { dryRun = false } = {})`
243
- - `partitionPreFileConfigSourceMutations(sourceMutations = [])`
244
- Local functions
245
- - `createSourceFile(relativeFile, sourceText)`
246
- - `normalizeSourceText(value = "")`
247
- - `insertText(sourceText, index, text)`
248
- - `appendBlock(sourceText, block)`
249
- - `renderImportMutation(mutation, options, packageId, mutationId)`
250
- - `sourceAlreadyHasImport(sourceFile, rendered)`
251
- - `ensureImport(sourceText, relativeFile, mutation, options, packageId, mutationId)`
252
- - `normalizeSourceArg(value = "")`
253
- - `callExpressionMatches(callExpression, callee, expectedArgs, uniqueArgIndex)`
254
- - `renderCallMutation(mutation, options, packageId, mutationId)`
255
- - `ensureCall(sourceText, relativeFile, mutation, options, packageId, mutationId)`
256
- - `sourceHasAssignmentToTarget(sourceFile, target)`
257
- - `renderAssignmentStatement(target, value)`
258
- - `ensureAssignment(sourceText, relativeFile, mutation, options, packageId, mutationId)`
259
- - `ensureExportConst(sourceText, relativeFile, mutation, options, packageId, mutationId)`
260
- - `applySourceMutationToContent(sourceText, relativeFile, mutation, options, packageId)`
261
- - `createManagedSourceRecord(relativeFile, mutation)`
262
- - `isPreFileConfigSourceMutation(value = {})`
263
-
264
- ### `src/server/cliRuntime/mutations/surfaceTargets.js`
265
- Exports
266
- - `resolveSurfaceTargetPathsForMutation({ appRoot, packageId, mutation, configContext } = {})`
267
- Local functions
268
- - `normalizeSurfacePagesRootForMutation(value = "")`
269
- - `normalizeSurfacePathForMutation(value = "", { context = "toSurfacePath" } = {})`
270
- - `resolveSurfaceDefinitionFromConfigForMutation({ configContext = {}, surfaceId = "", packageId = "" } = {})`
271
-
272
- ### `src/server/cliRuntime/mutations/templateContext.js`
273
- Exports
274
- - `applyTemplateContextReplacements(sourceContent, replacements)`
275
- - `interpolateFileMutationRecord(mutation, options, packageId)`
276
- - `renderTemplateFile(sourcePath, options, packageId, interpolationKey, templateContextReplacements = null)`
277
- - `resolveTemplateContextReplacementsForMutation({ packageEntry, mutation, options, appRoot, sourcePath, targetPaths, mutationContext = "files mutation" } = {})`
278
-
279
- ### `src/server/cliRuntime/mutations/textMutations.js`
280
- Exports
281
- - `applyTextMutations(packageEntry, appRoot, textMutations, options, managedText, touchedFiles, { dryRun = false } = {})`
282
- - `partitionPreFileConfigTextMutations(textMutations = [])`
283
- Local functions
284
- - `isPreFileConfigTextMutation(value = {})`
285
-
286
- ### `src/server/cliRuntime/mutationWhen.js`
287
- Exports
288
- - `normalizeMutationExtension(value)`
289
- - `normalizeTemplateContextRecord(value)`
290
- - `normalizeDependencyMutationRecord(value)`
291
- - `normalizeFileMutationRecord(value)`
292
- - `normalizeMutationWhen(value)`
293
- - `readObjectPath(source, rawPath)`
294
- - `normalizeWhenSourceValue(value)`
295
- - `resolveWhenConfigValue(configContext = {}, configPath = "")`
296
- - `shouldApplyMutationWhen(when, { options = {}, configContext = {}, packageId = "", mutationContext = "mutation" } = {})`
297
- Local functions
298
- - `normalizeWhenComparisonValue(value)`
299
- - `splitWhenComparisonTokens(value)`
300
- - `matchesWhenComparisonValue(optionValue, optionTokens, expectedValue)`
301
-
302
- ### `src/server/cliRuntime/packageInstallFlow.js`
303
- Exports
304
- - `applyPackageInstall({ packageEntry, packageOptions, appRoot, appPackageJson, packageRegistry, touchedFiles, directInstall = false, dryRun = false })`
305
- - `applyStatelessPackageMigrations({ packageEntry, packageOptions = {}, appRoot, touchedFiles, dryRun = false })`
306
- Local functions
307
- - `createMutationResult(packageEntry)`
308
- - `recordPackageJsonChange(result, sectionName, key, value)`
309
- - `normalizeModeToken(value = "")`
310
- - `isWorkspaceCapableTenancyMode(value = "")`
311
- - `collectInstallWarnings({ packageEntry, appRoot, appPackageJson })`
312
- - `dependencyMutationUsesWhen(entries = [])`
313
-
314
- ### `src/server/cliRuntime/packageIntrospection.js`
315
- Exports
316
- - `classifyExportedSymbols`
317
- - `deriveProviderDisplayName`
318
- - `formatPackageSubpathImport`
319
- - `inspectPackageOfferings({ packageEntry })`
320
- - `normalizePlacementContributions`
321
- - `normalizePlacementOutlets`
322
- - `shouldShowPackageExportTarget`
323
-
324
- ### `src/server/cliRuntime/packageIntrospection/exportedSymbols.js`
325
- Exports
326
- - `classifyExportedSymbols(symbols = [])`
327
- - `collectExportFileSymbolSummaries({ packageRoot, packageExports, notes })`
328
- Local functions
329
- - `parseNamedExportSpecifiers(specifierSource)`
330
- - `parseExportedSymbolsFromSource(source)`
331
-
332
- ### `src/server/cliRuntime/packageIntrospection/exportEntries.js`
333
- Exports
334
- - `describePackageExports({ packageRoot, packageJson })`
335
- - `formatPackageSubpathImport(packageId, subpath)`
336
- - `shouldShowPackageExportTarget({ subpath, target, targetType })`
337
- Local functions
338
- - `collectPackageExportEntries(exportsField)`
339
- - `deriveCanonicalExportTargetForSubpath(subpath)`
340
-
341
- ### `src/server/cliRuntime/packageIntrospection/placementNormalization.js`
342
- Exports
343
- - `normalizePlacementContributions(value)`
344
- - `normalizePlacementOutlets(value)`
345
- - `normalizePlacementTopology(value, { context = "package placement topology" } = {})`
346
-
347
- ### `src/server/cliRuntime/packageIntrospection/providerBindingIntrospection.js`
348
- Exports
349
- - `collectContainerBindingsFromProviderSource({ source, providerLabel, entrypoint, providerExportName })`
350
- - `deriveProviderDisplayName(bindingRecord)`
351
- Local functions
352
- - `escapeRegexLiteral(value)`
353
- - `parseQuotedStringLiteral(value)`
354
- - `resolveLineNumberAtIndex(source, index)`
355
- - `findMatchingBraceIndex(source, openBraceIndex)`
356
- - `extractProviderLifecycleMethodRanges(source, providerExportName)`
357
- - `collectConstTokenAssignments(source)`
358
- - `resolveTokenFromExpression(expression, constAssignments, visited = new Set())`
359
-
360
- ### `src/server/cliRuntime/packageMetadataValidation.js`
361
- Exports
362
- - `validatePackageMetadataShape(packageMetadata, metadataPath)`
363
- - `validateAppLocalPackageMetadataShape(packageMetadata, metadataPath, { expectedPackageId = "" } = {})`
364
- - `createPackageEntry({ packageId, version, packageMetadata, rootDir = "", relativeDir = "", manifestRelativePath = "", packageJson = {}, sourceType = "", source = {} })`
365
- - `isGeneratorPackageEntry(packageEntry)`
366
- Local functions
367
- - `normalizePackageKind(rawValue, metadataPath)`
368
- - `conditionUsesPackageOption(rawCondition)`
369
- - `validateFileMutationShape(packageMetadata, metadataPath, { packageKind = "" } = {})`
370
- - `validateSourceMutationShape(packageMetadata, metadataPath)`
371
- - `validateLifecycleHookSpec(spec = {}, metadataPath, label = "lifecycle hook")`
372
- - `validateLifecycleShape(packageMetadata, metadataPath)`
373
-
374
- ### `src/server/cliRuntime/packageOptions.js`
375
- Exports
376
- - `normalizeSurfaceIdForMutation(value = "")`
377
- - `parseSurfaceIdListForMutation(value = "")`
378
- - `resolvePackageOptions(packageEntry, inlineOptions, io, { appRoot = "", onPrompt = null } = {})`
379
- - `validateInlineOptionsForPackage(packageEntry, inlineOptions)`
380
- - `validateInlineOptionValuesForPackage(packageEntry, inlineOptions, { appRoot = "", optionNames = null } = {})`
381
- Local functions
382
- - `resolveSurfaceVisibilityOptionPolicy(packageEntry = {})`
383
- - `resolveSurfaceDefinitionsForOptionPolicy(configContext = {})`
384
- - `normalizeResolvedOptionValue(value = "")`
385
- - `isFlagOptionSchema(schema = {})`
386
- - `normalizeResolvedOptionSchemaValue({ packageEntry, optionName = "", schema = {}, value = "" } = {})`
387
- - `resolveSchemaValidatedOptionNames(packageEntry = {}, validationType = "", { optionNames = null } = {})`
388
- - `resolveAllowedValuesForSchema(schema = {})`
389
- - `parseCsvEnumOptionValues(value = "")`
390
- - `validateEnumOptionValues({ packageEntry, resolvedOptions = {}, optionNames = null } = {})`
391
- - `validateCsvEnumOptionValues({ packageEntry, resolvedOptions = {}, optionNames = null } = {})`
392
- - `validateEnabledSurfaceOptionValues({ packageEntry, resolvedOptions = {}, optionNames = null, configContext = {} } = {})`
393
- - `validateSurfaceVisibilityOptionPolicy({ packageEntry, resolvedOptions = {}, policy, configContext = {} } = {})`
394
- - `validateResolvedOptionPolicies({ packageEntry, resolvedOptions = {}, appRoot = "", resolveConfigContext } = {})`
395
- - `resolvePromptChoicesForOption({ schema = {}, configContext = {} } = {})`
396
- - `validateOptionValuesForPackage({ packageEntry, resolvedOptions = {}, appRoot = "", optionNames = null } = {})`
397
-
398
- ### `src/server/cliRuntime/packageRegistries.js`
399
- Exports
400
- - `isGeneratorPackageEntry`
401
- - `mergePackageRegistries(...registries)`
402
- - `loadAppLocalPackageRegistry(appRoot)`
403
- - `loadPackageRegistry()`
404
- - `resolveInstalledNodeModulePackageEntry({ appRoot, packageId })`
405
- - `hydratePackageRegistryFromInstalledNodeModules({ appRoot, packageRegistry, seedPackageIds = [], preferInstalledPackages = false })`
406
- - `loadBundleRegistry()`
407
- - `loadInstalledAppPackageRegistry(appRoot)`
408
- - `installedPackageRecordFromRegistry(packageRegistry = new Map())`
409
- Local functions
410
- - `normalizeRelativePosixPath(pathValue)`
411
- - `validateBundleMetadataShape(packageMetadata, metadataPath)`
412
- - `loadCatalogPackageRegistry()`
413
- - `loadInstalledNodeModulePackageEntry({ appRoot, packageId })`
414
-
415
- ### `src/server/cliRuntime/packageTemplateResolution.js`
416
- Exports
417
- - `cleanupPackageRootCaches()`
418
- - `resolvePackageTemplateRoot({ packageEntry, appRoot } = {})`
419
- Local functions
420
- - `hasJskitPackageManifest(packageRoot)`
421
- - `resolvePackageRootFromNodeModules({ appRoot, packageId })`
422
- - `loadLocalWorkspacePackageIdIndex()`
423
- - `resolvePackageRootFromLocalWorkspace({ packageId })`
424
-
425
- ### `src/server/cliRuntime/sensitiveOptions.js`
426
- Exports
427
- - `collectOptionReferences(value = "")`
428
- - `isSensitiveEnvKey(key = "")`
429
- - `isSensitivePackageOption(packageEntry = {}, optionName = "")`
430
- - `isSensitiveTextMutation({ packageEntry = {}, mutation = {}, resolvedKey = "" } = {})`
431
- - `resolveOptionEnvFallbacks({ packageEntry = {}, appRoot = "", optionInput = {}, readFileBufferIfExists, environment = process.env } = {})`
432
- Local functions
433
- - `isSensitiveName(value = "")`
434
- - `textValueReferencesSensitiveOption(packageEntry = {}, value = "")`
435
- - `isExactOptionReference(value = "", optionName = "")`
436
- - `readEnvValue(content = "", key = "")`
437
-
438
- ### `src/server/commandHandlers/app.js`
439
- Exports
440
- - `createAppCommands(ctx = {})`
441
- Local functions
442
- - `renderAppHelp(stream, definition = null)`
443
-
444
- ### `src/server/commandHandlers/appCommandCatalog.js`
445
- Exports
446
- - `APP_SCRIPT_WRAPPERS`
447
- - `APP_COMMAND_DEFINITIONS`
448
- - `listAppCommandDefinitions()`
449
- - `resolveAppCommandDefinition(rawName = "")`
450
- - `buildAppCommandOptionMeta(subcommandName = "")`
451
-
452
- ### `src/server/commandHandlers/appCommands/previewIdentity.js`
453
- Exports
454
- - `PREVIEW_IDENTITY_PROTOCOL`
455
- - `executeJskitPreviewIdentityRequest(value = {}, { env = process.env, fetchImpl = globalThis.fetch } = {})`
456
- - `runAppPreviewIdentityCommand(_ctx = {}, { env = process.env, fetchImpl = globalThis.fetch, stdin = process.stdin, stdout = process.stdout } = {})`
457
- Local functions
458
- - `previewIdentityResponse(requestId = "", values = {})`
459
- - `previewIdentityFailure(requestId = "", error = {})`
460
- - `commandError(message = "", code = "jskit_preview_identity_failed", extra = {})`
461
- - `readInput(stream)`
462
- - `normalizeRequest(value = {})`
463
- - `identityFromSubject(subject = {})`
464
- - `responseSetCookie(response = {})`
465
- - `cookieHeader(setCookie = [])`
466
- - `responsePayload(response = {})`
467
- - `upstreamError(payload = {}, response = {}, extra = {})`
468
- - `request(fetchImpl, href, options)`
469
- - `postJson(fetchImpl, href, body, headers = {})`
470
- - `readSession(fetchImpl, targetOrigin)`
471
- - `logout(fetchImpl, targetOrigin, session)`
472
- - `login(fetchImpl, targetOrigin, identity, secret, session)`
473
-
474
- ### `src/server/commandHandlers/appCommands/release.js`
475
- Exports
476
- - `runAppReleaseCommand(ctx = {}, { appRoot = "", options = {}, stdout, stderr })`
477
-
478
- ### `src/server/commandHandlers/appCommands/shared.js`
479
- Exports
480
- - `fileExists(filePath = "")`
481
- - `normalizeText(value = "")`
482
- - `isTruthyFlag(rawValue = "")`
483
- - `runExternalCommand(command, args = [], { cwd = "", env = {}, stdout, stderr, quiet = false, createCliError } = {})`
484
- - `runExternalCommandAsync(command, args = [], { cwd = "", env = {}, stdout, stderr, quiet = false, createCliError } = {})`
485
- - `runExternalShellCommand(commandText, { cwd = "", env = {}, stdout, stderr, quiet = false, createCliError } = {})`
486
- - `formatUtcReleaseTimestamp(date = new Date())`
487
- - `resolveLocalJskitBin(appRoot = "")`
488
- - `runLocalJskit(appRoot, args = [], { stdout, stderr, createCliError, quiet = false } = {})`
489
- - `runLocalJskitAsync(appRoot, args = [], { env = {}, stdout, stderr, createCliError, quiet = false } = {})`
490
- Local functions
491
- - `ensureCommandSucceeded(result, label, { createCliError, cwd = "", stdout, stderr, quiet = false } = {})`
492
-
493
- ### `src/server/commandHandlers/appCommands/updatePackages.js`
494
- Exports
495
- - `findRangeIntersectionVersion(ranges = [])`
496
- - `formatElapsedTime(elapsedMilliseconds = 0)`
497
- - `resolveRequiredDirectPeerUpdates({ createCliError, packageJson = {}, packageManifests = new Map() } = {})`
498
- - `runAppUpdatePackagesCommand(ctx = {}, { appRoot = "", options = {}, stdout, stderr })`
499
- - `runWithProgress(task, { activity, progressIntervalMs = PROGRESS_INTERVAL_MS, stdout, step } = {})`
500
- Local functions
501
- - `collectJskitPackageNames(packageMap = {})`
502
- - `collectManifestJskitPackageNames(packageJson = {})`
503
- - `resolveExactVersion(packageName = "", rawVersion = "", createCliError)`
504
- - `resolveRegistryArgs(registryUrl = "")`
505
- - `resolveInstallSpecs(packageNames = [], latestVersions = new Map())`
506
- - `parseRegistryPackageManifest(rawValue, packageName, createCliError)`
507
- - `resolveRegistryPackageManifests(packageNames = [], latestVersions = new Map(), { appRoot, createCliError, registryArgs, stderr, stdout })`
508
- - `resolveDeclaredDependencySection(packageJson = {}, packageName = "")`
509
- - `hasNpmWorkspaces(packageJson = {})`
510
- - `readJson(filePath)`
511
- - `resolveWorkspaceDirectories({ appRoot, createCliError, packageJson, stderr, stdout })`
512
- - `collectJskitMutationPackageNames(packageJson = {})`
513
- - `loadWorkspacePackages(workspaceDirectories = [])`
514
- - `resolveLatestVersions(packageNames = [], latestVersions = new Map(), { appRoot, createCliError, registryArgs, stderr, stdout })`
515
- - `updateWorkspaceManifest(packageJson = {}, latestVersions = new Map(), createCliError)`
516
- - `synchronizeWorkspacePackageSpecs({ appRoot, createCliError, dryRun, latestVersions, packageJson, registryArgs, stderr, stdout })`
517
- - `updateRootPackages({ appRoot, createCliError, dryRun, latestVersions, packageJson, registryArgs, stderr, stdout })`
518
- - `assertRootJskitVersionsAreExact({ appRoot, createCliError, latestVersions })`
519
-
520
- ### `src/server/commandHandlers/appCommands/verify.js`
521
- Exports
522
- - `runAppVerifyCommand(ctx = {}, { appRoot = "", options = {}, stdout, stderr })`
523
-
524
- ### `src/server/commandHandlers/blueprint.js`
525
- Exports
526
- - `createBlueprintCommands(ctx = {})`
527
- Local functions
528
- - `writeJson(stdout, payload)`
529
- - `writeBlueprintText(stdout, payload)`
530
- - `readStream(stream)`
531
- - `resolveTextInput({ cwd, fileOption, inlineOptions = {}, io = {}, stdinOption = "-", textOption })`
532
-
533
- ### `src/server/commandHandlers/completion.js`
534
- Exports
535
- - `createCompletionCommands(ctx = {})`
536
- Local functions
537
- - `resolveInstallBlock(relativeCompletionPath = "")`
538
- - `readTextFileIfExists(filePath = "")`
539
- - `installBashCompletion()`
540
-
541
- ### `src/server/commandHandlers/health.js`
542
- Exports
543
- - `createHealthCommands(ctx = {})`
544
-
545
- ### `src/server/commandHandlers/list.js`
546
- Exports
547
- - `createListCommands(ctx = {})`
548
- Local functions
549
- - `collectTokenMatches(source = "", pattern = COMPONENT_TOKEN_PATTERN)`
550
- - `appendTokenSource(map, token = "", source = "")`
551
- - `toShortPackageId(packageId = "")`
552
- - `resolveGeneratorPrimarySubcommand(packageEntry = {})`
553
- - `resolveGeneratorDescription(packageEntry = {})`
554
- - `resolveGeneratorQuickStartRows(packageEntry = {}, { limit = 3 } = {})`
555
- - `isLinkItemToken(token = "")`
556
- - `collectPlacementRendererKinds(placementTarget = {})`
557
- - `collectPlacementConcreteOutlets(placementTarget = {})`
558
- - `classifyPlacementTarget(placementTarget = {})`
559
- - `createConcreteTargetSourcePathMap(concreteTargets = [])`
560
- - `resolveChildPagePatternFromHostSourcePath(sourcePath = "")`
561
- - `resolveOwnerScopedChildPagePattern(placementTarget = {}, concreteSourcePathByTarget = new Map())`
562
- - `createPlacementTargetSummary(placementTarget = {}, color, { concreteSourcePathByTarget = new Map() } = {})`
563
- - `appendPlacementLayoutDetails(lines, placementTarget = {}, color)`
564
- - `collectMappedConcreteOutletIds(semanticPlacements = [])`
565
- - `resolveUnmappedConcreteTargets({ semanticPlacements = [], concreteTargets = [] } = {})`
566
- - `formatPlacementGuidanceLine(line = "", color)`
567
- - `appendPlacementGroup(lines, { color, title = "", description = "", guidance = [], targets = [], concreteSourcePathByTarget = new Map(), showLayoutDetails = false } = {})`
568
- - `appendUnmappedConcreteTargetWarnings(lines, { color, concreteTargets = [] } = {})`
569
- - `appendSemanticPlacementGroups(lines, { color, semanticPlacements = [], concreteTargets = [], showLayoutDetails = false } = {})`
570
- - `readFileIfExists(filePath = "")`
571
- - `collectProviderSourceFiles(rootPath = "")`
572
-
573
- ### `src/server/commandHandlers/mobile.js`
574
- Exports
575
- - `createMobileCommands(ctx = {})`
576
- Local functions
577
- - `collectManagedMobileFileDriftIssues({ ctx, appRoot, issues = [] } = {})`
578
- - `renderAndroidMobileCommandList(lines, color)`
579
- - `renderMobileHelp(stream, definition = null, platform = "")`
580
- - `isValidHttpOrHttpsUrl(value = "")`
581
- - `normalizeInlineOptions(options = {})`
582
- - `parsePortNumber(rawValue, { createCliError, optionLabel = "--port" } = {})`
583
- - `parseAdbDeviceList(output = "")`
584
- - `resolveAdbReversePort({ mobileConfig = null, explicitPort = "", createCliError } = {})`
585
- - `runCapturedBinary(binaryName, args = [], { cwd = process.cwd(), env = {}, createCliError, notFoundMessage = "" } = {})`
586
- - `listVisibleAndroidDevices({ ctx, appRoot } = {})`
587
- - `resolveAndroidDeviceTarget({ ctx, appRoot, explicitTarget = "", commandLabel = "this mobile command" } = {})`
588
- - `resolveInstalledMobileConfigForCommand({ appRoot, createCliError } = {})`
589
- - `runLocalBinary(binaryName, args = [], { appRoot, cwd = appRoot, env = {}, stderr, stdout, pathModule, createCliError, dryRun = false } = {})`
590
- - `assertMobileRuntimePackageInstalled({ ctx, appRoot } = {})`
591
- - `refreshManagedMobileFiles({ ctx, appRoot, options = {}, stdout } = {})`
592
- - `runMobileSyncAndroidCommand({ ctx, appRoot, options = {}, stdout, stderr })`
593
- - `runMobileRunAndroidCommand({ ctx, appRoot, options = {}, stdout, stderr })`
594
- - `runCapRunAndroidCommand({ ctx, appRoot, pathModule, target = "", stdout, stderr, dryRun = false } = {})`
595
- - `runMobileBuildAndroidCommand({ ctx, appRoot, options = {}, stdout, stderr })`
596
- - `runMobileDoctorCommand({ ctx, appRoot, stdout })`
597
- - `runMobileDevicesAndroidCommand({ ctx, appRoot, stdout })`
598
- - `runMobileTunnelAndroidCommand({ ctx, appRoot, options = {}, stdout })`
599
- - `runMobileRestartAndroidCommand({ ctx, appRoot, options = {}, stdout })`
600
- - `runMobileDevAndroidCommand({ ctx, appRoot, options = {}, stdout, stderr })`
601
-
602
- ### `src/server/commandHandlers/mobileCommandCatalog.js`
603
- Exports
604
- - `MOBILE_COMMAND_DEFINITIONS`
605
- - `listMobileCommandDefinitions()`
606
- - `resolveMobileCommandDefinition(rawName = "")`
607
- - `buildMobileCommandOptionMeta(subcommandName = "")`
608
-
609
- ### `src/server/commandHandlers/mobileShellSupport.js`
610
- Exports
611
- - `CAPACITOR_CONFIG_FILE`
612
- - `ANDROID_DIRECTORY_NAME`
613
- - `ANDROID_MANIFEST_RELATIVE_PATH`
614
- - `buildManagedMobileConfigStub({ packageJson = {} } = {})`
615
- - `isEmptyDisabledMobileConfigPlaceholder(mobileConfig = {})`
616
- - `resolveInstalledMobileConfig(appRoot = "")`
617
- - `resolveAndroidSdkDetails({ appRoot = "" } = {})`
618
- - `collectAndroidSdkComponentIssues({ appRoot = "", sdkRoot = "" } = {})`
619
- - `assertAndroidSdkConfigured({ ctx, appRoot } = {})`
620
- - `collectCapacitorShellInstallIssues({ ctx, appRoot } = {})`
621
- - `ensureMobileConfigStub({ ctx, appRoot, packageJson = {}, dryRun = false, stdout } = {})`
622
- - `buildManagedDeepLinkIntentFilterBlock(mobileConfig = {})`
623
- - `injectManagedDeepLinkBlock(manifestSource = "", managedBlock = "")`
624
- - `assertCapacitorShellInstalled({ ctx, appRoot })`
625
- - `ensureAndroidManifestDeepLinks({ ctx, appRoot, dryRun = false, stdout } = {})`
626
- - `collectAndroidNativeShellIdentityIssues({ ctx, appRoot } = {})`
627
- - `ensureAndroidNativeShellIdentity({ ctx, appRoot, dryRun = false, stdout } = {})`
628
- - `renderManagedMobileFile({ appRoot, relativeTargetPath, packageId = CAPACITOR_RUNTIME_PACKAGE_ID } = {})`
629
- Local functions
630
- - `normalizeRelativePosixPath(pathValue = "")`
631
- - `escapeRegExp(value = "")`
632
- - `pathExists(targetPath = "")`
633
- - `humanizeAppName(value = "")`
634
- - `slugifyForIdentifier(value = "")`
635
- - `parseAndroidSdkDirFromLocalProperties(source = "")`
636
- - `buildAndroidNativeConfig(mobileConfig = {})`
637
- - `replaceRequiredPattern(source = "", pattern, replacement, label = "pattern")`
638
- - `escapeXmlText(value = "")`
639
- - `replaceXmlStringValue(source = "", stringName = "", value = "")`
640
- - `renderAndroidVariablesGradleSource(source = "", nativeConfig = {})`
641
- - `renderAndroidAppBuildGradleSource(source = "", nativeConfig = {})`
642
- - `renderAndroidStringsSource(source = "", nativeConfig = {})`
643
- - `renderAndroidMainActivitySource(source = "", packageName = "", extension = ".java")`
644
- - `listFilesRecursively(rootDirectoryPath = "")`
645
- - `resolveAndroidMainActivityEntry(appRoot = "")`
646
- - `shouldAllowAndroidCleartextTraffic(mobileConfig = {})`
647
- - `renderAndroidManifestApplicationTrafficPolicy(manifestSource = "", mobileConfig = {})`
648
- - `renderManagedAndroidManifest(manifestSource = "", mobileConfig = {})`
649
-
650
- ### `src/server/commandHandlers/package.js`
651
- Exports
652
- - `createPackageCommands(ctx = {})`
653
-
654
- ### `src/server/commandHandlers/packageCommands/add.js`
655
- Exports
656
- - `runPackageAddCommand(ctx = {}, { positional, options, cwd, io })`
657
- Local functions
658
- - `resolveAvailablePackageSource({ packageEntry, appRoot })`
659
- - `withResolvedPackageSource({ packageEntry, packageRoot })`
660
- - `declareDirectPackageDependency({ packageEntry, packageJson, packageKind })`
661
- - `serializeDependencyState(packageJson = {})`
662
- - `collectPlannedRuntimePackageIds({ packageJson, packageRegistry, targetPackageIds, resolvePackageKind })`
663
- - `collectPlacementComponentTokensFromMutationResults(mutationResults = [])`
664
-
665
- ### `src/server/commandHandlers/packageCommands/create.js`
666
- Exports
667
- - `runPackageCreateCommand(ctx = {}, { positional, options, cwd, io })`
668
-
669
- ### `src/server/commandHandlers/packageCommands/createMigration.js`
670
- Exports
671
- - `createMigrationTemplate({ packageId, migrationId } = {})`
672
- - `runMigrationCreateCommand(ctx = {}, { options, cwd, io })`
673
-
674
- ### `src/server/commandHandlers/packageCommands/discoverabilityHelp.js`
675
- Exports
676
- - `isHelpToken(value = "")`
677
- - `renderGenerateCatalogHelp({ io, packageRegistry, resolvePackageKind, json = false } = {})`
678
- - `renderAddCatalogHelp({ io, packageRegistry, bundleRegistry, resolvePackageKind, json = false } = {})`
679
- - `renderGeneratePackageHelp({ io, packageEntry, packageIdInput = "", json = false } = {})`
680
- - `renderGenerateSubcommandHelp({ io, packageEntry, packageIdInput = "", subcommandName = "", json = false } = {})`
681
- - `renderAddPackageHelp({ io, packageEntry, packageIdInput = "", json = false } = {})`
682
- - `renderAddBundleHelp({ io, bundleId = "", bundle = {}, json = false } = {})`
683
- Local functions
684
- - `toShortPackageId(packageId = "")`
685
- - `resolvePackageSummary(entry = {})`
686
- - `resolveHelpText(rawValue = "", helpTextKey = "")`
687
- - `buildPackageOptionRows(packageEntry = {})`
688
- - `normalizeSubcommandPositionalArgRows(rawRows = [])`
689
- - `normalizeSubcommandOptionNames(rawOptionNames = [])`
690
- - `normalizeHelpExampleRows(rawRows = [])`
691
- - `normalizeHelpNoteRows(rawRows = [])`
692
- - `normalizeHelpParagraphRows(rawValue = "")`
693
- - `appendHelpLongDescription(lines = [], rawLongDescription = "", { color = null } = {})`
694
- - `appendHelpExamples(lines = [], exampleRows = [], { color = null } = {})`
695
- - `appendHelpExamplesWithHeading(lines = [], exampleRows = [], heading = "", { color = null } = {})`
696
- - `appendHelpNotes(lines = [], rawNotes = [], { color = null } = {})`
697
- - `appendSeparatedBlocks(lines = [], blocks = [])`
698
- - `resolveGeneratorSubcommandMetadata(packageEntry = {})`
699
- - `formatOptionSummary(optionRow = {}, { color = null } = {})`
700
- - `formatPositionalArgUsageToken(arg = {})`
701
- - `formatPositionalArgSummary(arg = {}, { color = null } = {})`
702
- - `findGeneratorSubcommandRow(packageEntry = {}, subcommandName = "")`
703
- - `buildSubcommandOptionRows(optionRows = [], subcommandRow = {})`
704
- - `resolvePrimaryGeneratorQuickStartRows(packageEntry = {}, { limit = 3 } = {})`
705
-
706
- ### `src/server/commandHandlers/packageCommands/generate.js`
707
- Exports
708
- - `runPackageGenerateCommand(ctx = {}, { positional, options, cwd, io }, { runCommandAdd })`
709
- Local functions
710
- - `resolveGeneratorSubcommandDefinitionMetadata(packageEntry = {}, subcommandName = "")`
711
- - `resolveSubcommandRequiresShellWeb(packageEntry = {}, subcommandName = "")`
712
- - `mapPackageMetadataBackedSubcommandArgsToInlineOptions(packageEntry = {}, subcommandName = "", subcommandArgs = [], inlineOptions = {}, createCliError)`
713
- - `resolveSubcommandRequiresInput(packageEntry = {}, subcommandName = "")`
714
- - `collectUnexpectedGeneratorSubcommandOptionNames(packageEntry = {}, subcommandName = "", inlineOptions = {})`
715
- - `resolveCreateTargetPolicy(packageEntry = {}, subcommandName = "")`
716
- - `normalizeRelativePathWithinApp(appRoot = "", targetPath = "", createCliError)`
717
- - `enforcePackageMetadataBackedCreateTargetPolicy({ packageEntry, subcommandName, inlineOptions = {}, appRoot = "", packageIdInput = "", createCliError, readdir } = {})`
718
-
719
- ### `src/server/commandHandlers/packageCommands/packageConfiguration.js`
720
- Exports
721
- - `orderRuntimePackageClosure(packageRegistry, packageIds, resolvePackageKind, { includePackage = () => true } = {})`
722
- - `orderRuntimePackagesForConfiguration(packageRegistry, requestedPackageIds, resolvePackageKind)`
723
- - `resolvePackageConfiguration({ packageRegistry, configurationRegistry, requestedPackageIds, packagesToApply, invocationMode, targetType, resolvedTargetPackageId, inlineOptions, resolvePackageKind, resolveBundleInlineOptionsForPackage, resolvePackageOptions, appRoot, readFileBufferIfExists, io })`
724
- Local functions
725
- - `resolvePackageOptionInput({ packageEntry, inlineOptions, appRoot, readFileBufferIfExists })`
726
-
727
- ### `src/server/commandHandlers/packageCommands/packageInstallLifecycle.js`
728
- Exports
729
- - `createInstallHookHelpers({ ctx, appRoot, io, appPackageJson })`
730
- - `invokeInstallHook({ packageEntry, appRoot, hookSpec, hookLabel, hookContext, createCliError })`
731
- - `packageManagesNpmInstall(packageEntry)`
732
- - `resolveInstallHookSpec(packageEntry, stage)`
733
- Local functions
734
- - `renderWrappedShellCommand(binaryName, args = [], { maxWidth = 100, continuationIndent = " " } = {})`
735
- - `runLocalProjectBinary(binaryName, args = [], { appRoot, io, pathModule = path, createCliError, explanation = "", dryRun = false } = {})`
736
- - `installAppDependencies({ appRoot, io, pathModule, createCliError, dryRun })`
737
- - `validateHookResult(result, { packageId = "", hookLabel = "" } = {})`
738
- - `loadInstallHook({ packageEntry, appRoot, hookSpec, hookLabel })`
739
-
740
- ### `src/server/commandHandlers/packageCommands/remove.js`
741
- Exports
742
- - `runPackageRemoveCommand(ctx = {}, { positional, options, cwd, io })`
743
-
744
- ### `src/server/commandHandlers/packageCommands/tabLinkItemProvisioning.js`
745
- Exports
746
- - `LOCAL_LINK_ITEM_COMPONENT_TOKENS`
747
- - `TAB_LINK_COMPONENT_TOKEN`
748
- - `collectProvisionableLocalPlacementComponentTokensFromApp({ appRoot = "" } = {})`
749
- - `resolveProvisionableLocalPlacementComponentTokens({ appRoot = "", componentTokens = [] } = {})`
750
- - `ensureLocalMainPlacementComponentProvisioning({ appRoot = "", createCliError, dryRun = false, touchedFiles = new Set(), componentTokens = [] } = {})`
751
- - `ensureLocalMainTabLinkItemProvisioning({ appRoot = "", createCliError, dryRun = false, touchedFiles = new Set() } = {})`
752
- Local functions
753
- - `toPosixPath(value = "")`
754
- - `ensureTrailingNewline(value = "")`
755
- - `insertImportIfMissing(source = "", importLine = "")`
756
- - `insertBeforeClassDeclaration(source = "", line = "", { className = "", contextFile = "" } = {})`
757
- - `readUtf8FileIfExists(absolutePath = "")`
758
- - `ensureProvisionedComponentFile(definition, { appRoot = "", dryRun = false, touchedFiles = new Set() } = {})`
759
- - `hasProvisionedTokenRegistration(providerSource = "", componentToken = "")`
760
- - `loadMainClientProviderSource({ appRoot = "", createCliError, componentToken = "" } = {})`
761
- - `ensureProvisionedProviderRegistration(definition, { appRoot = "", createCliError, dryRun = false, touchedFiles = new Set() } = {})`
762
-
763
- ### `src/server/commandHandlers/shared.js`
764
- Exports
765
- - `createCommandHandlerShared(ctx = {})`
766
-
767
- ### `src/server/commandHandlers/show.js`
768
- Exports
769
- - `createShowCommand(ctx = {})`
770
-
771
- ### `src/server/commandHandlers/show/payloads.js`
772
- Exports
773
- - `buildBundleShowPayload(bundle = {})`
774
- - `buildPackageShowPayload({ packageRegistry, packageEntry, options, inspectPackageOfferings, buildFileWriteGroups, listDeclaredCapabilities, buildCapabilityDetailsForPackage } = {})`
775
-
776
- ### `src/server/commandHandlers/show/renderBundleText.js`
777
- Exports
778
- - `renderBundlePayloadText({ payload, stdout, color, writeField } = {})`
779
-
780
- ### `src/server/commandHandlers/show/renderHelpers.js`
781
- Exports
782
- - `createShowRenderHelpers({ stdout, color, options, deriveProviderDisplayName } = {})`
783
-
784
- ### `src/server/commandHandlers/show/renderPackageCapabilities.js`
785
- Exports
786
- - `writeCapabilitiesSections({ payload, provides, requires, capabilityDetails, stdout, color, wrapWidth, writeWrappedItems } = {})`
787
- Local functions
788
- - `writeCapabilityRecord({ heading, records, includeDependsOnProviders = false, stdout, color, wrapWidth, writeWrappedItems } = {})`
789
- - `formatPackageSummary(detail)`
790
-
791
- ### `src/server/commandHandlers/show/renderPackageExports.js`
792
- Exports
793
- - `writePackageExportsSection({ payload, options, stdout, color, wrapWidth, normalizeRelativePosixPath, shouldShowPackageExportTarget, classifyExportedSymbols, writeWrappedItems } = {})`
794
- Local functions
795
- - `writeClassifiedSymbols({ label, entries, stdout, color, wrapWidth, writeWrappedItems } = {})`
796
-
797
- ### `src/server/commandHandlers/show/renderPackageText.js`
798
- Exports
799
- - `renderPackagePayloadText({ payload, provides, requires, capabilityDetails, options, stdout, color, resolveWrapWidth, writeWrappedItems, normalizeRelativePosixPath, formatPackageSubpathImport, normalizePlacementOutlets, normalizePlacementContributions, shouldShowPackageExportTarget, classifyExportedSymbols, deriveProviderDisplayName } = {})`
800
- Local functions
801
- - `resolveGeneratorSubcommandRows(payload = {})`
802
- - `resolveOwnershipGuidance(payload = {})`
803
- - `renderDependencyMutationSpec(versionSpec)`
804
-
805
- ### `src/server/commandHandlers/synchronization.js`
806
- Exports
807
- - `createSynchronizationCommands(ctx = {})`
808
- Local functions
809
- - `parseIntentInvocation({ positional = [], options = {}, createCliError, commandName, intent })`
810
-
811
- ### `src/server/core/argParser.js`
812
- Exports
813
- - `parseArgs(argv, { createCliError } = {})`
814
-
815
- ### `src/server/core/buildCommandDeps.js`
816
- Exports
817
- - `createCommandHandlerDeps(deps = {})`
818
-
819
- ### `src/server/core/commandCatalog.js`
820
- Exports
821
- - `COMMAND_IDS`
822
- - `OPTION_FLAG_LABELS`
823
- - `resolveCommandDescriptor(rawCommand)`
824
- - `isKnownCommandName(rawCommand)`
825
- - `listOverviewCommandDescriptors()`
826
- - `shouldShowCommandHelpOnBareInvocation(command = "", positional = [])`
827
- - `validateCommandOptions({ command = "", positional = [], options = {} } = {}, { createCliError, renderUsage = null } = {})`
828
- Local functions
829
- - `isHelpToken(value = "")`
830
- - `canDelegateAddInlineOptions(positional = [])`
831
- - `canDelegateGenerateInlineOptions(positional = [])`
832
- - `sortOptionLabels(labels = [])`
833
-
834
- ### `src/server/core/createCliRunner.js`
835
- Exports
836
- - `runCli`
837
-
838
- ### `src/server/core/createCommandHandlers.js`
839
- Exports
840
- - `createCommandHandlers(deps = {})`
841
-
842
- ### `src/server/core/dispatchCli.js`
843
- Exports
844
- - `createRunCli({ parseArgs, printUsage, shouldShowCommandHelpOnBareInvocation, validateCommandOptions, resolveCommandDescriptor, commandHandlers, cleanupPackageRootCaches, createCliError } = {})`
845
-
846
- ### `src/server/core/usageHelp.js`
847
- Exports
848
- - `printUsage(stream = process.stderr, { command = "" } = {})`
849
- - `shouldShowCommandHelpOnBareInvocation`
850
- Local functions
851
- - `appendSeparatedBlocks(lines = [], blocks = [])`
852
- - `writeHelpLines(stream, lines = [])`
853
- - `printTopLevelHelp(stream = process.stderr)`
854
- - `printCommandHelp(stream = process.stderr, command = "")`
855
-
856
- ### `src/server/index.js`
857
- Exports
858
- - `runCli`
859
- - `synchronizeAppCiWorkflow`
860
- - `composeCiContributions`
861
- - `JSKIT_CI_WORKFLOW_RELATIVE_PATH`
862
- - `renderGithubWorkflow`
863
-
864
- ### `src/server/shared/cliError.js`
865
- Exports
866
- - `createCliError(message, { showUsage = false, exitCode = 1, renderUsage = null } = {})`
867
-
868
- ### `src/server/shared/collectionUtils.js`
869
- Exports
870
- - `ensureArray(value)`
871
- - `ensureObject(value)`
872
- - `sortStrings(values)`
873
-
874
- ### `src/server/shared/optionInterpolation.js`
875
- Exports
876
- - `appendTextSnippet(content, snippet, position = "bottom")`
877
- - `escapeRegExp(value)`
878
- - `interpolateOptionValue(rawValue, options, ownerId, key)`
879
- - `isSecretOptionInput(optionSchema)`
880
- - `normalizeSkipChecks(value)`
881
- - `promptForRequiredOption({ ownerType, ownerId, optionName, optionSchema, promptChoices = [], stdin = process.stdin, stdout = process.stdout })`
882
- Local functions
883
- - `normalizeSnippet(value)`
884
- - `splitTextIntoWords(value)`
885
- - `wordsToPascal(words)`
886
- - `wordsToCamel(words)`
887
- - `wordsToSnake(words)`
888
- - `wordsToKebab(words)`
889
- - `resolveLastWordMutationInput(value)`
890
- - `toSingularForm(value)`
891
- - `toPluralForm(value)`
892
- - `normalizePathValue(value)`
893
- - `normalizePromptChoices(rawChoices = [])`
894
- - `findPromptChoice(promptChoices = [], answer = "")`
895
- - `promptForChoice({ promptText = "", promptChoices = [], stdin, stdout, required = false, defaultValue = "" })`
896
- - `parseTransformSpec(transform)`
897
- - `applyOptionTransform(value, transform, ownerId, key, optionName)`
898
- - `applyOptionTransformPipeline(rawValue, rawPipeline, ownerId, key, optionName)`
899
- - `createMutedReadlineOutput(stdout)`
900
-
901
- ### `src/server/shared/outputFormatting.js`
902
- Exports
903
- - `createColorFormatter(stream)`
904
- - `renderInlineCodeSpans(text = "", color = null)`
905
- - `resolveWrapWidth(stream, fallbackWidth = 80)`
906
- - `writeWrappedLines({ stdout, lines, wrapWidth } = {})`
907
- - `writeWrappedItems({ stdout, heading, items, lineIndent = " ", wrapWidth = 80 })`
908
- Local functions
909
- - `measureVisibleLength(text = "")`
910
- - `resolveLeadingWhitespace(text = "")`
911
- - `buildContinuationIndent({ prefix = "", fallbackPrefix = "" } = {})`
912
- - `resolveWrapPrefixes(line = "")`
913
- - `wrapOutputLine(line = "", { wrapWidth = 80 } = {})`
914
-
915
- ### `src/server/shared/packageIdHelpers.js`
916
- Exports
917
- - `toScopedPackageId(input)`
918
- - `resolvePackageIdInput(input, packageRegistry)`
919
- - `resolveInstalledPackageIdInput(input, installedPackages)`
920
-
921
- ### `src/server/shared/pathResolution.js`
922
- Exports
923
- - `CLI_PACKAGE_ROOT`
924
- - `BUNDLES_ROOT`
925
- - `CATALOG_PACKAGES_PATH`
926
- Local functions
927
- - `resolveCatalogPackagesPath()`
928
-
929
- ### bin
930
-
931
- ### `bin/jskit.js`
932
- Exports
933
- - None