@modufolio/panel 0.1.0 → 0.2.0

package/README.md

@@ -151,7 +151,7 @@ The reference implementation is appkit + appkit-portfolio.
 ## Tests
 
 ```bash
-npm test            # inside packages/panel
+npm test            # inside ui/
 ```
 
 Specs live in `tests/`, one file per module or component, run by the

package/dist/Builder/dragHandle.d.ts

@@ -10,4 +10,14 @@ import { EditorView } from 'prosemirror-view';
  * event alone rather than starting a drag that cannot finish.
  */
 export declare function startBlockDrag(view: EditorView, pos: number, event: DragEvent): boolean;
+/**
+ * The top-level block at a viewport coordinate, or null.
+ *
+ * `x` is pulled inside the content box before asking, so hovering the gutter —
+ * which is outside the editable area — still resolves the block beside it.
+ *
+ * Exported for the same reason as `startBlockDrag`: the coordinate handling
+ * around it needs a layout engine, but the position arithmetic does not.
+ */
+export declare function blockPosAt(view: EditorView, x: number, y: number): number | null;
 export declare function blockDragHandle(): Plugin;

package/dist/Builder/schema.d.ts

@@ -16,5 +16,5 @@ export type CodeLanguage = (typeof CODE_LANGUAGES)[number];
  * ProseMirror-based CMSs (see docs/prosemirror-builder.md §3.3).
  */
 export declare function safeHref(value: unknown): string | null;
-export declare const schema: Schema<"text" | "blockquote" | "image" | "heading" | "doc" | "paragraph" | "code_block" | "bullet_list" | "ordered_list" | "list_item" | "hard_break", "code" | "em" | "link" | "strong">;
+export declare const schema: Schema<"blockquote" | "image" | "text" | "heading" | "doc" | "paragraph" | "code_block" | "bullet_list" | "ordered_list" | "list_item" | "hard_break", "code" | "em" | "link" | "strong">;
 export type BuilderSchema = typeof schema;

package/dist/Components/Actions/Action.vue.d.ts

@@ -97,8 +97,8 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
     onClick?: ((...args: any[]) => any) | undefined;
 }>, {
     size: string;
-    label: string;
     type: "button" | "reset" | "submit";
+    label: string;
     disabled: boolean;
     color: string;
     icon: string | Function | Record<string, any>;

package/dist/Components/Columns/CellActions.vue.d.ts

@@ -1,17 +1,17 @@
 import { PropType } from 'vue';
-import { SchemaColumn, SchemaColumnAction } from '../Table/tableSchema';
-type ActionHandler = (record: Record<string, any>, action: SchemaColumnAction) => unknown;
+import { SchemaColumn, SchemaColumnAction, CellActionHandler } from '../Table/tableSchema';
+import { TableRecord } from '../Table/tableTypes';
 declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
     column: {
         type: PropType<SchemaColumn>;
         required: true;
     };
     record: {
-        type: PropType<Record<string, any>>;
+        type: PropType<TableRecord>;
         required: true;
     };
     handlers: {
-        type: PropType<Record<string, ActionHandler>>;
+        type: PropType<Record<string, CellActionHandler>>;
         default: () => {};
     };
 }>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
