@jskit-ai/agent-docs 0.1.126 → 0.1.128

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 (27) hide show
  1. package/guide/agent/app-extras/realtime.md +13 -13
  2. package/guide/agent/app-setup/a-more-interesting-shell.md +5 -3
  3. package/guide/agent/app-setup/upgrade-beta-1-to-final.md +108 -5
  4. package/guide/agent/app-setup/users.md +1 -1
  5. package/guide/agent/app-setup/working-with-the-jskit-cli.md +6 -1
  6. package/guide/agent/generators/advanced-cruds.md +19 -14
  7. package/guide/agent/generators/crud-generators.md +1 -1
  8. package/guide/agent/generators/row-policies.md +2 -10
  9. package/package.json +1 -1
  10. package/patterns/INDEX.md +1 -1
  11. package/patterns/client-requests.md +6 -4
  12. package/patterns/generated-ui-contract-tracking.md +2 -2
  13. package/patterns/live-actions.md +1 -1
  14. package/reference/autogen/KERNEL_MAP.md +3 -96
  15. package/reference/autogen/README.md +1 -0
  16. package/reference/autogen/packages/assistant-core.md +0 -11
  17. package/reference/autogen/packages/assistant-runtime.md +7 -0
  18. package/reference/autogen/packages/crud-core.md +0 -72
  19. package/reference/autogen/packages/http-web.md +624 -0
  20. package/reference/autogen/packages/kernel.md +7 -98
  21. package/reference/autogen/packages/resource-crud-core.md +94 -0
  22. package/reference/autogen/packages/users-web.md +0 -593
  23. package/reference/autogen/packages/workspaces-web.md +30 -42
  24. package/reference/autogen/tooling/create-app.md +0 -10
  25. package/reference/autogen/tooling/jskit-cli.md +0 -12
  26. package/skills/jskit/references/crud-operations.md +3 -2
  27. package/skills/jskit/references/ui-operations.md +3 -0
package/reference/autogen/packages/kernel.md CHANGED
@@ -127,7 +127,7 @@ Exports
127
127
  Exports
128
128
  - `Application`
129
129
  - `createApplication(options = {})`
130
- - `createProviderClass({ id, dependsOn = [], register = null, boot = null, shutdown = null } = {})`
130
+ - `createProviderClass({ id, startsAfter = [], register = null, boot = null, shutdown = null } = {})`
131
131
  Local functions
132
132
  - `normalizeStringArray(value)`
133
133
  - `nowMilliseconds()`
@@ -171,7 +171,7 @@ Exports
171
171
  - `KernelError`
172
172
  - `ProviderNormalizationError`
173
173
  - `DuplicateProviderError`
174
- - `ProviderDependencyError`
174
+ - `ProviderStartOrderError`
175
175
  - `ProviderLifecycleError`
176
176
 
177
177
  ### `shared/runtime/kernelErrors.js`
@@ -179,7 +179,7 @@ Exports
179
179
  - `KernelError`
180
180
  - `ProviderNormalizationError`
181
181
  - `DuplicateProviderError`
182
- - `ProviderDependencyError`
182
+ - `ProviderStartOrderError`
183
183
  - `ProviderLifecycleError`
184
184
 
185
185
  ### `shared/runtime/serviceProvider.js`
@@ -190,99 +190,6 @@ Exports
190
190
  Exports
191
191
  - `isContainerToken(value)`
192
192
 
