@wildo-ai/saas-frontend-lib 1.0.1

package/dist/esm/core/config/operation-surface.frontend.schemas.d.ts

@@ -0,0 +1,64 @@
+/**
+ * App-Level Component Types & Display Policy Enums
+ *
+ * Canonical home for `ApplicationLevelComponentType`, display policy enums
+ * (SidebarItemDisplayPolicy, CommandMenuDisplayPolicy, etc.), and HotkeyScope.
+ *
+ * Extracted from app-configuration-frontend.schemas.ts to break circular
+ * dependencies — view definition schemas import from here, and
+ * app-configuration-frontend imports those view definitions.
+ *
+ * Consumers import from this module or from `@wildo-ai/saas-frontend-lib`.
+ */
+export declare enum ApplicationLevelComponentType {
+    MENUBAR = "menubar",
+    TOOLBAR = "toolbar",
+    HOTKEY = "hotkey",
+    NOTIFICATION_CENTER = "notification_center",
+    /** @deprecated Use `ACTIVITY_BAR` instead. Will be removed in Step 4. */
+    NAVIGATION_RAIL = "navigation_rail",
+    /** @deprecated Use `UTILITY_PANEL` instead. Will be removed in Step 4. */
+    UTILITY_BAR = "utility_bar",
+    SIDEBAR = "sidebar",
+    COMMAND_MENU = "command_menu",
+    QUICK_ACTION_BUTTON = "quick_action_button",
+    QUICK_SWITCHER = "quick_switcher",
+    CONTROL_PANEL = "control_panel",
+    /** @deprecated Layout slot, not a shell component. Will be removed in Step 4. */
+    MAIN_CONTENT_CONTAINER = "main_content_container",
+    STATUS_BAR = "status_bar",
+    USER_DROPDOWN = "user_dropdown",
+    SETTINGS_DROPDOWN = "settings_dropdown",
+    NAVIGATION_CONTROL = "navigation_control",
+    /** @deprecated Mobile nav handled by responsive rendering. Will be removed in Step 4. */
+    ACTION_SHEET = "action_sheet",
+    /** Mode selector — renders available `AppMode`s as selectable icons. Replaces NAVIGATION_RAIL. */
+    ACTIVITY_BAR = "activity_bar",
+    /** Gmail-style right-side utility panel. Replaces UTILITY_BAR. */
+    UTILITY_PANEL = "utility_panel"
+}
+/** Sidebar item visibility policy */
+export declare enum SidebarItemDisplayPolicy {
+    ALWAYS = "always",
+    WHEN_BADGE = "when_badge",
+    SECTION_MORE_MENU = "section_more_menu"
+}
+/** Command menu command display policy */
+export declare enum CommandMenuDisplayPolicy {
+    ALWAYS = "always",
+    RECENT = "recent",
+    CONTEXTUAL = "contextual"
+}
+/** Quick action button display policy */
+export declare enum QuickActionDisplayPolicy {
+    PRIMARY = "primary",
+    MENU = "menu"
+}
+/** Hotkey scope — determines where the shortcut is active */
+export declare enum HotkeyScope {
+    GLOBAL = "global",
+    PAGE = "page",
+    COMPONENT = "component"
+}
+/** Per-operation sidebar surface configuration */
+//# sourceMappingURL=operation-surface.frontend.schemas.d.ts.map

package/dist/esm/core/config/operation-surface.frontend.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-surface.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../src/core/config/operation-surface.frontend.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAQH,oBAAY,6BAA6B;IACvC,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,mBAAmB,wBAAwB;IAC3C,yEAAyE;IACzE,eAAe,oBAAoB;IACnC,0EAA0E;IAC1E,WAAW,gBAAgB;IAC3B,OAAO,YAAY;IACnB,YAAY,iBAAiB;IAC7B,mBAAmB,wBAAwB;IAC3C,cAAc,mBAAmB;IACjC,aAAa,kBAAkB;IAC/B,iFAAiF;IACjF,sBAAsB,2BAA2B;IACjD,UAAU,eAAe;IACzB,aAAa,kBAAkB;IAC/B,iBAAiB,sBAAsB;IACvC,kBAAkB,uBAAuB;IACzC,yFAAyF;IACzF,YAAY,iBAAiB;IAE7B,kGAAkG;IAClG,YAAY,iBAAiB;IAC7B,kEAAkE;IAClE,aAAa,kBAAkB;CAChC;AAMD,qCAAqC;AACrC,oBAAY,wBAAwB;IAClC,MAAM,WAAW;IACjB,UAAU,eAAe;IACzB,iBAAiB,sBAAsB;CACxC;AAED,0CAA0C;AAC1C,oBAAY,wBAAwB;IAClC,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,UAAU,eAAe;CAC1B;AAED,yCAAyC;AACzC,oBAAY,wBAAwB;IAClC,OAAO,YAAY;IACnB,IAAI,SAAS;CACd;AAED,6DAA6D;AAC7D,oBAAY,WAAW;IACrB,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,SAAS,cAAc;CACxB;AAMD,kDAAkD"}