@@ -20,15 +20,15 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
         required: true;
     };
     record: {
-        type: PropType<Record<string, any>>;
+        type: PropType<TableRecord>;
         required: true;
     };
     handlers: {
-        type: PropType<Record<string, ActionHandler>>;
+        type: PropType<Record<string, CellActionHandler>>;
         default: () => {};
     };
 }>> & Readonly<{}>, {
-    handlers: Record<string, ActionHandler>;
+    handlers: Record<string, (record: TableRecord, action: SchemaColumnAction) => unknown>;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/Components/Columns/SelectColumn.vue.d.ts

@@ -1,4 +1,10 @@
 import { PropType } from 'vue';
+/** One choice as rendered; a bare string or number is accepted and normalised to this. */
+interface SelectOption {
+    label: string;
+    value: string | number;
+    class?: string;
+}
 declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
     value: {
         type: (StringConstructor | NumberConstructor | BooleanConstructor)[];
@@ -13,7 +19,7 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
         required: true;
     };
     options: {
-        type: PropType<any[]>;
+        type: PropType<Array<SelectOption | string | number>>;
         required: true;
     };
     placeholder: {
@@ -44,7 +50,7 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
         required: true;
     };
     options: {
-        type: PropType<any[]>;
+        type: PropType<Array<SelectOption | string | number>>;
         required: true;
     };
     placeholder: {

package/dist/Components/Core/Button.vue.d.ts

@@ -110,12 +110,12 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
     onClick?: ((...args: any[]) => any) | undefined;
 }>, {
     size: string;
-    label: string;
     type: string;
+    label: string;
+    as: string;
     disabled: boolean;
     color: string;
     loading: boolean;
-    as: string;
     href: string;
     icon: Function | Record<string, any>;
     iconPosition: string;

package/dist/Components/Core/FlashMessages.vue.d.ts

@@ -1,7 +1,12 @@
+/** Server flash messages, surfaced through DefaultProps as `$page.props.flash`. */
+interface FlashProps {
+    success?: string | null;
+    error?: string | null;
+}
 declare const _default: typeof __VLS_export;
 export default _default;
 declare const __VLS_export: import('vue').DefineComponent<{}, {}, {
     show: boolean;
 }, {
-    flash(): any;
+    flash(): FlashProps;
 }, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;

package/dist/Components/Core/SelectInput.vue.d.ts

@@ -13,8 +13,8 @@ declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {}, {}, {},
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
     "onUpdate:modelValue"?: ((value: string) => any) | undefined;
 }>, {
-    modelValue: string | null;
     id: string;
+    modelValue: string | null;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist/Components/Core/TextInput.vue.d.ts

@@ -17,9 +17,9 @@ declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
     "onUpdate:modelValue"?: ((value: string) => any) | undefined;
 }>, {
-    modelValue: string;
     id: string;
     type: string;
+    modelValue: string;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/Components/Dialogs/Dialog.vue.d.ts

@@ -65,8 +65,8 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
     onClose?: ((...args: any[]) => any) | undefined;
     "onUpdate:isOpen"?: ((...args: any[]) => any) | undefined;
 }>, {
-    width: string;
     title: string;
+    width: string;
     description: string;
     closable: boolean;
     closeOnOverlay: boolean;

package/dist/Components/Drawer/Drawer.vue.d.ts

@@ -109,8 +109,8 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
     onActivate?: ((...args: any[]) => any) | undefined;
     onBack?: ((...args: any[]) => any) | undefined;
 }>, {
-    width: string;
     title: string;
+    width: string;
     description: string;
     closable: boolean;
     closeOnOverlay: boolean;

package/dist/Components/Drawer/DrawerLink.vue.d.ts

@@ -1,3 +1,4 @@
+import { PropType } from 'vue';
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_1) => any;
@@ -37,7 +38,7 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
      * These help the backend maintain list context for navigation.
      */
     queryParams: {
-        type: () => Record<string, any>;
+        type: PropType<Record<string, unknown>>;
         default: () => {};
     };
 }>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
