@jskit-ai/agent-docs 0.1.46 → 0.1.47

package/guide/agent/app-setup/a-more-interesting-shell.md

@@ -211,9 +211,11 @@ There are two different paths to keep straight:
 1. placement and menu metadata such as `src/placement.js`
 2. direct Vuetify icon props inside normal `.vue` components
 
-In placement metadata, raw `mdi-*` strings are acceptable because the shell menu runtime normalizes them before Vuetify renders the icon. A menu entry like this is fine:
+For placement metadata, prefer importing app-specific icons from `@mdi/js` in the placement file itself. The shell menu runtime accepts the resolved SVG path value and passes it through to Vuetify:
 
 ```js
+import { mdiAccountCircleOutline } from "@mdi/js";
+
 addPlacement({
   id: "home.settings.profile.link",
   target: "page.section-nav",
@@ -223,18 +225,18 @@ addPlacement({
   props: {
     label: "Profile",
     to: "./profile",
-    icon: "mdi-account-circle-outline"
+    icon: mdiAccountCircleOutline
   }
 });
 ```
 
-But do not copy that same string into a normal Vue component:
+Do not copy raw `mdi-*` strings into a normal Vue component:
 
 ```vue
 <v-list-item prepend-icon="mdi-account-circle-outline" />
 ```
 
-JSKIT apps use Vuetify's SVG MDI renderer, so direct Vue icon props should use an `@mdi/js` path or a Vuetify alias instead:
+JSKIT apps use Vuetify's SVG MDI renderer, so direct Vue icon props should use the same `@mdi/js` path or a Vuetify alias instead:
 
 ```vue
 <script setup>
@@ -246,7 +248,8 @@ import { mdiAccountCircleOutline } from "@mdi/js";
 
 So the practical rule is:
 
-- editing `src/placement.js` or other shell menu metadata: `mdi-*` strings are fine
+- editing `src/placement.js` or other shell menu metadata: import app-specific icons from `@mdi/js` and pass the constant
+- raw `mdi-*` metadata strings are only safe for shell-web's small core normalized icon map
 - editing a normal `.vue` file: use `@mdi/js` or a Vuetify alias such as `$close`
 
 Later in the guide, `jskit doctor` will help catch the second mistake automatically.

package/guide/agent/app-setup/working-with-the-jskit-cli.md

@@ -686,13 +686,15 @@ That last check is narrower than it sounds. `doctor` is looking for the broken c
 <v-icon icon="mdi-paw" />
 ```
 
-It does not flag the normal menu-metadata case in `src/placement.js`, where a shell menu link may still use:
+It does not flag `src/placement.js` menu metadata because shell menu links normalize a small core icon map and also accept imported `@mdi/js` path constants. For app-specific icons, prefer a local import:
 
 ```js
-icon: "mdi-cog-outline"
+import { mdiPaw } from "@mdi/js";
+
+icon: mdiPaw
 ```
 
-because the shell runtime normalizes that metadata before Vuetify renders it. So if you see a `doctor` icon warning, the fix is usually "switch this Vue component to `@mdi/js`", not "remove every `mdi-*` string from the app."
+So if you see a `doctor` icon warning, the fix is usually "switch this Vue component to `@mdi/js`", not "centralize every icon in the app."
 
 In other words, `doctor` helps catch drift between:
 

package/guide/agent/generators/ui-generators.md

@@ -100,20 +100,23 @@ normally get adjusted.
 
 The important icon rule is this:
 
-- inside `src/placement.js` menu metadata, raw `mdi-*` strings are fine
-- inside normal Vue component props, they are not
+- inside `src/placement.js` menu metadata, import app-specific icons from `@mdi/js` and pass the path constant
+- only use raw `mdi-*` strings for the small set of shell-web core icons that JSKIT normalizes
+- inside normal Vue component props, use the same `@mdi/js` path constants or a Vuetify alias
 
 So this is a valid menu-placement customization:
 
 ```js
+import { mdiChartBoxOutline } from "@mdi/js";
+
 props: {
   label: "Reports",
   to: "/reports",
-  icon: "mdi-chart-box-outline"
+  icon: mdiChartBoxOutline
 }
 ```
 
