@jskit-ai/agent-docs 0.1.246 → 0.1.248

package/reference/autogen/packages/connector-google-calendar.md

@@ -19,7 +19,7 @@ Exports
 - `googleCalendarProvider`
 Local functions
 - `queryUrl(path, input)`
-- `invalid(message)`
+- `invalid(message, codes)`
 - `validateEventTime(point)`
 - `validateRecurrence(body)`
 - `validAttendee(person)`
@@ -32,6 +32,11 @@ Exports
 - `googleCalendarDefinition`
 - `googleScope(name)`
 
+### `src/shared/english-definition.js`
+Exports
+- `googleCalendarDefinition`
+- `googleScope`
+
 ### patterns
 
 ### `patterns/calendar-cli/example/knexfile.js`

package/reference/autogen/packages/connectors-catalog.md

@@ -316,7 +316,7 @@ Exports
 - `googleAdsSearchOperations`
 - `createGoogleAdsSearchService({ connections, configuration, context, integrationId })`
 Local functions
-- `error(message)`
+- `error(message, codes)`
 - `hash(value)`
 - `requestOperation(fields, build, validateResult)`
 - `mutated(result)`
@@ -378,7 +378,7 @@ Exports
 - `googleScope(name)`
 - `googleOperation(scopes, fields, request, validateResult)`
 - `googleBatchRequests(requests, product)`
-- `inputInvalid(message, statusCode = 422)`
+- `inputInvalid(message, { statusCode = 422, ...codes } = {})`
 - `googleRead(scopes, fields, destination, validateResult)`
 - `googleProvider(definition, origin, checkOperation, operations)`
 - `googleFileVerification(get, field)`
@@ -802,7 +802,7 @@ Local functions
 - `serializeNativeJson(value)`
 - `guid(value)`
 - `requestPath(request, index)`
-- `sameRecord(matches, message)`
+- `sameRecord(matches, message, codes)`
 - `cursor(value)`
 - `bookingDirectoryOperation(kind)`
 - `validContact(value)`
@@ -828,7 +828,7 @@ Exports
 - `createWizScanner({ configuration, authorize, resolveReference, resolveScanTarget, executable, environment = { PATH: process.env.PATH || "/usr/bin:/bin" }, timeoutMs = 600_000, maxReportBytes = 16 * 1024 * 1024 })`
 Local functions
 - `object(value)`
-- `failure(code, message, statusCode = 502)`
+- `failure(code, message, statusCode = 502, codes = {})`
 - `runCli(executable, args, options, signal, timeoutMs)`
 
 ### `src/server/woocommerce.js`
@@ -1029,6 +1029,21 @@ Exports
 - `resendDefinition`
 - `firecrawlDefinition`
 
+### `src/shared/english-ai.js`
+Exports
+- `aiCatalogue`
+- `getAiModel`
+- `listAiModels`
+
+### `src/shared/english-definitions.js`
+Exports
+- `createCanvaClientMetadata`
+- `validN8nOAuthDiscovery`
+
+### `src/shared/english-texts.js`
+Exports
+- `englishTexts`
+
 ### `src/shared/figma.js`
 Exports
 - `figmaDefinition`

package/reference/autogen/packages/connectors-core.md

@@ -19,7 +19,7 @@ Exports
 - `createConnectionService({ configuration, providers, resolveReference, store, authorize, executionMode = "application", fetchImpl = globalThis.fetch, now = Date.now })`
 Local functions
 - `publicConnection(connection)`
-- `requireOperationScope(operation, scopes, message)`
+- `requireOperationScope(operation, scopes, message, { messageCode })`
 - `operationRequest(operation, input, settings, providerData)`
 - `validateCallbackUrl(value)`
 - `connectionMatches(connection, integration, providerId, registration)`
@@ -73,6 +73,8 @@ Exports
 Exports
 - `DEFAULT_GRANT_TYPE`
 - `DEFAULT_TOKEN_ENDPOINT_AUTH_METHOD`
+- `MESSAGE_KEY_SOURCE`
+- `createEnglishProviderTexts(catalog)`
 - `registrationGrantType(record)`
 - `registrationClientAuthentication(record)`
 - `providerGrantTypes(provider)`
@@ -88,6 +90,8 @@ Exports
 - `IntegrationConfigurationError`
 - `parseIntegrationConfiguration(text, options)`
 - `validateIntegrationConfiguration(input, { providers = [], allowUnknownProviders = false } = {})`
+Local functions
+- `schemaFieldErrors(error, fallback, prefix = "")`
 
 ### migrations
 

package/reference/autogen/packages/connectors-web.md

@@ -14,6 +14,10 @@ Use this on demand; do not load the full index at startup.
 
 ### src
 
+### `src/client/i18n.js`
+Exports
+- `useJskitText`
+
 ### `src/client/index.js`
 Exports
 - `IntegrationConfigurationFields`
@@ -26,6 +30,7 @@ Local functions
 - `accountModeForGrant(grant, settings, accountMode)`
 - `settingValue(field)`
 - `settingHint(field)`
+- `settingItems(field)`
 - `settingErrors(field)`
 - `editAssistantPolicy(changes)`
 - `editIntegration(changes)`

package/reference/autogen/packages/database-runtime.md

@@ -56,6 +56,7 @@ Local functions
 
 ### `src/shared/dateUtils.js`
 Exports
+- `normalizeDateInput(value)`
 - `toIsoString(value)`
 - `toInsertDateTime(dateLike, fallback = new Date())`
 - `toDatabaseDateTimeUtc(value)`
@@ -63,7 +64,6 @@ Exports
 - `toJsonTime(value, { temporalPrecision } = {})`
 - `toJsonDateTime(value, { temporalPrecision } = {})`
 Local functions
