@jskit-ai/agent-docs 0.1.26 → 0.1.28

package/reference/autogen/packages/google-rewarded-core.md

@@ -0,0 +1,222 @@
+# packages/google-rewarded-core
+
+Generated by `npm run agent-docs:build`.
+Do not edit manually.
+
+Generated inventory for `packages/google-rewarded-core`.
+Use this on demand; do not load the full index at startup.
+
+## Scope
+- Source: `packages/google-rewarded-core/**/*{.js,.mjs,.cjs,.vue}`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+
+## Sections
+
+### src
+
+### `src/server/actions.js`
+Exports
+- `ACTION_CURRENT`
+- `ACTION_START`
+- `ACTION_GRANT`
+- `ACTION_CLOSE`
+- `googleRewardedActions`
+
+### `src/server/GoogleRewardedCoreProvider.js`
+Exports
+- `GoogleRewardedCoreProvider`
+
+### `src/server/inputSchemas.js`
+Exports
+- `currentQueryInputValidator`
+- `startCommandInputValidator`
+- `grantCommandInputValidator`
+- `closeCommandInputValidator`
+- `currentStateOutputValidator`
+- `startGateOutputValidator`
+- `grantRewardOutputValidator`
+- `closeSessionOutputValidator`
+Local functions
+- `createGateStateOutputValidator({ includeSession = false } = {})`
+
+### `src/server/providerConfigs/actions.js`
+Exports
+- `createActions({ surface } = {})`
+
+### `src/server/providerConfigs/GoogleRewardedProviderConfigsProvider.js`
+Exports
+- `GoogleRewardedProviderConfigsProvider`
+Local functions
+- `resolveCrudPolicyFromApp(app)`
+
+### `src/server/providerConfigs/registerRoutes.js`
+Exports
+- `registerRoutes(app, { routeOwnershipFilter = "public", routeSurface = "", routeRelativePath = "" } = {})`
+
+### `src/server/providerConfigs/repository.js`
+Exports
+- `createRepository({ api, knex } = {})`
+
+### `src/server/providerConfigs/service.js`
+Exports
+- `createService({ googleRewardedProviderConfigsRepository } = {})`
+Local functions
+- `return404IfNotFound(document = null)`
+
+### `src/server/registerRoutes.js`
+Exports
+- `registerRoutes(app, { routeOwnershipFilter = "workspace_user", routeSurface = "app", routeRelativePath = "google-rewarded" } = {})`
+Local functions
+- `createWorkflowResponses(outputValidator)`
+
+### `src/server/rules/actions.js`
+Exports
+- `createActions({ surface } = {})`
+
+### `src/server/rules/GoogleRewardedRulesProvider.js`
+Exports
+- `GoogleRewardedRulesProvider`
+Local functions
+- `resolveCrudPolicyFromApp(app)`
+
+### `src/server/rules/registerRoutes.js`
+Exports
+- `registerRoutes(app, { routeOwnershipFilter = "public", routeSurface = "", routeRelativePath = "" } = {})`
+
+### `src/server/rules/repository.js`
+Exports
+- `createRepository({ api, knex } = {})`
+
+### `src/server/rules/service.js`
+Exports
+- `createService({ googleRewardedRulesRepository } = {})`
+Local functions
+- `return404IfNotFound(document = null)`
+
+### `src/server/service.js`
+Exports
+- `createService({ googleRewardedRulesRepository, googleRewardedProviderConfigsRepository, googleRewardedWatchSessionsRepository, googleRewardedUnlockReceiptsRepository } = {})`
+Local functions
+- `resolveActionUser(context, input)`
+- `normalizeRecordList(document = null)`
+- `normalizeRecord(document = null)`
+- `normalizeGateKey(value = "")`
+- `normalizeSurface(value = "", { fallback = GOOGLE_REWARDED_SURFACE } = {})`
+- `toIsoOrNull(value = null)`
+- `parseDate(value = null)`
+- `addMinutes(date, minutes)`
+- `startOfUtcDay(date)`
+- `requireActor(context, input)`
+- `requireWorkspaceSlug(input = {})`
+- `requireGateKey(input = {})`
+- `formatRule(rule = null)`
+- `formatProviderConfig(record = null)`
+- `formatWatchSession(record = null)`
+- `formatUnlockReceipt(record = null)`
+- `isFutureDate(value = null, now = new Date())`
+
+### `src/server/support/requireGoogleRewardedUnlock.js`
+Exports
+- `requireGoogleRewardedUnlock(googleRewardedService, input = {}, { context = null, requireConfigured = false, errorCode = "", errorMessage = "" } = {})`
+Local functions
+- `normalizeReason(value = "")`
+- `isUnlockSatisfied(gateState = null)`
+- `hasBooleanGateFlag(gateState, key)`
+- `assertWellFormedGateState(gateState = null)`
+- `isConfigurationBypassAllowed(gateState = null, requireConfigured = false)`
+- `createRewardedGateError(gateState = null, { errorCode = "", errorMessage = "" } = {})`
+
+### `src/server/unlockReceipts/actions.js`
+Exports
+- `createActions({ surface } = {})`
+
+### `src/server/unlockReceipts/GoogleRewardedUnlockReceiptsProvider.js`
+Exports
+- `GoogleRewardedUnlockReceiptsProvider`
+Local functions
+- `resolveCrudPolicyFromApp(app)`
+
+### `src/server/unlockReceipts/registerRoutes.js`
+Exports
+- `registerRoutes(app, { routeOwnershipFilter = "public", routeSurface = "", routeRelativePath = "" } = {})`
+
+### `src/server/unlockReceipts/repository.js`
+Exports
+- `createRepository({ api, knex } = {})`
+
+### `src/server/unlockReceipts/service.js`
+Exports
+- `createService({ googleRewardedUnlockReceiptsRepository } = {})`
+Local functions
+- `return404IfNotFound(document = null)`
+
+### `src/server/watchSessions/actions.js`
+Exports
+- `createActions({ surface } = {})`
+
+### `src/server/watchSessions/GoogleRewardedWatchSessionsProvider.js`
+Exports
+- `GoogleRewardedWatchSessionsProvider`
+Local functions
+- `resolveCrudPolicyFromApp(app)`
+
+### `src/server/watchSessions/registerRoutes.js`
+Exports
+- `registerRoutes(app, { routeOwnershipFilter = "public", routeSurface = "", routeRelativePath = "" } = {})`
+
+### `src/server/watchSessions/repository.js`
+Exports
+- `createRepository({ api, knex } = {})`
+
+### `src/server/watchSessions/service.js`
+Exports
+- `createService({ googleRewardedWatchSessionsRepository } = {})`
+Local functions
+- `return404IfNotFound(document = null)`
+
+### `src/shared/googleRewardedProviderConfigResource.js`
+Exports
+- `resource`
+
+### `src/shared/googleRewardedRuleResource.js`
+Exports
+- `resource`
+
+### `src/shared/googleRewardedUnlockReceiptResource.js`
+Exports
+- `resource`
+
+### `src/shared/googleRewardedWatchSessionResource.js`
+Exports
+- `resource`
+
+### `src/shared/index.js`
+Exports
+- `googleRewardedRuleResource`
+- `googleRewardedProviderConfigResource`
+- `googleRewardedWatchSessionResource`
+- `googleRewardedUnlockReceiptResource`
+
+### templates
+
+### `templates/migrations/google_rewarded_provider_configs_initial.cjs`
+Exports
+- None
+
+### `templates/migrations/google_rewarded_rules_initial.cjs`
+Exports
+- None
+
+### `templates/migrations/google_rewarded_unlock_receipts_initial.cjs`
+Exports
+- None
+
+### `templates/migrations/google_rewarded_watch_sessions_initial.cjs`
+Exports
+- None
+
+### root
+
+### `package.descriptor.mjs`
+Exports
+- None

