@kosdev-code/kos-ddk-model-components 0.1.0-dev.10

package/hooks/start/with-start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-start.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-ddk-model-components/src/hooks/start/with-start.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAGzD,UAAU,UAAU;IAClB,KAAK,EAAE,UAAU,CAAC;CACnB;AAED,KAAK,aAAa,GAAG,UAAU,CAAC;AAEhC,wBAAgB,SAAS,CAAC,CAAC,SAAS,aAAa,GAAG,aAAa,EAC/D,gBAAgB,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,IAEhC,OAAO,IAAI,CAAC,CAAC,EAAE,MAAM,UAAU,CAAC,sDASzC"}

package/hooks/test/index.d.ts

@@ -0,0 +1,3 @@
+export * from './use-test';
+export * from './with-test';
+//# sourceMappingURL=index.d.ts.map

package/hooks/test/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-ddk-model-components/src/hooks/test/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/hooks/test/use-test.d.ts

@@ -0,0 +1,13 @@
+import { TestModel } from '../../models';
+export declare const useTest: () => {
+    model: TestModel | undefined;
+    ready: boolean;
+    error: string | undefined;
+    status: {
+        model: TestModel | undefined;
+        ready: boolean;
+        error: string | undefined;
+    };
+    KosModelLoader: import('react').FunctionComponent<import('react').PropsWithChildren<import('node_modules/@kosdev-code/kos-ui-sdk/ui/components/error-boundary/error-boundary').ErrorBoundaryProps & import('@kosdev-code/kos-ui-sdk').KosModelLoaderProps>>;
+};
+//# sourceMappingURL=use-test.d.ts.map

package/hooks/test/use-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-test.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-ddk-model-components/src/hooks/test/use-test.ts"],"names":[],"mappings":"AACA,OAAO,EAAQ,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAEpD,eAAO,MAAM,OAAO;;;;;;;;;;CASnB,CAAC"}

package/hooks/test/with-test.d.ts