-- `normalizeDateInput(value)`
 - `toDateOrThrow(value)`
 - `pad(value, size = 2)`
 - `requireValidDateParts(year, month, day)`
@@ -88,6 +88,7 @@ Local functions
 
 ### `src/shared/index.js`
 Exports
+- `normalizeDateInput`
 - `toIsoString`
 - `toInsertDateTime`
 - `toDatabaseDateTimeUtc`
@@ -111,9 +112,11 @@ Exports
 - `normalizeNullableString`
 - `normalizeDbRecordId`
 - `resolveInsertedRecordId`
+- `parseJsonValue`
 - `toDbJson`
 - `runInTransaction`
 - `createWithTransaction`
+- `lockScopedRecordId`
 
 ### `src/shared/repositoryOptions.js`
 Exports
@@ -125,9 +128,13 @@ Exports
 - `normalizeNullableString(value, { trim = true } = {})`
 - `normalizeDbRecordId(value, { fallback = null } = {})`
 - `resolveInsertedRecordId(insertResult, { fallback = null } = {})`
+- `parseJsonValue(value, fallback = null, options = {})`
 - `toDbJson(value)`
 - `runInTransaction(knex, callback)`
 - `createWithTransaction(knex)`
+- `lockScopedRecordId({ trx, tableName, recordId, scopeId, idColumn = "id", scopeColumn = "workspace_id" } = {})`
+Local functions
+- `requireSqlIdentifier(value, label)`
 
 ### `src/shared/transactionManager.js`
 Exports

package/reference/autogen/packages/http-runtime.md

@@ -42,7 +42,7 @@ Local functions
 Exports
 - `normalizeFieldErrors`
 - `resolveFieldErrors`
-- `createValidationFailure({ error = "Validation failed.", code = "validation_failed", fieldErrors = {} } = {})`
+- `createValidationFailure({ error = "Validation failed.", code = "validation_failed", fieldErrors = {}, fieldErrorCodes = null } = {})`
 
 ### `src/shared/clientRuntime/client.js`
 Exports
@@ -94,6 +94,7 @@ Local functions
 - `simplifyResourceObject(resource = {}, options = {})`
 - `assertPrimaryDataType(resource = {}, expectedType = "")`
 - `resolveCollectionPageMeta(document = {})`
+- `decodeJsonApiErrorFields(payload = {})`
 
 ### `src/shared/clientRuntime/retry.js`
 Exports
@@ -226,7 +227,7 @@ Exports
 - `createJsonApiResourceRouteTransport({ type = "", requestType = "", responseType = "", query = null, allowBodyId = false, successKind = "record", pointerPrefix = "/data/attributes", mapRequestRelationships = null, getRecordType = null, getRecordId = null, getRecordAttributes = null, getRecordRelationships = null, getRecordLinks = null, getRecordMeta = null, getIncluded = null, getDocumentLinks = null, getDocumentMeta = null, getCollectionItems = null } = {})`
 - `createJsonApiResourceRouteContract({ type = "", requestType = "", responseType = "", body = null, query = null, output = null, outputKind = "record", successStatus = 200, includeValidation400 = false, allowSparseFields = false, allowBodyId = false, pointerPrefix = "/data/attributes", bodyAttributeExcludeKeys = [], outputAttributeExcludeKeys = [], bodyRelationshipEntries = [], outputRelationshipEntries = [], getRecordType = null, getRecordId = null, getRecordAttributes = null, getRecordRelationships = null, getRecordLinks = null, getRecordMeta = null, getIncluded = null, getDocumentLinks = null, getDocumentMeta = null, getCollectionItems = null, mapRequestRelationships = null } = {})`
 Local functions
-- `createJsonApiTransportError(statusCode, message, code)`
+- `createJsonApiTransportError(statusCode, message, code, params = {})`
 - `resolveRouteType(type = "")`
 - `resolveRouteTypes(value = {})`
 - `resolveEmbeddedAttributesTransportSchema(definition, { context = "JSON:API resource", defaultMode = "replace", removeId = false, removeKeys = [], allowSparseFields = false } = {})`
@@ -246,7 +247,7 @@ Exports
 - `JSON_API_CONTENT_TYPE`
 - `resolveJsonApiTransportTypes({ type = "", requestType = "", responseType = "" } = {}, { context = "JSON:API transport" } = {})`
 - `createJsonApiDocument({ data = undefined, included = undefined, links = undefined, meta = undefined, errors = undefined } = {})`
-- `createJsonApiErrorDocumentFromFailure({ statusCode = 500, code = "", message = "", transactionOutcome, fieldErrors = {}, validationIssues = [], validationContext = "", pointerPrefix = "/data/attributes" } = {})`
+- `createJsonApiErrorDocumentFromFailure({ statusCode = 500, code = "", message = "", params = {}, messageCode = "", messageParams = {}, transactionOutcome, fieldErrors = {}, fieldErrorCodes = {}, validationIssues = [], validationIssueCodes = [], validationContext = "", pointerPrefix = "/data/attributes" } = {})`
 - `createJsonApiErrorObject({ status = "", code = "", title = "", detail = "", source = undefined, links = undefined, meta = undefined } = {})`
 - `createJsonApiResourceObject({ type = "", id = null, attributes = undefined, relationships = undefined, links = undefined, meta = undefined } = {})`
 - `isJsonApiCollectionDocument(payload = {})`
@@ -254,6 +255,7 @@ Exports
 - `isJsonApiErrorDocument(payload = {})`
 - `isJsonApiResourceDocument(payload = {})`
 - `isJsonContentType(contentType = "")`