package/dist/esm/core/config/operation-surface.frontend.schemas.js

@@ -0,0 +1,78 @@
+/**
+ * App-Level Component Types & Display Policy Enums
+ *
+ * Canonical home for `ApplicationLevelComponentType`, display policy enums
+ * (SidebarItemDisplayPolicy, CommandMenuDisplayPolicy, etc.), and HotkeyScope.
+ *
+ * Extracted from app-configuration-frontend.schemas.ts to break circular
+ * dependencies — view definition schemas import from here, and
+ * app-configuration-frontend imports those view definitions.
+ *
+ * Consumers import from this module or from `@wildo-ai/saas-frontend-lib`.
+ */
+// ════════════════════════════════════════════════════════════════
+// App-Level Component Types (canonical definition)
+// ════════════════════════════════════════════════════════════════
+export var ApplicationLevelComponentType;
+(function (ApplicationLevelComponentType) {
+    ApplicationLevelComponentType["MENUBAR"] = "menubar";
+    ApplicationLevelComponentType["TOOLBAR"] = "toolbar";
+    ApplicationLevelComponentType["HOTKEY"] = "hotkey";
+    ApplicationLevelComponentType["NOTIFICATION_CENTER"] = "notification_center";
+    /** @deprecated Use `ACTIVITY_BAR` instead. Will be removed in Step 4. */
+    ApplicationLevelComponentType["NAVIGATION_RAIL"] = "navigation_rail";
+    /** @deprecated Use `UTILITY_PANEL` instead. Will be removed in Step 4. */
+    ApplicationLevelComponentType["UTILITY_BAR"] = "utility_bar";
+    ApplicationLevelComponentType["SIDEBAR"] = "sidebar";
+    ApplicationLevelComponentType["COMMAND_MENU"] = "command_menu";
+    ApplicationLevelComponentType["QUICK_ACTION_BUTTON"] = "quick_action_button";
+    ApplicationLevelComponentType["QUICK_SWITCHER"] = "quick_switcher";
+    ApplicationLevelComponentType["CONTROL_PANEL"] = "control_panel";
+    /** @deprecated Layout slot, not a shell component. Will be removed in Step 4. */
+    ApplicationLevelComponentType["MAIN_CONTENT_CONTAINER"] = "main_content_container";
+    ApplicationLevelComponentType["STATUS_BAR"] = "status_bar";
+    ApplicationLevelComponentType["USER_DROPDOWN"] = "user_dropdown";
+    ApplicationLevelComponentType["SETTINGS_DROPDOWN"] = "settings_dropdown";
+    ApplicationLevelComponentType["NAVIGATION_CONTROL"] = "navigation_control";
+    /** @deprecated Mobile nav handled by responsive rendering. Will be removed in Step 4. */
+    ApplicationLevelComponentType["ACTION_SHEET"] = "action_sheet";
+    /** Mode selector — renders available `AppMode`s as selectable icons. Replaces NAVIGATION_RAIL. */
+    ApplicationLevelComponentType["ACTIVITY_BAR"] = "activity_bar";
+    /** Gmail-style right-side utility panel. Replaces UTILITY_BAR. */
+    ApplicationLevelComponentType["UTILITY_PANEL"] = "utility_panel";
+})(ApplicationLevelComponentType || (ApplicationLevelComponentType = {}));
+// ════════════════════════════════════════════════════════════════
+// Per-Surface Display Policy Enums
+// ════════════════════════════════════════════════════════════════
+/** Sidebar item visibility policy */
+export var SidebarItemDisplayPolicy;
+(function (SidebarItemDisplayPolicy) {
+    SidebarItemDisplayPolicy["ALWAYS"] = "always";
+    SidebarItemDisplayPolicy["WHEN_BADGE"] = "when_badge";
+    SidebarItemDisplayPolicy["SECTION_MORE_MENU"] = "section_more_menu";
+})(SidebarItemDisplayPolicy || (SidebarItemDisplayPolicy = {}));
+/** Command menu command display policy */
+export var CommandMenuDisplayPolicy;
+(function (CommandMenuDisplayPolicy) {
+    CommandMenuDisplayPolicy["ALWAYS"] = "always";
+    CommandMenuDisplayPolicy["RECENT"] = "recent";
+    CommandMenuDisplayPolicy["CONTEXTUAL"] = "contextual";
+})(CommandMenuDisplayPolicy || (CommandMenuDisplayPolicy = {}));
+/** Quick action button display policy */
+export var QuickActionDisplayPolicy;
+(function (QuickActionDisplayPolicy) {
+    QuickActionDisplayPolicy["PRIMARY"] = "primary";
+    QuickActionDisplayPolicy["MENU"] = "menu";
+})(QuickActionDisplayPolicy || (QuickActionDisplayPolicy = {}));
+/** Hotkey scope — determines where the shortcut is active */
+export var HotkeyScope;
+(function (HotkeyScope) {
+    HotkeyScope["GLOBAL"] = "global";
+    HotkeyScope["PAGE"] = "page";
+    HotkeyScope["COMPONENT"] = "component";
+})(HotkeyScope || (HotkeyScope = {}));
+// ════════════════════════════════════════════════════════════════
+// Per-Surface Config Schemas
+// ════════════════════════════════════════════════════════════════
+/** Per-operation sidebar surface configuration */
+//# sourceMappingURL=operation-surface.frontend.schemas.js.map

