@middag-io/react 0.2.0 → 0.3.0

package/dist-lib/contracts/page-contract.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Page Contract (ADR-807) — TypeScript mirror of PHP VOs in
+ * `classes/framework/shared/ui/*`.
+ *
+ * Backend sends this shape via Inertia props; the runtime resolves
+ * shell/layout/blocks through registries to render React components.
+ */
+import type { ActionConfirmation } from "@/contracts/block-data";
+export type Shell = "product" | "admin" | "course" | "immersive";
+export type LayoutTemplate = "stack" | "split" | "dashboard" | "master-detail" | "wizard" | "canvas";
+export type ActionIntent = "primary" | "secondary" | "danger" | "ghost" | "menu";
+export type ActionMethod = "get" | "post" | "put" | "delete";
+export interface Breadcrumb {
+    label: string;
+    href?: string;
+    external?: boolean;
+}
+export interface PageAction {
+    id: string;
+    label: string;
+    intent: ActionIntent;
+    href?: string;
+    method?: ActionMethod;
+    icon?: string;
+    requiresConfirmation?: boolean;
+    disabled?: boolean;
+    loading?: boolean;
+    confirmation?: ActionConfirmation;
+}
+export interface PageFilterTab {
+    key: string;
+    label: string;
+    badge?: number | string;
+}
+export interface PageBadge {
+    label: string;
+    variant: "success" | "warning" | "destructive" | "info";
+}
+export interface PageMeta {
+    key: string;
+    title: string;
+    subtitle?: string;
+    /** Hugeicons icon name displayed before title (detail pages only). */
+    icon?: string;
+    /** Status badge shown after title (detail pages). */
+    badge?: PageBadge;
+    /** Whether this page can be favorited. Defaults to true. */
+    favoritable?: boolean;
+    breadcrumbs?: Breadcrumb[];
+    actions?: PageAction[];
+    /** Page-level filter tabs rendered between header and content (preview 03 pattern). */
+    filterTabs?: PageFilterTab[];
+    /** Key of the initially active filter tab. Defaults to first tab. */
+    activeFilterTab?: string;
+}
+export interface BlockDescriptor<TData = Record<string, unknown>> {
+    type: string;
+    key: string;
+    data: TData;
+    variant?: string;
+    title?: string;
+    subtitle?: string;
+    actions?: PageAction[];
+    meta?: Record<string, unknown>;
+}
+export interface LayoutDescriptor {
+    template: LayoutTemplate;
+    regions: Record<string, BlockDescriptor[]>;
+    meta?: Record<string, unknown>;
+}
+export interface PageResources {
+    auth?: Record<string, unknown>;
+    capabilities?: string[];
+    featureFlags?: Record<string, boolean>;
+    locale?: string;
+}
+export interface PageContract {
+    version: "1";
+    shell: Shell;
+    page: PageMeta;
+    layout: LayoutDescriptor;
+    resources?: PageResources;
+}
+/** Contextual help data for the ContextAside panel */
+export interface HelpSection {
+    title: string;
+    body: string;
+}
+export interface HelpTip {
+    icon?: string;
+    text: string;
+}
+export interface HelpShortcut {
+    keys: string;
+    action: string;
+}
+export interface HelpData {
+    title: string;
+    description: string;
+    sections?: HelpSection[];
+    tips?: HelpTip[];
+    shortcuts?: HelpShortcut[];
+    learnMore?: string;
+}
+/** Inspector side-panel configuration */
+export interface InspectorData {
+    endpoint: string;
+    width: number;
+}
+/**
+ * Full Inertia props shape for ContractPage.
+ *
+ * `overlay` and `help` are separate props (not part of page_contract)
+ * to keep the @api VO unchanged.
+ */
+export interface ContractPageProps {
+    contract: PageContract;
+    /** When true, page renders in a full-screen overlay with X close. */
+    overlay?: boolean;
+    /** Contextual help shown in the ContextAside panel. */
+    help?: HelpData;
+    /** Inspector side-panel configuration. */
+    inspector?: InspectorData;
+}
+export interface PollingMeta {
+    interval: number;
+    enabled: boolean;
+}
+//# sourceMappingURL=page-contract.d.ts.map

package/dist-lib/contracts/page-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-contract.d.ts","sourceRoot":"","sources":["../../src/contracts/page-contract.ts"],"names":[],"mappings":"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"}