+- `normalizeCodedEntry(entry)`
 - `normalizeJsonApiDocument(payload = {})`
 - `normalizeJsonApiResourceObject(resource = {})`
 - `simplifyJsonApiDocument(payload = {})`
@@ -266,6 +268,7 @@ Local functions
 - `escapeJsonPointerSegment(value = "")`
 - `resolveValidationFieldName(issue = {})`
 - `resolveJsonApiValidationSource(issue = {}, validationContext = "")`
+- `createJsonApiErrorMeta({ transactionOutcome, params, messageCode, messageParams, fieldErrorCode })`
 - `simplifyJsonApiResourceObject(resource = {})`
 
 ### `src/shared/validators/operationValidation.js`

package/reference/autogen/packages/http-web.md

@@ -40,6 +40,7 @@ Local functions
 - `execute(action = {})`
 - `isActionDisabled(action = {})`
 - `isActionExecuting(action = {})`
+- `actionLabel(action = {})`
 
 ### `src/client/components/CrudListDateFilterControl.vue`
 Exports
@@ -57,7 +58,8 @@ Exports
 - None
 Local functions
 - `optionItems(filter = {})`
-- `placeholder(filter = {}, fallback = "")`
+- `filterLabel(filter = {}, key = "", params = {})`
+- `placeholder(filter = {}, fallbackKey = "")`
 
 ### `src/client/components/CrudListFilterSurface.vue`
 Exports
@@ -71,6 +73,7 @@ Exports
 - None
 Local functions
 - `isRowActionLoading(action = {})`
+- `rowActionLabel(action = {})`
 - `isRowActionDisabled(action = {})`
 - `runRowAction(action = {})`
 
@@ -173,7 +176,7 @@ Exports
 - `resolveLookupSelectedValues(filter = {}, rawValue = undefined)`
 - `createLookupOptionsFromItems(items = [], filter = {}, labelResolver = null)`
 - `mergeSelectedLookupOptions(options = [], selectedValues = [], cachedOptions = new Map())`
-- `resolveLookupOptionLabel(options = [], cachedOptions = new Map(), value = "", fallback = "Option")`
+- `resolveLookupOptionLabel(options = [], cachedOptions = new Map(), value = "", fallback = "")`
 Local functions
 - `createLookupOptionFromItem(item = {}, filter = {}, labelResolver = null)`
 
@@ -197,7 +200,7 @@ Local functions
 
 ### `src/client/composables/records/useAddEdit.js`
 Exports
-- `useAddEdit({ ownershipFilter = ROUTE_VISIBILITY_WORKSPACE, surfaceId = "", access = "auto", resource = null, apiSuffix = "", queryKeyFactory = null, viewPermissions = [], savePermissions = [], readMethod = "GET", readEnabled = true, writeMethod = "PATCH", client = null, transport = null, requestRecovery = null, requestRecoveryLabel = "Resource", placementSource = "http-web.add-edit", fallbackLoadError = "Unable to load resource.", fallbackSaveError = "", fieldErrorKeys = [], clearOnRouteChange = true, model, input, mapLoadedToModel, buildRawPayload, buildSavePayload, onSaveSuccess, validationFeedback = true, requestQueryParams = null, recordIdParam = "recordId", routeParams = null, routeRecordId = null, apiUrlTemplate = "", viewUrlTemplate = "", listUrlTemplate = "", saveRecordIdSelector = null, messages = {}, realtime = null } = {})`
+- `useAddEdit({ ownershipFilter = ROUTE_VISIBILITY_WORKSPACE, surfaceId = "", access = "auto", resource = null, apiSuffix = "", queryKeyFactory = null, viewPermissions = [], savePermissions = [], readMethod = "GET", readEnabled = true, writeMethod = "PATCH", client = null, transport = null, requestRecovery = null, requestRecoveryLabel = t("jskit.http.resource.label"), placementSource = "http-web.add-edit", fallbackLoadError = t("jskit.http.resource.loadFailed"), fallbackSaveError = "", fieldErrorKeys = [], clearOnRouteChange = true, model, input, mapLoadedToModel, buildRawPayload, buildSavePayload, onSaveSuccess, validationFeedback = true, requestQueryParams = null, recordIdParam = "recordId", routeParams = null, routeRecordId = null, apiUrlTemplate = "", viewUrlTemplate = "", listUrlTemplate = "", saveRecordIdSelector = null, messages = {}, realtime = null } = {})`
 
 ### `src/client/composables/records/useCrudAddEdit.js`
 Exports
@@ -219,11 +222,11 @@ Exports
 
 ### `src/client/composables/records/useList.js`
 Exports
-- `useList({ ownershipFilter = ROUTE_VISIBILITY_WORKSPACE, surfaceId = "", access = "auto", apiSuffix = "", queryKeyFactory = null, viewPermissions = [], readEnabled = true, placementSource = "http-web.list", fallbackLoadError = "Unable to load list.", initialPageParam = null, getNextPageParam, selectItems, client = null, transport = null, requestOptions, queryOptions, requestRecovery, requestRecoveryLabel = "List", realtime = null, recordIdParam = "recordId", recordIdSelector = null, viewUrlTemplate = "", editUrlTemplate = "", search = null, queryParams = null, routeQueryValueResolvers = null, requestQueryParams = null, requestFieldsets = null, syncToRoute = false } = {})`
+- `useList({ ownershipFilter = ROUTE_VISIBILITY_WORKSPACE, surfaceId = "", access = "auto", apiSuffix = "", queryKeyFactory = null, viewPermissions = [], readEnabled = true, placementSource = "http-web.list", fallbackLoadError = t("jskit.http.list.loadFailed"), initialPageParam = null, getNextPageParam, selectItems, client = null, transport = null, requestOptions, queryOptions, requestRecovery, requestRecoveryLabel = t("jskit.http.list.label"), realtime = null, recordIdParam = "recordId", recordIdSelector = null, viewUrlTemplate = "", editUrlTemplate = "", search = null, queryParams = null, routeQueryValueResolvers = null, requestQueryParams = null, requestFieldsets = null, syncToRoute = false } = {})`
 
 ### `src/client/composables/records/useView.js`
 Exports