@@ -75,7 +76,7 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
      * These help the backend maintain list context for navigation.
      */
     queryParams: {
-        type: () => Record<string, any>;
+        type: PropType<Record<string, unknown>>;
         default: () => {};
     };
 }>> & Readonly<{}>, {
@@ -84,7 +85,7 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
     preserveState: boolean;
     only: string[];
     showArrow: boolean;
-    queryParams: Record<string, any>;
+    queryParams: Record<string, unknown>;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist/Components/Drawer/DrawerRelationList.vue.d.ts

@@ -12,14 +12,16 @@
  * when the target's drawer slot lives on *another* page, which a drawer-only
  * visit would leave unrendered.
  */
+/** One related row, as the server sends it; `id` keys the row when present. */
+type RelationItem = Record<string, unknown>;
 type __VLS_Props = {
-    items?: any[];
+    items?: RelationItem[];
     heading?: string;
     emptyText?: string;
     /** Builds the row's destination; rows are inert when omitted. */
-    href?: (item: any) => string;
+    href?: (item: RelationItem) => string;
     navigation?: 'drawer' | 'visit';
-    queryParams?: Record<string, any>;
+    queryParams?: Record<string, unknown>;
     variant?: 'list' | 'cards';
     /** Show the "+ Add" affordance and emit `add`. */
     addable?: boolean;
@@ -34,10 +36,10 @@ type __VLS_Props = {
     showChevron?: boolean;
 };
 declare var __VLS_1: {}, __VLS_3: {}, __VLS_13: {
-    item: any;
+    item: RelationItem;
     index: number;
 }, __VLS_15: {
-    item: any;
+    item: RelationItem;
     index: number;
 };
 type __VLS_Slots = {} & {
@@ -50,19 +52,19 @@ type __VLS_Slots = {} & {
     rowActions?: (props: typeof __VLS_15) => any;
 };
 declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-    delete: (item: any) => any;
+    delete: (item: RelationItem) => any;
     add: () => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
-    onDelete?: ((item: any) => any) | undefined;
+    onDelete?: ((item: RelationItem) => any) | undefined;
     onAdd?: (() => any) | undefined;
 }>, {
     navigation: "drawer" | "visit";
-    items: any[];
-    href: (item: any) => string;
+    items: RelationItem[];
+    href: (item: RelationItem) => string;
     variant: "list" | "cards";
     heading: string;
     dense: boolean;
-    queryParams: Record<string, any>;
+    queryParams: Record<string, unknown>;
     deleteLabel: string;
     emptyText: string;
     addable: boolean;

package/dist/Components/Drawer/DrawerStack.vue.d.ts

@@ -1,38 +1,38 @@
 import { StackItem } from './useDrawerStack';
 export type { StackItem } from './useDrawerStack';
-declare var __VLS_29: `header-${string}`, __VLS_30: {
+declare var __VLS_37: `header-${string}`, __VLS_38: {
     item: StackItem;
     index: number;
-}, __VLS_33: string, __VLS_34: {
+}, __VLS_41: string, __VLS_42: {
     item: StackItem;
     index: number;
-    data: Record<string, any>;
-}, __VLS_38: `footer-${string}`, __VLS_39: {
+    data: Record<string, unknown>;
+}, __VLS_46: `footer-${string}`, __VLS_47: {
     item: StackItem;
     index: number;
-}, __VLS_53: `header-${string}`, __VLS_54: {
+}, __VLS_61: `header-${string}`, __VLS_62: {
     item: StackItem;
     index: number;
-}, __VLS_57: string, __VLS_58: {
+}, __VLS_65: string, __VLS_66: {
     item: StackItem;
     index: number;
-    data: Record<string, any>;
-}, __VLS_62: `footer-${string}`, __VLS_63: {
+    data: Record<string, unknown>;
+}, __VLS_70: `footer-${string}`, __VLS_71: {
     item: StackItem;
     index: number;
 };
 type __VLS_Slots = {} & {
-    [K in NonNullable<typeof __VLS_29>]?: (props: typeof __VLS_30) => any;
+    [K in NonNullable<typeof __VLS_37>]?: (props: typeof __VLS_38) => any;
 } & {
-    [K in NonNullable<typeof __VLS_33>]?: (props: typeof __VLS_34) => any;
+    [K in NonNullable<typeof __VLS_41>]?: (props: typeof __VLS_42) => any;
 } & {
-    [K in NonNullable<typeof __VLS_38>]?: (props: typeof __VLS_39) => any;
+    [K in NonNullable<typeof __VLS_46>]?: (props: typeof __VLS_47) => any;
 } & {
-    [K in NonNullable<typeof __VLS_53>]?: (props: typeof __VLS_54) => any;
+    [K in NonNullable<typeof __VLS_61>]?: (props: typeof __VLS_62) => any;
 } & {
-    [K in NonNullable<typeof __VLS_57>]?: (props: typeof __VLS_58) => any;
+    [K in NonNullable<typeof __VLS_65>]?: (props: typeof __VLS_66) => any;
 } & {
-    [K in NonNullable<typeof __VLS_62>]?: (props: typeof __VLS_63) => any;
+    [K in NonNullable<typeof __VLS_70>]?: (props: typeof __VLS_71) => any;
 };
 declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
     stack: {

package/dist/Components/Drawer/useDrawerDirtyGuard.d.ts

@@ -0,0 +1,17 @@
+import { Ref } from 'vue';
+/**
+ * Guard the enclosing drawer against silent discards.
+ *
+ * Call from any component rendered inside a drawer frame, handing it the
+ * form's dirty state; every close path — X, back arrow, backdrop, Escape,
+ * clicking a background frame — then routes through the stack's single
+ * discard dialog while the form reports dirty. Unregisters itself when the
+ * component's scope ends.
+ *
+ *   const { isDirty } = useNestedDrawerForm(fields)
+ *   useDrawerDirtyGuard(isDirty)
+ *
+ * Outside a drawer this is a no-op, so shared components can call it
+ * unconditionally.
+ */
+export declare function useDrawerDirtyGuard(isDirty: Ref<boolean>): void;

package/dist/Components/Drawer/useDrawerStack.d.ts

@@ -43,7 +43,7 @@ export interface StackItemTab {
  */
 export interface StackItem {
     type: string;
-    data: Record<string, any>;
+    data: Record<string, unknown>;
     title?: string;
     description?: string;
     width?: string;

package/dist/Components/Drawer/useIsDrawer.d.ts

@@ -37,6 +37,14 @@ export interface DrawerStackContext {
     pop: () => void;
     /** Close the entire stack */
     closeAll: () => void;
+    /**
+     * Register an unsaved-changes check for the drawer at `level`. The stack
+     * consults every check covering the frames a close would remove — the X,
+     * the back arrow, the backdrop and Escape all route through the same
+     * guard, so no close path can silently discard edits. Returns an
+     * unregister function; call it when the owning form unmounts.
+     */
+    registerDirtyCheck: (level: number, isDirty: () => boolean) => () => void;
 }
 /**
  * Detect if the current component is rendered inside a drawer.

package/dist/Components/Fields/BelongsToSelect.vue.d.ts

@@ -1,9 +1,14 @@
 import { PropType } from 'vue';
-declare var __VLS_1: {
-    option: any;
+/**
+ * An option row, keyed by whatever `valueKey` / `labelKey` name — the shape
+ * is the consumer's, so only the two keys the field reads are interpreted.
+ */
+type BelongsToOption = Record<string, unknown>;
+declare var __VLS_8: {
+    option: Record<string, unknown>;
 };
 type __VLS_Slots = {} & {
-    option?: (props: typeof __VLS_1) => any;
+    option?: (props: typeof __VLS_8) => any;
 };
 declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
     modelValue: {
@@ -38,7 +43,7 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
      * Options array or endpoint for fetching options
      */
     options: {
-        type: PropType<any[]>;
+        type: PropType<BelongsToOption[]>;
         default: () => never[];
     };
     endpoint: {
@@ -144,7 +149,7 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
      * Options array or endpoint for fetching options
      */
     options: {
-        type: PropType<any[]>;
+        type: PropType<BelongsToOption[]>;
         default: () => never[];
     };
     endpoint: {
@@ -219,13 +224,13 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
     onCreate?: ((...args: any[]) => any) | undefined;
 }>, {
     required: boolean;
-    modelValue: string | number | null;
     label: string;
-    placeholder: string;
     error: string;
-    disabled: boolean;
     width: string;
-    options: any[];
+    modelValue: string | number | null;
+    placeholder: string;
+    disabled: boolean;
+    options: BelongsToOption[];
     searchable: boolean;
     searchUrl: string;
     endpoint: string;

package/dist/Components/Fields/CheckboxField.vue.d.ts

@@ -80,12 +80,12 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
     "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
 }>, {
     required: boolean;
-    modelValue: boolean;
     id: string;
     help: string;
     error: string;
-    disabled: boolean;
     width: string;
+    modelValue: boolean;
+    disabled: boolean;
     description: string;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
 declare const _default: typeof __VLS_export;

package/dist/Components/Fields/ColorPickerField.vue.d.ts

@@ -91,13 +91,13 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
     "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
 }>, {
     required: boolean;
-    modelValue: string;
     label: string;
-    placeholder: string;
     help: string;
     error: string;
-    disabled: boolean;
     width: string;
+    modelValue: string;
+    placeholder: string;
+    disabled: boolean;
     presets: string[];
     format: string;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;

package/dist/Components/Fields/DataField.vue.d.ts

@@ -0,0 +1,55 @@
+declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+    /** Ties the label and any help/error text to the control. */
+    id: {
+        type: StringConstructor;
+        default: () => string;
+    };
+    modelValue: {
+        type: null;
+        default: null;
+    };
+    label: {
+        type: StringConstructor;
+        default: string;
+    };
+    help: {
+        type: StringConstructor;
+        default: string;
+    };
+    width: {
+        readonly type: StringConstructor;
+        readonly default: "full";
+        readonly validator: (v: string) => boolean;
+    };
+}>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    /** Ties the label and any help/error text to the control. */
+    id: {
+        type: StringConstructor;
+        default: () => string;
+    };
+    modelValue: {
+        type: null;
+        default: null;
+    };
+    label: {
+        type: StringConstructor;
+        default: string;
+    };
+    help: {
+        type: StringConstructor;
+        default: string;
+    };
+    width: {
+        readonly type: StringConstructor;
+        readonly default: "full";
+        readonly validator: (v: string) => boolean;
+    };
+}>> & Readonly<{}>, {
+    id: string;
+    label: string;
+    help: string;
+    width: string;
+    modelValue: any;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/Components/Fields/DatePickerField.vue.d.ts

@@ -90,13 +90,13 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
     required: boolean;
     min: string;
     max: string;
-    modelValue: string;
     id: string;
     label: string;
     help: string;
     error: string;
-    disabled: boolean;
     width: string;
+    modelValue: string;
+    disabled: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/Components/Fields/DateRangePickerField.vue.d.ts

@@ -125,12 +125,12 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
     required: boolean;
     min: string;
     max: string;
-    modelValue: Record<string, any>;
     label: string;
     help: string;
     error: string;
-    disabled: boolean;
     width: string;
+    modelValue: Record<string, any>;
+    disabled: boolean;
     showPresets: boolean;
     presets: Preset[];
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;

package/dist/Components/Fields/DateTimePickerField.vue.d.ts

@@ -120,13 +120,13 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
     required: boolean;
     min: string;
     max: string;
-    modelValue: string;
     id: string;
     label: string;
     help: string;
     error: string;
-    disabled: boolean;
     width: string;
+    modelValue: string;
+    disabled: boolean;
     step: number;
     defaultTime: string;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;