package/dist-lib/contracts/shared-props.d.ts

@@ -0,0 +1,76 @@
+/**
+ * SharedProps — typed Inertia shared props sent on every request.
+ *
+ * PHP side: inertia_manager::share() in http_kernel boot.
+ * Frontend: usePage<SharedProps>().props
+ *
+ * @see NV-05-ux-shell-sidebar.md §1.3
+ */
+import type { NavigationPayload, NavigationTreePayload } from "@/contracts/navigation";
+export interface SharedPropsAuth {
+    /** Moodle user ID */
+    id: number;
+    /** Full display name */
+    name: string;
+    /** Email address */
+    email: string;
+    /** URL to user avatar (Moodle profile picture) */
+    avatarUrl?: string;
+    /** Array of Moodle capability strings the user holds in current context */
+    capabilities: string[];
+}
+export interface SharedPropsTheme {
+    /** Pre-loaded i18n strings for the current page (key → translated string) */
+    strings?: Record<string, string>;
+    /**
+     * Current appearance preference: 'system' | 'light' | 'dark'.
+     * Sent from server to sync cross-device. Client reads localStorage first.
+     */
+    appearance?: "system" | "light" | "dark";
+    /**
+     * Moodle brand color (hex, e.g. "#1177d1").
+     * Present when local_middag/inherit_theme_colors = ON.
+     * PHP injects :root { --middag-brand: <value> } in page head.
+     */
+    brandColor?: string;
+    /** Whether Moodle theme color inheritance is active */
+    inherit?: boolean;
+}
+export interface SharedPropsFlash {
+    /** Success message to show as toast */
+    success?: string;
+    /** Error message to show as toast */
+    error?: string;
+    /** Info message to show as toast */
+    info?: string;
+    /** Warning message to show as toast */
+    warning?: string;
+    toast?: {
+        severity: "success" | "error" | "warning" | "info";
+        message: string;
+        duration?: number;
+    };
+}
+export interface AdminTabItem {
+    key: string;
+    label: string;
+    href: string;
+}
+export interface AdminTabsProps {
+    active: string;
+    items: AdminTabItem[];
+}
+export interface SharedProps {
+    navigation: NavigationPayload | NavigationTreePayload;
+    auth: SharedPropsAuth;
+    theme: SharedPropsTheme;
+    flash?: SharedPropsFlash;
+    /** Effective locale string, e.g. "pt-BR", "en" */
+    locale: string;
+    /** MIDDAG version string, e.g. "5.0.0" */
+    version: string;
+    /** Global scope data from global_scope_manager (extensions add their keys) */
+    scope?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+//# sourceMappingURL=shared-props.d.ts.map

package/dist-lib/contracts/shared-props.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-props.d.ts","sourceRoot":"","sources":["../../src/contracts/shared-props.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,eAAe;IAC9B,qBAAqB;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;;OAGG;IACH,UAAU,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;IACzC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE;QACN,QAAQ,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;QACnD,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,iBAAiB,GAAG,qBAAqB,CAAC;IACtD,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,gBAAgB,CAAC;IACxB,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/dist-lib/hooks/use-copy-to-clipboard.d.ts

@@ -0,0 +1,2 @@
+export { useCopyToClipboard } from "@/lib/hooks/use-copy-to-clipboard";
+//# sourceMappingURL=use-copy-to-clipboard.d.ts.map

package/dist-lib/hooks/use-copy-to-clipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-copy-to-clipboard.d.ts","sourceRoot":"","sources":["../../src/hooks/use-copy-to-clipboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC"}

package/dist-lib/hooks/use-file-upload.d.ts

@@ -0,0 +1,2 @@
+export { useFileUpload, formatBytes, type FileMetadata, type FileWithPreview, type FileUploadOptions, type FileUploadState, type FileUploadActions, } from "@/lib/hooks/use-file-upload";
+//# sourceMappingURL=use-file-upload.d.ts.map

package/dist-lib/hooks/use-file-upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-file-upload.d.ts","sourceRoot":"","sources":["../../src/hooks/use-file-upload.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,WAAW,EACX,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,iBAAiB,GACvB,MAAM,6BAA6B,CAAC"}

package/dist-lib/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @middag-io/react — barrel export for ESM lib build.
+ *
+ * Exports the reusable core of the MIDDAG React UI:
+ *   - Contracts (TypeScript types/interfaces)
+ *   - ContractPage (page renderer)
+ *   - Registries (shell, layout, block registration)
+ *   - Theme utilities
+ *   - Providers (i18n, auth, flash, scope, progress)
+ *   - Hooks
+ */
+export type { PageContract, PageMeta, HelpData, HelpSection, PageFilterTab, BlockDescriptor, LayoutDescriptor, ContractPageProps, } from "@/contracts/page-contract";
+export type { SharedProps } from "@/contracts/shared-props";
+export type { NavigationPayload } from "@/contracts/navigation";
+export { ContractPage } from "@/app/ContractPage";
+export { shellRegistry, layoutRegistry, blockRegistry, type ShellProps, type LayoutProps, type BlockProps, } from "@/app/registries";
+export { registerDefaults } from "@/app/register-defaults";
+export { getStoredAppearance, setAppearance, cycleAppearance, getEffectiveTheme, applyTheme, toggleDir, initDir, onSystemThemeChange, type Appearance, type EffectiveTheme, } from "@/base/theme/appearance";
+export { I18nProvider, useTranslation, type AsyncStringResolver, } from "@/app/providers/i18n";
+export { useIsDark } from "@/base/hooks/useIsDark";
+export { deprecated } from "@/lib/deprecation";
+//# sourceMappingURL=index.d.ts.map

package/dist-lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,YAAY,EACV,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAGhE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EACL,aAAa,EACb,cAAc,EACd,aAAa,EACb,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,UAAU,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAG3D,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,UAAU,EACV,SAAS,EACT,OAAO,EACP,mBAAmB,EACnB,KAAK,UAAU,EACf,KAAK,cAAc,GACpB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,YAAY,EACZ,cAAc,EACd,KAAK,mBAAmB,GACzB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGnD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}