package/dist/esm/core/config/operation-surface.frontend.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-surface.frontend.schemas.js","sourceRoot":"","sources":["../../../../src/core/config/operation-surface.frontend.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,mEAAmE;AACnE,mDAAmD;AACnD,mEAAmE;AAEnE,MAAM,CAAN,IAAY,6BA2BX;AA3BD,WAAY,6BAA6B;IACvC,oDAAmB,CAAA;IACnB,oDAAmB,CAAA;IACnB,kDAAiB,CAAA;IACjB,4EAA2C,CAAA;IAC3C,yEAAyE;IACzE,oEAAmC,CAAA;IACnC,0EAA0E;IAC1E,4DAA2B,CAAA;IAC3B,oDAAmB,CAAA;IACnB,8DAA6B,CAAA;IAC7B,4EAA2C,CAAA;IAC3C,kEAAiC,CAAA;IACjC,gEAA+B,CAAA;IAC/B,iFAAiF;IACjF,kFAAiD,CAAA;IACjD,0DAAyB,CAAA;IACzB,gEAA+B,CAAA;IAC/B,wEAAuC,CAAA;IACvC,0EAAyC,CAAA;IACzC,yFAAyF;IACzF,8DAA6B,CAAA;IAE7B,kGAAkG;IAClG,8DAA6B,CAAA;IAC7B,kEAAkE;IAClE,gEAA+B,CAAA;AACjC,CAAC,EA3BW,6BAA6B,KAA7B,6BAA6B,QA2BxC;AAED,mEAAmE;AACnE,mCAAmC;AACnC,mEAAmE;AAEnE,qCAAqC;AACrC,MAAM,CAAN,IAAY,wBAIX;AAJD,WAAY,wBAAwB;IAClC,6CAAiB,CAAA;IACjB,qDAAyB,CAAA;IACzB,mEAAuC,CAAA;AACzC,CAAC,EAJW,wBAAwB,KAAxB,wBAAwB,QAInC;AAED,0CAA0C;AAC1C,MAAM,CAAN,IAAY,wBAIX;AAJD,WAAY,wBAAwB;IAClC,6CAAiB,CAAA;IACjB,6CAAiB,CAAA;IACjB,qDAAyB,CAAA;AAC3B,CAAC,EAJW,wBAAwB,KAAxB,wBAAwB,QAInC;AAED,yCAAyC;AACzC,MAAM,CAAN,IAAY,wBAGX;AAHD,WAAY,wBAAwB;IAClC,+CAAmB,CAAA;IACnB,yCAAa,CAAA;AACf,CAAC,EAHW,wBAAwB,KAAxB,wBAAwB,QAGnC;AAED,6DAA6D;AAC7D,MAAM,CAAN,IAAY,WAIX;AAJD,WAAY,WAAW;IACrB,gCAAiB,CAAA;IACjB,4BAAa,CAAA;IACb,sCAAuB,CAAA;AACzB,CAAC,EAJW,WAAW,KAAX,WAAW,QAItB;AAED,mEAAmE;AACnE,6BAA6B;AAC7B,mEAAmE;AAEnE,kDAAkD"}

