@kosdev-code/kos-ui-sdk 0.1.0-dev.5789 → 0.1.0-dev.5797

package/kos-models.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-03-24T15:19:11.321Z",
+  "generatedAt": "2026-03-26T13:35:31.418Z",
   "packageName": "@kosdev-code/kos-ui-sdk",
   "models": {
     "browser-router-model": {

package/models/models/browser-router/types/index.d.ts

@@ -16,6 +16,7 @@
  * });
  * ```
  *
+ * @kosService core.browser-router
  * @group KOS Model
  * @category Service Integration
  * @category Browser Router

package/models/models/canvas-dispatcher/types/index.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Configuration options for CanvasDispatcher model instances.
+ *
+ * @kosService core.canvas-dispatcher
+ */
 export interface CanvasDispatcherOptions {}
 declare type Renderer = {
   reset(): void;

package/models/models/canvas-renderer/types/index.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Configuration options for CanvasRenderer model instances.
+ *
+ * @kosService core.canvas-renderer
+ */
 export interface CanvasRendererOptions {
   height?: number;
   width?: number;

package/models/models/config-bean/types/index.d.ts

@@ -8,6 +8,7 @@ import { KosServiceResponse } from '../../../../core';
  * Specifies which configuration path to access and optionally provides custom
  * service implementations for testing or alternative backends.
  *
+ * @kosService core.use-config-property
  * @category Model Configuration
  * @category System Integration
  */

package/models/models/config-bean-prop/types/index.d.ts

@@ -29,6 +29,7 @@ import { UnitConverter } from '../../../decorators';
  * };
  * ```
  *
+ * @kosService core.use-config-property
  * @group KOS Model
  * @category Configuration
  */
@@ -77,6 +78,7 @@ export interface ConfigPropConverter {
  * };
  * ```
  *
+ * @kosService core.use-config-property
  * @group KOS Model
  * @category Configuration
  */
@@ -99,6 +101,7 @@ export type FormatOptions =
  * ];
  * ```
  *
+ * @kosService core.use-config-property
  * @group KOS Model
  * @category Configuration
  */
@@ -144,6 +147,7 @@ export interface OptionsType {
  * };
  * ```
  *
+ * @kosService core.use-config-property
  * @group KOS Model
  * @category Configuration
  */
@@ -183,6 +187,7 @@ export type OptionsExpander =
  * };
  * ```
  *
+ * @kosService core.use-config-property
  * @group KOS Model
  * @category Configuration
  */
@@ -299,6 +304,7 @@ export interface ConfigBeanPropOptions {
  * });
  * ```
  *
+ * @kosService core.use-config-property
  * @group KOS Model
  * @category Configuration
  */

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

@@ -16,6 +16,7 @@
  * const device = Device.factory(deviceOptions);
  * ```
  *
+ * @kosService core.device
  * @group KOS Model
  * @category Service Integration
  */

package/models/models/future/future-types.d.ts

