@smilodon/core 1.4.10 → 1.4.12

package/dist/types/src/components/enhanced-select.d.ts

@@ -4,7 +4,7 @@
  * server-side selection, and full customization
  */
 import type { GlobalSelectConfig } from '../config/global-config';
-import type { GroupedItem, ClassMap } from '../types';
+import type { GroupedItem, ClassMap, SelectCapabilitiesReport, LimitationState, LimitationPolicyMap, TrackingSnapshot } from '../types';
 import type { OptionRenderer as OptionRendererFn } from '../renderers/contracts';
 export declare class EnhancedSelect extends HTMLElement {
     /** live set of all connected instances; used to auto-close siblings */
@@ -45,6 +45,7 @@ export declare class EnhancedSelect extends HTMLElement {
     private _mirrorGlobalStylesForCustomOptions;
     private _globalStylesObserver;
     private _globalStylesContainer;
+    private _tracking;
     get classMap(): ClassMap | undefined;
     set classMap(map: ClassMap | undefined);
     /**
@@ -103,6 +104,14 @@ export declare class EnhancedSelect extends HTMLElement {
     private _setBusy;
     private _handleError;
     private _emit;
+    private _track;
+    private _getKnownLimitationDefinitions;
+    private _evaluateLimitationStatus;
+    getKnownLimitations(): LimitationState[];
+    setLimitationPolicies(policies: LimitationPolicyMap): void;
+    getTrackingSnapshot(): TrackingSnapshot;
+    clearTracking(source?: 'event' | 'style' | 'limitation' | 'all'): void;
+    getCapabilities(): SelectCapabilitiesReport;
     private _emitChange;
     get optionRenderer(): OptionRendererFn | undefined;
     set optionRenderer(renderer: OptionRendererFn | undefined);
@@ -154,6 +163,7 @@ export declare class EnhancedSelect extends HTMLElement {
      * Update component configuration
      */
     updateConfig(config: Partial<GlobalSelectConfig>): void;
+    private _mergeConfig;
     private _handleClearControlClick;
     private _syncClearControlState;
     /**

package/dist/types/src/config/global-config.d.ts

@@ -2,6 +2,7 @@
  * Global Configuration System for Select Components
  * Allows users to define default behaviors that can be overridden at component level
  */
+import type { KnownLimitationId, LimitationPolicy } from '../types';
 export interface ScrollToSelectedConfig {
     /** Whether to scroll to selected item when dropdown opens/closes */
     enabled: boolean;
@@ -156,6 +157,26 @@ export interface CallbackConfig {
     /** Called on error */
     onError?: (error: Error) => void;
 }
+export interface TrackingConfig {
+    /** Master switch for runtime tracking */
+    enabled: boolean;
+    /** Track emitted events */
+    events: boolean;
+    /** Track styling-related changes */
+    styling: boolean;
+    /** Track limitations and policy changes */
+    limitations: boolean;
+    /** Emit `diagnostic` events for tracking entries */
+    emitDiagnostics: boolean;
+    /** Maximum retained entries per tracking channel */
+    maxEntries: number;
+}
+export interface LimitationsConfig {
+    /** Policy map for known limitations */
+    policies: Partial<Record<KnownLimitationId, LimitationPolicy>>;
+    /** Auto-reset selection state when mode changes single <-> multi */
+    autoMitigateRuntimeModeSwitch: boolean;
+}
 export interface GlobalSelectConfig {
     /** Selection behavior */
     selection: SelectionConfig;
@@ -177,6 +198,10 @@ export interface GlobalSelectConfig {
     clearControl: ClearControlConfig;
     /** Callbacks */
     callbacks: CallbackConfig;
+    /** Runtime tracking controls */
+    tracking: TrackingConfig;
+    /** Known limitations controls */
+    limitations: LimitationsConfig;
     /** Enable/disable entire component */
     enabled: boolean;
     /** Enable search/filter */

package/dist/types/src/types.d.ts

@@ -64,6 +64,63 @@ export interface ClearEventDetail {
     clearedSelection: boolean;
     clearedSearch: boolean;
 }
+export type KnownLimitationId = 'variableItemHeight' | 'builtInFetchPaginationApi' | 'virtualizationOverheadSmallLists' | 'runtimeModeSwitching' | 'legacyBrowserSupport' | 'webkitArchLinux';
+export type LimitationControlMode = 'default' | 'suppress' | 'strict';
+export interface LimitationPolicy {
+    mode: LimitationControlMode;
+    note?: string;
+}
+export type LimitationPolicyMap = Partial<Record<KnownLimitationId, LimitationPolicy>>;
+export interface LimitationState {
+    id: KnownLimitationId;
+    title: string;
+    description: string;
+    mode: LimitationControlMode;
+    status: 'active' | 'mitigated' | 'suppressed';
+    workaround?: string;
+}
+export interface TrackingEntry {
+    timestamp: number;
+    source: 'event' | 'style' | 'limitation';
+    name: string;
+    detail?: unknown;
+}
+export interface TrackingSnapshot {
+    events: TrackingEntry[];
+    styles: TrackingEntry[];
+    limitations: TrackingEntry[];
+}
+export interface SelectCapabilitiesReport {
+    styling: {
+        classMap: boolean;
+        optionRenderer: boolean;
+        groupHeaderRenderer: boolean;
+        cssCustomProperties: boolean;
+        shadowParts: boolean;
+        globalStyleMirroring: boolean;
+    };
+    events: {
+        emitted: SelectEventName[];
+        diagnosticEvent: boolean;
+    };
+    functionality: {
+        multiSelect: boolean;
+        searchable: boolean;
+        infiniteScroll: boolean;
+        loadMore: boolean;
+        clearControl: boolean;
+        groupedItems: boolean;
+        serverSideSelection: boolean;
+        runtimeModeSwitchMitigation: boolean;
+    };
+    limitations: LimitationState[];
+}
+export interface DiagnosticEventDetail {
+    timestamp: number;
+    source: 'event' | 'style' | 'limitation';
+    name: string;
+    detail?: unknown;
+}
 export interface SelectEventsDetailMap {
     select: SelectEventDetail;
     open: OpenEventDetail;
@@ -75,6 +132,7 @@ export interface SelectEventsDetailMap {
     loadMore: LoadMoreEventDetail;
     remove: RemoveEventDetail;
     clear: ClearEventDetail;
+    diagnostic: DiagnosticEventDetail;
 }
 export type SelectEventName = keyof SelectEventsDetailMap;
 export interface RendererHelpers {

package/dist/types/tests/capabilities-tracking.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smilodon/core",
-  "version": "1.4.10",
+  "version": "1.4.12",
   "description": "High-performance native select component with extreme-scale virtualization - React, Vue, Svelte, Vanilla JS",
   "type": "module",
   "main": "./dist/index.cjs",