package/dist/esm/core/config/verify-feature-references.frontend.d.ts

@@ -0,0 +1,18 @@
+import type { FeatureConfiguration, FeatureReferenceValidationIssues } from '@wildo-ai/saas-models';
+import type { AppConfiguration_Frontend } from './app-configuration-frontend.schemas.js';
+import type { FrontendResourcesRegistry } from '../../core/resources/resources.frontend.schemas.js';
+export interface FrontendFeatureReferenceVerificationResult extends FeatureReferenceValidationIssues {
+    isValid: boolean;
+    warnings: string[];
+}
+/**
+ * DEV-time validation for frontend-authored feature refs that never pass
+ * through backend startup. This covers app-level views plus resource-owned UI
+ * declarations such as inserted charts and resource guidance.
+ */
+export declare function verifyFrontendFeatureReferences(params: {
+    resourcesRegistry: FrontendResourcesRegistry;
+    appConfig: AppConfiguration_Frontend;
+    featureConfiguration: FeatureConfiguration;
+}): FrontendFeatureReferenceVerificationResult;
+//# sourceMappingURL=verify-feature-references.frontend.d.ts.map

package/dist/esm/core/config/verify-feature-references.frontend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-feature-references.frontend.d.ts","sourceRoot":"","sources":["../../../../src/core/config/verify-feature-references.frontend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,gCAAgC,EAGjC,MAAM,uBAAuB,CAAC;AAK/B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AACtF,OAAO,KAAK,EAEV,yBAAyB,EAC1B,MAAM,+DAA+D,CAAC;AAEvE,MAAM,WAAW,0CAA2C,SAAQ,gCAAgC;IAClG,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE;IACtD,iBAAiB,EAAE,yBAAyB,CAAC;IAC7C,SAAS,EAAE,yBAAyB,CAAC;IACrC,oBAAoB,EAAE,oBAAoB,CAAC;CAC5C,GAAG,0CAA0C,CA6B7C"}

package/dist/esm/core/config/verify-feature-references.frontend.js