193
- ### `shared/support/crudFieldContract.js`
194
- Exports
195
- - `CRUD_FIELD_STORAGE_COLUMN`
196
- - `CRUD_FIELD_STORAGE_VIRTUAL`
197
- - `CRUD_FIELD_WRITE_SERIALIZER_DATETIME_UTC`
198
- - `CRUD_LOOKUP_FORM_CONTROL_AUTOCOMPLETE`
199
- - `CRUD_LOOKUP_FORM_CONTROL_SELECT`
200
- - `checkCrudLookupFormControl(value, { context = "crud field ui.formControl", defaultValue = CRUD_LOOKUP_FORM_CONTROL_AUTOCOMPLETE } = {})`
201
- - `resolveCrudFieldSchemaProperties(value, { context = "crud resource field definitions" } = {})`
202
- - `normalizeCrudFieldStorageConfig(fieldDefinition = {}, { context = "crud field storage", fieldKey = "" } = {})`
203
- - `buildCrudOperationSchemaFields(fields = {}, operationName = "")`
204
- - `buildCrudFieldContractMap(resource = {}, { context = "crud resource field contract" } = {})`
205
- - `resolveCrudFieldContractEntry(resource = {}, fieldKey = "", options = {})`
206
- Local functions
207
- - `cloneStructuredFieldMetadata(value = {})`
208
- - `mergeFieldContractEntry(target, source, { context = "crud field contract", fieldKey = "" } = {})`
209
-
210
- ### `shared/support/crudListFilters.js`
211
- Exports
212
- - `CRUD_LIST_FILTER_TYPE_FLAG`
213
- - `CRUD_LIST_FILTER_TYPE_ENUM`
214
- - `CRUD_LIST_FILTER_TYPE_ENUM_MANY`
215
- - `CRUD_LIST_FILTER_TYPE_RECORD_ID`
216
- - `CRUD_LIST_FILTER_TYPE_RECORD_ID_MANY`
217
- - `CRUD_LIST_FILTER_TYPE_DATE`
218
- - `CRUD_LIST_FILTER_TYPE_DATE_RANGE`
219
- - `CRUD_LIST_FILTER_TYPE_NUMBER_RANGE`
220
- - `CRUD_LIST_FILTER_TYPE_PRESENCE`
221
- - `CRUD_LIST_FILTER_TYPES`
222
- - `CRUD_LIST_FILTER_PRESENCE_PRESENT`
223
- - `CRUD_LIST_FILTER_PRESENCE_MISSING`
224
- - `CRUD_LIST_FILTER_PRESENCE_OPTIONS`
225
- - `CRUD_LIST_FILTER_INVALID_VALUES_REJECT`
226
- - `CRUD_LIST_FILTER_INVALID_VALUES_DISCARD`
227
- - `INVALID_CRUD_LIST_FILTER_QUERY_VALUE`
228
- - `normalizeCrudListFilterInvalidValues(value = "")`
229
- - `parseCrudListRangeQueryExpression(value = null)`
230
- - `formatCrudListRangeQueryExpression(startValue = "", endValue = "", { collapseExact = false } = {})`
231
- - `defineCrudListFilters(definitions = {})`
232
- - `createCrudListFilterEmptyValue(filter = {})`
233
- - `createCrudListFilterInitialValue(filter = {})`
234
- - `isCrudListFilterMultiValue(filter = {})`
235
- - `isCrudListFilterStructuredValue(filter = {})`
236
- - `normalizeCrudListFilterUiValue(filter = {}, rawValue)`
237
- - `areCrudListFilterUiValuesEqual(filter = {}, currentValue, expectedValue)`
238
- - `hasCrudListFilterUiValue(filter = {}, rawValue)`
239
- - `listCrudListFilterChipValues(filter = {}, rawValue)`
240
- - `formatCrudListFilterDefaultChipLabel(filter = {}, rawValue, { resolveAtomicValue = null } = {})`
241
- - `formatCrudListFilterQueryValue(filter = {}, value)`
242
- - `parseCrudListFilterQueryValue(filter = {}, value, { invalidValues = CRUD_LIST_FILTER_INVALID_VALUES_REJECT } = {})`
243
- - `resolveCrudListFilterQueryKeys(definition = {})`
244
- - `resolveCrudListFilterOptionLabel(definition = {}, value = "", { fallback = "" } = {})`
245
- Local functions
246
- - `firstCrudListFilterValue(value)`
247
- - `isPrimitiveCrudListFilterInput(value)`
248
- - `isPrimitiveOrPrimitiveArrayCrudListFilterInput(value)`
249
- - `normalizeDateFilterText(value)`
250
- - `normalizeCanonicalRecordIdList(value)`
251
- - `normalizeFiniteFilterNumber(value)`
252
- - `normalizeAllowedFilterTextValue(value, allowedValues = new Set())`
253
- - `normalizeAllowedFilterTextValues(value, allowedValues = new Set())`
254
- - `resolveCrudListFilterAllowedValues(filter = {})`
255
- - `normalizeCrudListDateRangeUiValue(rawValue)`
256
- - `normalizeCrudListNumberRangeUiValue(rawValue)`
257
- - `matchCrudListFilterValues(currentValue, expectedValue)`
258
- - `rejectInvalidCrudListFilterValue({ invalidValues = CRUD_LIST_FILTER_INVALID_VALUES_REJECT } = {})`
259
- - `normalizeCrudListDateRangeQueryValue(value)`
260
- - `normalizeCrudListNumberRangeQueryValue(value)`
261
- - `normalizeCrudListFilterType(value = "")`
262
- - `normalizeCrudListFilterOption(rawOption = null, { context = "filter option" } = {})`
263
- - `normalizeCrudListFilterOptions(rawOptions = [], { context = "filter options" } = {})`
264
- - `normalizeCrudListFilterPresenceOptions(rawOptions = [])`
265
- - `normalizeCrudListFilterLookup(rawLookup = null)`
266
- - `resolveCrudListFilterOptionSet(rawDefinition = {}, type = "")`
267
- - `normalizeCrudListFilterDefinition(rawKey = "", rawDefinition = null)`
268
-
269
- ### `shared/support/crudLookup.js`
270
- Exports
271
- - `DEFAULT_CRUD_LOOKUP_CONTAINER_KEY`
272
- - `normalizeCrudLookupApiPath(value = "")`
273
- - `normalizeCrudLookupNamespace(value = "")`
274
- - `resolveCrudLookupApiPathFromNamespace(value = "")`
275
- - `resolveCrudResourceScopeName(value = "")`
276
- - `normalizeCrudLookupContainerKey(value, { defaultValue = DEFAULT_CRUD_LOOKUP_CONTAINER_KEY, context = "crud lookup container key" } = {})`
277
- - `resolveCrudLookupContainerKey(resource = {}, options = {})`
278
- - `resolveCrudLookupFieldKeys(resource = {}, { allowKeys = [] } = {})`
279
- - `resolveCrudParentFilterKeys(resource = {})`
280
- - `resolveCrudLookupFieldKeyFromRouteParam(resource = {}, routeParamKey = "", { allowKeys = [] } = {})`
281
- - `resolveCrudParentFilterFieldKeyFromRouteParam(resource = {}, routeParamKey = "")`
282
- Local functions
283
- - `resolveCrudLookupFieldEntries(resource = {}, { allowKeys = [] } = {})`
284
- - `resolveCrudLookupCreateSchemaKeys(resource = {})`
285
-
286
193
  ### `shared/support/deepFreeze.js`