@@ -0,0 +1,6 @@
+import { TestModel } from '../../models';
+export interface TestProps {
+    test: TestModel;
+}
+export declare function withTest<T extends TestProps = TestProps>(WrappedComponent: React.ComponentType<T>): (props: Omit<T, keyof TestProps>) => import("@emotion/react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=with-test.d.ts.map

package/hooks/test/with-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-test.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-ddk-model-components/src/hooks/test/with-test.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG9C,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,wBAAgB,QAAQ,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,EACtD,gBAAgB,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,IAEhC,OAAO,IAAI,CAAC,CAAC,EAAE,MAAM,SAAS,CAAC,sDASxC"}

package/hooks/trouble-action/index.d.ts

@@ -0,0 +1,3 @@
+export * from './use-trouble-action';
+export * from './with-trouble-action';
+//# sourceMappingURL=index.d.ts.map

package/hooks/trouble-action/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-ddk-model-components/src/hooks/trouble-action/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC"}

package/hooks/trouble-action/use-trouble-action.d.ts

@@ -0,0 +1,13 @@
+import { TroubleActionManagerModel } from '../../../../kos-ddk-models/src/index.ts';
+export declare const useTroubleActionState: () => {
+    model: TroubleActionManagerModel | undefined;
+    ready: boolean;
+    error: string | undefined;
+    status: {
+        model: TroubleActionManagerModel | undefined;
+        ready: boolean;
+        error: string | undefined;
+    };
+    KosModelLoader: import('react').FunctionComponent<import('react').PropsWithChildren<import('node_modules/@kosdev-code/kos-ui-sdk/ui/components/error-boundary/error-boundary').ErrorBoundaryProps & import('@kosdev-code/kos-ui-sdk').KosModelLoaderProps>>;
+};
+//# sourceMappingURL=use-trouble-action.d.ts.map

package/hooks/trouble-action/use-trouble-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-trouble-action.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-ddk-model-components/src/hooks/trouble-action/use-trouble-action.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,yBAAyB,EAE/B,MAAM,6BAA6B,CAAC;AAKrC,eAAO,MAAM,qBAAqB;;;;;;;;;;CAmBjC,CAAC"}

package/hooks/trouble-action/with-trouble-action.d.ts

@@ -0,0 +1,8 @@
+import { TroubleActionManagerModel } from '../../../../kos-ddk-models/src/index.ts';
+interface TroubleActionProps {
+    troubleAction: TroubleActionManagerModel;
+}
+type HoCTroubleActionProps = TroubleActionProps;
+export declare function withTroubleAction<T extends HoCTroubleActionProps = HoCTroubleActionProps>(WrappedComponent: React.ComponentType<T>): (props: Omit<T, keyof TroubleActionProps>) => import("@emotion/react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=with-trouble-action.d.ts.map

package/hooks/trouble-action/with-trouble-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-trouble-action.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-ddk-model-components/src/hooks/trouble-action/with-trouble-action.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAGxE,UAAU,kBAAkB;IAC1B,aAAa,EAAE,yBAAyB,CAAC;CAC1C;AAED,KAAK,qBAAqB,GAAG,kBAAkB,CAAC;AAEhD,wBAAgB,iBAAiB,CAC/B,CAAC,SAAS,qBAAqB,GAAG,qBAAqB,EACvD,gBAAgB,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,IAChC,OAAO,IAAI,CAAC,CAAC,EAAE,MAAM,kBAAkB,CAAC,sDASjD"}

package/hooks/troubles/index.d.ts

@@ -0,0 +1,4 @@
+export * from './use-trouble-data';
+export * from './use-trouble-decoration';
+export * from './use-trouble-visibility';
+//# sourceMappingURL=index.d.ts.map

package/hooks/troubles/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-ddk-model-components/src/hooks/troubles/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC"}

package/hooks/troubles/use-trouble-data.d.ts

@@ -0,0 +1,3 @@
+import { TroubleModel } from '@kosdev-code/kos-ui-sdk';
+export declare const useTroubleData: (trouble?: TroubleModel) => Record<string, any>;
+//# sourceMappingURL=use-trouble-data.d.ts.map

package/hooks/troubles/use-trouble-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-trouble-data.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-ddk-model-components/src/hooks/troubles/use-trouble-data.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAGhF,eAAO,MAAM,cAAc,GAAI,UAAU,YAAY,wBAcpD,CAAC"}

package/hooks/troubles/use-trouble-decoration.d.ts

@@ -0,0 +1,110 @@
+import { IKosDataModel } from '@kosdev-code/kos-ui-sdk';
+/**
+ * Hook for applying visual decorations based on trouble states in KOS models.
+ *
+ * This hook analyzes trouble states associated with a KOS data model and returns
+ * styling properties that can be applied to UI components to visually indicate
+ * trouble severity and status. It automatically determines appropriate background
+ * and text colors based on the highest priority trouble.
+ *
+ * @category Hooks
+ * @subcategory Trouble Management
+ *
+ * @param model - The KOS data model to check for troubles. Must implement IKosDataModel.
+ *                If the model is not trouble-aware, an empty object is returned.
+ *
+ * @returns An object containing styling and trouble information:
+ * - `backgroundColor` - The background color derived from the highest priority trouble
+ * - `fontColor` - Appropriate text color (white for dark backgrounds, undefined for light)
+ * - `highestTrouble` - Reference to the highest priority trouble model
+ * - `initialized` - Whether trouble data has been initialized
+ * - `troubleCount` - Total number of visible troubles
+ * - `hasTroubles` - Boolean indicating if any troubles exist
+ *
+ * @example
+ * ```tsx
+ * // Basic usage in a component
+ * const MyComponent = ({ model }) => {
+ *   const { backgroundColor, fontColor, hasTroubles } = useTroubleDecoration(model);
+ *
+ *   return (
+ *     <div style={{ backgroundColor, color: fontColor }}>
+ *       {hasTroubles && <TroubleIndicator />}
+ *       <span>Component content</span>
+ *     </div>
+ *   );
+ * };
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Using trouble count for badges
+ * const TroubleCard = ({ dataModel }) => {
+ *   const {
+ *     backgroundColor,
+ *     fontColor,
+ *     troubleCount,
+ *     highestTrouble
+ *   } = useTroubleDecoration(dataModel);
+ *
+ *   return (
+ *     <Card style={{ borderColor: backgroundColor }}>
+ *       {troubleCount > 0 && (
+ *         <Badge color={backgroundColor} textColor={fontColor}>
+ *           {troubleCount} issue{troubleCount > 1 ? 's' : ''}
+ *         </Badge>
+ *       )}
+ *       {highestTrouble && (
+ *         <TroubleDetails trouble={highestTrouble} />
+ *       )}
+ *     </Card>
+ *   );
+ * };
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Conditional rendering based on initialization
+ * const SafeTroubleDisplay = ({ model }) => {
+ *   const { initialized, hasTroubles, backgroundColor } = useTroubleDecoration(model);
+ *
+ *   if (!initialized) {
+ *     return <LoadingSpinner />;
+ *   }
+ *
+ *   if (!hasTroubles) {
+ *     return <SuccessMessage>No issues detected</SuccessMessage>;
+ *   }
+ *
+ *   return (
+ *     <Alert severity="warning" style={{ backgroundColor }}>
+ *       Issues detected - check system status
+ *     </Alert>
+ *   );
+ * };
+ * ```
+ *
+ * @remarks
+ * - This hook only works with trouble-aware models (models that implement the TroubleAware interface)
+ * - Colors are automatically adjusted for accessibility (dark text on light backgrounds, light text on dark)
+ * - The hook respects role-based visibility filters applied by useVisibleTroubles
+ * - Re-renders automatically when trouble states change due to the underlying kosAutoEffect
+ *
+ * @see {@link useVisibleTroubles} - For accessing the filtered trouble list directly
+ * @see {@link isTroubleAware} - For checking if a model supports trouble tracking
+ */
+export declare const useTroubleDecoration: (model?: IKosDataModel) => {
+    /** Background color derived from the highest priority trouble, undefined if no troubles */
+    backgroundColor?: string;
+    /** Text color optimized for contrast against backgroundColor (white for dark backgrounds) */
+    fontColor?: string;
+    /** Reference to the highest priority trouble model instance */
+    highestTrouble?: any;
+    /** Whether trouble data has been loaded and initialized */
+    initialized?: boolean;
+    /** Total count of visible troubles after role-based filtering */
+    troubleCount?: number;
+    /** Boolean flag indicating if any troubles are present */
+    hasTroubles?: boolean;
+};
+//# sourceMappingURL=use-trouble-decoration.d.ts.map

package/hooks/troubles/use-trouble-decoration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-trouble-decoration.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-ddk-model-components/src/hooks/troubles/use-trouble-decoration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAO7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6FG;AACH,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,aAAa,KACpB;IACD,2FAA2F;IAC3F,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6FAA6F;IAC7F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,cAAc,CAAC,EAAE,GAAG,CAAC;IACrB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,OAAO,CAAC;CAuBvB,CAAC"}

package/hooks/troubles/use-trouble-visibility.d.ts

@@ -0,0 +1,9 @@
+import { TroubleModel } from '@kosdev-code/kos-ui-sdk';
+interface Props {
+    troubleType?: string;
+    condition?: (trouble: TroubleModel) => boolean;
+}
+type TroubleVisibility = [boolean, TroubleModel | undefined, TroubleModel[]];
+export declare const useTroubleVisibility: ({ troubleType, condition, }: Props) => TroubleVisibility;
+export {};
+//# sourceMappingURL=use-trouble-visibility.d.ts.map

package/hooks/troubles/use-trouble-visibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-trouble-visibility.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-ddk-model-components/src/hooks/troubles/use-trouble-visibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAO5D,UAAU,KAAK;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC;CAChD;AAED,KAAK,iBAAiB,GAAG,CAAC,OAAO,EAAE,YAAY,GAAG,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC;AAC7E,eAAO,MAAM,oBAAoB,GAAI,6BAGlC,KAAK,KAAG,iBAoBV,CAAC"}

package/hooks/utilities/index.d.ts

@@ -0,0 +1,3 @@
+export * from './use-utilities';
+export * from './with-utilities';
+//# sourceMappingURL=index.d.ts.map

package/hooks/utilities/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-ddk-model-components/src/hooks/utilities/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC"}

package/hooks/utilities/use-utilities.d.ts

@@ -0,0 +1,13 @@
+import { UtilitiesModel } from '../../../../kos-ddk-models/src/index.ts';
+export declare const useUtilities: (id: string) => {
+    model: UtilitiesModel | undefined;
+    ready: boolean;
+    error: string | undefined;
+    status: {
+        model: UtilitiesModel | undefined;
+        ready: boolean;
+        error: string | undefined;
+    };
+    KosModelLoader: import('react').FunctionComponent<import('react').PropsWithChildren<import('node_modules/@kosdev-code/kos-ui-sdk/ui/components/error-boundary/error-boundary').ErrorBoundaryProps & import('@kosdev-code/kos-ui-sdk').KosModelLoaderProps>>;
+};
+//# sourceMappingURL=use-utilities.d.ts.map

package/hooks/utilities/use-utilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-utilities.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-ddk-model-components/src/hooks/utilities/use-utilities.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAExE,eAAO,MAAM,YAAY,GAAI,IAAI,MAAM;;;;;;;;;;CAStC,CAAC"}

package/hooks/utilities/with-utilities.d.ts

@@ -0,0 +1,7 @@
+import { UtilitiesModel } from '../../../../kos-ddk-models/src/index.ts';
+interface UtilitiesProps {
+    utilities: UtilitiesModel;
+}
+export declare function withUtilities<T extends UtilitiesProps = UtilitiesProps>(WrappedComponent: React.ComponentType<T>): (id: string) => (props: Omit<T, keyof UtilitiesProps>) => import("@emotion/react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=with-utilities.d.ts.map

package/hooks/utilities/with-utilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-utilities.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-ddk-model-components/src/hooks/utilities/with-utilities.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAG7D,UAAU,cAAc;IACtB,SAAS,EAAE,cAAc,CAAC;CAC3B;AAED,wBAAgB,aAAa,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,EACrE,gBAAgB,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,IAEhC,IAAI,MAAM,MAAM,OAAO,IAAI,CAAC,CAAC,EAAE,MAAM,cAAc,CAAC,sDAS7D"}

package/hooks/utilities-container/index.d.ts

@@ -0,0 +1,3 @@
+export * from './use-utilities-container';
+export * from './with-utilities-container';
+//# sourceMappingURL=index.d.ts.map

package/hooks/utilities-container/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-ddk-model-components/src/hooks/utilities-container/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC"}

package/hooks/utilities-container/use-utilities-container.d.ts

@@ -0,0 +1,13 @@
+import { UtilitiesContainerModel } from '../../../../kos-ddk-models/src/index.ts';
+export declare const useUtilitiesContainer: () => {
+    model: UtilitiesContainerModel | undefined;
+    ready: boolean;
+    error: string | undefined;
+    status: {
+        model: UtilitiesContainerModel | undefined;
+        ready: boolean;
+        error: string | undefined;
+    };
+    KosModelLoader: import('react').FunctionComponent<import('react').PropsWithChildren<import('node_modules/@kosdev-code/kos-ui-sdk/ui/components/error-boundary/error-boundary').ErrorBoundaryProps & import('@kosdev-code/kos-ui-sdk').KosModelLoaderProps>>;
+};
+//# sourceMappingURL=use-utilities-container.d.ts.map

package/hooks/utilities-container/use-utilities-container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-utilities-container.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-ddk-model-components/src/hooks/utilities-container/use-utilities-container.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,uBAAuB,EACxB,MAAM,6BAA6B,CAAC;AAErC,eAAO,MAAM,qBAAqB;;;;;;;;;;CASjC,CAAC"}

package/hooks/utilities-container/with-utilities-container.d.ts

@@ -0,0 +1,6 @@
+import { UtilitiesContainerModel } from '../../../../kos-ddk-models/src/index.ts';
+export interface UtilitiesContainerProps {
+    utilitiesContainer: UtilitiesContainerModel;
+}
+export declare function withUtilitiesContainer<T extends UtilitiesContainerProps = UtilitiesContainerProps>(WrappedComponent: React.ComponentType<T>): (props: Omit<T, keyof UtilitiesContainerProps>) => import("@emotion/react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=with-utilities-container.d.ts.map

package/hooks/utilities-container/with-utilities-container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-utilities-container.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-ddk-model-components/src/hooks/utilities-container/with-utilities-container.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAGtE,MAAM,WAAW,uBAAuB;IACtC,kBAAkB,EAAE,uBAAuB,CAAC;CAC7C;AAED,wBAAgB,sBAAsB,CACpC,CAAC,SAAS,uBAAuB,GAAG,uBAAuB,EAC3D,gBAAgB,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,IAChC,OAAO,IAAI,CAAC,CAAC,EAAE,MAAM,uBAAuB,CAAC,sDAStD"}