@@ -0,0 +1,117 @@
+import { collectFeatureReferenceValidationIssues, extractFeatureReferencesFromRequiredFeatures, } from '@wildo-ai/saas-models';
+/**
+ * DEV-time validation for frontend-authored feature refs that never pass
+ * through backend startup. This covers app-level views plus resource-owned UI
+ * declarations such as inserted charts and resource guidance.
+ */
+export function verifyFrontendFeatureReferences(params) {
+    const usages = [
+        ...collectAppViewFeatureReferenceUsages(params.appConfig),
+        ...collectResourceConfigurationFeatureReferenceUsages(params.resourcesRegistry),
+    ];
+    const issues = collectFeatureReferenceValidationIssues({
+        definitions: params.featureConfiguration.definitions,
+        usages,
+    });
+    const warnings = [
+        ...issues.unknownIssues.map((issue) => (`${issue.surface}: unknown feature reference(s): ${formatFeatureReferences(issue.references)}`)),
+        ...issues.incompatibleIssues.map((issue) => (`${issue.surface}: incompatible feature reference(s): ${issue.references
+            .map((reference) => (`'${reference.featureId}' via ${reference.slotLabel} expects ${reference.expectedValueType} but registry defines ${reference.actualValueType}`))
+            .join(', ')}`)),
+    ];
+    return {
+        ...issues,
+        warnings,
+        isValid: warnings.length === 0,
+    };
+}
+function collectAppViewFeatureReferenceUsages(appConfig) {
+    return [
+        ...collectViewArrayFeatureReferenceUsages(appConfig.compositeViews, (view) => `frontend composite view '${view.ref}'`),
+        ...collectViewArrayFeatureReferenceUsages(appConfig.fullCustomViews, (view) => `frontend full custom view '${view.ref}'`),
+        ...collectViewArrayFeatureReferenceUsages(appConfig.flowsActorsViews, (view) => `frontend flows/actors view '${view.ref}'`),
+        ...collectViewArrayFeatureReferenceUsages(appConfig.onboardingViews, (_view, index) => `frontend onboarding view #${index + 1}`),
+        ...collectFrontendGuidanceFlowFeatureReferenceUsages(appConfig),
+    ];
+}
+function collectFrontendGuidanceFlowFeatureReferenceUsages(appConfig) {
+    return (appConfig.guidanceFlows ?? []).flatMap((flow) => {
+        const references = extractFeatureReferencesFromRequiredFeatures(flow.audience?.requiredFeatures);
+        if (references.length === 0) {
+            return [];
+        }
+        return [{
+                surface: `frontend guidance flow '${flow.ref}' audience`,
+                references,
+            }];
+    });
+}
+function collectViewArrayFeatureReferenceUsages(views, surfaceBuilder) {
+    if (!views) {
+        return [];
+    }
+    return views.flatMap((view, index) => {
+        const references = extractFeatureReferencesFromRequiredFeatures(view.requiredFeatures);
+        if (references.length === 0) {
+            return [];
+        }
+        return [{
+                surface: surfaceBuilder(view, index),
+                references,
+            }];
+    });
+}
+function collectResourceConfigurationFeatureReferenceUsages(resourcesRegistry) {
+    return Object.entries(resourcesRegistry.resourceConfigurations).flatMap(([resourceType, resourceConfiguration]) => (collectSingleResourceConfigurationFeatureReferenceUsages(resourceType, resourceConfiguration)));
+}
+function collectSingleResourceConfigurationFeatureReferenceUsages(resourceType, resourceConfiguration) {
+    const frontendConfiguration = resourceConfiguration.frontendConfiguration;
+    return [
+        ...(frontendConfiguration?.compositeViews ?? []).flatMap((view) => {
+            const references = extractFeatureReferencesFromRequiredFeatures(view.requiredFeatures);
+            if (references.length === 0) {
+                return [];
+            }
+            return [{
+                    surface: `resource '${resourceType}' composite view '${view.ref}'`,
+                    references,
+                }];
+        }),
+        ...(frontendConfiguration?.chartViews ?? []).flatMap((view) => {
+            const references = extractFeatureReferencesFromRequiredFeatures(view.chartDefinition.requiredFeatures);
+            if (references.length === 0) {
+                return [];
+            }
+            return [{
+                    surface: `resource '${resourceType}' chart '${view.ref}'`,
+                    references,
+                }];
+        }),
+        ...(frontendConfiguration?.executionViews ?? []).flatMap((view) => {
+            const references = extractFeatureReferencesFromRequiredFeatures(view.requiredFeatures);
+            if (references.length === 0) {
+                return [];
+            }
+            return [{
+                    surface: `resource '${resourceType}' execution view '${view.ref}'`,
+                    references,
+                }];
+        }),
+        ...(frontendConfiguration?.guidance ?? []).flatMap((flow) => {
+            const references = extractFeatureReferencesFromRequiredFeatures(flow.audience?.requiredFeatures);
+            if (references.length === 0) {
+                return [];
+            }
+            return [{
+                    surface: `resource '${resourceType}' guidance flow '${flow.ref}' audience`,
+                    references,
+                }];
+        }),
+    ];
+}
+function formatFeatureReferences(references) {
+    return references
+        .map((reference) => `'${reference.featureId}' via ${reference.slotLabel}`)
+        .join(', ');
+}
+//# sourceMappingURL=verify-feature-references.frontend.js.map

package/dist/esm/core/config/verify-feature-references.frontend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-feature-references.frontend.js","sourceRoot":"","sources":["../../../../src/core/config/verify-feature-references.frontend.ts"],"names":[],"mappings":"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"}