package/reference/autogen/packages/google-rewarded-web.md

@@ -0,0 +1,71 @@
+# packages/google-rewarded-web
+
+Generated by `npm run agent-docs:build`.
+Do not edit manually.
+
+Generated inventory for `packages/google-rewarded-web`.
+Use this on demand; do not load the full index at startup.
+
+## Scope
+- Source: `packages/google-rewarded-web/**/*{.js,.mjs,.cjs,.vue}`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+
+## Sections
+
+### src
+
+### `src/client/components/GoogleRewardedGateHost.vue`
+Exports
+- None
+Local functions
+- `handleWatchClick()`
+- `handleCancelClick()`
+- `handleDismissError()`
+
+### `src/client/composables/useGoogleRewardedRuntime.js`
+Exports
+- `useGoogleRewardedRuntime()`
+
+### `src/client/index.js`
+Exports
+- `GoogleRewardedClientProvider`
+- `GoogleRewardedGateHost`
+- `GOOGLE_REWARDED_RUNTIME_INJECTION_KEY`
+- `createGoogleRewardedRuntime`
+- `useGoogleRewardedRuntime`
+
+### `src/client/providers/GoogleRewardedClientProvider.js`
+Exports
+- `GoogleRewardedClientProvider`
+
+### `src/client/runtime/googleRewardedRuntime.js`
+Exports
+- `GOOGLE_REWARDED_RUNTIME_INJECTION_KEY`
+- `createGoogleRewardedRuntime()`
+Local functions
+- `createInitialState()`
+- `applyState(target, source)`
+- `normalizeWorkspaceSlug(value = "")`
+- `isWellFormedGateState(gateState = null)`
+- `buildApiPath(workspaceSlug = "", action = "", query = null)`
+- `ensureGooglePublisherTagLoaded()`
+- `launchRewardedSlot({ adUnitPath = "", onReady = null, onGranted = null, onClosed = null, onUnavailable = null } = {})`
+- `requestCurrent(input = {})`
+
+### `src/index.js`
+Exports
+- None
+
+### `src/server/index.js`
+Exports
+- None
+
+### `src/shared/index.js`
+Exports
+- None
+
+### root
+
+### `package.descriptor.mjs`
+Exports
+- None

