@middag-io/react 0.18.0 → 0.19.0

package/dist-lib/contracts/generated/contract-types.d.ts

@@ -0,0 +1,278 @@
+/**
+ * @generated by scripts/gen-contracts.mjs — DO NOT EDIT BY HAND.
+ *
+ * TypeScript types for the MIDDAG wire contract.
+ *
+ * Source of truth: middag-php-ui value objects -> JSON Schema (draft 2020-12).
+ * Regenerate:  npm run gen:contracts
+ * Drift gate:  npm run gen:contracts:check
+ *
+ * @source middag-php-ui/schema/{page-contract,fragment}.json
+ * @contract-version 1
+ * @hash e45deaf10bee8f90
+ */
+export type Label = string | Translatable;
+export type ActionTarget = {
+    kind: "link";
+    href: string;
+    external?: true;
+} | {
+    kind: "route";
+    route: string;
+    params?: {
+        [k: string]: unknown;
+    };
+} | {
+    kind: "request";
+    endpoint: string;
+    method: HttpMethod;
+};
+export type HttpMethod = "get" | "post" | "put" | "patch" | "delete";
+export type ActionIntent = "primary" | "secondary" | "danger" | "success" | "warning" | "info" | "link" | "ghost";
+export type ThemeMode = "light" | "dark" | "system";
+export type NotificationLevel = "success" | "info" | "warning" | "error";
+export type FragmentKind = "block" | "region" | "table" | "form" | "detail" | "inspector" | "notifications" | "custom";
+export type ResourcePatch = {
+    preferences?: UserPreferences;
+    capabilities?: {
+        [k: string]: boolean;
+    };
+    featureFlags?: {
+        [k: string]: boolean;
+    };
+} | [];
+export type ValueFormat = "text" | "date" | "datetime" | "time" | "number" | "currency" | "boolean" | "badge";
+export type FilterType = "select" | "text" | "date" | "date_range" | "boolean" | "number_range";
+export type FieldConstraints = {
+    required?: true;
+    min?: number;
+    max?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    step?: string;
+} | [];
+export type RegionUpdateMode = "replace" | "append" | "prepend" | "remove" | "update";
+export type ActionTargetKind = "link" | "route" | "request";
+export type ChartType = "line" | "bar" | "area" | "pie" | "donut";
+export type ConditionOperator = "eq" | "neq" | "in" | "not_in" | "gt" | "gte" | "lt" | "lte" | "truthy" | "falsy" | "exists" | "empty" | "matches";
+export type FieldType = "text" | "textarea" | "richtext" | "password" | "email" | "url" | "int" | "float" | "select" | "multiselect" | "radio" | "checkbox" | "switch" | "date" | "datetime" | "time" | "duration" | "file" | "entity_picker" | "autocomplete" | "tags" | "hidden" | "static" | "header";
+export type RenderTarget = "html" | "props";
+export interface PageContract {
+    version: "1";
+    shell: string;
+    page: PageMeta;
+    layout: LayoutDescriptor;
+    resources?: PageResources;
+    notifications?: Notification[];
+}
+export interface PageMeta {
+    key: string;
+    title: Label;
+    subtitle?: Label;
+    breadcrumbs?: Breadcrumb[];
+    actions?: Action[];
+}
+export interface Translatable {
+    key: string;
+    domain: string;
+    params?: {
+        [k: string]: unknown;
+    };
+}
+export interface Breadcrumb {
+    label: Label;
+    href?: string;
+    external?: true;
+}
+export interface Action {
+    id: string;
+    label: Label;
+    target: ActionTarget;
+    intent: ActionIntent;
+    icon?: string;
+    confirmation?: Confirmation;
+    capability?: string;
+    disabled?: true;
+    loading?: true;
+}
+export interface Confirmation {
+    title: Label;
+    message: Label;
+    variant: string;
+    confirmLabel?: Label;
+    cancelLabel?: Label;
+}
+export interface LayoutDescriptor {
+    template: string;
+    regions: {
+        [k: string]: BlockDescriptor[];
+    } | [];
+    meta?: {
+        [k: string]: unknown;
+    };
+}
+export interface BlockDescriptor {
+    type: string;
+    key: string;
+    data: {
+        [k: string]: unknown;
+    } | [];
+    variant?: string;
+    title?: Label;
+    subtitle?: Label;
+    actions?: Action[];
+    meta?: {
+        [k: string]: unknown;
+    };
+    poll?: PollConfig;
+}
+export interface PollConfig {
+    endpoint: string;
+    intervalMs: number;
+    pauseWhenHidden: boolean;
+    stopAfterMs?: number;
+}
+export interface PageResources {
+    preferences: UserPreferences;
+    capabilities: {
+        [k: string]: boolean;
+    } | [];
+    featureFlags: {
+        [k: string]: boolean;
+    } | [];
+    user?: Identity;
+    branding?: Branding;
+}
+export interface UserPreferences {
+    theme: ThemeMode;
+    locale: string;
+    timezone?: string;
+    dateFormat?: string;
+    numberFormat?: string;
+    [k: string]: unknown;
+}
+export interface Identity {
+    id: string;
+    name: string;
+    email?: string;
+    avatarUrl?: string;
+    roles?: string[];
+}
+export interface Branding {
+    appName: string;
+    logoUrl?: string;
+    logoCompactUrl?: string;
+}
+export interface Notification {
+    level: NotificationLevel;
+    message: Label;
+    dismissible: boolean;
+    title?: Label;
+    timeout?: number;
+    action?: Action;
+}
+export interface Fragment {
+    version: "1";
+    kind: FragmentKind;
+    payload?: {
+        [k: string]: unknown;
+    };
+    notifications?: Notification[];
+    resources?: ResourcePatch;
+    customType?: string;
+}
+export interface InspectorDescriptor {
+    endpoint: string;
+    width: number;
+    poll?: PollConfig;
+}
+export interface NavigationNode {
+    key: string;
+    label: Label;
+    icon?: string;
+    href?: string;
+    badge?: string;
+    active?: true;
+    drilldown?: true;
+    collapsible?: true;
+    defaultOpen?: true;
+    children?: NavigationNode[];
+}
+export interface TableConfig {
+    columns: Column[];
+    filters?: FilterDefinition[];
+    rowActions?: Action[];
+    bulkActions?: Action[];
+    options: TableOptions;
+}
+export interface Column {
+    key: string;
+    label: Label;
+    sortable: boolean;
+    searchable: boolean;
+    format: ValueFormat;
+    formatOptions?: {
+        [k: string]: unknown;
+    };
+    options?: {
+        [k: string]: unknown;
+    };
+}
+export interface FilterDefinition {
+    key: string;
+    label: Label;
+    type: FilterType;
+    options?: {
+        value: unknown;
+        label: Label;
+    }[];
+    placeholder?: Label;
+    default?: unknown;
+}
+export interface TableOptions {
+    perPage: number;
+    sortDirection: string;
+    selectable: boolean;
+    searchable: boolean;
+    sortColumn?: string;
+}
+export interface Pagination {
+    page: number;
+    perPage: number;
+    total: number;
+    lastPage: number;
+}
+export interface ChartSeries {
+    name: string;
+    data: number[];
+}
+export interface Tab {
+    id: string;
+    label: Label;
+    blocks: BlockDescriptor[];
+}
+export interface FormStep {
+    id: string;
+    label: Label;
+    fields: string[];
+    help?: Label;
+}
+export interface RegionUpdate {
+    region: string;
+    mode: RegionUpdateMode;
+    blocks?: BlockDescriptor[];
+    keys?: string[];
+}
+export interface ActionResult {
+    success: boolean;
+    notifications?: Notification[];
+    redirect?: string;
+    refreshBlocks?: string[];
+    errors?: {
+        [k: string]: string | string[];
+    };
+    fragments?: Fragment[];
+    resources?: ResourcePatch;
+}
+//# sourceMappingURL=contract-types.d.ts.map