-- `useView({ resource = null, ownershipFilter = ROUTE_VISIBILITY_WORKSPACE, surfaceId = "", access = "auto", apiSuffix = "", queryKeyFactory = null, viewPermissions = [], readMethod = "GET", readEnabled = true, client = null, transport = null, requestRecovery = null, requestRecoveryLabel = "Resource", placementSource = "http-web.view", fallbackLoadError = "Unable to load resource.", notFoundStatuses = [404], notFoundMessage = "Record not found.", model, mapLoadedToModel, requestQueryParams = null, requestFieldsets = null, recordIdParam = "recordId", routeParams = null, routeRecordId = null, apiUrlTemplate = "", listUrlTemplate = "", editUrlTemplate = "", includeRecordIdInQueryKey = false, realtime = undefined } = {})`
+- `useView({ resource = null, ownershipFilter = ROUTE_VISIBILITY_WORKSPACE, surfaceId = "", access = "auto", apiSuffix = "", queryKeyFactory = null, viewPermissions = [], readMethod = "GET", readEnabled = true, client = null, transport = null, requestRecovery = null, requestRecoveryLabel = t("jskit.http.resource.label"), placementSource = "http-web.view", fallbackLoadError = t("jskit.http.resource.loadFailed"), notFoundStatuses = [404], notFoundMessage = t("jskit.http.crud.recordNotFound"), model, mapLoadedToModel, requestQueryParams = null, requestFieldsets = null, recordIdParam = "recordId", routeParams = null, routeRecordId = null, apiUrlTemplate = "", listUrlTemplate = "", editUrlTemplate = "", includeRecordIdInQueryKey = false, realtime = undefined } = {})`
 
 ### `src/client/composables/runtime/addEditUiRuntime.js`
 Exports
@@ -255,7 +258,7 @@ Local functions
 
 ### `src/client/composables/runtime/operationValidationHelpers.js`
 Exports
-- `validateOperationInput({ input, rawPayload = {}, fieldBag = null, feedback = null, validationMessage = "Validation failed." } = {})`
+- `validateOperationInput({ input, rawPayload = {}, fieldBag = null, feedback = null, validationMessage = "" } = {})`
 
 ### `src/client/composables/runtime/useAddEditCore.js`
 Exports
@@ -269,7 +272,7 @@ Exports
 Exports
 - `buildEndpointReadRequestOptions({ method = "GET", query = null, transport = null } = {})`
 - `buildEndpointWriteRequestOptions({ method = "PATCH", body = undefined, options = null, transport = null } = {})`
-- `useEndpointResource({ queryKey, path = "", enabled = true, client = null, readMethod = "GET", writeMethod = "PATCH", readQuery = null, transport = null, refreshOnPull = false, realtime = null, queryOptions = null, mutationOptions = null, requestRecovery = null, requestRecoveryLabel = "Request", fallbackLoadError = "Unable to load resource.", fallbackSaveError = "Unable to save resource." } = {})`
+- `useEndpointResource({ queryKey, path = "", enabled = true, client = null, readMethod = "GET", writeMethod = "PATCH", readQuery = null, transport = null, refreshOnPull = false, realtime = null, queryOptions = null, mutationOptions = null, requestRecovery = null, // No label: shell-web's request recovery names the app. requestRecoveryLabel = "", fallbackLoadError = "jskit.http.resource.loadFailed", fallbackSaveError = "jskit.http.resource.saveFailed" } = {})`
 Local functions
 - `resolveRequestQuery(value = null)`
 
@@ -281,7 +284,7 @@ Exports
 ### `src/client/composables/runtime/useListCore.js`
 Exports
 - `buildListRequestOptions({ requestOptions = null, transport = null, pageParam = null } = {})`
-- `useListCore({ queryKey, path = "", enabled = true, client = null, transport = null, initialPageParam = null, getNextPageParam, selectItems, requestOptions = null, queryOptions = null, requestRecovery = null, requestRecoveryLabel = "List", fallbackLoadError = "Unable to load list." } = {})`
+- `useListCore({ queryKey, path = "", enabled = true, client = null, transport = null, initialPageParam = null, getNextPageParam, selectItems, requestOptions = null, queryOptions = null, requestRecovery = null, requestRecoveryLabel = t("jskit.http.list.label"), fallbackLoadError = t("jskit.http.list.loadFailed") } = {})`
 Local functions
 - `resolveRequestOptionsObject(value = null)`
 - `resolveListRequestMethod(requestOptions = null)`
@@ -292,7 +295,7 @@ Exports
 
 ### `src/client/composables/runtime/useViewCore.js`
 Exports
-- `useViewCore({ resource, model, canView, mapLoadedToModel, notFoundStatuses = [404], notFoundMessage = "Record not found." } = {})`
+- `useViewCore({ resource, model, canView, mapLoadedToModel, notFoundStatuses = [404], notFoundMessage = "" } = {})`
 Local functions
 - `normalizeStatusList(value)`
 
@@ -302,8 +305,9 @@ Exports
 
 ### `src/client/composables/support/errorMessageHelpers.js`
 Exports