-But if you later open the generated page file itself and add a Vuetify icon to the template, switch back to `@mdi/js`:
+If you later open the generated page file itself and add a Vuetify icon to the template, use the same `@mdi/js` pattern:
 
 ```vue
 <script setup>
@@ -123,7 +126,7 @@ import { mdiChartBoxOutline } from "@mdi/js";
 <v-icon :icon="mdiChartBoxOutline" />
 ```
 
-This split matters because JSKIT's shell menu components normalize menu metadata icons for you, while direct Vue icon props go straight to Vuetify.
+This keeps icon imports local and tree-shakeable. Do not import the whole `@mdi/js` namespace just to look up icon names dynamically.
 
 ## What `page` is really good at
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/agent-docs",
-  "version": "0.1.46",
+  "version": "0.1.47",
   "description": "Distributed JSKIT agent references, prompts, guides, and generated reference maps.",
   "type": "module",
   "files": [

package/reference/autogen/KERNEL_MAP.md

@@ -106,6 +106,7 @@ Exports
 - `normalizeCrudLookupApiPath(value = "")`
 - `normalizeCrudLookupNamespace(value = "")`
 - `resolveCrudLookupApiPathFromNamespace(value = "")`
+- `resolveCrudResourceScopeName(value = "")`
 - `normalizeCrudLookupContainerKey(value, { defaultValue = DEFAULT_CRUD_LOOKUP_CONTAINER_KEY, context = "crud lookup container key" } = {})`
 - `resolveCrudLookupContainerKey(resource = {}, options = {})`
 - `resolveCrudLookupFieldKeys(resource = {}, { allowKeys = [] } = {})`

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

@@ -176,6 +176,18 @@ Exports
 - `AUTH_ACCESS_TOKEN_MAX_LENGTH`
 - `AUTH_REFRESH_TOKEN_MAX_LENGTH`
 
+### `src/shared/authDenied.js`
+Exports
+- `AUTH_DENIED_CODE_MAX_LENGTH`
+- `AUTH_DENIED_CODE_PATTERN`
+- `AUTH_DENIED_CODES`
+- `AUTH_DENIED_DEFAULT_MESSAGES`
+- `AUTH_DENIED_LOGIN_MESSAGES`
+- `AUTH_DENIED_MESSAGE_MAX_LENGTH`
+- `normalizeAuthDenied(input = null)`
+- `normalizeAuthDeniedCode(value = "")`
+- `resolveAuthDeniedLoginMessage(input = null)`
+
 ### `src/shared/authMethods.js`
 Exports
 - `AUTH_METHOD_PASSWORD_ID`
@@ -234,6 +246,7 @@ Exports
 - `devLoginAsOutputValidator`
 - `logoutOutputValidator`
 - `oauthProviderCatalogEntryOutputValidator`
+- `authDeniedOutputSchema`
 - `sessionOutputValidator`
 - `sessionUnavailableOutputValidator`
 - `createCommandMessages({ fields = {}, defaultMessage = "Invalid value." } = {})`
@@ -347,6 +360,11 @@ Exports
 Exports
 - `createApi`
 - `runAuthSignOutFlow`
+- `AUTH_DENIED_CODES`
+- `AUTH_DENIED_DEFAULT_MESSAGES`
+- `AUTH_DENIED_LOGIN_MESSAGES`
+- `normalizeAuthDenied`
+- `resolveAuthDeniedLoginMessage`
 - `AUTH_PATHS`
 - `buildAuthOauthStartPath`
 

package/reference/autogen/packages/auth-provider-supabase-core.md

@@ -194,7 +194,7 @@ Local functions
 Exports
 - `buildSupabaseServerClientOptions(options = {})`
 Local functions
-- `resolveRealtimeTransport({ nativeWebSocket = globalThis.WebSocket, fallbackTransport = WebSocket } = {})`
+- `resolveRealtimeTransport(options = {})`
 
 ### `src/server/lib/test-utils.js`
 Exports

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

@@ -300,13 +300,19 @@ Local functions
 - `isRecord(value)`
 - `resolveSchemaFieldDefinitions(definition = null)`
 - `resolveJsonApiRelationshipEntries(definition = null)`
+- `readOwnValue(source = {}, key = "")`
+- `resolveLookupContainer(record = {}, lookupContainerKey = "")`
+- `resolveRelationshipValueSource(record = {}, entry = {}, { lookupContainerKey = "", preferLookup = false } = {})`
+- `normalizeLookupId(value)`
+- `normalizeRelationshipIdentifierId(value = null)`
+- `createRelationshipIdentifier(entry = {}, value = null)`
 - `createRecordAttributesResolver(definition = null, { excludeKeys = [] } = {})`
-- `createRecordRelationshipsResolver(definition = null)`
+- `createRecordRelationshipsResolver(definition = null, { lookupContainerKey = "" } = {})`
 - `createRequestRelationshipMapper(definition = null)`
 - `resolveOutputAttributeExcludeKeys(resource = {})`
 - `resolveLookupContainerKey(resource = {})`
-- `normalizeLookupId(value)`
 - `normalizeIncludedLookupRecord(source = null, fallbackId = null)`
+- `appendIncludedRelationshipResource({ included = [], seen = new Set(), entry = {}, lookupRecord = null, fallbackId = null } = {})`
 - `createLookupIncludedResolver(definition = null, { lookupContainerKey = "" } = {})`
 
 ### `src/server/serviceEvents.js`

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

@@ -282,7 +282,7 @@ Local functions
 - `resolveRouteTypes(value = {})`
 - `resolveEmbeddedAttributesTransportSchema(definition, { context = "JSON:API resource", defaultMode = "replace", removeId = false, removeKeys = [] } = {})`
 - `normalizeRelationshipSchemaEntries(entries = [])`
-- `createJsonApiRelationshipDataSchema(relationshipType = "", { nullable = false } = {})`
+- `createJsonApiRelationshipDataSchema(relationshipType = "", { many = false, nullable = false } = {})`
 - `createJsonApiRelationshipsTransportSchema(entries = [], { includeRequired = false } = {})`
 - `createJsonApiMetaSuccessTransportSchema({ meta } = {})`
 - `defaultRecordTypeResolver(type)`

package/reference/autogen/packages/json-rest-api-core.md

@@ -42,6 +42,7 @@ Local functions
 - `normalizeJsonRestText(value, { fallback = "" } = {})`
 - `normalizeJsonRestObject(value)`
 - `normalizeJsonRestList(value)`
+- `resolveJsonRestCollectionRelationships(resource = {})`
 - `extractJsonApiInputRelationships(attributes = {}, resource = null, relationships = null)`
 
 ### root

package/reference/autogen/packages/kernel.md

@@ -270,6 +270,7 @@ Exports
 - `normalizeCrudLookupApiPath(value = "")`
 - `normalizeCrudLookupNamespace(value = "")`
 - `resolveCrudLookupApiPathFromNamespace(value = "")`
+- `resolveCrudResourceScopeName(value = "")`
 - `normalizeCrudLookupContainerKey(value, { defaultValue = DEFAULT_CRUD_LOOKUP_CONTAINER_KEY, context = "crud lookup container key" } = {})`
 - `resolveCrudLookupContainerKey(resource = {}, options = {})`
 - `resolveCrudLookupFieldKeys(resource = {}, { allowKeys = [] } = {})`
@@ -1532,5 +1533,6 @@ Exports
 - `loadInstalledPackageDescriptor({ appRoot, packageId, installedPackageState, required = false })`
 - `resolveDescriptorPathForInstalledPackage({ appRoot, packageId, installedPackageState, required = false })`
 Local functions
+- `resolveNodeModulesDescriptorCandidatePaths({ appRoot, packageId })`
 - `resolveDescriptorCandidatePaths({ appRoot, packageId, installedPackageState })`
 - `normalizeDescriptorPayload(descriptorModule)`

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

@@ -353,6 +353,12 @@ Local functions
 - `isRelativeMenuLinkTarget(target = "")`
 - `surfaceRequiresWorkspaceFromPlacementContext(contextValue = null, surfaceId = "")`
 
+### `src/client/support/routeTransitionKey.js`
+Exports
+- `resolveShellRouteTransitionKey({ routePathKey = "", routeTransitionName = "", surfaceId = "" } = {})`
+Local functions
+- `normalizeText(value = "")`
+
 ### `src/server/support/localLinkItemScaffolds.js`
 Exports
 - `LOCAL_LINK_ITEM_COMPONENT_DEFINITIONS`

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

@@ -95,10 +95,6 @@ Local functions
 - `submitMemberRoleUpdate(member, roleSid)`
 - `submitRemoveMember(member)`
 
-### `src/client/components/WorkspaceProfileClientElement.vue`
-Exports
-- None
-
 ### `src/client/components/WorkspacesClientElement.vue`
 Exports
 - None
@@ -115,26 +111,6 @@ Local functions
 - `createWorkspace()`
 - `refreshBootstrap()`
 
-### `src/client/components/WorkspaceSettingsClientElement.vue`
-Exports
-- None
-Local functions
-- `toWorkspaceEntrySnapshot(entry = null)`
-- `toWorkspaceListSnapshot(list = [])`
-- `toWorkspaceSettingsSnapshot(settings = null)`
-- `applyShellWorkspaceContext(payload = {})`
-- `handleFormSaved()`
-
-### `src/client/components/WorkspaceSettingsFieldsClientElement.vue`
-Exports
-- None
-
-### `src/client/composables/useBootstrapQuery.js`
-Exports
-- `useBootstrapQuery({ workspaceSlug = "", enabled = true, staleTime = DEFAULT_BOOTSTRAP_STALE_TIME_MS, refetchOnMount = false, refetchOnWindowFocus = false } = {})`
-Local functions
-- `normalizeStaleTime(value, fallback = DEFAULT_BOOTSTRAP_STALE_TIME_MS)`
-
 ### `src/client/composables/useWorkspaceRouteContext.js`
 Exports
 - `useWorkspaceRouteContext()`

package/reference/autogen/tooling/jskit-cli.md

@@ -770,24 +770,34 @@ Local functions
 Exports
 - `HELPER_MAP_JSON_RELATIVE_PATH`
 - `HELPER_MAP_MARKDOWN_RELATIVE_PATH`
-- `buildHelperMap({ targetRoot })`
+- `buildHelperMap({ targetRoot, previousMap = null })`
 - `readHelperMap({ targetRoot })`
 - `updateHelperMap({ targetRoot })`
 Local functions
 - `pathExists(filePath)`
 - `readJsonFile(filePath)`
+- `readFileHash(filePath)`
 - `normalizePackageDependencies(packageJson = {})`
 - `classifySymbol(name = "")`
 - `createExportAnalysisProject()`
-- `kindFromDeclaration(declaration, exportName = "")`
 - `addSymbol(symbols, symbol)`
+- `compilerNodeHasModifier(node, modifierKind)`
+- `exportedDeclarationName(node)`
+- `addExportedDeclarationSymbol(symbols, node, kind = "export")`
+- `bindingNameTexts(bindingName, names = [])`
+- `addVariableStatementExports(symbols, statement)`
+- `addNamedExportSymbols(symbols, exportClause)`
 - `extractExportedSymbols(sourceFile)`
 - `extractVueScriptSource(source = "", filePath = "")`
 - `addCodeFileToProject(project, file)`
 - `walkCodeFiles(rootPath, relativeRoot = "")`
 - `collectAppExports(targetRoot)`
 - `flattenPackageExports(exportsField)`
-- `collectJskitPackageExports(targetRoot, packageJson = {})`
+- `packageExportTargetRecords(packageRoot, exportTargets = [])`
+- `packageExportFingerprint({ installedPackageJson = {}, packageName = "", targetRecords = [] } = {})`
+- `cachedPackageExports(previousPackagesByName = new Map(), packageName = "", fingerprint = "")`
+- `previousPackageMap(previousMap = null)`
+- `collectJskitPackageExports(targetRoot, packageJson = {}, previousMap = null)`
 - `renderExportList(symbols = [])`
 - `renderHelperMapMarkdown(map)`