@infotrust/ui 0.0.0-stage → 0.30.0

package/dist/components/shell/ItAppShell.vue.d.ts

@@ -0,0 +1,68 @@
+import { type ItShellNavItem, type ItShellUser } from './types';
+type __VLS_Props = {
+    navItems: ItShellNavItem[];
+    /** A collapsible group under a divider (the Suite's Settings). */
+    settingsItems?: ItShellNavItem[];
+    settingsLabel?: string;
+    /** The mobile account drawer's links. Defaults to settingsItems. */
+    mobileAccountItems?: ItShellNavItem[];
+    /** Link rows in the profile menu, above #profile-menu content. */
+    profileItems?: ItShellNavItem[];
+    brandName?: string;
+    brandTo?: string;
+    /** Full-page brand target, for apps hosted on another origin. */
+    brandHref?: string;
+    user?: ItShellUser | null;
+    /** Second line under the user name (the Suite shows the org). */
+    userMeta?: string;
+    /** Every InfoTrust app supports light and dark, so the frame always shows the theme control. */
+    themeLabel?: string;
+    /** `full-bleed` drops the route padding (editors, canvases). */
+    contentMode?: 'contained' | 'full-bleed';
+    /** localStorage key for the collapsed rail. */
+    collapseStorageKey?: string;
+};
+type __VLS_Slots = {
+    default(): unknown;
+    brand?(scope: {
+        collapsed: boolean;
+    }): unknown;
+    'nav-end'?(scope: {
+        collapsed: boolean;
+    }): unknown;
+    'sidebar-footer'?(scope: {
+        collapsed: boolean;
+    }): unknown;
+    'profile-menu'?(scope: {
+        close: () => void;
+    }): unknown;
+    'topbar-start'?(): unknown;
+    'topbar-end'?(): unknown;
+    banner?(): unknown;
+    overlays?(): unknown;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "sign-out": () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onSign-out"?: (() => any) | undefined;
+}>, {
+    settingsItems: ItShellNavItem[];
+    settingsLabel: string;
+    mobileAccountItems: ItShellNavItem[];
+    profileItems: ItShellNavItem[];
+    brandName: string;
+    brandTo: string;
+    brandHref: string;
+    user: ItShellUser | null;
+    userMeta: string;
+    themeLabel: string;
+    contentMode: "contained" | "full-bleed";
+    collapseStorageKey: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/shell/ItCommandTrigger.vue.d.ts

@@ -0,0 +1,17 @@
+type __VLS_Props = {
+    label?: string;
+    /** Register Cmd/Ctrl+K (ignored while typing in a field). */
+    shortcut?: boolean;
+    /** Show the sparkle that marks a built-in assistant. */
+    assistant?: boolean;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    open: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onOpen?: (() => any) | undefined;
+}>, {
+    label: string;
+    shortcut: boolean;
+    assistant: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/shell/ItOrgSwitcher.vue.d.ts

@@ -0,0 +1,26 @@
+import { type ItOrg, type ItOrgClient } from './org';
+type __VLS_Props = {
+    client: ItOrgClient;
+    /** Shown before the list loads (from the app's auth state). */
+    fallbackOrgId?: string | null;
+    /** The trigger's accessible prefix: "Organization: InfoTrust". */
+    label?: string;
+    /** Where the opened parents are kept (localStorage). `null` keeps them for the page only. */
+    storageKey?: string | null;
+};
+declare function toggle(event: Event): void;
+declare const _default: import("vue").DefineComponent<__VLS_Props, {
+    toggle: typeof toggle;
+    close: () => void | undefined;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    error: (message: string) => any;
+    "active-org": (org: ItOrg | null) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onError?: ((message: string) => any) | undefined;
+    "onActive-org"?: ((org: ItOrg | null) => any) | undefined;
+}>, {
+    label: string;
+    fallbackOrgId: string | null;
+    storageKey: string | null;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/shell/ItShellMenuItem.vue.d.ts

@@ -0,0 +1,18 @@
+import { type ItShellIcon } from './types';
+type __VLS_Props = {
+    icon: ItShellIcon;
+    label: string;
+    to?: string;
+    href?: string;
+    tone?: 'default' | 'danger';
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    click: (event: MouseEvent) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onClick?: ((event: MouseEvent) => any) | undefined;
+}>, {
+    tone: "default" | "danger";
+    href: string;
+    to: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/shell/ItShellNavBranch.vue.d.ts

@@ -0,0 +1,15 @@
+import { type ItShellNavItem } from './types';
+type __VLS_Props = {
+    item: ItShellNavItem;
+    depth?: number;
+    mobile?: boolean;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    navigate: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onNavigate?: (() => any) | undefined;
+}>, {
+    depth: number;
+    mobile: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/shell/ItShellNavLink.vue.d.ts

@@ -0,0 +1,18 @@
+import { type ItShellNavItem } from './types';
+type __VLS_Props = {
+    item: ItShellNavItem;
+    current?: boolean;
+    /** The link sits in the collapsed rail. */
+    collapsed?: boolean;
+    /**
+     * The item's alert label: the rail shows a dot on the icon and adds the label to the link's
+     * name and hover hint (with the labels shown, the alert is its own link beside this one).
+     */
+    alertLabel?: string;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    navigate: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onNavigate?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/shell/ItShellSidebarButton.vue.d.ts

@@ -0,0 +1,15 @@
+import { type Component } from 'vue';
+type __VLS_Props = {
+    icon: Component;
+    label: string;
+    /** Bordered, so it reads as a button rather than a link. */
+    outlined?: boolean;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    click: (event: MouseEvent) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onClick?: ((event: MouseEvent) => any) | undefined;
+}>, {
+    outlined: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/shell/ItThemeControl.vue.d.ts

@@ -0,0 +1,13 @@
+import type { ItThemePreference } from '../../composables/useItTheme';
+type __VLS_Props = {
+    modelValue: ItThemePreference;
+    label?: string;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: ItThemePreference) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: ItThemePreference) => any) | undefined;
+}>, {
+    label: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/shell/org.d.ts

@@ -0,0 +1,36 @@
+export interface ItOrg {
+    orgid: string;
+    name?: string;
+    parent_orgid?: string | null;
+    parentOrgid?: string | null;
+    /** The org's own mark: an image URL (its brand's favicon, square). Without one, the switcher draws a building. */
+    icon?: string | null;
+}
+export interface ItOrgClient extends EventTarget {
+    orgPicker: {
+        getOrgList(): Promise<ItOrg[]>;
+        /** Bypasses a cache, when the client has one. Called each time the switcher opens. */
+        refreshOrgList?(): Promise<ItOrg[]>;
+        getCurrentOrg(): Promise<ItOrg | null>;
+    };
+    /** Switches the active org. Fires `orgchange` (detail `{ org }`) on the client. */
+    setCurrentOrg(orgid: string): Promise<void>;
+}
+/** One visible row of the org tree. */
+export interface ItOrgRow {
+    org: ItOrg;
+    /** 1 = top level. */
+    level: number;
+    /** Position among its visible siblings, from 1. */
+    posinset: number;
+    setsize: number;
+    hasChildren: boolean;
+}
+export declare const itOrgName: (org: ItOrg) => string;
+/**
+ * The org list as tree rows, depth first, siblings sorted by name. An org
+ * whose parent is missing from the list (or is `root`) is top level. With a
+ * query (name or orgid), an org shows when it or a descendant matches, so a
+ * match keeps its path.
+ */
+export declare function itOrgRows(orgs: readonly ItOrg[], query?: string): ItOrgRow[];

package/dist/components/shell/types.d.ts

@@ -0,0 +1,67 @@
+import type { Component, InjectionKey, Ref } from 'vue';
+export interface ItShellImageIcon {
+    src: string;
+    alt?: string;
+}
+export type ItShellIcon = Component | ItShellImageIcon;
+interface ItShellNavItemBase {
+    id?: string;
+    label: string;
+    icon: ItShellIcon;
+    /** Omit to derive from the current route (exact match, or a sub-path of `to`). */
+    active?: boolean;
+    /** Additional route prefixes, matched at path segment boundaries. `active` overrides these. */
+    match?: string[];
+    tooltip?: string;
+    children?: ItShellNavItem[];
+}
+export interface ItShellNavAlert {
+    count: number;
+    label: string;
+    to?: string;
+    href?: string;
+}
+export type ItShellNavLinkItem = ItShellNavItemBase & {
+    /**
+     * Something in this section waits for the person: a bell with a blue dot at the end of the
+     * row (the dot alone on the icon in the collapsed rail, where the item's name and hover hint
+     * add the alert's label). It is its own link to `to` / `href` (the section's worklist),
+     * beside the item's link, never inside it. `label` names it and is its hover hint ("8 runs
+     * need attention"); the count is not drawn. Hidden at 0. The bell jingles on hover and
+     * focus, and rings once by itself when the count rises. Link items only.
+     */
+    alert?: ItShellNavAlert;
+} & ({
+    to: string;
+    href?: never;
+} | {
+    href: string;
+    to?: never;
+});
+export type ItShellNavGroupItem = ItShellNavItemBase & {
+    children: ItShellNavItem[];
+    to?: never;
+    href?: never;
+    alert?: never;
+};
+export type ItShellNavItem = ItShellNavLinkItem | ItShellNavGroupItem;
+export interface ItShellUser {
+    name?: string;
+    email?: string;
+    /** https URLs only; anything else falls back to initials. */
+    picture?: string;
+}
+export declare function isShellImageIcon(icon: ItShellIcon): icon is ItShellImageIcon;
+export declare function shellNavItemKey(item: ItShellNavItem): string;
+/** Current route path, provided by ItAppShell to its nav items. */
+export declare const SHELL_PATH: InjectionKey<Ref<string>>;
+/** Frame state that parts placed in shell regions read, so they adapt without props. */
+export interface ItShellState {
+    /** The sidebar is the 72px icon rail (manual collapse). */
+    collapsed: Readonly<Ref<boolean>>;
+    /** Close the profile menu and both mobile drawers. */
+    closeOverlays: () => void;
+}
+export declare const SHELL_STATE: InjectionKey<ItShellState>;
+export declare function isNavItemActive(item: ItShellNavItem, path: string): boolean;
+export {};

package/dist/components/status/ItBadge.vue.d.ts

@@ -0,0 +1,12 @@
+export type ItBadgeTone = 'neutral' | 'info' | 'success' | 'warning' | 'danger';
+type __VLS_Props = {
+    label: string;
+    tone?: ItBadgeTone;
+    /** Mono face, for a code word such as a request method. */
+    mono?: boolean;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    tone: ItBadgeTone;
+    mono: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/status/ItEntityTypeChip.vue.d.ts

@@ -0,0 +1,14 @@
+/** An entity kind with platform identity. Both layouts are static text. */
+type __VLS_Props = {
+    platform?: string;
+    type: string;
+    label?: string;
+    plural?: boolean;
+    /** Place the decorative logo beside the chip or inside its tint. */
+    logoPosition?: 'beside' | 'inside';
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    plural: boolean;
+    logoPosition: "beside" | "inside";
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/status/ItLabelChip.vue.d.ts

@@ -0,0 +1,21 @@
+import { type ItRouteLocation } from '../../utils/router';
+type __VLS_Props = {
+    label: string;
+    category?: string;
+    /** Show a remove button. Emits `remove`. */
+    removable?: boolean;
+    /** Visually marks a label inherited from a parent asset. */
+    inherited?: boolean;
+    /** Source name, exposed as an accessible description. */
+    inheritedFrom?: string;
+    clickable?: boolean;
+    to?: ItRouteLocation;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    click: (event: MouseEvent) => any;
+    remove: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onClick?: ((event: MouseEvent) => any) | undefined;
+    onRemove?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/status/ItLabelChipList.vue.d.ts

@@ -0,0 +1,27 @@
+export interface ItLabel {
+    id?: string;
+    name: string;
+    category?: string;
+    inherited?: boolean;
+    inheritedFrom?: string;
+    /** Ids of the broader labels this one implies (specific ⇒ broad): "KitKat" implies "Nestlé". */
+    implies?: readonly string[];
+}
+declare const _default: import("vue").DefineComponent<{
+    labels: Array<ItLabel | string>;
+    /** Most chips to show, even with room for more. */
+    max?: number;
+    removable?: boolean;
+}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    remove: (label: ItLabel) => any;
+}, string, import("vue").PublicProps, Readonly<{
+    labels: Array<ItLabel | string>;
+    /** Most chips to show, even with room for more. */
+    max?: number;
+    removable?: boolean;
+}> & Readonly<{
+    onRemove?: ((label: ItLabel) => any) | undefined;
+}>, {
+    max: number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/status/ItPlatformChip.vue.d.ts

@@ -0,0 +1,20 @@
+type __VLS_Props = {
+    platform: string | null | undefined;
+    /** `short` = "GA4", `full` = "Google Analytics 4". */
+    name?: 'short' | 'full';
+    /** Text to show instead of the platform name; the full platform name moves to the tooltip. */
+    label?: string;
+    /** `chip` = tinted box (tables, filters, headers); `pill` = fully rounded, for chip rows of labels. */
+    shape?: 'chip' | 'pill';
+    /** Add built-in platform artwork. Registered logo URLs always render. */
+    logo?: boolean;
+    size?: 'sm' | 'md';
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    label: string;
+    size: "sm" | "md";
+    name: "short" | "full";
+    shape: "chip" | "pill";
+    logo: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/status/ItPlatformLogo.vue.d.ts

@@ -0,0 +1,17 @@
+declare const _default: import("vue").DefineComponent<{
+    platform: string | null | undefined;
+    /** 12/14 inside chips · 16 inline · 20 headings · 24 page headers · 32 cards · 48 platform pages. */
+    size?: 12 | 14 | 16 | 20 | 24 | 32 | 48;
+    /** The platform's name is printed beside it: hide the logo from screen readers. */
+    decorative?: boolean;
+}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{
+    platform: string | null | undefined;
+    /** 12/14 inside chips · 16 inline · 20 headings · 24 page headers · 32 cards · 48 platform pages. */
+    size?: 12 | 14 | 16 | 20 | 24 | 32 | 48;
+    /** The platform's name is printed beside it: hide the logo from screen readers. */
+    decorative?: boolean;
+}> & Readonly<{}>, {
+    size: 12 | 14 | 16 | 20 | 24 | 32 | 48;
+    decorative: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/status/ItSeverityBadge.vue.d.ts

@@ -0,0 +1,9 @@
+type __VLS_Props = {
+    severity: number | string | null | undefined;
+    /** `badge` for tables and headers; `dot` for dense inline use. */
+    variant?: 'badge' | 'dot';
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    variant: "badge" | "dot";
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/status/ItStatus.vue.d.ts

@@ -0,0 +1,12 @@
+import { type StatusTone } from '../../registries/status';
+type __VLS_Props = {
+    status: string | null | undefined;
+    /** Registry domain for domain-specific statuses (see registerStatuses). */
+    domain?: string;
+    /** Override the registry label (rare — prefer registerStatuses). */
+    label?: string;
+    /** Override the registry tone (rare). */
+    tone?: StatusTone;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;