package/dist-lib/contracts/generated/contract-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-types.d.ts","sourceRoot":"","sources":["../../../src/contracts/generated/contract-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,YAAY,CAAC;AAC1C,MAAM,MAAM,YAAY,GACpB;IACE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,IAAI,CAAC;CACjB,GACD;IACE,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE;QACP,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;KACtB,CAAC;CACH,GACD;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;CACpB,CAAC;AACN,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AACrE,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,WAAW,GACX,QAAQ,GACR,SAAS,GACT,SAAS,GACT,MAAM,GACN,MAAM,GACN,OAAO,CAAC;AACZ,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AACpD,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AACzE,MAAM,MAAM,YAAY,GACpB,OAAO,GACP,QAAQ,GACR,OAAO,GACP,MAAM,GACN,QAAQ,GACR,WAAW,GACX,eAAe,GACf,QAAQ,CAAC;AACb,MAAM,MAAM,aAAa,GACrB;IACE,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,YAAY,CAAC,EAAE;QACb,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;KACtB,CAAC;IACF,YAAY,CAAC,EAAE;QACb,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;KACtB,CAAC;CACH,GACD,EAAE,CAAC;AACP,MAAM,MAAM,WAAW,GACnB,MAAM,GACN,MAAM,GACN,UAAU,GACV,MAAM,GACN,QAAQ,GACR,UAAU,GACV,SAAS,GACT,OAAO,CAAC;AACZ,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,YAAY,GAAG,SAAS,GAAG,cAAc,CAAC;AAChG,MAAM,MAAM,gBAAgB,GACxB;IACE,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GACD,EAAE,CAAC;AACP,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AACtF,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAC5D,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC;AAClE,MAAM,MAAM,iBAAiB,GACzB,IAAI,GACJ,KAAK,GACL,IAAI,GACJ,QAAQ,GACR,IAAI,GACJ,KAAK,GACL,IAAI,GACJ,KAAK,GACL,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,OAAO,GACP,SAAS,CAAC;AACd,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,UAAU,GACV,UAAU,GACV,UAAU,GACV,OAAO,GACP,KAAK,GACL,KAAK,GACL,OAAO,GACP,QAAQ,GACR,aAAa,GACb,OAAO,GACP,UAAU,GACV,QAAQ,GACR,MAAM,GACN,UAAU,GACV,MAAM,GACN,UAAU,GACV,MAAM,GACN,eAAe,GACf,cAAc,GACd,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,QAAQ,CAAC;AACb,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,CAAC;AAE5C,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,GAAG,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,gBAAgB,CAAC;IACzB,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;CAChC;AACD,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,CAAC,EAAE,KAAK,CAAC;IACjB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AACD,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE;QACP,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;KACtB,CAAC;CACH;AACD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,IAAI,CAAC;CACjB;AACD,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB;AACD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,KAAK,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB,WAAW,CAAC,EAAE,KAAK,CAAC;CACrB;AACD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EACH;QACE,CAAC,CAAC,EAAE,MAAM,GAAG,eAAe,EAAE,CAAC;KAChC,GACD,EAAE,CAAC;IACP,IAAI,CAAC,EAAE;QACL,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;KACtB,CAAC;CACH;AACD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EACA;QACE,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;KACtB,GACD,EAAE,CAAC;IACP,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,QAAQ,CAAC,EAAE,KAAK,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE;QACL,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;KACtB,CAAC;IACF,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AACD,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AACD,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,eAAe,CAAC;IAC7B,YAAY,EACR;QACE,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;KACtB,GACD,EAAE,CAAC;IACP,YAAY,EACR;QACE,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;KACtB,GACD,EAAE,CAAC;IACP,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AACD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AACD,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AACD,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AACD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,iBAAiB,CAAC;IACzB,OAAO,EAAE,KAAK,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AACD,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,GAAG,CAAC;IACb,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,CAAC,EAAE;QACR,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;KACtB,CAAC;IACF,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;IAC/B,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AACD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AACD,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,IAAI,CAAC;IACd,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;CAC7B;AACD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,YAAY,CAAC;CACvB;AACD,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,aAAa,CAAC,EAAE;QACd,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;KACtB,CAAC;IACF,OAAO,CAAC,EAAE;QACR,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;KACtB,CAAC;CACH;AACD,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,CAAC,EAAE;QACR,KAAK,EAAE,OAAO,CAAC;QACf,KAAK,EAAE,KAAK,CAAC;KACd,EAAE,CAAC;IACJ,WAAW,CAAC,EAAE,KAAK,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AACD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AACD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AACD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AACD,MAAM,WAAW,GAAG;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AACD,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,CAAC,EAAE,KAAK,CAAC;CACd;AACD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AACD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,CAAC,EAAE;QACP,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC;KAChC,CAAC;IACF,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B"}