287
194
  Exports
288
195
  - `deepFreeze(value, seen = new WeakSet())`
@@ -799,13 +706,15 @@ Exports
799
706
  - `resolveInstalledClientPackageIds(options)`
800
707
  - `resolveLocalScopePackageIds({ appRoot })`
801
708
  - `resolveInstalledClientModules({ appRoot })`
802
- - `createJskitClientBootstrapPlugin()`
709
+ - `resolveInstalledViteProxyEntries(installedPackages = [], { proxyTarget = "" } = {})`
710
+ - `createJskitClientBootstrapPlugin({ proxyTarget = "" } = {})`
803
711
  Local functions
804
712
  - `isLocalScopePackageId(value)`
805
713
  - `readJsonFile(filePath, fallback)`
806
714
  - `hasClientExport(packageJson)`
807
715
  - `isPathInsideRoot(rootPath, candidatePath)`
808
716
  - `splitSpecifierSuffix(source)`
717
+ - `resolveClientModulesFromInstalledPackages(installedPackages = [])`
809
718
  - `normalizeClientModulePackageMetadataEntries(value)`
810
719
  - `resolveClientRuntimeDedupeSpecifiers(userResolveConfig = {})`
811
720
 
@@ -1023,7 +932,7 @@ Exports
1023
932
  - `KernelError`
1024
933
  - `ProviderNormalizationError`
1025
934
  - `DuplicateProviderError`
1026
- - `ProviderDependencyError`
935
+ - `ProviderStartOrderError`
1027
936
  - `ProviderLifecycleError`