package/reference/autogen/packages/kernel.md

@@ -288,6 +288,35 @@ Exports
 Exports
 - `formatDateTime(value, { fallback = "unknown" } = {})`
 
+### `shared/support/generatedUiContract.js`
+Exports
+- `GENERATED_UI_FORBIDDEN_CARD_SHELL_PATTERNS`
+- `GENERATED_UI_FORBIDDEN_LIVE_COPY_PATTERNS`
+- `GENERATED_UI_NAVIGATION_ROLE_DEFAULT`
+- `GENERATED_UI_NAVIGATION_ROLE_LINK_PLACEMENTS`
+- `GENERATED_UI_NAVIGATION_ROLE_OPTION`
+- `GENERATED_UI_NAVIGATION_ROLE_VALUES`
+- `GENERATED_UI_NO_LINK_NAVIGATION_ROLES`
+- `GENERATED_UI_SOURCE_CONTRACT_PROFILES`
+- `GENERATED_UI_SURFACE_PROFILES`
+- `assertGeneratedUiSourceContract(source = "", options = {})`
+- `buildGeneratedUiScreenClassName(baseClassName = "", { surfaceProfile = "" } = {})`
+- `collectGeneratedUiSourceContractIssues(source = "", { profile = "", forbidLiveCopy = undefined, forbidCardShell = undefined, forbiddenPatterns = [], requiredPatterns = [] } = {})`
+- `inferGeneratedUiNavigationRole(options = {}, { dynamicRoutePolicy = "leaf", routePath = "" } = {})`
+- `isGeneratedUiNoLinkNavigationRole(value = "")`
+- `normalizeGeneratedUiNavigationRole(value = "")`
+- `resolveGeneratedUiSurfaceProfile(surfaceProfile = "")`
+- `resolveGeneratedUiNavigationRoleLinkPlacement(options = {}, inferenceContext = {})`
+- `shouldCreateGeneratedUiNavigationLink(options = {}, { allowLinkTo = false, dynamicRoutePolicy = "leaf", routePath = "" } = {})`
+Local functions
+- `matchesGeneratedUiContractPattern(source = "", pattern)`
+- `normalizeGeneratedUiContractPattern(patternEntry = {}, fallbackMessage = "")`
+- `normalizeGeneratedUiContractPatternList(patternEntries = [], fallbackMessage = "")`
+- `resolveGeneratedUiSourceContractProfile(profile = "")`
+- `hasExplicitGeneratedUiNavigationRole(options = {})`
+- `normalizeGeneratedUiRouteSegments(routePath = "")`
+- `isGeneratedUiDynamicRouteSegment(routeSegment = "")`
+
 ### `shared/support/index.js`
 Exports
 - `isRecord`