-- `toQueryErrorMessage(error, fallbackMessage = "", defaultMessage = "Request failed.")`
-- `toUiErrorMessage(error, fallbackMessage = "", defaultMessage = "Request failed.")`
+- `toQueryErrorMessage(error, fallbackMessage = "", defaultMessage = "")`
+- `toUiErrorMessage(error, fallbackMessage = "", defaultMessage = "")`
+- `toUiFieldErrors(error)`
 
 ### `src/client/composables/support/listQueryParamSupport.js`
 Exports
@@ -409,11 +413,11 @@ Local functions
 
 ### `src/client/composables/useCommand.js`
 Exports
-- `useCommand({ ownershipFilter = ROUTE_VISIBILITY_WORKSPACE, surfaceId = "", access = "auto", apiSuffix = "", runPermissions = [], writeMethod = "POST", client = null, resource: commandResource = null, transport = null, placementSource = "http-web.command", fallbackRunError = "Unable to complete action.", fieldErrorKeys = [], clearOnRouteChange = true, model, input, buildRawPayload, buildCommandPayload, buildCommandOptions, onRunSuccess, onRunError, suppressSuccessMessage = false, messages = {}, realtime = null } = {})`
+- `useCommand({ ownershipFilter = ROUTE_VISIBILITY_WORKSPACE, surfaceId = "", access = "auto", apiSuffix = "", runPermissions = [], writeMethod = "POST", client = null, resource: commandResource = null, transport = null, placementSource = "http-web.command", fallbackRunError = "jskit.http.feedback.actionFailed", fieldErrorKeys = [], clearOnRouteChange = true, model, input, buildRawPayload, buildCommandPayload, buildCommandOptions, onRunSuccess, onRunError, suppressSuccessMessage = false, messages = {}, realtime = null } = {})`
 
 ### `src/client/composables/useCrudAddEditScreen.js`
 Exports
-- `useCrudAddEditScreen({ screen = null, mode = "new", title = "", subtitle = "", saveLabel = "Save", cancelTo = "", resource = null, operationName = "", formFields = [], addEditOptions = {}, saveSuccess = {}, fieldBinding = null, createModel = null, buildPayload = null, mapPayloadToModel = null, input = null, preserveCancelQuery = false } = {})`
+- `useCrudAddEditScreen({ screen = null, mode = "new", title = "", subtitle = "", saveLabel = "", cancelTo = "", resource = null, operationName = "", formFields = [], addEditOptions = {}, saveSuccess = {}, fieldBinding = null, createModel = null, buildPayload = null, mapPayloadToModel = null, input = null, preserveCancelQuery = false } = {})`
 Local functions
 - `normalizeProvidedScreen(screen = null)`
 
@@ -421,7 +425,7 @@ Local functions
 Exports
 - `requireCrudDeleteOperation(resource = null)`
 - `resolveDeleteApiSuffix(screen, apiUrlTemplate = "")`
-- `useCrudDeleteAction({ screen = null, resource = null, resourceNamespace = "", apiUrlTemplate = "", access = "auto", client = null, router: routerOverride = null, fallbackDeleteError = "Unable to delete record." } = {})`
+- `useCrudDeleteAction({ screen = null, resource = null, resourceNamespace = "", apiUrlTemplate = "", access = "auto", client = null, router: routerOverride = null, fallbackDeleteError = t("jskit.http.crud.delete.failed") } = {})`
 Local functions
 - `requireCrudViewScreen(screen = null)`
 - `resolveListLocation(screen)`
@@ -453,7 +457,7 @@ Local functions
 
 ### `src/client/composables/useCrudListParentTitle.js`
 Exports
-- `useCrudListParentTitle({ listRuntime = null, resource = {}, recordIdParam = "recordId", queryKeyPrefix = ["http-web", "crud-list-parent-title"], placementSource = "http-web.crud-list-parent-title", fallbackLoadError = "Unable to load parent record.", notFoundMessage = "Parent record not found.", route = null, viewRuntimeFactory = useView } = {})`
+- `useCrudListParentTitle({ listRuntime = null, resource = {}, recordIdParam = "recordId", queryKeyPrefix = ["http-web", "crud-list-parent-title"], placementSource = "http-web.crud-list-parent-title", fallbackLoadError = t("jskit.http.crud.parent.loadFailed"), notFoundMessage = t("jskit.http.crud.parent.notFound"), route = null, viewRuntimeFactory = useView } = {})`
 Local functions
 - `normalizeQueryKeyPrefix(value = [])`
 
@@ -466,7 +470,7 @@ Local functions
 ### `src/client/composables/useCrudListScreen.js`
 Exports
 - `__testables`
-- `useCrudListScreen({ client = null, resource = null, resourceNamespace = "resource", apiSuffix = "", recordIdParam = "recordId", recordIdSelector = null, titleFallbackFieldKey = "", viewUrlTemplate = "", editUrlTemplate = "", newUrlTemplate = "", recordChangedEvents = [], listFilters = {}, listBulkActions = [], listRowActions = [], syntheticRows = null, routeQueryBlacklist = Object.freeze(["include", "cursor", "limit"]), requestQueryParams = null, requestFieldsets = null, readEnabled = true, requestRecoveryLabel = "Records", fallbackLoadError = "Unable to load records." } = {})`
+- `useCrudListScreen({ client = null, resource = null, resourceNamespace = "resource", apiSuffix = "", recordIdParam = "recordId", recordIdSelector = null, titleFallbackFieldKey = "", viewUrlTemplate = "", editUrlTemplate = "", newUrlTemplate = "", recordChangedEvents = [], listFilters = {}, listBulkActions = [], listRowActions = [], syntheticRows = null, routeQueryBlacklist = Object.freeze(["include", "cursor", "limit"]), requestQueryParams = null, requestFieldsets = null, readEnabled = true, requestRecoveryLabel = t("jskit.http.crud.records"), fallbackLoadError = t("jskit.http.crud.list.loadFailed") } = {})`
 Local functions
 - `buildCrudListActionContext(records, client)`
 - `formatCrudListCardValue(value)`