1028
937
  - `KernelCoreServiceProvider`
1029
938
 
package/reference/autogen/packages/resource-crud-core.md CHANGED
@@ -14,6 +14,100 @@ Use this on demand; do not load the full index at startup.
14
14
 
15
15
  ### src
16
16
 
17
+ ### `src/shared/crudFieldContract.js`
18
+ Exports
19
+ - `CRUD_FIELD_STORAGE_COLUMN`
20
+ - `CRUD_FIELD_STORAGE_VIRTUAL`
21
+ - `CRUD_FIELD_WRITE_SERIALIZER_DATETIME_UTC`
22
+ - `CRUD_LOOKUP_FORM_CONTROL_AUTOCOMPLETE`
23
+ - `CRUD_LOOKUP_FORM_CONTROL_SELECT`
24
+ - `checkCrudLookupFormControl(value, { context = "crud field ui.formControl", defaultValue = CRUD_LOOKUP_FORM_CONTROL_AUTOCOMPLETE } = {})`
25
+ - `resolveCrudFieldSchemaProperties(value, { context = "crud resource field definitions" } = {})`
26
+ - `normalizeCrudFieldStorageConfig(fieldDefinition = {}, { context = "crud field storage", fieldKey = "" } = {})`
27
+ - `buildCrudOperationSchemaFields(fields = {}, operationName = "")`
28
+ - `buildCrudFieldContractMap(resource = {}, { context = "crud resource field contract" } = {})`
29
+ - `resolveCrudFieldContractEntry(resource = {}, fieldKey = "", options = {})`
30
+ Local functions
31
+ - `cloneStructuredFieldMetadata(value = {})`
32
+ - `mergeFieldContractEntry(target, source, { context = "crud field contract", fieldKey = "" } = {})`
33
+
34
+ ### `src/shared/crudListFilters.js`
35
+ Exports
36
+ - `CRUD_LIST_FILTER_TYPE_FLAG`
37
+ - `CRUD_LIST_FILTER_TYPE_ENUM`
38
+ - `CRUD_LIST_FILTER_TYPE_ENUM_MANY`
39
+ - `CRUD_LIST_FILTER_TYPE_RECORD_ID`
40
+ - `CRUD_LIST_FILTER_TYPE_RECORD_ID_MANY`
41
+ - `CRUD_LIST_FILTER_TYPE_DATE`
42
+ - `CRUD_LIST_FILTER_TYPE_DATE_RANGE`
43
+ - `CRUD_LIST_FILTER_TYPE_NUMBER_RANGE`
44
+ - `CRUD_LIST_FILTER_TYPE_PRESENCE`
45
+ - `CRUD_LIST_FILTER_TYPES`
46
+ - `CRUD_LIST_FILTER_PRESENCE_PRESENT`
47
+ - `CRUD_LIST_FILTER_PRESENCE_MISSING`
48
+ - `CRUD_LIST_FILTER_PRESENCE_OPTIONS`
49
+ - `CRUD_LIST_FILTER_INVALID_VALUES_REJECT`
50
+ - `CRUD_LIST_FILTER_INVALID_VALUES_DISCARD`
51
+ - `INVALID_CRUD_LIST_FILTER_QUERY_VALUE`
52
+ - `normalizeCrudListFilterInvalidValues(value = "")`
53
+ - `parseCrudListRangeQueryExpression(value = null)`
54
+ - `formatCrudListRangeQueryExpression(startValue = "", endValue = "", { collapseExact = false } = {})`
55
+ - `defineCrudListFilters(definitions = {})`
56
+ - `createCrudListFilterEmptyValue(filter = {})`
57
+ - `createCrudListFilterInitialValue(filter = {})`
58
+ - `isCrudListFilterMultiValue(filter = {})`
59
+ - `isCrudListFilterStructuredValue(filter = {})`
60
+ - `normalizeCrudListFilterUiValue(filter = {}, rawValue)`
61
+ - `areCrudListFilterUiValuesEqual(filter = {}, currentValue, expectedValue)`
62
+ - `hasCrudListFilterUiValue(filter = {}, rawValue)`
63
+ - `listCrudListFilterChipValues(filter = {}, rawValue)`
64
+ - `formatCrudListFilterDefaultChipLabel(filter = {}, rawValue, { resolveAtomicValue = null } = {})`
65
+ - `formatCrudListFilterQueryValue(filter = {}, value)`
66
+ - `parseCrudListFilterQueryValue(filter = {}, value, { invalidValues = CRUD_LIST_FILTER_INVALID_VALUES_REJECT } = {})`
67
+ - `resolveCrudListFilterQueryKeys(definition = {})`
68
+ - `resolveCrudListFilterOptionLabel(definition = {}, value = "", { fallback = "" } = {})`
69
+ Local functions
70
+ - `firstCrudListFilterValue(value)`
71
+ - `isPrimitiveCrudListFilterInput(value)`
72
+ - `isPrimitiveOrPrimitiveArrayCrudListFilterInput(value)`
73
+ - `normalizeDateFilterText(value)`
74
+ - `normalizeCanonicalRecordIdList(value)`
75
+ - `normalizeFiniteFilterNumber(value)`
76
+ - `normalizeAllowedFilterTextValue(value, allowedValues = new Set())`
77
+ - `normalizeAllowedFilterTextValues(value, allowedValues = new Set())`
78
+ - `resolveCrudListFilterAllowedValues(filter = {})`
79
+ - `normalizeCrudListDateRangeUiValue(rawValue)`
80
+ - `normalizeCrudListNumberRangeUiValue(rawValue)`
81
+ - `matchCrudListFilterValues(currentValue, expectedValue)`
82
+ - `rejectInvalidCrudListFilterValue({ invalidValues = CRUD_LIST_FILTER_INVALID_VALUES_REJECT } = {})`
83
+ - `normalizeCrudListDateRangeQueryValue(value)`
84
+ - `normalizeCrudListNumberRangeQueryValue(value)`
85
+ - `normalizeCrudListFilterType(value = "")`
86
+ - `normalizeCrudListFilterOption(rawOption = null, { context = "filter option" } = {})`
87
+ - `normalizeCrudListFilterOptions(rawOptions = [], { context = "filter options" } = {})`
88
+ - `normalizeCrudListFilterPresenceOptions(rawOptions = [])`
89
+ - `normalizeCrudListFilterLookup(rawLookup = null)`
90
+ - `resolveCrudListFilterOptionSet(rawDefinition = {}, type = "")`
91
+ - `normalizeCrudListFilterDefinition(rawKey = "", rawDefinition = null)`
92
+
93
+ ### `src/shared/crudLookup.js`
94
+ Exports
95
+ - `DEFAULT_CRUD_LOOKUP_CONTAINER_KEY`
96
+ - `normalizeCrudLookupApiPath(value = "")`
97
+ - `normalizeCrudLookupNamespace(value = "")`
98
+ - `resolveCrudLookupApiPathFromNamespace(value = "")`
99
+ - `resolveCrudResourceScopeName(value = "")`
100
+ - `normalizeCrudLookupContainerKey(value, { defaultValue = DEFAULT_CRUD_LOOKUP_CONTAINER_KEY, context = "crud lookup container key" } = {})`
101
+ - `isCrudRuntimeOutputOnlyFieldKey(value = "", { lookupContainerKey = DEFAULT_CRUD_LOOKUP_CONTAINER_KEY } = {})`
102
+ - `resolveCrudLookupContainerKey(resource = {}, options = {})`
103
+ - `resolveCrudLookupFieldKeys(resource = {}, { allowKeys = [] } = {})`
104
+ - `resolveCrudParentFilterKeys(resource = {})`
105
+ - `resolveCrudLookupFieldKeyFromRouteParam(resource = {}, routeParamKey = "", { allowKeys = [] } = {})`
106
+ - `resolveCrudParentFilterFieldKeyFromRouteParam(resource = {}, routeParamKey = "")`
107
+ Local functions
108
+ - `resolveCrudLookupFieldEntries(resource = {}, { allowKeys = [] } = {})`
109
+ - `resolveCrudLookupCreateSchemaKeys(resource = {})`
110
+
17
111
  ### `src/shared/crudNamespaceSupport.js`
18
112
  Exports
19
113
  - `normalizeCrudNamespace(value = "")`