@@ -338,6 +367,10 @@ Exports
 - `normalizeRecordId(value, { fallback = null } = {})`
 - `normalizeOpaqueId(value, { fallback = null } = {})`
 - `normalizeOneOf(value, allowedValues = [], fallback = "")`
+- `normalizeMobileAssetMode(value = "", { fallback = "bundled" } = {})`
+- `normalizeMobileCallbackPath(value = "", { fallback = "/auth/login" } = {})`
+- `normalizeMobileConfig(source = {})`
+- `normalizeMobileStrategy(value = "", { fallback = "" } = {})`
 - `ensureNonEmptyText(value, label = "value")`
 
 ### `shared/support/permissions.js`
@@ -393,14 +426,26 @@ Local functions
 
 ### `shared/support/shellLayoutTargets.js`
 Exports
+- `PLACEMENT_LAYOUT_CLASSES`
 - `describeShellOutletTargets(targets = [])`
-- `discoverShellOutletTargetsFromVueSource(source = "", { context = "shell layout" } = {})`
+- `discoverShellOutletTargetsFromVueSource(source = "", { context = "shell layout", enforceSingleDefault = true } = {})`
 - `findShellOutletTargetById(targets = [], targetId = "")`
+- `normalizePlacementKind(value = "")`
+- `normalizePlacementLayoutClass(value = "")`
+- `normalizePlacementOwnerId(value = "")`
+- `normalizePlacementSurfaceId(value = "")`
+- `normalizePlacementSurfaces(value)`
+- `normalizePlacementTopologyDefinition(value = {}, { context = "placement topology" } = {})`
+- `normalizePlacementTopologyEntry(value = {}, { context = "placement topology" } = {})`
+- `normalizePlacementTopologyVariant(value = {}, { context = "placement topology variant" } = {})`
+- `normalizeSemanticPlacementId(value = "")`
 - `normalizeShellOutletTargetId(value = "")`
 - `normalizeShellOutletTargetRecord(value = {}, { context = "shell layout" } = {})`
+- `resolvePlacementTargetReference(value = "")`
 - `resolveShellOutletTargetParts({ target = "" } = {})`
 Local functions
 - `parseTagAttributes(attributesSource = "")`
+- `normalizePlacementRenderers(value = {})`
 - `isDefaultAttributeEnabled(value)`
 
 ### `shared/support/sorting.js`
@@ -606,6 +651,8 @@ Exports
 - `CLIENT_APP_CONFIG_GLOBAL_KEY`
 - `setClientAppConfig(source = {})`
 - `getClientAppConfig()`
+- `resolveMobileConfig(appConfig = getClientAppConfig())`
+- `resolveClientAssetMode(appConfig = getClientAppConfig())`
 Local functions
 - `normalizeClientAppConfig(source = {})`
 
@@ -623,6 +670,10 @@ Exports
 ### `client/index.js`
 Exports
 - `getClientAppConfig`
+- `resolveMobileConfig`
+- `resolveClientAssetMode`
+- `normalizeIncomingAppUrl`
+- `registerMobileLaunchRouting`
 - `resolveClientBootstrapDebugEnabled`
 - `createShellRouter`
 - `bootstrapClientShellApp`
@@ -633,9 +684,19 @@ Exports
 - `createStructuredLogger(logger = console)`
 - `summarizeRouterRoutes(router)`
 
+### `client/mobileLaunchRouting.js`
+Exports
+- `normalizeIncomingAppUrl(url = "", mobileConfig = {}, { currentOrigin = "", allowedHttpOrigins = [] } = {})`
+- `registerMobileLaunchRouting({ router, mobileConfig = {}, getInitialLaunchUrl = async () => "", subscribeToLaunchUrls = () => () => {}, resolveTargetPath = null, currentOrigin = typeof window === "object" && window?.location ? String(window.location.origin || "") : "", allowedHttpOrigins = [], logger = null } = {})`
+Local functions
+- `buildNormalizedRoutePath(pathname = "/", search = "", hash = "")`
+- `normalizeResolvedRoutePath(value = "", fallback = "")`
+- `normalizeAllowedHttpOrigins({ mobileConfig = {}, currentOrigin = "", allowedHttpOrigins = [] } = {})`
+- `normalizeCustomSchemeRoutePath(parsedUrl)`
+
 ### `client/moduleBootstrap.js`
 Exports