@@ -479,11 +483,11 @@ Local functions
 
 ### `src/client/composables/useCrudViewScreen.js`
 Exports
-- `useCrudViewScreen({ resource = null, resourceNamespace = "resource", apiUrlTemplate = "", recordIdParam = "recordId", titleFallbackFieldKey = "", listUrlTemplate = "", editUrlTemplate = "", recordChangedEvent = "", requestQueryParams = null, requestFieldsets = null, readEnabled = true, queryKeyFactory = null, requestRecoveryLabel = "Record", fallbackLoadError = "Unable to load record.", notFoundMessage = "Record not found." } = {})`
+- `useCrudViewScreen({ resource = null, resourceNamespace = "resource", apiUrlTemplate = "", recordIdParam = "recordId", titleFallbackFieldKey = "", listUrlTemplate = "", editUrlTemplate = "", recordChangedEvent = "", requestQueryParams = null, requestFieldsets = null, readEnabled = true, queryKeyFactory = null, requestRecoveryLabel = t("jskit.http.crud.record"), fallbackLoadError = t("jskit.http.crud.view.loadFailed"), notFoundMessage = t("jskit.http.crud.recordNotFound") } = {})`
 
 ### `src/client/composables/usePagedCollection.js`
 Exports
-- `usePagedCollection({ queryKey, enabled = true, initialPageParam = null, queryFn, getNextPageParam = defaultGetNextPageParam, selectItems = defaultSelectItems, dedupeBy = null, queryOptions = null, fallbackLoadError = "Unable to load list." } = {})`
+- `usePagedCollection({ queryKey, enabled = true, initialPageParam = null, queryFn, getNextPageParam = defaultGetNextPageParam, selectItems = defaultSelectItems, dedupeBy = null, queryOptions = null, fallbackLoadError = t("jskit.http.list.loadFailed") } = {})`
 - `trimInfinitePagesToFirst(data = null)`
 Local functions
 - `defaultSelectItems(page)`
@@ -522,6 +526,11 @@ Exports
 - `CRUD_LIST_FILTER_PRESENCE_OPTIONS`
 - `defineCrudListFilters`
 
+### `src/client/i18n.js`
+Exports
+- `createTextError`
+- `useJskitText`
+
 ### `src/client/index.js`
 Exports
 - `CrudAddEditScreen`

package/reference/autogen/packages/kernel.md

@@ -41,6 +41,20 @@ Local functions
 - `resolveProviderDependencies(provider, capabilities)`
 - `normalizeProviderOutputs(provider, value)`
 
+### `shared/i18n/index.js`
+Exports
+- `catalogMessage(catalog, key = "")`
+- `flattenCatalog(catalog, prefix = "")`
+- `formatMessage(template = "", params = {})`
+- `mergeCatalogs(...catalogs)`
+- `messageKeyForCode(code = "")`
+- `messageParams(template = "")`
+Local functions
+- `isRecord(value)`
+- `placeholderEnd(template, start)`
+- `parseMessage(template = "")`
+- `pluralChoice(count, choices)`
+
 ### `shared/index.js`
 Exports
 - `resolveLinkPath`
@@ -108,6 +122,8 @@ Exports
 - `normalizeQueryToken(value, { fallback = "__none__" } = {})`
 - `normalizeObject(value, { fallback = {} } = {})`
 - `normalizeIfInSource(source, normalized, fieldName, normalizer = (value) => value)`
+- `normalizeIfPresent(value, normalizer = (entry) => entry)`
+- `normalizeOrNull(value, normalizer = (entry) => entry)`
 - `isRecord(value)`
 - `normalizeArray(value)`
 - `normalizeUniqueTextList(value, { acceptSingle = false } = {})`
@@ -299,7 +315,9 @@ Exports
 - `resolveSchemaTransportSchemaDefinition`
 - `executeJsonRestSchemaDefinition`
 - `buildSchemaValidationError`
+- `codedFieldErrors`
 - `validateSchemaPayload`
+- `resolveValidationIssueCode`
 - `RECORD_ID_PATTERN`
 - `recordIdSchema`
 - `nullableRecordIdSchema`
@@ -322,7 +340,8 @@ Local functions
 - `requireJsonRestSchemaInstance(schemaDefinition = null, { context = "schema definition.schema" } = {})`
 - `resolveJsonRestSchemaFieldMessages(schemaDefinition = null, fieldName = "")`
 - `resolveJsonRestSchemaParentFieldMessages(schemaDefinition = null, fieldName = "")`
-- `resolveJsonRestSchemaFieldErrorMessage(fieldName, entry, schemaDefinition = null)`
+- `resolveFieldMessageOverride(messages, key)`
+- `resolveJsonRestSchemaFieldError(fieldName, entry, schemaDefinition = null)`
 
 ### `shared/validators/mergeObjectSchemas.js`
 Exports
@@ -356,9 +375,15 @@ Local functions
 
 ### `shared/validators/schemaPayloadValidation.js`
 Exports
-- `buildSchemaValidationError({ message = "Schema validation failed.", fieldErrors = null, errors = null, cause, statusCode = null } = {})`
+- `buildSchemaValidationError({ message = SCHEMA_VALIDATION_FAILED_MESSAGE, fieldErrors = null, fieldErrorCodes = null, errors = null, cause, statusCode = null } = {})`
+- `codedFieldErrors(error)`
+- `errorFieldErrors(error)`
 - `validateSchemaPayload(schemaDefinition, payload, { phase = "input", context = "schema definition", statusCode = null } = {})`
 
