@modufolio/panel 0.1.0 → 0.2.0

package/dist/Components/Table/tableSchema.d.ts

@@ -1,10 +1,4 @@
-/**
- * Client-side shape of a server-authored table schema.
- *
- * Mirrors App\Table\TableSchema / App\Table\Column. Declared in a .ts file
- * rather than inside the SFC so pages can import the types (`<script setup>`
- * cannot export type declarations).
- */
+import { TableRecord } from './tableTypes';
 export type SchemaColumnType = 'text' | 'select' | 'money' | 'numeric' | 'badge' | 'date' | 'boolean' | 'image' | 'icon' | 'color';
 /**
  * An action button rendered inside every cell of a column.
@@ -174,7 +168,7 @@ export interface TableSchema {
  * Returns undefined rather than throwing when any segment is missing, so a
  * null relation renders the column's placeholder instead of blowing up.
  */
-export declare function getPath(record: Record<string, any>, path: string): unknown;
+export declare function getPath(record: TableRecord, path: string): unknown;
 /**
  * The cell actions that apply to one row, after `hiddenWhen` is resolved
  * against it. Dot-paths are supported, matching every other field reference.
@@ -210,16 +204,39 @@ export interface SchemaBulkAction {
     confirm?: boolean;
     confirmMessage?: string;
 }
+/**
+ * The callbacks a page injects for what a schema can declare but not do.
+ *
+ * A schema is serialised Inertia data, so it can say a column is editable or
+ * that an action exists, but never how to persist or perform it; these are
+ * the shapes the page's handler maps take.
+ */
+/** Saves an in-place edit: the row, the column key, and the new value. */
+export type CellHandler = {
+    bivarianceHack(record: TableRecord, column: string, value: unknown): unknown;
+}['bivarianceHack'];
+/** Services a column's cell action for one row. */
+export type CellActionHandler = {
+    bivarianceHack(record: TableRecord, action: SchemaColumnAction): unknown;
+}['bivarianceHack'];
+/** Services a row action the table cannot perform itself. */
+export type RowActionHandler = {
+    bivarianceHack(record: TableRecord, action: SchemaRowAction): unknown;
+}['bivarianceHack'];
+/** Services a bulk action over the selection. */
+export type BulkActionHandler = {
+    bivarianceHack(records: TableRecord[], action: SchemaBulkAction): unknown;
+}['bivarianceHack'];
 /** The actions this row offers, after its own visibility fields are read. */
-export declare function visibleRowActions(actions: SchemaRowAction[] | undefined, record: Record<string, any>): SchemaRowAction[];
-export declare function visibleCellActions(column: SchemaColumn, record: Record<string, any>): SchemaColumnAction[];
+export declare function visibleRowActions(actions: SchemaRowAction[] | undefined, record: TableRecord): SchemaRowAction[];
+export declare function visibleCellActions(column: SchemaColumn, record: TableRecord): SchemaColumnAction[];
 /**
  * Fill a URL template from a record: `/panel/contacts/{id}/organization/{organization.id}`.
  *
  * Returns null when a placeholder cannot be resolved — a link containing a
  * literal `{organization.id}` would 404, so no link is the better answer.
  */
-export declare function resolveRecordUrl(template: string | null | undefined, record: Record<string, any>): string | null;
+export declare function resolveRecordUrl(template: string | null | undefined, record: TableRecord): string | null;
 /**
  * Empty form value per filter type — the shape useListFilters needs so it can
  * tell "unset" from "set", and so reset() restores the right type.

package/dist/Components/Table/tableTypes.d.ts

@@ -8,6 +8,19 @@ export interface TableColumn {
     headerClass?: string;
     cellClass?: string;
 }
-export type TableRecord = Record<string, any>;
+/**
+ * One row of table data, as the server sends it. Cell values are `unknown`
+ * and narrowed where they are read — the schema, not the row type, says what
+ * each column holds.
+ */
+export type TableRecord = Record<string, unknown>;
+/** A row's primary key, as the server sends it. */
+export type RecordId = string | number;
+/**
+ * The row's `id`, for the calls that key a request on it (a delete, a bulk
+ * post). Rows arrive untyped, so the shape is asserted here — once — rather
+ * than at every call site.
+ */
+export declare function recordId(record: TableRecord): RecordId;
 /** Columns carry either `key` or `name`; every lookup goes through this. */
 export declare function columnName(column: TableColumn): string | undefined;