-- `bootClientModules({ clientModules = [], app, pinia = null, router, surfaceRuntime, surfaceMode, env, logger = console } = {})`
+- `bootClientModules({ clientModules = [], app, pinia = null, queryClient = null, router, surfaceRuntime, surfaceMode, env, logger = console } = {})`
 Local functions
 - `normalizePackageId(value)`
 - `toRouteSnapshot(route)`
@@ -652,7 +713,7 @@ Local functions
 - `assertRoutesDeclaredInDescriptor({ packageId, source, normalizedRoutes = [], descriptorRouteDeclarations = null } = {})`
 - `resolveDescriptorClientRoutes({ packageId, descriptorUiRoutes = [], routeComponents = {}, logger = null } = {})`
 - `normalizeClientModuleEntries(clientModules)`
-- `createClientRuntimeApp({ profile = "client", app, pinia = null, router, env, logger, surfaceRuntime, surfaceMode } = {})`
+- `createClientRuntimeApp({ profile = "client", app, pinia = null, queryClient = null, router, env, logger, surfaceRuntime, surfaceMode } = {})`
 
 ### `client/pageRedirects.js`
 Exports
@@ -665,7 +726,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 } = {})`
-- `bootstrapClientShellApp({ createApp, rootComponent, appConfig = {}, appPlugins = [], pinia = 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, mountSelector = "#app" } = {})`
+- `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" } = {})`
 Local functions
 - `installAppPlugins(app, appPlugins = [])`
 
@@ -1275,9 +1336,17 @@ Exports
 - `resolveAppConfig(scope = null)`
 - `normalizeDefaultSurfaceId(value, { fallback = "" } = {})`
 - `resolveDefaultSurfaceId(scope = null, { defaultSurfaceId = "" } = {})`
+- `resolveMobileConfig(source = null)`
+- `resolveClientAssetMode(source = null)`
+- `resolveMobileCallbackUrls(source = null, { appPublicUrl = "" } = {})`
+Local functions
+- `buildWebCallbackUrl(appPublicUrl = "", callbackPath = "")`
+- `buildMobileCallbackUrl(customScheme = "", callbackPath = "")`
+- `buildAppLinkCallbackUrls(appLinkDomains = [], callbackPath = "")`
 
 ### `server/support/appConfigFiles.js`
 Exports
+- `loadAppConfigFromAppRoot({ appRoot = "", publicConfigRelativePath = PUBLIC_CONFIG_RELATIVE_PATH, serverConfigRelativePath = SERVER_CONFIG_RELATIVE_PATH } = {})`
 - `loadAppConfigFromModuleUrl({ moduleUrl = import.meta.url, publicConfigRelativePath = PUBLIC_CONFIG_RELATIVE_PATH, serverConfigRelativePath = SERVER_CONFIG_RELATIVE_PATH } = {})`
 Local functions
 - `normalizeConfigObject(value)`
@@ -1298,6 +1367,10 @@ Local functions
 Exports
 - `symlinkSafeRequire`
 - `resolveAppConfig`
+- `resolveMobileConfig`
+- `resolveClientAssetMode`
+- `resolveMobileCallbackUrls`
+- `loadAppConfigFromAppRoot`
 - `loadAppConfigFromModuleUrl`
 - `importFreshModuleFromAbsolutePath`
 - `resolveRequiredAppRoot`
@@ -1312,7 +1385,10 @@ Exports
 - `deriveDefaultSubpagesHost`
 - `resolveNearestParentSubpagesHost`
 - `resolvePageLinkTargetDetails`
+- `discoverPlacementTopologyFromApp`
+- `discoverShellOutletSourcePathsFromApp`
 - `discoverShellOutletTargetsFromApp`
+- `resolveSemanticPlacementTargetFromApp`
 - `resolveShellOutletPlacementTargetFromApp`
 
 ### `server/support/pageTargets.js`