+### `shared/validators/validationIssueCodes.js`
+Exports
+- `resolveValidationIssueCode(issue = {})`
+
 ### client
 
 ### `client/appConfig.js`
@@ -376,12 +401,13 @@ Exports
 - `createAsyncModuleRecoveryState({ label = "App module", message = "", retry = null } = {})`
 - `dismissAsyncModuleRecovery(state)`
 - `dynamicImportErrorMessage(error = null, { label = "App module", stale = isDynamicImportError(error) } = {})`
-- `guardedReloadApp({ browserWindow = typeof window !== "undefined" ? window : null, fetchFn = typeof fetch === "function" ? fetch : null, state = null, label = "App", message = "The app cannot reload because the app server is not reachable. Restart the server, then click Retry or Reload." } = {})`
+- `guardedReloadApp({ browserWindow = typeof window !== "undefined" ? window : null, fetchFn = typeof fetch === "function" ? fetch : null, state = null, label = "App", message = RELOAD_UNAVAILABLE.message, messageCode = message === RELOAD_UNAVAILABLE.message ? RELOAD_UNAVAILABLE.messageCode : "", messageParams = {} } = {})`
 - `installAsyncModuleRecoveryHandlers({ router = null, state, label = "App module", onNotify = null, windowObject = typeof window !== "undefined" ? window : null } = {})`
 - `isDynamicImportError(error = null)`
-- `notifyAsyncModuleLoadError(state, error = null, { label = "App module", message = "", retry = null, stale = isDynamicImportError(error) } = {})`
+- `notifyAsyncModuleLoadError(state, error = null, { label = "App module", message = "", messageCode = "", messageParams = {}, retry = null, stale = isDynamicImportError(error) } = {})`
 Local functions
 - `errorText(error = null)`
+- `dynamicImportErrorMessageCode(label, stale)`
 
 ### `client/componentInteraction.js`
 Exports
@@ -393,11 +419,39 @@ Exports
 Local functions
 - `normalizeComponentId(value)`
 
+### `client/i18n.js`
+Exports
+- `createTextError(keyOrMessage = "", params = {})`
+- `registerJskitMessages(catalog = {})`
+- `setJskitI18n(i18n = null)`
+- `useJskitText()`
+Local functions
+- `registry()`
+- `mergeEnglishIntoI18n()`
+- `activeLocale()`
+- `pluralOptions(params)`
+- `t(key = "", params = {}, { locale } = {})`
+- `hasMessage(key = "")`
+- `text(value, options)`
+- `codedMessage(code, params = {}, sentEnglish = "")`
+- `serverMessage(source, fallback = "")`
+- `fieldErrorMessages(error)`
+- `validDate(value)`
+- `formatDate(value, options)`
+- `formatTime(value, options)`
+- `formatDateTime(value, options)`
+- `formatNumber(value, options)`
+- `formatRelativeTime(value, { now = Date.now(), ...options } = {})`
+
 ### `client/index.js`
 Exports
 - `getClientAppConfig`
 - `resolveMobileConfig`
 - `resolveClientAssetMode`
+- `createTextError`
+- `registerJskitMessages`
+- `setJskitI18n`
+- `useJskitText`
 - `createAsyncModuleRecoveryState`
 - `dismissAsyncModuleRecovery`
 - `dynamicImportErrorMessage`
@@ -455,7 +509,7 @@ Exports
 - `resolveClientBootstrapDebugEnabled({ env = {}, debugEnabled = undefined, debugEnvKey = "VITE_JSKIT_CLIENT_DEBUG" } = {})`
 - `createClientBootstrapLogger({ env = {}, logger = console, debugEnabled = undefined, debugEnvKey = "VITE_JSKIT_CLIENT_DEBUG" } = {})`
 - `createSurfaceShellRouter({ createRouter, history, routes = [], surfaceRuntime, surfaceMode, fallbackRoute = null, notFoundComponent = null, guard = false, scrollBehavior = shellScrollBehavior } = {})`
-- `bootstrapClientShellApp({ createApp, rootComponent, appConfig = {}, appPlugins = [], pinia = null, queryClient = null, router, bootClientModules, surfaceRuntime, surfaceMode, env = {}, fallbackRoute = null, logger = console, createBootstrapLogger = null, debugEnabled = undefined, debugEnvKey = "VITE_JSKIT_CLIENT_DEBUG", debugMessage = "Client modules bootstrapped before router install.", onAfterModulesBootstrapped = null, onAfterRouterReady = null, mountSelector = "#app" } = {})`
+- `bootstrapClientShellApp({ createApp, rootComponent, appConfig = {}, appPlugins = [], i18n = null, pinia = null, queryClient = null, router, bootClientModules, surfaceRuntime, surfaceMode, env = {}, fallbackRoute = null, logger = console, createBootstrapLogger = null, debugEnabled = undefined, debugEnvKey = "VITE_JSKIT_CLIENT_DEBUG", debugMessage = "Client modules bootstrapped before router install.", onAfterModulesBootstrapped = null, onAfterRouterReady = null, mountSelector = "#app" } = {})`
 Local functions
 - `installAppPlugins(app, appPlugins = [])`
 - `isSurfaceRootRecord(record)`
@@ -488,7 +542,8 @@ Exports
 - `bootInstalledClientModules(context = {})`
 - `CLIENT_BOOTSTRAP_VIRTUAL_ID`
 - `CLIENT_BOOTSTRAP_RESOLVED_ID`