package/dist/Components/Table/useSchemaActions.d.ts

@@ -1,14 +1,15 @@
-import { SchemaRowAction, SchemaBulkAction, TableSchema } from './tableSchema';
-type Row = Record<string, any>;
+import { SchemaRowAction, SchemaBulkAction, TableSchema, RowActionHandler, BulkActionHandler } from './tableSchema';
+import { TableRecord } from './tableTypes';
+type Row = TableRecord;
 interface ActionOptions {
     schema: () => TableSchema;
     /** Appended to record links so a drawer preserves the current list state. */
-    queryParams: () => Record<string, any>;
+    queryParams: () => Record<string, unknown>;
     /** The resource's own word for one record ('movie'), for the delete dialog. */
     recordLabel: () => string | undefined;
     /** Row actions the schema declares but the table cannot service itself. */
-    rowActionHandlers: () => Record<string, (record: Row, action: SchemaRowAction) => unknown>;
-    bulkActionHandlers: () => Record<string, (records: Row[], action: SchemaBulkAction) => unknown>;
+    rowActionHandlers: () => Record<string, RowActionHandler>;
+    bulkActionHandlers: () => Record<string, BulkActionHandler>;
 }
 /**
  * Runs the actions a schema declares, and owns the confirmations they need.
@@ -20,29 +21,11 @@ export declare function useSchemaActions(options: ActionOptions): {
     rowActionsFor: (record: Row) => SchemaRowAction[];
     runRowAction: (action: SchemaRowAction, record: Row) => void;
     deletion: import('vue').ComputedRef<{
-        state: {
-            open: boolean;
-            record: Row | null;
-            plan: {
-                blocked: boolean;
-                protected?: string[] | undefined;
-                nested?: {
-                    label: string;
-                    type?: string | undefined;
-                    children?: any[] | undefined;
-                }[] | undefined;
-                counts?: Record<string, number> | undefined;
-                linkCounts?: Record<string, number> | undefined;
-                soft?: boolean | undefined;
-            } | null;
-            loading: boolean;
-            deleting: boolean;
-            error: string | null;
-        };
-        request: (record: Row) => Promise<void>;
+        state: import('../..').DeleteConfirmationState<TableRecord>;
+        request: (record: TableRecord) => Promise<void>;
         confirm: () => Promise<void>;
         close: () => void;
-        message: ((record: Row) => string) | undefined;
+        message: ((record: TableRecord) => string) | undefined;
     }>;
     deleteLabel: import('vue').ComputedRef<string>;
     runBulkAction: (action: SchemaBulkAction, records: Row[]) => void;

package/dist/Composables/useDeleteConfirmation.d.ts

@@ -10,22 +10,24 @@
  * Deliberately not tied to generated resources: most pages that delete things
  * are hand-written, and they are the ones still calling confirm().
  */
+/** One record in the tree of what a delete would take with it. */
+export interface DeletionNode {
+    label: string;
+    type?: string;
+    children?: DeletionNode[];
+}
 export interface DeletionPlan {
     blocked: boolean;
     /** Human labels of the records standing in the way. */
     protected?: string[];
     /** Nested tree of what would be deleted. */
-    nested?: Array<{
-        label: string;
-        type?: string;
-        children?: any[];
-    }>;
+    nested?: DeletionNode[];
     counts?: Record<string, number>;
     linkCounts?: Record<string, number>;
     /** True when the record is only trashed, so nothing is at stake. */
     soft?: boolean;
 }