package/dist-lib/lib/deprecation.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Emit a deprecation warning for a renamed or removed API.
+ * Each warning is shown only once per session to avoid console noise.
+ *
+ * @example
+ * deprecated("useOldHook", "useNewHook");
+ * deprecated("BlockType.header", "BlockType.title", "https://docs.middag.io/changelog#v0.2.0");
+ */
+export declare function deprecated(oldApi: string, newApi: string, docUrl?: string): void;
+//# sourceMappingURL=deprecation.d.ts.map

package/dist-lib/lib/deprecation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deprecation.d.ts","sourceRoot":"","sources":["../../src/lib/deprecation.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,GACd,IAAI,CASN"}

package/dist-lib/lib/hooks/use-copy-to-clipboard.d.ts

@@ -0,0 +1,8 @@
+export declare function useCopyToClipboard({ timeout, onCopy, }?: {
+    timeout?: number;
+    onCopy?: () => void;
+}): {
+    isCopied: boolean;
+    copyToClipboard: (value: string) => void;
+};
+//# sourceMappingURL=use-copy-to-clipboard.d.ts.map

package/dist-lib/lib/hooks/use-copy-to-clipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-copy-to-clipboard.d.ts","sourceRoot":"","sources":["../../../src/lib/hooks/use-copy-to-clipboard.ts"],"names":[],"mappings":"AAIA,wBAAgB,kBAAkB,CAAC,EACjC,OAAc,EACd,MAAM,GACP,GAAE;IACD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CAChB;;6BAG4B,MAAM;EAuBvC"}

package/dist-lib/lib/hooks/use-file-upload.d.ts