package/dist-lib/contracts/generated/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @generated by scripts/gen-contracts.mjs — DO NOT EDIT BY HAND.
+ *
+ * Barrel for the generated contract layer.
+ *
+ * Source of truth: middag-php-ui value objects -> JSON Schema (draft 2020-12).
+ * Regenerate:  npm run gen:contracts
+ * Drift gate:  npm run gen:contracts:check
+ *
+ * @source middag-php-ui/schema/{page-contract,fragment}.json
+ * @contract-version 1
+ * @hash e45deaf10bee8f90
+ */
+export * from "./contract-types";
+export { pageContractSchemaCore, fragmentSchemaCore } from "./contract-schema";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/contracts/generated/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}

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

@@ -1,12 +1,15 @@
 /**
- * Zod schemas for PageContract runtime validation.
+ * Zod schema for PageContract runtime validation.
  *
- * Used by ContractPage to validate contracts received from the backend
- * before rendering. Catches malformed data early with diagnostic errors
- * instead of cryptic runtime TypeErrors.
+ * Used by ContractPage to validate contracts received from the backend before
+ * rendering. The schema is the canonical wire shape generated from
+ * `middag-php-ui` (single source of truth) — see `@/contracts/generated`.
  *
- * Validation is shallow for the core structure — block data is typed
- * but not validated (extensions add custom block types with unknown shapes).
+ * DA-03: the host-extensible parts are validated loosely. The generated core is
+ * already lenient on unknown keys (premium overlay + forward-compat fields are
+ * stripped, not rejected); on top of that, `resources` is relaxed to a
+ * permissive record because hosts patch it (preferences/capabilities/branding)
+ * and the React premium overlay (auth/locale) rides alongside.
  */
 import { z } from "zod";
 export declare const pageContractSchema: z.ZodObject<{
@@ -14,38 +17,83 @@ export declare const pageContractSchema: z.ZodObject<{
     shell: z.ZodString;
     page: z.ZodObject<{
         key: z.ZodString;
-        title: z.ZodString;
-        subtitle: z.ZodOptional<z.ZodString>;
-        icon: z.ZodOptional<z.ZodString>;
-        badge: z.ZodOptional<z.ZodObject<{
-            label: z.ZodString;
-            variant: z.ZodEnum<{
-                warning: "warning";
+        title: z.ZodAny;
+        subtitle: z.ZodOptional<z.ZodAny>;
+        breadcrumbs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            label: z.ZodAny;
+            href: z.ZodOptional<z.ZodString>;
+            external: z.ZodOptional<z.ZodLiteral<true>>;
+        }, z.core.$strip>>>;
+        actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodAny;
+            target: z.ZodAny;
+            intent: z.ZodEnum<{
                 success: "success";
+                primary: "primary";
+                secondary: "secondary";
+                danger: "danger";
+                warning: "warning";
                 info: "info";
-                destructive: "destructive";
+                link: "link";
+                ghost: "ghost";
             }>;
-        }, z.core.$strip>>;
-        favoritable: z.ZodOptional<z.ZodBoolean>;
-        breadcrumbs: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-        actions: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-        filterTabs: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-        activeFilterTab: z.ZodOptional<z.ZodString>;
+            icon: z.ZodOptional<z.ZodString>;
+            confirmation: z.ZodOptional<z.ZodObject<{
+                title: z.ZodAny;
+                message: z.ZodAny;
+                variant: z.ZodString;
+                confirmLabel: z.ZodOptional<z.ZodAny>;
+                cancelLabel: z.ZodOptional<z.ZodAny>;
+            }, z.core.$strip>>;
+            capability: z.ZodOptional<z.ZodString>;
+            disabled: z.ZodOptional<z.ZodLiteral<true>>;
+            loading: z.ZodOptional<z.ZodLiteral<true>>;
+        }, z.core.$strip>>>;
     }, z.core.$strip>;
     layout: z.ZodObject<{
         template: z.ZodString;
-        regions: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
-            type: z.ZodString;
-            key: z.ZodString;
-            data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-            variant: z.ZodOptional<z.ZodString>;
-            title: z.ZodOptional<z.ZodString>;
-            subtitle: z.ZodOptional<z.ZodString>;
-            actions: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-            meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        }, z.core.$strip>>>;
-        meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        regions: z.ZodAny;
+        meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
     }, z.core.$strip>;
