@dskripchenko/laravel-admin 1.32.2 → 1.34.0

package/dist/components/render/formState.d.ts

@@ -39,3 +39,14 @@ export declare function provideFormState(initial?: Record<string, unknown>, init
 export declare function useFormState(): FormStateContext;
 /** The optional form: null when there is none. */
 export declare function tryUseFormState(): FormStateContext | null;
+/**
+ * Provides a form context scoped to one object-valued field of `parent` — the
+ * backend's Field\Group, whose state is `{city: ..., street: ...}` under its
+ * own name.
+ *
+ * Unlike NestedFieldsGroup this keeps no copy: every read and write goes to
+ * `parent.state[name]`, and the errors are the parent's `name.child` keys —
+ * the shape Laravel's validator reports them in — seen without the prefix.
+ * Scopes nest: a group inside a group prefixes twice.
+ */
+export declare function provideScopedFormState(parent: FormStateContext, name: string): FormStateContext;

package/dist/components/render/index.d.ts

@@ -10,6 +10,10 @@ export type { ComponentBundle } from './registry';
 export { registerBuiltinComponents } from './builtin';
 export { provideFormState, useFormState, tryUseFormState, } from './formState';
 export type { FormStateContext } from './formState';
+export { createScreenContext, provideScreenContext, useScreenContext, } from './screenContext';
+export type { ScreenContext, ScreenContextOptions, ScreenActionLike } from './screenContext';
+export { provideListenerEndpoint, useListenerEndpoint } from './listenerContext';
+export type { ListenerEndpoint } from './listenerContext';
 export { default as TextField } from '../fields/TextField.vue';
 export { default as TextAreaField } from '../fields/TextAreaField.vue';
 export { default as NumberField } from '../fields/NumberField.vue';
@@ -22,3 +26,12 @@ export { default as RowsLayout } from '../layouts/RowsLayout.vue';
 export { default as ColumnsLayout } from '../layouts/ColumnsLayout.vue';
 export { default as SectionLayout } from '../layouts/SectionLayout.vue';
 export { default as TabsLayout } from '../layouts/TabsLayout.vue';
+export { default as AccordionLayout } from '../layouts/AccordionLayout.vue';
+export { default as WizardLayout } from '../layouts/WizardLayout.vue';
+export { default as ModalLayout } from '../layouts/ModalLayout.vue';
+export { default as DrawerLayout } from '../layouts/DrawerLayout.vue';
+export { default as ViewLayout } from '../layouts/ViewLayout.vue';
+export { default as WrapperLayout } from '../layouts/WrapperLayout.vue';
+export { default as InfolistLayout } from '../layouts/InfolistLayout.vue';
+export { default as AuditTrailLayout } from '../layouts/AuditTrailLayout.vue';
+export { default as ListenerLayout } from '../layouts/ListenerLayout.vue';

package/dist/components/render/listenerContext.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Where a Listener layout sends its requests.
+ *
+ * The page that owns the form provides it: ScreenPage points at the screen's
+ * `listener` action, ResourceFormPage at the resource's, adding the form's
+ * context and the record id. Without one — a settings page, a unit test — a
+ * listener simply draws its children as the server first sent them.
+ */
+import { type InjectionKey } from 'vue';
+export interface ListenerEndpoint {
+    /** The action's URL relative to the API root, e.g. `/contact/listener`. */
+    url: () => string;
+    /** Extra body fields sent along with `{listener, state}`. */
+    extra?: () => Record<string, unknown>;
+}
+declare const ListenerEndpointKey: InjectionKey<ListenerEndpoint>;
+export declare function provideListenerEndpoint(endpoint: ListenerEndpoint): void;
+/** The endpoint, or null when no page provides one. */
+export declare function useListenerEndpoint(): ListenerEndpoint | null;
+export { ListenerEndpointKey };

package/dist/components/render/screenContext.d.ts

@@ -0,0 +1,75 @@
+/**
+ * The screen context: what a layout deep in the tree may ask of the screen it
+ * sits on.
+ *
+ * Two things live here:
+ *
+ *   - the overlays — the open/closed state of the Modal and Drawer layouts,
+ *     keyed by the layout's id. An action carrying `attributes.opens` (see the
+ *     backend's `Action::opens()`) opens the overlay with that id;
+ *   - the dispatcher — a click on an action, wherever it is drawn (the command
+ *     bar, a modal's footer, a wizard's submit), goes through `dispatch`, which
+ *     asks for the confirmation and opens an overlay, or hands the action to
+ *     the page's action runner (`run`) — or, without one, calls the screen's
+ *     method.
+ *
+ * ScreenPage provides it. Outside a screen — a resource form, a unit test —
+ * `useScreenContext()` returns null and the layouts degrade gracefully: an
+ * overlay keeps its own local state and a submit has nowhere to go.
+ */
+import { type InjectionKey, type Ref } from 'vue';
+/** The shape of an action as the backend serializes it (Action::toArray). */
+export interface ScreenActionLike {
+    name?: string;
+    label?: string;
+    type?: string;
+    icon?: string | null;
+    primary?: boolean;
+    destructive?: boolean;
+    confirm?: {
+        message: string;
+        title?: string;
+    } | null;
+    attributes?: Record<string, unknown>;
+}
+export interface ScreenContext {
+    isOpen: (id: string) => boolean;
+    open: (id: string) => void;
+    close: (id: string) => void;
+    /** Whether a screen method is running right now. */
+    running: Readonly<Ref<boolean>>;
+    /**
+     * Calls a screen method with the current state. Resolves to true on
+     * success, false on a failure — the errors land in the screen store.
+     */
+    runMethod: (method: string) => Promise<boolean>;
+    /**
+     * Runs an action: the confirmation first, then either `attributes.opens`
+     * (an overlay) or `attributes.method` (a screen method). Resolves to true
+     * when the action went through.
+     */
+    dispatch: (action: ScreenActionLike) => Promise<boolean>;
+}
+declare const ScreenContextKey: InjectionKey<ScreenContext>;
+export interface ScreenContextOptions {
+    running: Readonly<Ref<boolean>>;
+    runMethod: (method: string) => Promise<boolean>;
+    /** The confirmation prompt; the panel's confirmation dialog by default. */
+    confirm?: (confirm: {
+        message: string;
+        title?: string;
+    }) => boolean | Promise<boolean>;
+    /**
+     * Runs any action that does not open an overlay — confirmation included.
+     * ScreenPage passes its action runner here, so the layouts' actions get
+     * every action type (modal, async, link…) too. Without it only
+     * `attributes.method` is understood.
+     */
+    run?: (action: ScreenActionLike) => Promise<boolean>;
+}
+export declare function createScreenContext(options: ScreenContextOptions): ScreenContext;
+export declare function provideScreenContext(options: ScreenContextOptions): ScreenContext;
+/** The screen context, or null outside a screen. */
+export declare function useScreenContext(): ScreenContext | null;
+/** For tests and hosts that render layouts outside ScreenPage. */
+export { ScreenContextKey };

package/dist/components/render/screenContext.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/resource/AuditTimeline.vue.d.ts

@@ -7,6 +7,10 @@ interface Props {
      */
     subjectType: string | null;
     subjectId: string | number;
+    /** Show at most this many of the latest events; all of them when null. */
+    limit?: number | null;
 }
-declare const _default: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
+    limit: number | null;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 export default _default;

package/dist/components/resource/ResourceIndexPage.vue.d.ts

@@ -10,20 +10,20 @@ interface Props {
     /** Router route name behind the “Create” action. */
     createRouteName?: string | null;
 }
-declare var __VLS_5: {}, __VLS_79: {}, __VLS_149: {
+declare var __VLS_5: {}, __VLS_78: {}, __VLS_147: {
     filters: Record<string, unknown>;
     setFilter: (key: string, value: unknown) => Promise<void>;
-}, __VLS_215: `cell-${string}`, __VLS_216: {
+}, __VLS_228: `cell-${string}`, __VLS_229: {
     row: Record<string, unknown> | undefined;
 };
 type __VLS_Slots = {} & {
-    [K in NonNullable<typeof __VLS_215>]?: (props: typeof __VLS_216) => any;
+    [K in NonNullable<typeof __VLS_228>]?: (props: typeof __VLS_229) => any;
 } & {
     actions?: (props: typeof __VLS_5) => any;
 } & {
-    'header-menu'?: (props: typeof __VLS_79) => any;
+    'header-menu'?: (props: typeof __VLS_78) => any;
 } & {
-    filters?: (props: typeof __VLS_149) => any;
+    filters?: (props: typeof __VLS_147) => any;
 };
 declare const __VLS_component: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     import: () => any;

package/dist/components/resource/ResourceViewPage.vue.d.ts

@@ -19,12 +19,12 @@ interface Props {
     /** The prefix of the UID label next to the status: 'A-' gives 'A-1284'. */
     uidPrefix?: string;
 }
-declare var __VLS_75: {
+declare var __VLS_74: {
     record: Record<string, unknown>;
     resource: import("../..").ManifestResourceMeta | null;
 };
 type __VLS_Slots = {} & {
-    sidebar?: (props: typeof __VLS_75) => any;
+    sidebar?: (props: typeof __VLS_74) => any;
 };
 declare const __VLS_component: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
     indexRouteName: string | null;

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

@@ -0,0 +1,2 @@
+declare const _default: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/composables/useActionRunner.d.ts

@@ -0,0 +1,132 @@
+import { type Router } from 'vue-router';
+export interface ActionConfirm {
+    message: string;
+    title?: string;
+    confirmLabel?: string;
+    cancelLabel?: string;
+}
+/** An action as Action::toArray() serializes it, normalized. */
+export interface AdminAction {
+    name: string;
+    label: string;
+    type: string;
+    icon: string | null;
+    confirm: ActionConfirm | null;
+    primary: boolean;
+    destructive: boolean;
+    position: string[];
+    attributes: Record<string, unknown>;
+    /** The nested actions of a dropdown. */
+    items: AdminAction[];
+}
+/** One run of an action. */
+export interface ActionRunOptions {
+    /**
+     * The record keys this run applies to — a row's own menu passes its row —
+     * instead of the context's `ids()` (the selection).
+     */
+    ids?: Array<string | number>;
+}
+/** How a page runs a server-side action in its own context. */
+export interface ActionExecutor {
+    /**
+     * Runs a button, bulk or modal action; `payload` is the modal form's
+     * values, `options` what `run()` was given.
+     */
+    execute: (action: AdminAction, payload?: Record<string, unknown>, options?: ActionRunOptions) => Promise<unknown>;
+    /** The record keys the actions apply to, when the context has any. */
+    ids?: () => Array<string | number>;
+    /** After a successful execute: a toast, a reload. */
+    onSuccess?: (action: AdminAction, result: unknown, options?: ActionRunOptions) => void | Promise<void>;
+    /** When execute fails; a toast with the error's message by default. */
+    onError?: (action: AdminAction, err: unknown) => void;
+    /** Reloads the context's data after an async action has finished. */
+    refresh?: () => void | Promise<void>;
+}
+export interface DelayedStatus {
+    uuid?: string;
+    status: string;
+    progress?: number | null;
+    data?: unknown;
+    error?: string | null;
+}
+/** Normalizes one serialized action; null when it has no name or label. */
+export declare function normalizeAction(raw: unknown): AdminAction | null;
+export declare function normalizeActions(raw: unknown): AdminAction[];
+/**
+ * Whether the action applies to records: a BulkAction always does, an action
+ * marked `standalone()` never does, any other one does when it is placed in
+ * rows or in the bulk bar. The backend's Action::requiresSelection() answers
+ * the same way.
+ */
+export declare function needsSelection(action: AdminAction): boolean;
+/**
+ * Whether a selection of `count` records satisfies the action's
+ * requiresAtLeast / requiresAtMost (BulkAction).
+ */
+export declare function selectionAllows(action: AdminAction, count: number): boolean;
+export type ModalSize = 'sm' | 'md' | 'lg' | 'xl' | 'full';
+/** The UidModal sizes; the backend's modalSize() is a free-form string. */
+export declare function modalSizeOf(raw: unknown): ModalSize;
+/**
+ * Turns an absolute href into a router path when it points inside the panel;
+ * null when it has to be a full navigation.
+ */
+export declare function toRouterPath(router: Router | undefined, href: string): string | null;
+export declare function useActionRunner(executor: ActionExecutor): {
+    run: (action: AdminAction, options?: ActionRunOptions) => Promise<boolean>;
+    running: import("vue").Ref<boolean, boolean>;
+    confirm: (opts: ActionConfirm | string, destructive?: boolean) => Promise<boolean>;
+    confirmState: {
+        open: boolean;
+        title: string;
+        message: string;
+        confirmLabel: string;
+        cancelLabel: string;
+        destructive: boolean;
+    };
+    resolveConfirm: (ok: boolean) => void;
+    modalState: {
+        open: boolean;
+        seq: number;
+        action: {
+            name: string;
+            label: string;
+            type: string;
+            icon: string | null;
+            confirm: {
+                message: string;
+                title?: string | undefined;
+                confirmLabel?: string | undefined;
+                cancelLabel?: string | undefined;
+            } | null;
+            primary: boolean;
+            destructive: boolean;
+            position: string[];
+            attributes: Record<string, unknown>;
+            items: /*elided*/ any[];
+        } | null;
+        title: string;
+        submitLabel: string;
+        size: ModalSize;
+        fields: Array<Record<string, unknown>>;
+        values: Record<string, unknown>;
+        errors: Record<string, string[]>;
+        submitting: boolean;
+        options: {
+            ids?: Array<string | number> | undefined;
+        } | undefined;
+    };
+    submitModal: () => Promise<void>;
+    closeModal: () => void;
+    asyncState: {
+        open: boolean;
+        label: string;
+        status: string;
+        progress: number;
+        error: string | null;
+        finished: boolean;
+    };
+    closeAsync: () => void;
+};
+export type ActionRunner = ReturnType<typeof useActionRunner>;

package/dist/composables/useActionRunner.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/composables/useConfirm.d.ts

@@ -0,0 +1,31 @@
+export interface ConfirmOptions {
+    message: string;
+    title?: string;
+    confirmLabel?: string;
+    cancelLabel?: string;
+    /** Paints the confirm button as dangerous. */
+    destructive?: boolean;
+}
+export interface ConfirmState {
+    open: boolean;
+    title: string;
+    message: string;
+    confirmLabel: string;
+    cancelLabel: string;
+    destructive: boolean;
+}
+export declare const confirmState: {
+    open: boolean;
+    title: string;
+    message: string;
+    confirmLabel: string;
+    cancelLabel: string;
+    destructive: boolean;
+};
+/** Asks a question; resolves to true when the user agreed. */
+export declare function confirmDialog(opts: ConfirmOptions | string): Promise<boolean>;
+/** Answers the open question (the dialog's buttons, its cross, Escape). */
+export declare function resolveConfirmDialog(ok: boolean): void;
+export declare function useConfirm(): {
+    confirm: typeof confirmDialog;
+};

package/dist/composables/useConfirm.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/formState-DVU2igtT.js

@@ -0,0 +1,76 @@
+import { reactive as u, provide as d, inject as y } from "vue";
+const f = /* @__PURE__ */ Symbol("admin.form-state");
+function E(e = {}, i = {}, c) {
+  const n = u(e), s = u({ ...i }), l = {
+    state: n,
+    errors: s,
+    mode: c,
+    setField(o, r) {
+      n[o] = r, s[o] && delete s[o];
+    },
+    getField(o) {
+      return n[o];
+    },
+    setError(o, r) {
+      r === null || r.length === 0 ? delete s[o] : s[o] = r;
+    },
+    setErrors(o) {
+      for (const r of Object.keys(s)) delete s[r];
+      Object.assign(s, o);
+    },
+    clearErrors() {
+      for (const o of Object.keys(s)) delete s[o];
+    }
+  };
+  return d(f, l), l;
+}
+function a() {
+  const e = y(f);
+  if (!e)
+    throw new Error("useFormState() called outside of provideFormState() scope");
+  return e;
+}
+function b() {
+  return y(f, null);
+}
+function m(e, i) {
+  const c = `${i}.`, n = () => {
+    const r = e.getField(i);
+    return r !== null && typeof r == "object" && !Array.isArray(r) ? r : {};
+  }, s = () => Object.keys(e.errors).filter((r) => r.startsWith(c)).map((r) => r.slice(c.length)), l = new Proxy({}, {
+    get: (r, t) => typeof t == "string" ? e.errors[c + t] : void 0,
+    has: (r, t) => typeof t == "string" && c + t in e.errors,
+    ownKeys: () => s(),
+    getOwnPropertyDescriptor: (r, t) => typeof t == "string" && c + t in e.errors ? { enumerable: !0, configurable: !0, value: e.errors[c + t] } : void 0
+  }), o = {
+    get state() {
+      return n();
+    },
+    errors: l,
+    mode: e.mode,
+    setField(r, t) {
+      e.setField(i, { ...n(), [r]: t }), e.setError(c + r, null);
+    },
+    getField(r) {
+      return n()[r];
+    },
+    setError(r, t) {
+      e.setError(c + r, t);
+    },
+    setErrors(r) {
+      for (const t of s()) e.setError(c + t, null);
+      for (const [t, F] of Object.entries(r)) e.setError(c + t, F);
+    },
+    clearErrors() {
+      for (const r of s()) e.setError(c + r, null);
+    }
+  };
+  return d(f, o), o;
+}
+export {
+  m as a,
+  E as p,
+  b as t,
+  a as u
+};
+//# sourceMappingURL=formState-DVU2igtT.js.map

package/dist/formState-DVU2igtT.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formState-DVU2igtT.js","sources":["../resources/ts/components/render/formState.ts"],"sourcesContent":["/**\n * The form-state composable: it exposes the state and the errors through\n * provide/inject.\n *\n * The container — a resource form, a settings page — calls\n * `provideFormState()`, and the field components in the tree call\n * `useFormState()` to read a value and change a field.\n *\n * The state is a reactive proxy that setField mutates by key; the errors are a\n * separate reactive map of field name → string[] messages.\n */\n\nimport { inject, provide, reactive, type InjectionKey } from 'vue'\n\nexport interface FormStateContext {\n  state: Record<string, unknown>\n  errors: Record<string, string[]>\n  /** The form's context: FieldRenderer hides the fields with visibility[mode]=false. */\n  mode?: 'create' | 'update' | 'view'\n  setField: (name: string, value: unknown) => void\n  getField: (name: string) => unknown\n  setError: (name: string, messages: string[] | null) => void\n  setErrors: (next: Record<string, string[]>) => void\n  clearErrors: () => void\n}\n\nconst FormStateKey: InjectionKey<FormStateContext> = Symbol('admin.form-state')\n\n/**\n * Creates the form context and provides it to the descendants.\n *\n * The `initial` object given is wrapped into `reactive()`, so the mutations are\n * visible from outside too: the caller owns the state and may read it after a\n * submit.\n *\n * @param initial The state's initial values.\n * @param initialErrors The initial errors, for a re-render after a\n *                      ValidationError.\n */\nexport function provideFormState(\n  initial: Record<string, unknown> = {},\n  initialErrors: Record<string, string[]> = {},\n  mode?: 'create' | 'update' | 'view',\n): FormStateContext {\n  const state = reactive(initial)\n  const errors = reactive<Record<string, string[]>>({ ...initialErrors })\n\n  const ctx: FormStateContext = {\n    state,\n    errors,\n    mode,\n    setField(name, value) {\n      ;(state as Record<string, unknown>)[name] = value\n      // Clear that field's errors as it changes, as one expects.\n      if (errors[name]) {\n        delete errors[name]\n      }\n    },\n    getField(name) {\n      return (state as Record<string, unknown>)[name]\n    },\n    setError(name, messages) {\n      if (messages === null || messages.length === 0) {\n        delete errors[name]\n      } else {\n        errors[name] = messages\n      }\n    },\n    setErrors(next) {\n      for (const key of Object.keys(errors)) delete errors[key]\n      Object.assign(errors, next)\n    },\n    clearErrors() {\n      for (const key of Object.keys(errors)) delete errors[key]\n    },\n  }\n\n  provide(FormStateKey, ctx)\n  return ctx\n}\n\n/**\n * Returns the form context. It throws when called outside a\n * `provideFormState()`.\n */\nexport function useFormState(): FormStateContext {\n  const ctx = inject(FormStateKey)\n  if (!ctx) {\n    throw new Error('useFormState() called outside of provideFormState() scope')\n  }\n  return ctx\n}\n\n/** The optional form: null when there is none. */\nexport function tryUseFormState(): FormStateContext | null {\n  return inject(FormStateKey, null)\n}\n\n/**\n * Provides a form context scoped to one object-valued field of `parent` — the\n * backend's Field\\Group, whose state is `{city: ..., street: ...}` under its\n * own name.\n *\n * Unlike NestedFieldsGroup this keeps no copy: every read and write goes to\n * `parent.state[name]`, and the errors are the parent's `name.child` keys —\n * the shape Laravel's validator reports them in — seen without the prefix.\n * Scopes nest: a group inside a group prefixes twice.\n */\nexport function provideScopedFormState(parent: FormStateContext, name: string): FormStateContext {\n  const prefix = `${name}.`\n  const obj = (): Record<string, unknown> => {\n    const v = parent.getField(name)\n    return v !== null && typeof v === 'object' && !Array.isArray(v) ? (v as Record<string, unknown>) : {}\n  }\n  const ownKeys = (): string[] =>\n    Object.keys(parent.errors)\n      .filter((k) => k.startsWith(prefix))\n      .map((k) => k.slice(prefix.length))\n\n  // A live view over the parent's errors: reads go through the parent's\n  // reactive map, so a component reading `errors.city` re-renders when\n  // `errors['address.city']` changes.\n  const errors = new Proxy({} as Record<string, string[]>, {\n    get: (_t, key) => (typeof key === 'string' ? parent.errors[prefix + key] : undefined),\n    has: (_t, key) => typeof key === 'string' && prefix + key in parent.errors,\n    ownKeys: () => ownKeys(),\n    getOwnPropertyDescriptor: (_t, key) =>\n      typeof key === 'string' && prefix + key in parent.errors\n        ? { enumerable: true, configurable: true, value: parent.errors[prefix + key] }\n        : undefined,\n  })\n\n  const ctx: FormStateContext = {\n    get state() {\n      return obj()\n    },\n    errors,\n    mode: parent.mode,\n    setField(key, value) {\n      parent.setField(name, { ...obj(), [key]: value })\n      parent.setError(prefix + key, null)\n    },\n    getField(key) {\n      return obj()[key]\n    },\n    setError(key, messages) {\n      parent.setError(prefix + key, messages)\n    },\n    setErrors(next) {\n      for (const key of ownKeys()) parent.setError(prefix + key, null)\n      for (const [key, messages] of Object.entries(next)) parent.setError(prefix + key, messages)\n    },\n    clearErrors() {\n      for (const key of ownKeys()) parent.setError(prefix + key, null)\n    },\n  }\n\n  provide(FormStateKey, ctx)\n  return ctx\n}\n"],"names":["FormStateKey","provideFormState","initial","initialErrors","mode","state","reactive","errors","ctx","name","value","messages","next","key","provide","useFormState","inject","tryUseFormState","provideScopedFormState","parent","prefix","obj","v","ownKeys","k","_t"],"mappings":"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"}

package/dist/formState-DqHe1Jgd.cjs

@@ -0,0 +1,2 @@
+"use strict";const n=require("vue"),d=Symbol("admin.form-state");function y(e={},l={},c){const i=n.reactive(e),s=n.reactive({...l}),u={state:i,errors:s,mode:c,setField(o,r){i[o]=r,s[o]&&delete s[o]},getField(o){return i[o]},setError(o,r){r===null||r.length===0?delete s[o]:s[o]=r},setErrors(o){for(const r of Object.keys(s))delete s[r];Object.assign(s,o)},clearErrors(){for(const o of Object.keys(s))delete s[o]}};return n.provide(d,u),u}function F(){const e=n.inject(d);if(!e)throw new Error("useFormState() called outside of provideFormState() scope");return e}function v(){return n.inject(d,null)}function S(e,l){const c=`${l}.`,i=()=>{const r=e.getField(l);return r!==null&&typeof r=="object"&&!Array.isArray(r)?r:{}},s=()=>Object.keys(e.errors).filter(r=>r.startsWith(c)).map(r=>r.slice(c.length)),u=new Proxy({},{get:(r,t)=>typeof t=="string"?e.errors[c+t]:void 0,has:(r,t)=>typeof t=="string"&&c+t in e.errors,ownKeys:()=>s(),getOwnPropertyDescriptor:(r,t)=>typeof t=="string"&&c+t in e.errors?{enumerable:!0,configurable:!0,value:e.errors[c+t]}:void 0}),o={get state(){return i()},errors:u,mode:e.mode,setField(r,t){e.setField(l,{...i(),[r]:t}),e.setError(c+r,null)},getField(r){return i()[r]},setError(r,t){e.setError(c+r,t)},setErrors(r){for(const t of s())e.setError(c+t,null);for(const[t,f]of Object.entries(r))e.setError(c+t,f)},clearErrors(){for(const r of s())e.setError(c+r,null)}};return n.provide(d,o),o}exports.provideFormState=y;exports.provideScopedFormState=S;exports.tryUseFormState=v;exports.useFormState=F;
+//# sourceMappingURL=formState-DqHe1Jgd.cjs.map

package/dist/formState-DqHe1Jgd.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"formState-DqHe1Jgd.cjs","sources":["../resources/ts/components/render/formState.ts"],"sourcesContent":["/**\n * The form-state composable: it exposes the state and the errors through\n * provide/inject.\n *\n * The container — a resource form, a settings page — calls\n * `provideFormState()`, and the field components in the tree call\n * `useFormState()` to read a value and change a field.\n *\n * The state is a reactive proxy that setField mutates by key; the errors are a\n * separate reactive map of field name → string[] messages.\n */\n\nimport { inject, provide, reactive, type InjectionKey } from 'vue'\n\nexport interface FormStateContext {\n  state: Record<string, unknown>\n  errors: Record<string, string[]>\n  /** The form's context: FieldRenderer hides the fields with visibility[mode]=false. */\n  mode?: 'create' | 'update' | 'view'\n  setField: (name: string, value: unknown) => void\n  getField: (name: string) => unknown\n  setError: (name: string, messages: string[] | null) => void\n  setErrors: (next: Record<string, string[]>) => void\n  clearErrors: () => void\n}\n\nconst FormStateKey: InjectionKey<FormStateContext> = Symbol('admin.form-state')\n\n/**\n * Creates the form context and provides it to the descendants.\n *\n * The `initial` object given is wrapped into `reactive()`, so the mutations are\n * visible from outside too: the caller owns the state and may read it after a\n * submit.\n *\n * @param initial The state's initial values.\n * @param initialErrors The initial errors, for a re-render after a\n *                      ValidationError.\n */\nexport function provideFormState(\n  initial: Record<string, unknown> = {},\n  initialErrors: Record<string, string[]> = {},\n  mode?: 'create' | 'update' | 'view',\n): FormStateContext {\n  const state = reactive(initial)\n  const errors = reactive<Record<string, string[]>>({ ...initialErrors })\n\n  const ctx: FormStateContext = {\n    state,\n    errors,\n    mode,\n    setField(name, value) {\n      ;(state as Record<string, unknown>)[name] = value\n      // Clear that field's errors as it changes, as one expects.\n      if (errors[name]) {\n        delete errors[name]\n      }\n    },\n    getField(name) {\n      return (state as Record<string, unknown>)[name]\n    },\n    setError(name, messages) {\n      if (messages === null || messages.length === 0) {\n        delete errors[name]\n      } else {\n        errors[name] = messages\n      }\n    },\n    setErrors(next) {\n      for (const key of Object.keys(errors)) delete errors[key]\n      Object.assign(errors, next)\n    },\n    clearErrors() {\n      for (const key of Object.keys(errors)) delete errors[key]\n    },\n  }\n\n  provide(FormStateKey, ctx)\n  return ctx\n}\n\n/**\n * Returns the form context. It throws when called outside a\n * `provideFormState()`.\n */\nexport function useFormState(): FormStateContext {\n  const ctx = inject(FormStateKey)\n  if (!ctx) {\n    throw new Error('useFormState() called outside of provideFormState() scope')\n  }\n  return ctx\n}\n\n/** The optional form: null when there is none. */\nexport function tryUseFormState(): FormStateContext | null {\n  return inject(FormStateKey, null)\n}\n\n/**\n * Provides a form context scoped to one object-valued field of `parent` — the\n * backend's Field\\Group, whose state is `{city: ..., street: ...}` under its\n * own name.\n *\n * Unlike NestedFieldsGroup this keeps no copy: every read and write goes to\n * `parent.state[name]`, and the errors are the parent's `name.child` keys —\n * the shape Laravel's validator reports them in — seen without the prefix.\n * Scopes nest: a group inside a group prefixes twice.\n */\nexport function provideScopedFormState(parent: FormStateContext, name: string): FormStateContext {\n  const prefix = `${name}.`\n  const obj = (): Record<string, unknown> => {\n    const v = parent.getField(name)\n    return v !== null && typeof v === 'object' && !Array.isArray(v) ? (v as Record<string, unknown>) : {}\n  }\n  const ownKeys = (): string[] =>\n    Object.keys(parent.errors)\n      .filter((k) => k.startsWith(prefix))\n      .map((k) => k.slice(prefix.length))\n\n  // A live view over the parent's errors: reads go through the parent's\n  // reactive map, so a component reading `errors.city` re-renders when\n  // `errors['address.city']` changes.\n  const errors = new Proxy({} as Record<string, string[]>, {\n    get: (_t, key) => (typeof key === 'string' ? parent.errors[prefix + key] : undefined),\n    has: (_t, key) => typeof key === 'string' && prefix + key in parent.errors,\n    ownKeys: () => ownKeys(),\n    getOwnPropertyDescriptor: (_t, key) =>\n      typeof key === 'string' && prefix + key in parent.errors\n        ? { enumerable: true, configurable: true, value: parent.errors[prefix + key] }\n        : undefined,\n  })\n\n  const ctx: FormStateContext = {\n    get state() {\n      return obj()\n    },\n    errors,\n    mode: parent.mode,\n    setField(key, value) {\n      parent.setField(name, { ...obj(), [key]: value })\n      parent.setError(prefix + key, null)\n    },\n    getField(key) {\n      return obj()[key]\n    },\n    setError(key, messages) {\n      parent.setError(prefix + key, messages)\n    },\n    setErrors(next) {\n      for (const key of ownKeys()) parent.setError(prefix + key, null)\n      for (const [key, messages] of Object.entries(next)) parent.setError(prefix + key, messages)\n    },\n    clearErrors() {\n      for (const key of ownKeys()) parent.setError(prefix + key, null)\n    },\n  }\n\n  provide(FormStateKey, ctx)\n  return ctx\n}\n"],"names":["FormStateKey","provideFormState","initial","initialErrors","mode","state","reactive","errors","ctx","name","value","messages","next","key","provide","useFormState","inject","tryUseFormState","provideScopedFormState","parent","prefix","obj","v","ownKeys","k","_t"],"mappings":"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"}