-- `createVirtualModuleSource(clientModules = [])`
+- `createVirtualModuleSource(clientModules = [], localePackageIds = [])`
+- `resolveLocalePackageIds(installedPackages = [])`
 - `resolveClientOptimizeIncludeSpecifiers(clientModules = [], excludeSpecifiers = [])`
 - `resolveClientOptimizeExcludeSpecifiers(clientModules = [])`
 - `resolveCanonicalLocalPackageId(resolvedId, localPackage)`
@@ -590,6 +645,7 @@ Exports
 - `normalizeActionInput(definition, input)`
 - `normalizeActionOutput(definition, output)`
 Local functions
+- `schemaFieldErrorDetails(error)`
 - `createActionValidationError({ status = 400, message = "Validation failed.", code = "ACTION_VALIDATION_FAILED", details, cause } = {})`
 
 ### `server/actions/registry.js`
@@ -645,8 +701,11 @@ Local functions
 - `hasHeaderValue(headers = {}, key = "")`
 - `hasRequestBody(headers = {})`
 - `resolveValidationFieldErrors(error)`
+- `fieldErrorPayloadFields({ fieldErrors, fieldErrorCodes } = {})`
+- `messageCodeFields(error, expose = true)`
+- `hiddenServerErrorFields(code = "")`
 - `resolveRequestRouteTransport(request)`
-- `applyRouteTransportErrorResponse(reply, request, error, { statusCode = 500, normalizedErrorCode = "", message = error?.message, exposeDetails = true } = {})`
+- `applyRouteTransportErrorResponse(reply, request, error, { statusCode = 500, normalizedErrorCode = "", message = error?.message, exposeDetails = true, messageFields = {} } = {})`
 - `resolveApiErrorStatus(error, code)`
 - `applyErrorHeaders(reply, error)`
 
@@ -738,6 +797,14 @@ Local functions
 - `isJsonValue(value, ancestors = new Set())`
 - `schemaCacheKey(schema)`
 
+### `server/i18n.js`
+Exports
+- `createServerI18n({ appRoot = "", catalogs = [] } = {})`
+Local functions
+- `loadAppTranslations(appRoot)`
+- `appTranslations(appRoot)`
+- `localeCandidates(locale = "")`
+
 ### `server/platform/index.js`
 Exports
 - `registerSurfaceRequestConstraint`
@@ -798,6 +865,8 @@ Exports
 - `DomainValidationError`
 - `ConflictError`
 - `NotFoundError`
+Local functions
+- `normalizeErrorParams(params)`
 
 ### `server/runtime/EventProvider.js`
 Exports

package/reference/autogen/packages/mobile-capacitor.md

@@ -14,6 +14,11 @@ Use this on demand; do not load the full index at startup.
 
 ### src
 
+### `src/client/i18n.js`
+Exports
+- `createTextError`
+- `useJskitText`
+
 ### `src/client/index.js`
 Exports
 - `MobileCapacitorClientProvider`
@@ -35,7 +40,7 @@ Exports
 - `isCapacitorApiRequestTarget(url = "")`
 - `resolveCapacitorAbsoluteHttpUrl(url = "", apiBaseUrl = "", messages = {})`
 Local functions
-- `parseAbsoluteHttpUrl(url = "", { apiBaseUrl = "", emptyUrlMessage = "URL is required.", missingApiBaseUrlMessage = "config.mobile.apiBaseUrl is required.", invalidApiBaseUrlMessage = "config.mobile.apiBaseUrl must be a valid absolute URL.", invalidApiBaseUrlProtocolMessage = "config.mobile.apiBaseUrl must use http or https.", invalidUrlProtocolMessage = "URL must use http or https." } = {})`
+- `parseAbsoluteHttpUrl(url = "", { apiBaseUrl = "", emptyUrlMessage = "jskit.mobile.apiRequest.urlRequired", missingApiBaseUrlMessage = "jskit.mobile.apiRequest.apiBaseUrlRequired", invalidApiBaseUrlMessage = "jskit.mobile.apiRequest.apiBaseUrlInvalid", invalidApiBaseUrlProtocolMessage = "jskit.mobile.apiRequest.apiBaseUrlProtocol", invalidUrlProtocolMessage = "jskit.mobile.apiRequest.urlProtocol" } = {})`
 - `normalizeFetchInput(input = "")`
 
 ### `src/client/runtime/globalCapacitorAppAdapter.js`

package/reference/autogen/packages/payments-core.md

@@ -58,7 +58,7 @@ Exports
 - `createPaymentService({ store, configuration, clock = Date.now })`
 - `PaymentError`
 Local functions
-- `fail(code, message, status)`
+- `fail(code, message, status, options)`
 - `reference(value)`
 - `units(value)`
 - `timestamp(value)`
@@ -78,7 +78,7 @@ Local functions
 Exports
 - `validatePaymentConfiguration(document)`
 Local functions
-- `configurationError(message, fieldErrors)`
+- `configurationError(message, fieldErrors, { messageCode, messageParams = {} })`
 
 ### migrations
 

package/reference/autogen/packages/payments-web.md

@@ -18,12 +18,20 @@ Use this on demand; do not load the full index at startup.
 Exports
 - None
 Local functions
+- `historyTitle(item)`
+- `historyTotal(item)`
+- `statusLabel(status)`
+- `locale()`
 - `number(value)`
 - `date(value)`
 - `planName(id)`
 - `checkout(plan)`
 - `loadHistory(collection, after = null)`
 
+### `src/client/i18n.js`
+Exports
+- `useJskitText`
+
 ### fixtures
 
 ### `fixtures/payment-account/main.js`