@@ -4,8 +4,10 @@ import { IKosDataModel } from '../../../core';
 /**
  * Basic Future delegation interface for models that hold a single Future reference.
  *
+ * @kosService core.future-aware
  * @group KOS Model
  * @category Asynchronous Operations
+  * @kosApiLevel 2
  */
 export interface FutureDelegate<T extends {} = Record<string, unknown>> {
     future?: IFutureModel<T>;
@@ -34,8 +36,10 @@ export interface FutureDelegate<T extends {} = Record<string, unknown>> {
  * }
  * ```
  *
+ * @kosService core.future-aware
  * @group KOS Model
  * @category Asynchronous Operations
+  * @kosApiLevel 2
  */
 export interface FutureContainer<T extends {} = Record<string, unknown>> {
     futureHandler: FutureAwareContainer<T>;
@@ -44,8 +48,10 @@ export interface FutureContainer<T extends {} = Record<string, unknown>> {
 /**
  * Advanced pattern for models managing multiple named Future operations.
  *
+ * @kosService core.future-aware
  * @group KOS Model
  * @category Asynchronous Operations
+  * @kosApiLevel 7
  */
 export interface MultiFutureAware<T extends {} = Record<string, unknown>> {
     futureMap: Map<string, IFutureModel<T>>;
@@ -72,8 +78,10 @@ export interface MultiFutureAware<T extends {} = Record<string, unknown>> {
  * const activeFutures = container.allFutures;
  * ```
  *
+ * @kosService core.future-aware
  * @group KOS Model
  * @category Asynchronous Operations
+  * @kosApiLevel 2
  */
 export interface FutureAwareContainer<T extends {} = Record<string, unknown>> extends FutureDelegate<T> {
     removeFuture(alias?: string): void;
@@ -105,8 +113,10 @@ export interface FutureAwareContainer<T extends {} = Record<string, unknown>> ex
  * }
  * ```
  *
+ * @kosService core.future-aware
  * @group KOS Model
  * @category Asynchronous Operations
+  * @kosApiLevel 2
  */
 export interface FutureAware {
     readonly statusFuture?: IFutureModel;
@@ -141,8 +151,10 @@ export interface FutureAware {
  *   .build();
  * ```
  *
+ * @kosService core.future-aware
  * @group KOS Model
  * @category Asynchronous Operations
+  * @kosApiLevel 2
  */
 export interface IFutureModelOptions<T extends {} = Record<string, unknown>> {
     id: string;
@@ -234,6 +246,7 @@ export interface IFutureModelOptions<T extends {} = Record<string, unknown>> {
  * ```
  *
  * @interface
+ * @kosService core.future-aware
  * @group KOS Model
  * @category Asynchronous Operations
  * @useDeclaredType
@@ -241,6 +254,7 @@ export interface IFutureModelOptions<T extends {} = Record<string, unknown>> {
  * @see {@link IFutureModelOptions} - Configuration options for Future instances
  * @see {@link FutureAware} - Interface for models that integrate with Futures
  * @see {@link FutureContainer} - Container pattern for managing multiple Futures
+  * @kosApiLevel 2
  */
 export interface IFutureModel<T extends {} = Record<string, unknown>> extends IKosDataModel, Omit<IFutureModelOptions<T>, "modifyFuture"> {
     id: string;

package/models/models/future/future-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"future-types.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/future/future-types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"future-types.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/future/future-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACpE,MAAM,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACrE,aAAa,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC;IACvC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CACpE;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACtE,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;CACzC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAC1E,SAAQ,cAAc,CAAC,CAAC,CAAC;IACzB,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IACvD,SAAS,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzD,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9B,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CACpE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACzE,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EACP;QACE,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,GACD;QACE,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;KAChB,GACD;QACE,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;KAChB,EAAE,CAAC;IACR,UAAU,CAAC,EAAE,CAAC,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8EG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAClE,SAAQ,aAAa,EACnB,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,cAAc,CAAC;IAC9C,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EACP;QACE,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;KAChB,GACD;QACE,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;KAChB,EAAE,CAAC;IACR,UAAU,CAAC,EAAE,CAAC,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,aAAa,EAAE,MAAM,CAAC;CACvB"}

package/models/models/gpio-chip/types/index.d.ts

@@ -1,5 +1,10 @@
 // ---------------  GpioChip ---------------
 
+/**
+ * Configuration options for GpioChip model instances.
+ *
+ * @kosService core.gpio
+ */
 export interface GpioChipOptions {
   num: number;
   devName: string;
@@ -9,6 +14,11 @@ export interface GpioChipOptions {
 }
 
 // ---------------  GpioChipContainer ---------------
+/**
+ * Configuration options for GpioChipContainer model instances.
+ *
+ * @kosService core.gpio
+ */
 export interface GpioChipContainerOptions {
   destinationAddress?: string;
 }

package/models/models/gpio-pin/types/index.d.ts

@@ -1,5 +1,10 @@
 // ---------------  GpioPin ---------------
 
+/**
+ * Configuration options for GpioPin model instances.
+ *
+ * @kosService core.gpio
+ */
 export interface GpioPinOptions {
   name: string;
   chipNum: number;
@@ -10,4 +15,9 @@ export interface GpioPinOptions {
 }
 
 // ---------------  GpioPinContainer ---------------
+/**
+ * Configuration options for GpioPinContainer model instances.
+ *
+ * @kosService core.gpio
+ */
 export interface GpioPinContainerOptions {}

package/models/models/key-value/types/index.d.ts

@@ -42,6 +42,7 @@
  * ];
  * ```
  *
+ * @kosService core.key-value
  * @group KOS Model
  * @category Data Persistence
  * @category Key-Value Store

package/models/models/kos-expression-evaluator/types/index.d.ts

@@ -1 +1,6 @@
+/**
+ * Configuration options for KosExpressionEvaluator model instances.
+ *
+ * @kosService core.kos-expression-evaluator
+ */
 export interface KosExpressionEvaluatorOptions {}

package/models/models/kos-log-manager/types/index.d.ts

@@ -16,6 +16,7 @@
  *   .build();
  * ```
  *
+ * @kosService core.logging
  * @group KOS Model
  * @category Device Logging
  */
@@ -42,6 +43,7 @@ export interface KosLogManagerOptions {}
  * const troubleshootingLevel: LogLevelNames = 'trace';
  * ```
  *
+ * @kosService core.logging
  * @group KOS Model
  * @category Device Logging
  */
@@ -99,6 +101,7 @@ export type LogLevelNames = "trace" | "debug" | "info" | "warn" | "error";
  * // ... and all other loggers starting with 'kos-ui-sdk'
  * ```
  *
+ * @kosService core.logging
  * @group KOS Model
  * @category Device Logging
  */
@@ -179,6 +182,7 @@ export interface LogOverride {
  * );
  * ```
  *
+ * @kosService core.logging
  * @group KOS Model
  * @category Device Logging
  */

package/models/models/kos-time/types/index.d.ts

@@ -21,6 +21,7 @@
  * await timeModel.updateSystemTime(morningTime);
  * ```
  *
+ * @kosService core.kos-time
  * @category System Integration
  * @category Time Management
  */
@@ -56,6 +57,7 @@ export interface TimeBean {
  * await timeModel.updateSystemDate(newYear);
  * ```
  *
+ * @kosService core.kos-time
  * @category System Integration
  * @category Time Management
  */
@@ -86,6 +88,7 @@ export interface DateBean {
  *   .build();
  * ```
  *
+ * @kosService core.kos-time
  * @category Model Configuration
  * @category System Integration
  */

package/models/models/log-block/types/index.d.ts

@@ -25,6 +25,7 @@
  *   .build();
  * ```
  *
+ * @kosService core.logging
  * @group KOS Model
  * @category Device Logging
  */
@@ -101,6 +102,7 @@ export interface LogBlockOptions {
  * configuration options such as block sorting preferences, memory limits,
  * or automatic cleanup policies.
  *
+ * @kosService core.logging
  * @group KOS Model
  * @category Device Logging
  */
@@ -114,6 +116,7 @@ export interface LogBlockContainerOptions {}
  * as received from the KOS system. Similar to LogBlockOptions but uses
  * timestamp numbers instead of Date objects for serialization efficiency.
  *
+ * @kosService core.logging
  * @group KOS Model
  * @category Device Logging
  */
@@ -142,6 +145,7 @@ export interface LogBlockType {
  * Used in topic handlers for log line events, containing both the actual
  * log lines and the block metadata. Extends LogBlockType with the lines array.
  *
+ * @kosService core.logging
  * @group KOS Model
  * @category Device Logging
  */

package/models/models/log-stream/types/index.d.ts

@@ -36,6 +36,7 @@
  *   .build();
  * ```
  *
+ * @kosService core.logging
  * @group KOS Model
  * @category Device Logging
  */
@@ -79,8 +80,9 @@ export interface LogStreamOptions {
  *   .build();
  * ```
  *
+ * @kosService core.logging
  * @category Model Configuration
- * @category Data Persistence  
+ * @category Data Persistence
  */
 // eslint-disable-next-line @typescript-eslint/no-empty-interface
 export interface LogStreamContainerOptions {}

package/models/models/network-interface/types/index.d.ts

@@ -19,6 +19,7 @@ import { NetworkInterfaceData } from '../services';
  * };
  * ```
  *
+ * @kosService core.network
  * @group KOS Model
  * @category Network Interfaces
  */

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

@@ -1,9 +1,19 @@
+/**
+ * Status values for OTA artifact installation state.
+ *
+ * @kosService core.ota
+ */
 export type OTAStatus =
   | "INSTALLED" // Green Check
   | "INVALID"
   | "MISSING"
   | "STAGED"; // Green Half Check
 
+/**
+ * Information about an OTA artifact.
+ *
+ * @kosService core.ota
+ */
 export interface OTAArtifactInfo {
   hash: string;
   identifier: string;
@@ -13,6 +23,11 @@ export interface OTAArtifactInfo {
   version?: string;
 }
 
+/**
+ * OTA download request information.
+ *
+ * @kosService core.ota
+ */
 export interface OTARequest {
   currentSize: number;
   downloaderActive: boolean;
@@ -24,6 +39,11 @@ export interface OTARequest {
   lastUpdateTime: number;
 }
 
+/**
+ * Response from the OTA artifact service.
+ *
+ * @kosService core.ota
+ */
 export interface OTAArtifactResponse {
   artifactInfo?: OTAArtifactInfo;
   done: boolean;
@@ -32,6 +52,11 @@ export interface OTAArtifactResponse {
   status: OTAStatus;
 }
 
+/**
+ * Status values for an individual updater operation.
+ *
+ * @kosService core.ota
+ */
 export type UpdaterStatus =
   | "downloading"
   | "error"
@@ -39,6 +64,11 @@ export type UpdaterStatus =
   | "pending"
   | "ready";
 
+/**
+ * Individual update item tracking information.
+ *
+ * @kosService core.ota
+ */
 export interface UpdaterItem {
   manifest?: boolean;
   error?: string;
@@ -194,6 +224,7 @@ export interface UpdaterItem {
  * };
  * ```
  *
+ * @kosService core.ota
  * @category Model Configuration
  * @category System Integration
  */

package/models/models/region-info/types/index.d.ts

@@ -27,8 +27,10 @@ import { IKosDataModel } from '../../../../core';
  * console.log(result); // '8.047'
  * ```
  *
+ * @kosService core.region-info
  * @group KOS Model
  * @category Region Info
+ * @kosApiLevel 2
  */
 export interface UnitSource {
     /** Measurement system identifier (e.g., 'metric', 'imperial', 'us') */
@@ -38,10 +40,35 @@ export interface UnitSource {
     /** Specific unit name (e.g., 'meter', 'kilogram', 'fahrenheit') */
     unit?: string;
 }
+/**
+ * Key type for measure maps — a string or the literal 'default'.
+ *
+ * @kosService core.region-info
+ */
 export type MeasureMapKeys = string | "default";
+/**
+ * Record mapping MeasureMapKeys to Unit, defining units for each measurement system.
+ *
+ * @kosService core.region-info
+ */
 export type SystemMeasureMap = Record<MeasureMapKeys, Unit>;
+/**
+ * Record mapping measurement types to their respective SystemMeasureMap.
+ *
+ * @kosService core.region-info
+ */
 export type MeasureMap = Record<string, SystemMeasureMap>;
+/**
+ * Record mapping strings, typically used for default settings.
+ *
+ * @kosService core.region-info
+ */
 export type SystemDefaultMap = Record<string, string>;
+/**
+ * Record mapping unit systems to their default settings.
+ *
+ * @kosService core.region-info
+ */
 export type DefaultMeasureMap = Record<string, SystemDefaultMap>;
 /**
  * Configuration options for creating RegionInfoModel instances.
@@ -58,6 +85,7 @@ export type DefaultMeasureMap = Record<string, SystemDefaultMap>;
  * const regionModel = RegionInfo.instance().options(options).build();
  * ```
  *
+ * @kosService core.region-info
  * @group KOS Model
  * @category Region Info
  */
@@ -83,8 +111,10 @@ interface FormatOptions extends BaseOptions {
  * ];
  * ```
  *
+ * @kosService core.region-info
  * @group KOS Model
  * @category Region Info
+ * @kosApiLevel 2
  */
 export interface TimeFormatOptions extends FormatOptions {
     /** True if using 12-hour format with AM/PM, false for 24-hour format */
@@ -105,8 +135,10 @@ export interface TimeFormatOptions extends FormatOptions {
  * ];
  * ```
  *
+ * @kosService core.region-info
  * @group KOS Model
  * @category Region Info
+ * @kosApiLevel 2
  */
 export interface DateFormatOptions extends FormatOptions {
     /** Order of date components: 'MDY', 'DMY', 'YMD', etc. */
@@ -127,8 +159,10 @@ export interface DateFormatOptions extends FormatOptions {
  * ];
  * ```
  *
+ * @kosService core.region-info
  * @group KOS Model
  * @category Region Info
+ * @kosApiLevel 2
  */
 export interface UnitSystemOptions extends BaseOptions {
     /** Display name of the unit system (e.g., 'Metric System', 'Imperial System') */
@@ -168,12 +202,14 @@ export interface UnitSystemOptions extends BaseOptions {
  * console.log(regionModel.selectedCountry);     // 'us'
  * ```
  *
+ * @kosService core.region-info
  * @group KOS Model
  * @category Region Info
  * @useDeclaredType
  *
  * @see {@link UnitSource} - Unit conversion source specification
  * @see {@link RegionInfoOptions} - Configuration options for RegionInfoModel instances
+ * @kosApiLevel 2
  */
 export interface RegionInfoModel<AdditionalData extends BaseRegionResponse = BaseRegionResponse> extends RegionInfoOptions, IKosDataModel {
     /** Unique identifier for the region model instance. */
@@ -192,6 +228,9 @@ export interface RegionInfoModel<AdditionalData extends BaseRegionResponse = Bas
     readonly selectedCountry: string;
     /** The currently selected time zone. */
     readonly selectedTimeZone: string;
+    /**
+     * @kosApiLevel 22
+     */
     readonly serviceBasePath: string;
     /**
      * The detailed information of the selected region, extended with additional data.
@@ -277,6 +316,11 @@ export interface RegionInfoModel<AdditionalData extends BaseRegionResponse = Bas
      */
     getDefaultUnitDecimalPlaces(measure: string, unitSystem: string, unit?: string): number;
 }
+/**
+ * Enum for keys used in UnitTuple.
+ *
+ * @kosService core.region-info
+ */
 export declare enum UnitTupleKeys {
     family = 0,
     scale = 1,
@@ -285,6 +329,11 @@ export declare enum UnitTupleKeys {
     alias = 4,
     system = 5
 }
+/**
+ * Tuple type for unit properties: family, scale, offset, decimals, alias.
+ *
+ * @kosService core.region-info
+ */
 export type UnitTuple = [
     family: string,
     scale: number,

package/models/models/region-info/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/region-info/types/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/region-info/types/index.ts"],"names":[],"mappings":"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"}

package/models/models/software-info/types/index.d.ts

@@ -14,6 +14,7 @@ import { PublicModelInterface } from '../../../../core';
  * const softwareInfo = SoftwareInfo.instance('system-info').build();
  * ```
  *
+ * @kosService core.software-info
  * @category Model Configuration
  * @category System Integration
  */
@@ -24,6 +25,7 @@ export interface SoftwareInfoOptions {
 
 /**
  * @interface
+ * @kosService core.software-info
  * @useDeclaredType
  */
 export type SoftwareInfoModel = PublicModelInterface<SoftwareInfoModelImpl>;
@@ -34,6 +36,7 @@ export type SoftwareInfoModel = PublicModelInterface<SoftwareInfoModelImpl>;
  * This interface describes a software artifact (component, package, or module)
  * installed on a KOS device node, including its identification, grouping, and version.
  *
+ * @kosService core.software-info
  * @group KOS Model
  * @category Types
  */
@@ -53,6 +56,7 @@ export interface ArtifactsType {
  * including the node identification, KOS framework version, and all installed artifacts
  * organized by functional groups.
  *
+ * @kosService core.software-info
  * @group KOS Model
  * @category Types
  */

package/models/models/state-bean/types/index.d.ts

@@ -48,6 +48,7 @@ import { StatePropertyTypes } from '../../types';
  *   .build();
  * ```
  *
+ * @kosService core.state-bean
  * @category Model Configuration
  * @category State Management
  */
@@ -100,6 +101,7 @@ type StateKeys<T extends Record<string, StatePropertyTypes>> = keyof T;
  *
  * @template T - The state property type mapping
  *
+ * @kosService core.state-bean
  * @group KOS Model
  * @category Types
  */
@@ -112,6 +114,7 @@ export type StatePropsMap<T> = Map<StateKeys<T>, T[keyof T]>;
  * access to device state properties through an observable Map structure. The interface
  * supports real-time synchronization with device state via WebSocket topics.
  *
+ * @kosService core.state-bean
  * @group KOS Model
  * @category Model Interface
  */

package/models/models/state-prop/types/index.d.ts

@@ -18,6 +18,7 @@ import { StatePropertyTypes } from '../../types';
  *   .build();
  * ```
  *
+ * @kosService core.state-prop
  * @category Model Configuration
  * @category State Management
  */
@@ -51,6 +52,7 @@ export interface StatePropOptions {
  * access to individual properties within a StateBean through automatic dependency
  * management and reactive value updates.
  *
+ * @kosService core.state-prop
  * @group KOS Model
  * @category Model Interface
  */