+    notifications: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        level: z.ZodEnum<{
+            success: "success";
+            warning: "warning";
+            info: "info";
+            error: "error";
+        }>;
+        message: z.ZodAny;
+        dismissible: z.ZodBoolean;
+        title: z.ZodOptional<z.ZodAny>;
+        timeout: z.ZodOptional<z.ZodNumber>;
+        action: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodAny;
+            target: z.ZodAny;
+            intent: z.ZodEnum<{
+                success: "success";
+                primary: "primary";
+                secondary: "secondary";
+                danger: "danger";
+                warning: "warning";
+                info: "info";
+                link: "link";
+                ghost: "ghost";
+            }>;
+            icon: z.ZodOptional<z.ZodString>;
+            confirmation: z.ZodOptional<z.ZodObject<{
+                title: z.ZodAny;
+                message: z.ZodAny;
+                variant: z.ZodString;
+                confirmLabel: z.ZodOptional<z.ZodAny>;
+                cancelLabel: z.ZodOptional<z.ZodAny>;
+            }, z.core.$strip>>;
+            capability: z.ZodOptional<z.ZodString>;
+            disabled: z.ZodOptional<z.ZodLiteral<true>>;
+            loading: z.ZodOptional<z.ZodLiteral<true>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
     resources: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
 export type PageContractValidationError = {
@@ -53,8 +101,8 @@ export type PageContractValidationError = {
     message: string;
 };
 /**
- * Validate a PageContract shape. Returns null if valid, or an array
- * of validation errors if invalid.
+ * Validate a PageContract shape. Returns null if valid, or an array of
+ * validation errors if invalid.
  */
 export declare function validatePageContract(contract: unknown): PageContractValidationError[] | null;
 //# sourceMappingURL=page-contract-schema.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"page-contract-schema.d.ts","sourceRoot":"","sources":["../../src/contracts/page-contract-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA0CxB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAM7B,CAAC;AAEH,MAAM,MAAM,2BAA2B,GAAG;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,GAAG,2BAA2B,EAAE,GAAG,IAAI,CAQ5F"}
+{"version":3,"file":"page-contract-schema.d.ts","sourceRoot":"","sources":["../../src/contracts/page-contract-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAE7B,CAAC;AAEH,MAAM,MAAM,2BAA2B,GAAG;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,GAAG,2BAA2B,EAAE,GAAG,IAAI,CAQ5F"}

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

@@ -1,189 +1,47 @@
 /**
- * Page Contract (ADR-807) — TypeScript mirror of PHP VOs in
- * `classes/framework/shared/ui/*`.
+ * Page Contract — composed wire types.
  *
- * Backend sends this shape via Inertia props; the runtime resolves
- * shell/layout/blocks through registries to render React components.
- */
-import type { ActionBase, ActionConfirmation, ActionIntent, ActionMethod } from "../contracts/block-data";
-import type { SharedPropsAuth } from "../contracts/shared-props";
-/**
- * Shell type — the application frame that wraps all content.
- *
- * A shell provides the page chrome: sidebar navigation, header, toaster,
- * floating controls, and any global UI elements. Analogous to a browser's
- * "chrome" — everything outside the content viewport.
- *
- * Built-in shells:
- * - `"product"` — Full sidebar + header (ProductShell). Used for most pages.
- * - `"immersive"` — Minimal chrome, full-screen content (ImmersiveShell).
- *   Used for wizards, flow editors, onboarding.
- *
- * Extensible: consumers register custom shells with `registerShell(key, Component)`
- * and send the key from PHP via PageContract.shell.
- */
-export type Shell = "product" | "immersive" | (string & {});
-/**
- * Layout template — arranges blocks within the shell's content region.
- *
- * A layout defines named regions (content, aside, metrics, header, footer)
- * and how they are positioned. Blocks are placed into regions by the backend
- * via PageContract.layout.regions.
- *
- * Built-in layouts:
- * - `"stack"` — Single column, blocks stacked vertically.
- * - `"sidebar"` — Two-column: main content + 320px aside.
- * - `"dashboard"` — Metrics row + main content + optional aside.
- * - `"wizard"` — Step indicator + content + action footer.
+ * The wire shape comes from `middag-php-ui` value objects, generated into
+ * `@/contracts/generated`. This file refines those canonical types into the
+ * public contract the runtime renders (i18n-aware actions, typed block data).
  *
- * Extensible: consumers register custom layouts with `registerLayout(key, Component)`
- * and send the key from PHP via PageContract.layout.template.
+ * Premium overlays — page chrome (badge, meta, filter tabs), contextual help,
+ * inspector, the action `display` channel, and the `Pro*` page contract — live in
+ * `@middag-io/react-pro`, composed OVER these base types. The free engine ships
+ * the lean wire shape only. Dependency direction is one-way: react-pro → react.
  */
-export type LayoutTemplate = "stack" | "sidebar" | "dashboard" | "wizard" | (string & {});
-export interface Breadcrumb {
-    label: string;
-    href?: string;
-    external?: boolean;
-}
-/**
- * Page-level action button. Extends ActionBase with optional href/method for
- * both navigation (GET) and server actions (POST/PUT/DELETE).
- */
-export interface PageAction extends ActionBase {
-    intent: ActionIntent;
-    href?: string;
-    method?: ActionMethod;
-    /** Server-driven loading state (true while a backend job is running). */
-    loading?: boolean;
-    confirmation?: ActionConfirmation;
-}
-export interface PageFilterTab {
-    key: string;
-    label: string;
-    badge?: number | string;
-}
-export interface PageBadge {
-    label: string;
-    variant: "success" | "warning" | "destructive" | "info";
-}
-/** Avatar shown in the page header meta row. */
-export interface PageMetaAvatar {
-    initials: string;
-    label: string;
-    color?: string;
-}
-/** A single meta item displayed below the title. */
-export type PageMetaItem = {
-    type: "avatars";
-    avatars: PageMetaAvatar[];
-} | {
-    type: "text";
-    text: string;
-    icon?: string;
-} | {
-    type: "separator";
-};
-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[];
+import type { Action } from "../contracts/block-data";
+import type { BlockDescriptor as WireBlockDescriptor, Breadcrumb as WireBreadcrumb, LayoutDescriptor as WireLayoutDescriptor, PageContract as WirePageContract, PageMeta as WirePageMeta, PageResources as WirePageResources } from "../contracts/generated";
+/** Breadcrumb — canonical (i18n-aware label, external flag). */
+export type Breadcrumb = WireBreadcrumb;
+/** Page-level action button — the canonical Action (DA-05). */
+export type PageAction = Action;
+export type PageMeta = Omit<WirePageMeta, "actions"> & {
     actions?: PageAction[];
-    /** Inline meta items displayed below the title (avatars, timestamp, counters). */
-    meta?: PageMetaItem[];
-    /** 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;
+};
+export type BlockDescriptor<TData = Record<string, unknown>> = Omit<WireBlockDescriptor, "data" | "actions"> & {
     data: TData;
-    variant?: string;
-    title?: string;
-    subtitle?: string;
     actions?: PageAction[];
-    /**
-     * Block metadata.
-     *
-     * Reserved keys:
-     * - `lazyProp` (string): Inertia prop key for lazy-loaded data. When set,
-     *   the block reads data from `usePage().props[lazyProp]` instead of `block.data`.
-     *   PHP sends `data: {}` as placeholder; LazyBlock replaces it with the fetched data.
-     *   If the prop is null, the block auto-fetches via `router.reload({ only: [lazyProp] })`.
-     * - `loading` (boolean): When true, block shows a loading skeleton.
-     */
-    meta?: Record<string, unknown>;
-}
-export interface LayoutDescriptor {
-    template: LayoutTemplate;
+};
+export type LayoutDescriptor = Omit<WireLayoutDescriptor, "regions"> & {
     regions: Record<string, BlockDescriptor[]>;
-    meta?: Record<string, unknown>;
-}
-export interface PageResources {
-    auth?: SharedPropsAuth;
-    featureFlags?: Record<string, boolean>;
-    locale?: string;
-}
-export interface PageContract {
-    version: "1";
-    shell: Shell;
+};
+/** Page resources — canonical php-ui shape. */
+export type PageResources = WirePageResources;
+export type PageContract = Omit<WirePageContract, "page" | "layout" | "resources"> & {
     page: PageMeta;
     layout: LayoutDescriptor;
     resources?: PageResources;
     /** Entity type → route pattern map. Blocks resolve entity refs against this. */
     entities?: Record<string, string>;
-}
-/** 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.
+ * Inertia props shape for ContractPage. `overlay` toggles a full-screen overlay.
+ * Premium props (help, inspector) are added by @middag-io/react-pro.
  */
 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