package/dist/esm/core/config/verify-launcher-content.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Launcher Content Verification
+ *
+ * DEV-mode startup validator that walks every content-declaring launcher's
+ * configuration and verifies that all declared references resolve to real
+ * registry entries (operations, views, engine pages, hosted components).
+ *
+ * Adapts traversal to each launcher's structural model — sidebar sections
+ * use a discriminated union on `contentKind`, while other launchers are
+ * flat item arrays.
+ *
+ * @see launcher-operation-binding-analysis.md §3.11
+ * @see app-shell-implementation-plan.md Step 5
+ */
+import type { AppConfiguration_Frontend } from './app-configuration-frontend.schemas.js';
+import type { FrontendResourcesRegistry } from '../../core/resources/resources.frontend.schemas.js';
+export declare enum LauncherVerificationSeverity {
+    ERROR = "error",
+    WARNING = "warning"
+}
+export declare enum LauncherVerificationErrorCode {
+    RESOURCE_NOT_FOUND = "RESOURCE_NOT_FOUND",
+    OPERATION_NOT_FOUND = "OPERATION_NOT_FOUND",
+    VIEW_NOT_FOUND = "VIEW_NOT_FOUND",
+    VIEW_REF_COLLISION = "VIEW_REF_COLLISION",
+    ENGINE_PAGE_NOT_FOUND = "ENGINE_PAGE_NOT_FOUND",
+    RESOURCE_BROWSER_RESOURCE_NOT_FOUND = "RESOURCE_BROWSER_RESOURCE_NOT_FOUND",
+    RESOURCE_BROWSER_BOUND_OPERATION_NOT_FOUND = "RESOURCE_BROWSER_BOUND_OPERATION_NOT_FOUND",
+    RESOURCE_BROWSER_NAVIGATION_OPERATION_NOT_FOUND = "RESOURCE_BROWSER_NAVIGATION_OPERATION_NOT_FOUND",
+    RESOURCE_BROWSER_MISSING_LABEL_CONFIG = "RESOURCE_BROWSER_MISSING_LABEL_CONFIG",
+    ACTIVITY_BAR_ENABLED_BUT_NO_APP_MODES = "ACTIVITY_BAR_ENABLED_BUT_NO_APP_MODES",
+    HOSTED_COMPONENT_NOT_CONFIGURED = "HOSTED_COMPONENT_NOT_CONFIGURED",
+    VISIBLE_IN_MODES_ORPHAN = "VISIBLE_IN_MODES_ORPHAN",
+    BADGE_REFERENCE_DUPLICATE = "BADGE_REFERENCE_DUPLICATE",
+    APP_SCOPE_DUPLICATE_RESOURCE_TYPE = "APP_SCOPE_DUPLICATE_RESOURCE_TYPE",
+    VIEW_NOT_LAUNCHABLE = "VIEW_NOT_LAUNCHABLE",
+    UNKNOWN_TARGET_KIND = "UNKNOWN_TARGET_KIND"
+}
+export interface LauncherVerificationError {
+    severity: LauncherVerificationSeverity;
+    code: LauncherVerificationErrorCode;
+    context: string;
+    message: string;
+    item?: unknown;
+}
+export interface LauncherVerificationResult {
+    errors: LauncherVerificationError[];
+    isValid: boolean;
+}
+/**
+ * Validates all launcher content declarations against the resource registry
+ * and view definitions. Adapts traversal per launcher's structural model.
+ *
+ * Call at startup in DEV mode only. Returns errors/warnings — does not throw.
+ *
+ * @see launcher-operation-binding-analysis.md §3.11
+ */
+export declare function verifyLauncherContent(registry: FrontendResourcesRegistry, appConfig: AppConfiguration_Frontend, isComponentRegistered?: (componentRef: string) => boolean): LauncherVerificationResult;
+/**
+ * Formats and logs verification results to the console.
+ * Groups errors by severity and includes a summary table.
+ */
+export declare function reportLauncherVerificationResults(result: LauncherVerificationResult): void;
+//# sourceMappingURL=verify-launcher-content.d.ts.map

package/dist/esm/core/config/verify-launcher-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-launcher-content.d.ts","sourceRoot":"","sources":["../../../../src/core/config/verify-launcher-content.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AACtF,OAAO,KAAK,EAAE,yBAAyB,EAAoC,MAAM,+DAA+D,CAAC;AAgCjJ,oBAAY,4BAA4B;IACtC,KAAK,UAAU;IACf,OAAO,YAAY;CACpB;AAED,oBAAY,6BAA6B;IACvC,kBAAkB,uBAAuB;IACzC,mBAAmB,wBAAwB;IAC3C,cAAc,mBAAmB;IACjC,kBAAkB,uBAAuB;IACzC,qBAAqB,0BAA0B;IAC/C,mCAAmC,wCAAwC;IAC3E,0CAA0C,+CAA+C;IACzF,+CAA+C,oDAAoD;IACnG,qCAAqC,0CAA0C;IAC/E,qCAAqC,0CAA0C;IAC/E,+BAA+B,oCAAoC;IACnE,uBAAuB,4BAA4B;IACnD,yBAAyB,8BAA8B;IACvD,iCAAiC,sCAAsC;IACvE,mBAAmB,wBAAwB;IAC3C,mBAAmB,wBAAwB;CAC5C;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,4BAA4B,CAAC;IACvC,IAAI,EAAE,6BAA6B,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,yBAAyB,EAAE,CAAC;IACpC,OAAO,EAAE,OAAO,CAAC;CAClB;AAmcD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,yBAAyB,EACnC,SAAS,EAAE,yBAAyB,EACpC,qBAAqB,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,GACxD,0BAA0B,CA8N5B;AAMD;;;GAGG;AACH,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,0BAA0B,GAAG,IAAI,CAqB1F"}