@@ -1326,7 +1402,7 @@ Exports
 - `resolvePageTargetDetails({ appRoot, targetFile = "", context = "page target" } = {})`
 - `deriveDefaultSubpagesHost(pageTarget = {})`
 - `resolveNearestParentSubpagesHost({ appRoot, pageTarget = {}, context = "page target" } = {})`
-- `resolvePageLinkTargetDetails({ appRoot, targetFile = "", pageTarget = null, placement = "", componentToken = "", linkTo = "", defaultComponentToken = DEFAULT_PAGE_LINK_COMPONENT_TOKEN, subpageComponentToken = DEFAULT_SUBPAGE_LINK_COMPONENT_TOKEN, context = "page target" } = {})`
+- `resolvePageLinkTargetDetails({ appRoot, targetFile = "", pageTarget = null, placement = "", componentToken = "", linkTo = "", context = "page target" } = {})`
 Local functions
 - `normalizeRelativeFilePath(value = "")`
 - `validateVueTargetFile(relativePath = "", { context = "page target" } = {})`
@@ -1351,10 +1427,12 @@ Local functions
 - `buildParentPageFileCandidates(pageTarget = {}, ancestorRoute = {})`
 - `resolveSubpagesHostTargetFromPageSource(source = "")`
 - `normalizePlacementTargetId(target = {})`
+- `resolveConcreteTargetOwner(target = "")`
+- `topologyPlacementTargetsConcreteOutlet(placement = {}, target = "")`
+- `resolveSemanticPlacementTargetForConcreteOutlet({ appRoot, concreteTarget = "", surface = "", context = "page target" } = {})`
 - `resolveRelativeLinkToFromParent(pageTarget = {}, parentHost = null)`
 - `resolveRelativeLinkToFromNearestIndexOwner(pageTarget = {})`
-- `resolveInferredPageLinkTo({ explicitLinkTo = "", pageTarget = {}, parentHost = null, placementTarget = null, suppressImplicitRelativeLinks = false } = {})`
-- `resolveInferredPageLinkComponentToken({ explicitComponentToken = "", parentHost = null, placementTarget = null, defaultComponentToken = DEFAULT_PAGE_LINK_COMPONENT_TOKEN, subpageComponentToken = DEFAULT_SUBPAGE_LINK_COMPONENT_TOKEN } = {})`
+- `resolveInferredPageLinkTo({ explicitLinkTo = "", pageTarget = {}, parentHost = null, preservesRelativeSubpageLinks = false, suppressImplicitRelativeLinks = false } = {})`
 - `renderPageLinkWhenLine(pageTarget = {})`
 
 ### `server/support/path.js`
@@ -1369,19 +1447,25 @@ Exports
 
 ### `server/support/shellOutlets.js`
 Exports
+- `discoverPlacementTopologyFromApp({ appRoot } = {})`
+- `discoverShellOutletSourcePathsFromApp({ appRoot, sourceRoot = "src" } = {})`
 - `discoverShellOutletTargetsFromApp({ appRoot, sourceRoot = "src" } = {})`
+- `resolveSemanticPlacementTargetFromApp({ appRoot, placement = "", owner = "", surface = "", context = "ui-generator" } = {})`
 - `resolveShellOutletPlacementTargetFromApp({ appRoot, placement = "", context = "ui-generator" } = {})`
 Local functions
 - `parseTagAttributes(attributesSource = "")`
 - `isDefaultEnabled(value)`
 - `normalizeAppRouteOutletTarget({ outlet = {}, sourcePath = "" } = {})`
-- `discoverRouteMetaOutletTargetsFromVueSource(source = "", { context = "shell layout" } = {})`
+- `discoverRouteMetaOutletTargetsFromVueSource(source = "", { context = "shell layout", enforceSingleDefault = true } = {})`
 - `collectVueFilePaths(rootDirectoryPath)`
 - `readInstalledPackageStates(appRoot)`
 - `normalizePackageOutletTarget({ packageId = "", outlet = {}, descriptorPath = "" } = {})`
-- `loadOutletDefaultOverrides(appRoot = "")`
-- `applyOutletDefaultOverrides(target = {}, outletDefaultOverrides = {})`
 - `collectInstalledPackageOutletTargets(appRoot)`