@@ -0,0 +1,47 @@
+import type React from "react";
+import { type ChangeEvent, type DragEvent, type InputHTMLAttributes } from "react";
+export type FileMetadata = {
+    name: string;
+    size: number;
+    type: string;
+    url: string;
+    id: string;
+};
+export type FileWithPreview = {
+    file: File | FileMetadata;
+    id: string;
+    preview?: string;
+};
+export type FileUploadOptions = {
+    maxFiles?: number;
+    maxSize?: number;
+    accept?: string;
+    multiple?: boolean;
+    initialFiles?: FileMetadata[];
+    onFilesChange?: (files: FileWithPreview[]) => void;
+    onFilesAdded?: (addedFiles: FileWithPreview[]) => void;
+    onError?: (errors: string[]) => void;
+};
+export type FileUploadState = {
+    files: FileWithPreview[];
+    isDragging: boolean;
+    errors: string[];
+};
+export type FileUploadActions = {
+    addFiles: (files: FileList | File[]) => void;
+    removeFile: (id: string) => void;
+    clearFiles: () => void;
+    clearErrors: () => void;
+    handleDragEnter: (e: DragEvent<HTMLElement>) => void;
+    handleDragLeave: (e: DragEvent<HTMLElement>) => void;
+    handleDragOver: (e: DragEvent<HTMLElement>) => void;
+    handleDrop: (e: DragEvent<HTMLElement>) => void;
+    handleFileChange: (e: ChangeEvent<HTMLInputElement>) => void;
+    openFileDialog: () => void;
+    getInputProps: (props?: InputHTMLAttributes<HTMLInputElement>) => InputHTMLAttributes<HTMLInputElement> & {
+        ref: React.Ref<HTMLInputElement>;
+    };
+};
+export declare const useFileUpload: (options?: FileUploadOptions) => [FileUploadState, FileUploadActions];
+export declare const formatBytes: (bytes: number, decimals?: number) => string;
+//# sourceMappingURL=use-file-upload.d.ts.map

package/dist-lib/lib/hooks/use-file-upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-file-upload.d.ts","sourceRoot":"","sources":["../../../src/lib/hooks/use-file-upload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,mBAAmB,EACzB,MAAM,OAAO,CAAC;AAEf,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,IAAI,GAAG,YAAY,CAAC;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,YAAY,EAAE,CAAC;IAC9B,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,IAAI,CAAC;IACnD,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,eAAe,EAAE,KAAK,IAAI,CAAC;IACvD,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,EAAE,KAAK,IAAI,CAAC;IAC7C,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,eAAe,EAAE,CAAC,CAAC,EAAE,SAAS,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IACrD,eAAe,EAAE,CAAC,CAAC,EAAE,SAAS,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IACrD,cAAc,EAAE,CAAC,CAAC,EAAE,SAAS,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IACpD,UAAU,EAAE,CAAC,CAAC,EAAE,SAAS,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAChD,gBAAgB,EAAE,CAAC,CAAC,EAAE,WAAW,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;IAC7D,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,aAAa,EAAE,CACb,KAAK,CAAC,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,KAC1C,mBAAmB,CAAC,gBAAgB,CAAC,GAAG;QAC3C,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;KAClC,CAAC;CACH,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,UAAS,iBAAsB,KAC9B,CAAC,eAAe,EAAE,iBAAiB,CAqVrC,CAAC;AAGF,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,EAAE,iBAAY,KAAG,MAUzD,CAAC"}

package/dist-lib/lib/hooks/use-mobile.d.ts

@@ -0,0 +1,2 @@
+export declare function useIsMobile(): boolean;
+//# sourceMappingURL=use-mobile.d.ts.map

package/dist-lib/lib/hooks/use-mobile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-mobile.d.ts","sourceRoot":"","sources":["../../../src/lib/hooks/use-mobile.ts"],"names":[],"mappings":"AAkBA,wBAAgB,WAAW,IAAI,OAAO,CAErC"}

package/dist-lib/lib/portal-container.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Portal container for CSS isolation (ADR-807).
+ *
+ * Radix UI portals default to document.body, which is outside .middag-root.
+ * This utility returns the #middag-portals container (created in inertia-app.tsx)
+ * so portal content inherits our scoped Tailwind styles.
+ */
+export declare function getPortalContainer(): HTMLElement;
+//# sourceMappingURL=portal-container.d.ts.map

package/dist-lib/lib/portal-container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portal-container.d.ts","sourceRoot":"","sources":["../../src/lib/portal-container.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,wBAAgB,kBAAkB,IAAI,WAAW,CAKhD"}

package/dist-lib/lib/utils.d.ts

@@ -0,0 +1,3 @@
+import { type ClassValue } from "clsx";
+export declare function cn(...inputs: ClassValue[]): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist-lib/lib/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/lib/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAQ,MAAM,MAAM,CAAC;AAG7C,wBAAgB,EAAE,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,UAEzC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@middag-io/react",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "type": "module",
   "description": "MIDDAG shared React UI library for Moodle, WordPress and other Inertia hosts",
   "repository": {