-export interface DeleteConfirmationState<T = any> {
+export interface DeleteConfirmationState<T = unknown> {
     open: boolean;
     record: T | null;
     plan: DeletionPlan | null;
@@ -35,7 +37,7 @@ export interface DeleteConfirmationState<T = any> {
     deleting: boolean;
     error: string | null;
 }
-export interface UseDeleteConfirmationOptions<T = any> {
+export interface UseDeleteConfirmationOptions<T = unknown> {
     /**
      * Where to ask what deleting `record` would do. Omit for a plain
      * confirmation.
@@ -55,30 +57,8 @@ export interface UseDeleteConfirmationOptions<T = any> {
     /** Shown when there is no preview to describe consequences with. */
     message?: (record: T) => string;
 }
-export declare function useDeleteConfirmation<T = any>(options: UseDeleteConfirmationOptions<T>): {
-    state: {
-        open: boolean;
-        record: import('vue').UnwrapRef<T> | null;
-        plan: {
-            blocked: boolean;
-            protected?: string[]
-            /** Nested tree of what would be deleted. */
-             | undefined;
-            nested?: {
-                label: string;
-                type?: string | undefined;
-                children?: any[] | undefined;
-            }[] | undefined;
-            counts?: Record<string, number> | undefined;
-            linkCounts?: Record<string, number>
-            /** True when the record is only trashed, so nothing is at stake. */
-             | undefined;
-            soft?: boolean | undefined;
-        } | null;
-        loading: boolean;
-        deleting: boolean;
-        error: string | null;
-    };
+export declare function useDeleteConfirmation<T = unknown>(options: UseDeleteConfirmationOptions<T>): {
+    state: DeleteConfirmationState<T>;
     request: (record: T) => Promise<void>;
     confirm: () => Promise<void>;
     close: () => void;

package/dist/Composables/useNestedDrawerForm.d.ts

@@ -40,6 +40,13 @@ export interface UseNestedDrawerFormReturn {
     closeForm: () => void;
     resetForm: () => void;
     getFormData: () => Record<string, unknown>;
+    /**
+     * Only the fields whose value differs from what the form opened with —
+     * what an edit submit should PATCH. Smaller conflict surface, honest audit
+     * trails: an untouched field cannot clobber a concurrent change. Create
+     * mode has no meaningful baseline, so callers use getFormData() there.
+     */
+    getChangedData: () => Record<string, unknown>;
     /**
      * True while the open form holds edits that have not been submitted —
      * what an "unsaved changes" guard asks before letting a navigation

package/dist/index.css

@@ -1 +1 @@
-.ui-toggle-button[data-v-5920d123]{display:inline-flex;align-items:center;justify-content:center}.pm-editor .ProseMirror{outline:none;min-height:8rem}.pm-editor .ProseMirror>*+*{margin-top:.75rem}.pm-editor .ProseMirror h2{font-size:1.25rem;font-weight:600}.pm-editor .ProseMirror h3{font-size:1.125rem;font-weight:600}.pm-editor .ProseMirror h4,.pm-editor .ProseMirror h5,.pm-editor .ProseMirror h6,.pm-editor .ProseMirror strong{font-weight:600}.pm-editor .ProseMirror em{font-style:italic}.pm-editor .ProseMirror a{text-decoration:underline;color:inherit}.pm-editor .ProseMirror code{font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:.875em;background:#f3f4f6;padding:.1em .3em;border-radius:.25rem}.pm-editor .ProseMirror pre{background:#f3f4f6;padding:.75rem;border-radius:.375rem;overflow-x:auto}.pm-editor .ProseMirror pre code{background:none;padding:0}.pm-editor .ProseMirror blockquote{border-left:3px solid rgb(209 213 219);padding-left:.75rem;color:#4b5563}.pm-editor .ProseMirror ul{list-style:disc;padding-left:1.25rem}.pm-editor .ProseMirror ol{list-style:decimal;padding-left:1.25rem}.pm-editor .ProseMirror li>*+*{margin-top:.25rem}.pm-editor .pm-placeholder:before{content:attr(data-placeholder);color:#d1d5db;float:left;height:0;pointer-events:none}.pm-editor .ProseMirror-selectednode{outline:2px solid rgb(59 130 246);border-radius:.375rem}.pm-editor .pm-dropcursor{background:#3b82f6}.pm-drag-handle{position:absolute;left:.5rem;display:none;align-items:center;justify-content:center;width:1rem;padding:.125rem;border-radius:.25rem;color:#d1d5db;cursor:grab;-webkit-user-select:none;user-select:none}.pm-drag-handle:hover{color:#6b7280;background:#f3f4f6}.pm-drag-handle:active{cursor:grabbing}.pm-drag-handle svg{width:.75rem;height:1.25rem;pointer-events:none}
+.ui-toggle-button[data-v-92aa6553]{display:inline-flex;align-items:center;justify-content:center}.pm-editor .ProseMirror{outline:none;min-height:8rem}.pm-editor .ProseMirror>*+*{margin-top:.75rem}.pm-editor .ProseMirror h2{font-size:1.25rem;font-weight:600}.pm-editor .ProseMirror h3{font-size:1.125rem;font-weight:600}.pm-editor .ProseMirror h4,.pm-editor .ProseMirror h5,.pm-editor .ProseMirror h6,.pm-editor .ProseMirror strong{font-weight:600}.pm-editor .ProseMirror em{font-style:italic}.pm-editor .ProseMirror a{text-decoration:underline;color:inherit}.pm-editor .ProseMirror code{font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:.875em;background:#f3f4f6;padding:.1em .3em;border-radius:.25rem}.pm-editor .ProseMirror pre{background:#f3f4f6;padding:.75rem;border-radius:.375rem;overflow-x:auto}.pm-editor .ProseMirror pre code{background:none;padding:0}.pm-editor .ProseMirror blockquote{border-left:3px solid rgb(209 213 219);padding-left:.75rem;color:#4b5563}.pm-editor .ProseMirror ul{list-style:disc;padding-left:1.25rem}.pm-editor .ProseMirror ol{list-style:decimal;padding-left:1.25rem}.pm-editor .ProseMirror li>*+*{margin-top:.25rem}.pm-editor .pm-placeholder:before{content:attr(data-placeholder);color:#d1d5db;float:left;height:0;pointer-events:none}.pm-editor .ProseMirror-selectednode{outline:2px solid rgb(59 130 246);border-radius:.375rem}.pm-editor .pm-dropcursor{background:#3b82f6}.pm-drag-handle{position:absolute;left:.5rem;display:none;align-items:center;justify-content:center;width:1rem;padding:.125rem;border-radius:.25rem;color:#d1d5db;cursor:grab;-webkit-user-select:none;user-select:none}.pm-drag-handle:hover{color:#6b7280;background:#f3f4f6}.pm-drag-handle:active{cursor:grabbing}.pm-drag-handle svg{width:.75rem;height:1.25rem;pointer-events:none}

package/dist/index.d.ts

@@ -2,7 +2,7 @@
  * @modufolio/panel — schema-driven admin panel components for
  * Inertia.js + Vue 3.
  */
-export declare const VERSION = "0.1.0";
+export declare const VERSION = "0.2.0";
 export { createPanel, type CreatePanelOptions } from './plugin';
 export { apiFetch, ApiError, type ApiFetchOptions } from './Utils/apiFetch';
 export * from './Utils/optimistic';
@@ -31,6 +31,7 @@ export * from './Composables/useDragReorder';
 export * from './Composables/useLocalStoragePersistence';
 export * from './Composables/useUnsavedChangesWarning';
 export * from './Composables/useNestedDrawerForm';
+export { useDrawerDirtyGuard } from './Components/Drawer/useDrawerDirtyGuard';
 export * from './Composables/useDeleteConfirmation';
 export * from './Composables/useReconciled';
 export { default as Button } from './Components/Core/Button.vue';
@@ -86,6 +87,10 @@ export { default as FieldGrid } from './Components/Fields/FieldGrid.vue';
 export { fieldsFromSpec, initialValues } from './Components/Fields/fieldsFromSpec';
 export { default as BlueprintForm } from './Components/Fields/BlueprintForm.vue';
 export { useFieldWidth, fieldWidthProp } from './Components/Fields/useFieldWidth';
+export { default as FieldPrimitive } from './Components/Fields/FieldPrimitive.vue';
+export { default as FieldLabel } from './Components/Fields/FieldLabel.vue';
+export { default as FieldDescription } from './Components/Fields/FieldDescription.vue';
+export { default as FieldMessage } from './Components/Fields/FieldMessage.vue';
 export { useBlueprint, defineBlueprint, evaluateCondition, registerFieldType, resolveFieldComponent, type FieldDef, type FieldType, type BuiltinFieldType, type OptionItem, type Condition, type ConditionTuple, type ConditionOperator, } from './Components/Fields/useBlueprint';
 export { required, min, max, email, url, pattern, integer, same, firstError, rulesFromSpec, type ValidationRule, } from './Components/Fields/validation';
 export { default as TextField } from './Components/Fields/TextField.vue';