+- `withTopologySource(placement = {}, sourcePath = "")`
+- `loadAppPlacementTopology(appRoot)`
+- `collectInstalledPackagePlacementTopology(appRoot)`
+- `findSemanticPlacementById(placements = [], { id = "", owner = "", surface = "" } = {})`
+- `collectAppSourceShellOutletTargets({ appRoot, sourceRoot = "src", enforceSingleDefault = true, context = "discoverShellOutletTargetsFromApp" } = {})`
 
 ### `server/support/SupportCoreServiceProvider.js`
 Exports

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

@@ -0,0 +1,76 @@
+# packages/mobile-capacitor
+
+Generated by `npm run agent-docs:build`.
+Do not edit manually.
+
+Generated inventory for `packages/mobile-capacitor`.
+Use this on demand; do not load the full index at startup.
+
+## Scope
+- Source: `packages/mobile-capacitor/**/*{.js,.mjs,.cjs,.vue}`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+
+## Sections
+
+### src
+
+### `src/client/index.js`
+Exports
+- `MobileCapacitorClientProvider`
+- `createMobileCapacitorRuntime`
+- `createGlobalCapacitorAppAdapter`
+- `createNoopCapacitorAppAdapter`
+- `resolveCapacitorAppPlugin`
+- `clientProviders`
+
+### `src/client/providers/MobileCapacitorClientProvider.js`
+Exports
+- `MobileCapacitorClientProvider`
+- `installCapacitorAwareGlobalFetch({ adapter = null, apiBaseUrl = "", globalObject = globalThis } = {})`
+
+### `src/client/runtime/apiRequestClient.js`
+Exports
+- `createCapacitorAwareFetch({ fetchImpl = globalThis.fetch, adapter = null, apiBaseUrl = "" } = {})`
+- `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." } = {})`
+- `normalizeFetchInput(input = "")`
+
+### `src/client/runtime/globalCapacitorAppAdapter.js`
+Exports
+- `createGlobalCapacitorAppAdapter({ globalObject = globalThis, appPlugin = null } = {})`
+- `createNoopCapacitorAppAdapter()`
+- `resolveCapacitorAppPlugin(globalObject = globalThis)`
+
+### `src/client/runtime/mobileCapacitorRuntime.js`
+Exports
+- `createMobileCapacitorRuntime({ router, mobileConfig = {}, adapter = createNoopCapacitorAppAdapter(), placementRuntime = null, authCallbackCompleter = null, authGuardRuntime = null, logger = null } = {})`
+Local functions
+- `extractPathname(value = "")`
+- `normalizeCallbackCompleter(value = null)`
+- `normalizeAuthGuardRuntime(value = null)`
+- `isAuthCallbackTargetPath(targetPath = "", mobileConfig = {})`
+
+### `src/client/runtime/oauthLaunchClient.js`
+Exports
+- `createCapacitorAwareOAuthLaunchClient({ adapter = null, browserPlugin = Browser, location = null, apiBaseUrl = "" } = {})`
+- `resolveCapacitorLaunchUrl(url = "", apiBaseUrl = "")`
+
+### `src/server/buildTemplateContext.js`
+Exports
+- `buildTemplateContext({ appRoot } = {})`
+- `prepareInstallHook({ appRoot, appPackageJson = {}, io, dryRun = false, helpers = {} } = {})`
+- `finalizeInstallHook({ appRoot, io, dryRun = false, skipManagedFinalize = false, helpers = {} } = {})`
+Local functions
+- `requireNonEmptyText(value, label = "value")`
+- `requireUrl(value, label = "value", { allowHttp = true, allowHttps = true } = {})`
+- `buildCapacitorServerBlock(mobileConfig = {})`
+- `buildAppLinkDomainsValue(appLinkDomains = [])`
+- `directoryContainsAnyFiles(directoryPath = "")`
+
+### root
+
+### `package.descriptor.mjs`
+Exports
+- None

package/reference/autogen/packages/realtime.md

@@ -42,6 +42,7 @@ Local functions
 Exports
 - `RealtimeClientProvider`
 Local functions
+- `isCapacitorRuntimeAvailable(app)`
 - `resolveRealtimeClientConfig(app)`
 
 ### `src/client/runtime.js`