@kosdev-code/kos-ui-sdk 2.0.45 → 2.0.46

package/models/models/translation/types/index.d.ts

@@ -5,147 +5,13 @@ import { KosContext, KosParentAware } from '../../../../core';
 
 // ---------------  Translation ---------------
 
-/**
- * Configuration options for Translation model instances.
- *
- * This interface defines the complete configuration structure for individual translation
- * namespace models, including locale settings, resolution strategies, and custom loading
- * mechanisms. Translation models handle the actual key resolution and interpolation for
- * specific functional areas within KOS applications.
- *
- * @example Basic Translation Configuration
- * ```typescript
- * // Device status translations with English fallback
- * const statusOptions: TranslationOptions = {
- *   namespace: 'device-status',
- *   currentLocale: 'es',
- *   defaultLocale: 'en',
- *   descriptor: {
- *     'es': {
- *       fallbacks: ['en']
- *     },
- *     'en': {
- *       fallbacks: []
- *     }
- *   },
- *   kosParentId: 'translation-container'
- * };
- *
- * const statusTranslation = Translation.instance('status-translations')
- *   .options(statusOptions)
- *   .build();
- * ```
- *
- * @example Custom Bundle Resolution
- * ```typescript
- * // API-based translation loading
- * const apiBundleResolver = async (
- *   namespace: string,
- *   locale: string,
- *   context?: KosContext
- * ): Promise<TranslationResponse> => {
- *   const response = await fetch(`/api/translations/${namespace}/${locale}`);
- *   return await response.json();
- * };
- *
- * const apiOptions: TranslationOptions = {
- *   namespace: 'alerts',
- *   currentLocale: 'fr',
- *   defaultLocale: 'en',
- *   descriptor: {
- *     'fr': { fallbacks: ['en'] },
- *     'en': { fallbacks: [] }
- *   },
- *   bundleResolver: apiBundleResolver,
- *   kosParentId: 'translation-container'
- * };
- * ```
- *
- * @example Multi-Regional Configuration
- * ```typescript
- * // Complex fallback chains for regional variations
- * const regionalOptions: TranslationOptions = {
- *   namespace: 'regional-ui',
- *   currentLocale: 'pt-BR',
- *   defaultLocale: 'en',
- *   descriptor: {
- *     'pt-BR': { fallbacks: ['pt', 'es', 'en'] },
- *     'pt-PT': { fallbacks: ['pt', 'es', 'en'] },
- *     'pt': { fallbacks: ['es', 'en'] },
- *     'es': { fallbacks: ['en'] },
- *     'en': { fallbacks: [] }
- *   },
- *   kosParentId: 'translation-container'
- * };
- * ```
- *
- * @kosService core.translation
- * @group KOS Model
- * @category i18n
- */
 export interface TranslationOptions extends KosParentAware {
-  /**
-   * Translation namespace identifier, typically corresponding to a feature area.
-   * Used to organize translations by functional domain and prevent key conflicts.
-   *
-   * @example "device-status"
-   * @example "user-settings"
-   * @example "maintenance-scheduler"
-   */
   namespace: string;
-
-  /**
-   * Current active locale for this translation model.
-   * Determines which language variant to load and display.
-   *
-   * @example "en" - English
-   * @example "es" - Spanish
-   * @example "pt-BR" - Brazilian Portuguese
-   */
   currentLocale: string;
-
-  /**
-   * Default fallback locale when translations are missing in the current locale.
-   * Typically set to the primary application language.
-   *
-   * @default "en"
-   */
   defaultLocale: string;
-
-  /**
-   * Optional base URL for translation file loading.
-   * Used with default file-based resolution strategy.
-   *
-   * @example "/assets/locales"
-   * @example "https://cdn.example.com/translations"
-   */
   rootUrl?: string;
-
-  /**
-   * Locale descriptors defining fallback chains and configuration for each locale.
-   * Maps locale codes to their fallback hierarchy and metadata.
-   */
   descriptor: Record<string, LocaleDescriptor>;
-
-  /**
-   * Optional custom path resolver for translation file loading.
-   * Overrides default path construction logic.
-   *
-   * @param namespace - Target translation namespace
-   * @param locale - Target locale code
-   * @returns Full path to translation resource
-   */
   resolver?: (namespace: string, locale: string) => string;
-
-  /**
-   * Optional custom bundle resolver for advanced translation loading strategies.
-   * Enables loading from APIs, device storage, or custom sources.
-   *
-   * @param namespace - Target translation namespace
-   * @param locale - Target locale code
-   * @param context - KOS context for accessing shared data
-   * @returns Promise resolving to translation data
-   */
   bundleResolver?: (
     namespace: string,
     locale: string,
@@ -154,160 +20,12 @@ export interface TranslationOptions extends KosParentAware {
 }
 
 // ---------------  TranslationContainer ---------------
-
-/**
- * Configuration options for TranslationContainer model instances.
- *
- * This interface defines the configuration structure for translation container models,
- * which manage multiple translation namespaces and coordinate global locale switching.
- * Containers serve as the central orchestration point for internationalization in KOS
- * applications.
- *
- * @example Basic Container Configuration
- * ```typescript
- * // Multi-namespace application translations
- * const containerOptions: TranslationContainerOptions = {
- *   lang: 'es',
- *   defaultNamespace: 'common',
- *   descriptor: {
- *     namespaces: {
- *       'common': {
- *         basePath: '/assets/locales',
- *         locales: {
- *           'en': { file: 'en/common.json', defaultLocale: 'en' },
- *           'es': { file: 'es/common.json', defaultLocale: 'en' },
- *           'fr': { file: 'fr/common.json', defaultLocale: 'en' }
- *         }
- *       },
- *       'dashboard': {
- *         basePath: '/assets/locales',
- *         locales: {
- *           'en': { file: 'en/dashboard.json', defaultLocale: 'en' },
- *           'es': { file: 'es/dashboard.json', defaultLocale: 'en' },
- *           'fr': { file: 'fr/dashboard.json', defaultLocale: 'en' }
- *         }
- *       }
- *     }
- *   }
- * };
- *
- * const appTranslations = TranslationContainer.instance('app-i18n')
- *   .options(containerOptions)
- *   .build();
- * ```
- *
- * @example CDN-Based Translation Loading
- * ```typescript
- * // Custom resolver for CDN-hosted translations
- * const cdnResolver = function(
- *   namespace: string,
- *   locale: string
- * ): string {
- *   return `https://cdn.example.com/translations/${namespace}/${locale}.json`;
- * };
- *
- * const cdnOptions: TranslationContainerOptions = {
- *   lang: 'ja',
- *   resolver: cdnResolver,
- *   descriptor: {
- *     namespaces: {
- *       'device-control': {
- *         basePath: '', // Ignored with custom resolver
- *         locales: {
- *           'ja': { file: '', defaultLocale: 'en' },
- *           'en': { file: '', defaultLocale: 'en' }
- *         }
- *       }
- *     }
- *   }
- * };
- * ```
- *
- * @example Development Environment Setup
- * ```typescript
- * // Hot-reload friendly configuration for development
- * const devOptions: TranslationContainerOptions = {
- *   lang: 'en',
- *   rootUrl: '/dev-translations',
- *   descriptor: {
- *     namespaces: {
- *       'ui': {
- *         basePath: '/ui-translations',
- *         locales: {
- *           'en': { file: 'en/ui.json', defaultLocale: 'en' },
- *           'es': { file: 'es/ui.json', defaultLocale: 'en' }
- *         }
- *       },
- *       'forms': {
- *         basePath: '/form-translations',
- *         locales: {
- *           'en': { file: 'en/forms.json', defaultLocale: 'en' },
- *           'es': { file: 'es/forms.json', defaultLocale: 'en' }
- *         }
- *       }
- *     }
- *   }
- * };
- * ```
- *
- * @kosService core.translation
- * @group KOS Model
- * @category i18n
- */
 export interface TranslationContainerOptions {
-  /**
-   * Current application-wide locale setting.
-   * Applied to all child translation models when they are created or updated.
-   *
-   * @example "en" - English
-   * @example "es" - Spanish
-   * @example "pt-BR" - Brazilian Portuguese
-   */
   lang: string;
-
-  /**
-   * Comprehensive locale and namespace descriptor defining the complete
-   * translation structure for the application.
-   */
   descriptor: Localization;
-
-  /**
-   * Optional default namespace for application-wide common translations.
-   * When specified, provides easy access to shared UI elements and messages.
-   *
-   * @example "common"
-   * @example "shared"
-   * @example "ui-elements"
-   */
   defaultNamespace?: string;
-
-  /**
-   * Optional base URL for all translation file loading.
-   * Applied as prefix to all translation resource paths.
-   *
-   * @example "/assets/locales"
-   * @example "https://cdn.example.com/app-translations"
-   * @example "/tenant-specific/translations"
-   */
   rootUrl?: string;
-
-  /**
-   * Optional URL for loading translation descriptor dynamically.
-   * Enables runtime configuration of translation structure.
-   *
-   * @example "/api/translations/descriptor"
-   * @example "https://config.example.com/translation-manifest.json"
-   */
   descriptorUrl?: string;
-
-  /**
-   * Optional custom resolver for translation file path construction.
-   * Overrides default path resolution logic for all namespaces.
-   *
-   * @param namespace - Target translation namespace
-   * @param locale - Target locale code
-   * @returns Full path to translation resource
-   */
   resolver?: (
     this: TranslationContainerModel,
     namespace: string,
@@ -315,67 +33,6 @@ export interface TranslationContainerOptions {
   ) => string;
 }
 
-/**
- * Type definitions for variable interpolation in translation keys.
- *
- * Translation models support sophisticated variable substitution patterns
- * for dynamic content in internationalized applications.
- *
- * @kosService core.translation
- * @group KOS Model
- * @category Internationalization
- */
-export type ResolveTranslationOptions<T = string> =
-  | {
-      /**
-       * Context variables for template-based interpolation using {{variable}} syntax.
-       *
-       * @example
-       * ```typescript
-       * t('welcome.message', {
-       *   context: { username: 'John', unreadCount: 5 }
-       * })
-       * // "Welcome {{username}}, you have {{unreadCount}} messages"
-       * // Result: "Welcome John, you have 5 messages"
-       * ```
-       */
-      context?: Record<string, any>;
-
-      /**
-       * Data variables for macro-based interpolation using __variable__ syntax.
-       *
-       * @example
-       * ```typescript
-       * t('system.info', {
-       *   data: { version: '2.1.0', platform: 'Linux' }
-       * })
-       * // "System __version__ running on __platform__"
-       * // Result: "System 2.1.0 running on Linux"
-       * ```
-       */
-      data?: Record<string, any>;
-
-      /**
-       * Contextual modifier for conditional key resolution.
-       * Enables different translations based on application state.
-       *
-       * @example
-       * ```typescript
-       * // Translation file: { "title": "Create", "title_edit": "Update" }
-       * t('title', { context: 'edit' })
-       * // Resolves to "title_edit" key, returns "Update"
-       * ```
-       */
-      context?: string;
-
-      /**
-       * Fallback value when translation key is not found.
-       * Ensures graceful degradation for missing translations.
-       */
-      defaultValue?: T;
-    }
-  | string;
-
 declare global {
   interface AbstractModelFactory {
     createTranslation: (id: string, options: TranslationOptions) => Translation;

package/models/models/trouble/index.d.ts

@@ -1,7 +1,6 @@
 import * as TroubleServices from "./services";
 export { Trouble } from './trouble-registration';
-export type { ContainerTroubleData, DeferAware, HandleTroubleData, NozzleTroubleData, ResolveAware, TroubleAware, TroubleModel, TroubleOptions, } from './types';
-export type { TroubleResponse } from './services';
+export type { DeferAware, ResolveAware, TroubleAware, TroubleModel, TroubleOptions, } from './types';
 export * from './utils/is-trouble-aware';
 export { EXTENSION_TROUBLE_DATA_MAPPER } from './utils/trouble-data-extension';
 export { EXTENSION_TROUBLE_MAPPER } from './utils/trouble-extension';

package/models/models/trouble/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/trouble/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,eAAe,MAAM,YAAY,CAAC;AAE9C,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,YAAY,EACV,oBAAoB,EACpB,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,cAAc,GACf,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAC/E,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/trouble/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,eAAe,MAAM,YAAY,CAAC;AAE9C,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,YAAY,EACV,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,cAAc,GACf,MAAM,SAAS,CAAC;AACjB,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAC/E,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/models/models/trouble/services/trouble-services.d.ts

@@ -1,7 +1,7 @@
 import { FutureResponse } from '../../../services/future';
 import { KosServiceResponse } from '../../../../core';
 
-export interface TroubleResponse<ClientAttributes = any> {
+export interface TroubleResponse {
     reason: string;
     createTime: string;
     resolvable: boolean;
@@ -11,15 +11,13 @@ export interface TroubleResponse<ClientAttributes = any> {
     type: string;
     tags: string[];
     info: any;
-    attrs: ClientAttributes;
 }
-export declare const getKosConnectionId: () => string | undefined;
 /**
  * @category Service
  * @internal
  * Retrieves the initial Trouble data.
  */
-export declare const getTroubles: (servicePath: string) => Promise<KosServiceResponse<TroubleResponse<any>[]> | undefined>;
-export declare const resolveTrouble: (troubleId: string, servicePath?: string, tracker?: string) => Promise<FutureResponse>;
-export declare const bulkResolveTroubles: (troubleIds: string[], servicePath?: string, tracker?: string) => Promise<FutureResponse>;
+export declare const getTroubles: () => Promise<KosServiceResponse<TroubleResponse[]> | undefined>;
+export declare const resolveTrouble: (troubleId: string, tracker?: string) => Promise<FutureResponse>;
+export declare const bulkResolveTroubles: (troubleIds: string[], tracker?: string) => Promise<FutureResponse>;
 //# sourceMappingURL=trouble-services.d.ts.map

package/models/models/trouble/services/trouble-services.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trouble-services.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/trouble/services/trouble-services.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAEL,kBAAkB,EAInB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAkB,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAO1E,MAAM,WAAW,eAAe,CAAC,gBAAgB,GAAG,GAAG;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,GAAG,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,GAAG,CAAC;IACV,KAAK,EAAE,gBAAgB,CAAC;CACzB;AAGD,eAAO,MAAM,kBAAkB,QAAO,MAAM,GAAG,SAY9C,CAAC;AAIF;;;;GAIG;AACH,eAAO,MAAM,WAAW,gBAAuB,MAAM,oEAapD,CAAC;AAEF,eAAO,MAAM,cAAc,cACd,MAAM,kCAEP,MAAM,4BAwBjB,CAAC;AAEF,eAAO,MAAM,mBAAmB,eAClB,MAAM,EAAE,kCAEV,MAAM,4BAwBjB,CAAC"}
+{"version":3,"file":"trouble-services.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/trouble/services/trouble-services.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,kBAAkB,EAGnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAkB,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAO1E,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,GAAG,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,GAAG,CAAC;CACX;AACD;;;;GAIG;AACH,eAAO,MAAM,WAAW,kEAGvB,CAAC;AAEF,eAAO,MAAM,cAAc,cAAqB,MAAM,YAAY,MAAM,4BAqBvE,CAAC;AAEF,eAAO,MAAM,mBAAmB,eAClB,MAAM,EAAE,YACV,MAAM,4BAuBjB,CAAC"}

package/models/models/trouble/trouble-model.d.ts

@@ -1,5 +1,4 @@
 import { DeferAware, TroubleModel, TroubleOptions } from './types';
-import { TroubleResponse } from './services';
 import { FutureAwareContainer } from '../future/future-types';
 import { IKosModelLogger, KosContextLogger, KosCreationContext } from '../../../core';
 
@@ -19,12 +18,10 @@ export declare class TroubleModelImpl<AdditionalData extends object = any> imple
     tags: string[];
     data: AdditionalData;
     rank: number;
-    servicePath: string;
     group?: string;
     createTime?: string;
-    rawJson?: TroubleResponse<any>;
     private _mapped;
-    constructor(modelId: string, { resolvable, tags, info, id, clientData, rank, ifaces, type, group, createTime, role, color, servicePath, rawJson, ...rest }: TroubleOptions, context: KosCreationContext);
+    constructor(modelId: string, { resolvable, tags, info, id, clientData, rank, ifaces, type, group, createTime, role, color, ...rest }: TroubleOptions, context: KosCreationContext);
     getTitleWithContext(context: string): string;
     getSubtitleWithContext(context: string): string;
     get rawId(): string;

package/models/models/trouble/trouble-model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trouble-model.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/trouble/trouble-model.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACxB,MAAM,eAAe,CAAC;AAGvB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAGnE,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAExE,eAAO,MAAM,UAAU,kBAAkB,CAAC;AAM1C,qBACa,gBAAgB,CAAC,cAAc,SAAS,MAAM,GAAG,GAAG,CAC/D,YAAW,YAAY,CAAC,cAAc,CAAC,EAAE,eAAe;IAExD,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAU;IAE7B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,oBAAoB,CAAC;IACpC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC;IAC/B,OAAO,CAAC,OAAO,CAAwB;gBAErC,OAAO,EAAE,MAAM,EACf,EACE,UAAU,EACV,IAAI,EACJ,IAAI,EACJ,EAAE,EACF,UAAU,EACV,IAAI,EACJ,MAAM,EACN,IAAI,EACJ,KAAK,EACL,UAAU,EACV,IAAI,EACJ,KAAK,EACL,WAAW,EACX,OAAO,EACP,GAAG,IAAI,EACR,EAAE,cAAc,EACjB,OAAO,EAAE,kBAAkB;IA0B7B,mBAAmB,CAAC,OAAO,EAAE,MAAM;IAWnC,sBAAsB,CAAC,OAAO,EAAE,MAAM;IAWtC,IAAI,KAAK,WAER;IACD,IAAI,KAAK,WAER;IAED,IAAI,QAAQ,WAEX;IAED,IAAI,SAAS,WAEZ;IAED,IAAI,UAAU,YAEb;IAED,IAAI,MAAM,uFAET;IAEK,iBAAiB;IAIvB,IAAI,iBAAiB,qEAMpB;IACD,IAAI,QAAQ,YAKX;IACD,IAAI,WAAW,IAAI,OAAO,CAMzB;IAED,UAAU;IAGV,KAAK;IAIL,WAAW;IAML,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM;CAc/B"}
+{"version":3,"file":"trouble-model.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/trouble/trouble-model.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACxB,MAAM,eAAe,CAAC;AAGvB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAInE,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAExE,eAAO,MAAM,UAAU,kBAAkB,CAAC;AAM1C,qBACa,gBAAgB,CAAC,cAAc,SAAS,MAAM,GAAG,GAAG,CAC/D,YAAW,YAAY,CAAC,cAAc,CAAC,EAAE,eAAe;IAExD,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAU;IAE7B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,oBAAoB,CAAC;IACpC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IAEb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,OAAO,CAAwB;gBAErC,OAAO,EAAE,MAAM,EACf,EACE,UAAU,EACV,IAAI,EACJ,IAAI,EACJ,EAAE,EACF,UAAU,EACV,IAAI,EACJ,MAAM,EACN,IAAI,EACJ,KAAK,EACL,UAAU,EACV,IAAI,EACJ,KAAK,EACL,GAAG,IAAI,EACR,EAAE,cAAc,EACjB,OAAO,EAAE,kBAAkB;IAyB7B,mBAAmB,CAAC,OAAO,EAAE,MAAM;IAWnC,sBAAsB,CAAC,OAAO,EAAE,MAAM;IAWtC,IAAI,KAAK,WAER;IACD,IAAI,KAAK,WAER;IAED,IAAI,QAAQ,WAEX;IAED,IAAI,SAAS,WAEZ;IAED,IAAI,UAAU,YAEb;IAED,IAAI,MAAM,uFAET;IAEK,iBAAiB;IAIvB,IAAI,iBAAiB,qEAMpB;IACD,IAAI,QAAQ,YAKX;IACD,IAAI,WAAW,IAAI,OAAO,CAMzB;IAED,UAAU;IAGV,KAAK;IAIL,WAAW;IAML,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM;CAc/B"}

package/models/models/trouble/types/index.d.ts

@@ -28,9 +28,8 @@ import { IKosDataModel } from '../../../core';
  * };
  * ```
  *
- * @kosService core.trouble-aware
- * @group KOS Model
- * @category Types
+ * @category Trouble Management
+ * @subcategory Types
  */
 export interface TroubleOptions<AdditionalData extends object = any> {
   /** Whether this trouble can be resolved through user action */
@@ -59,10 +58,6 @@ export interface TroubleOptions<AdditionalData extends object = any> {
   info: unknown;
   /** Optional grouping identifier for related troubles */
   group?: string;
-  /** Service path for the trouble instance */
-  servicePath?: string;
-  /** Raw JSON data for the trouble instance */
-  rawJson?: TroubleResponse<any>;
   /** Index signature for additional domain-specific data */
   [key: keyof AdditionalData]: AdditionalData[key];
 }
@@ -85,24 +80,96 @@ export interface TroubleOptions<AdditionalData extends object = any> {
  *
  * @template AdditionalData - Type parameter for domain-specific trouble data
  *
- * @interface
- * @example Basic Usage
+ * @example
  * ```typescript
+ * // Check trouble severity
  * function handleTrouble(trouble: TroubleModel) {
  *   if (trouble.rank >= 8) {
  *     console.error(`Critical trouble: ${trouble.reason}`);
+ *     notifyOperator(trouble);
+ *   } else if (trouble.rank >= 5) {
+ *     console.warn(`Warning: ${trouble.reason}`);
+ *   }
+ *
+ *   // Check if user can resolve
+ *   if (trouble.resolvable && hasRole(trouble.role)) {
+ *     showResolveButton(trouble);
+ *   }
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Resolve a trouble with proper future handling
+ * async function resolveTrouble(trouble: TroubleModel) {
+ *   if (!trouble.resolvable) {
+ *     throw new Error('Trouble is not resolvable');
  *   }
  *
- *   if (trouble.resolvable) {
+ *   try {
+ *     // Resolution returns a FutureResponse with future tracking
  *     const futureResponse = await trouble.resolve();
+ *     if (futureResponse) {
+ *       console.log(`Resolution started, future ID: ${futureResponse.id}`);
+ *
+ *       // The trouble's future property will be updated with the resolution future
+ *       // You can track progress through the future model
+ *       if (trouble.future) {
+ *         const endState = await trouble.future.waitForCompletion();
+ *         if (endState === 'COMPLETED') {
+ *           console.log('Trouble resolved successfully');
+ *         } else if (endState === 'FAILED') {
+ *           console.error('Resolution failed');
+ *         }
+ *       }
+ *     }
+ *   } catch (error) {
+ *     console.error('Failed to initiate resolution:', error);
+ *   }
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Using cancellable promise utilities with trouble resolution
+ * import { createCancellablePromise } from '@kosdev-code/kos-ui-sdk';
+ *
+ * async function resolveTroubleWithCancel(trouble: TroubleModel) {
+ *   const futureResponse = await trouble.resolve();
+ *
+ *   if (futureResponse && trouble.future) {
+ *     // Create a cancellable promise for the resolution
+ *     const cancellableResolve = createCancellablePromise(
+ *       trouble.future.waitForCompletion(),
+ *       undefined,
+ *       () => trouble.future?.cancelFuture(),
+ *       trouble.future
+ *     );
+ *
+ *     // Subscribe to progress updates
+ *     const unsubscribe = cancellableResolve.onProgressUpdate((progress, status) => {
+ *       console.log(`Resolution progress: ${(progress * 100).toFixed(0)}% - ${status}`);
+ *     });
+ *
+ *     try {
+ *       const endState = await cancellableResolve;
+ *       console.log(`Resolution completed with state: ${endState}`);
+ *     } catch (error) {
+ *       if (cancellableResolve.isCancelled()) {
+ *         console.log('Resolution was cancelled');
+ *       } else {
+ *         console.error('Resolution failed:', error);
+ *       }
+ *     } finally {
+ *       unsubscribe();
+ *     }
  *   }
  * }
  * ```
  *
- * @useDeclaredType
- * @kosService core.trouble-aware
- * @group KOS Model
- * @category Trouble Management
+ *
+ * @category KOS Model
+ * @subcategory Trouble Management
  *
  * @see {@link TroubleAware} - Interface for models that can have troubles
  * @see {@link DeferAware} - Deferral capabilities
@@ -134,8 +201,6 @@ export interface TroubleModel<AdditionalData extends object = any>
   info: unknown;
   /** Original trouble ID before any transformations */
   rawId: string;
-  /** Full response data object */
-  rawJson?: TroubleResponse<any>;
   /** Resolves the trouble, returning a promise with the resolution response */
   resolve: () => Promise<FutureResponse | undefined>;
   /** Domain-specific additional data attached to the trouble */
@@ -155,9 +220,8 @@ export interface TroubleModel<AdditionalData extends object = any>
 /**
  * Domain-specific trouble data for handle-related issues.
  *
- * @kosService core.trouble-aware
- * @group KOS Model
- * @category Domain Data
+ * @category Trouble Management
+ * @subcategory Domain Data
  */
 export interface HandleTroubleData {
   /** Path to the affected handle component */
@@ -167,9 +231,8 @@ export interface HandleTroubleData {
 /**
  * Domain-specific trouble data for nozzle-related issues.
  *
- * @kosService core.trouble-aware
- * @group KOS Model
- * @category Domain Data
+ * @category Trouble Management
+ * @subcategory Domain Data
  */
 export interface NozzleTroubleData {
   /** Path to the affected nozzle component */
@@ -179,9 +242,8 @@ export interface NozzleTroubleData {
 /**
  * Domain-specific trouble data for container-related issues.
  *
- * @kosService core.trouble-aware
- * @group KOS Model
- * @category Domain Data
+ * @category Trouble Management
+ * @subcategory Domain Data
  */
 export interface ContainerTroubleData {
   /** Identifier of the affected container */
@@ -208,9 +270,8 @@ export interface ContainerTroubleData {
  * }
  * ```
  *
- * @kosService core.trouble-aware
- * @group KOS Model
- * @category Capabilities
+ * @category Trouble Management
+ * @subcategory Capabilities
  */
 export interface ResolveAware {
   /**
@@ -253,9 +314,8 @@ export interface ResolveAware {
  * }
  * ```
  *
- * @kosService core.trouble-aware
- * @group KOS Model
- * @category Capabilities
+ * @category Trouble Management
+ * @subcategory Capabilities
  */
 export interface DeferAware {
   /** Whether this item should be deferred based on current conditions */
@@ -350,9 +410,8 @@ export interface DeferAware {
  * }
  * ```
  *
- * @kosService core.trouble-aware
- * @group KOS Model
- * @category Interfaces
+ * @category Trouble Management
+ * @subcategory Interfaces
  *
  * @see {@link TroubleModel} - The trouble model interface
  * @see {@link isTroubleAware} - Type guard for checking TroubleAware

package/models/models/trouble/utils/is-trouble-aware.d.ts

@@ -9,7 +9,7 @@ import { TroubleAware } from '../types';
  * object, which are required by the TroubleAware interface.
  *
  * @category Utilities
- * @category Trouble Management
+ * @subcategory Trouble Management
  *
  * @param obj - The object to check for trouble awareness. Can be any type.
  *
@@ -94,5 +94,5 @@ import { TroubleAware } from '../types';
  * @see {@link TroubleAware} - The interface this function checks for
  * @see {@link useTroubleDecoration} - Hook that uses this guard internally
  */
-export declare function isTroubleAware(obj?: any): obj is TroubleAware;
+export declare function isTroubleAware(obj: any): obj is TroubleAware;
 //# sourceMappingURL=is-trouble-aware.d.ts.map

package/models/models/trouble/utils/is-trouble-aware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"is-trouble-aware.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/trouble/utils/is-trouble-aware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6FG;AACH,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,GAAG,IAAI,YAAY,CAO7D"}
+{"version":3,"file":"is-trouble-aware.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/trouble/utils/is-trouble-aware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6FG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,YAAY,CAO5D"}