@dskripchenko/laravel-admin 1.45.1 → 1.46.0

package/dist/components/dashboard/CartesianChartWidget.vue.d.ts

@@ -1,5 +1,5 @@
 import './chart.css';
-import { type ChartSeries } from './chartGeometry';
+import { type ChartValueFormat, type ChartSeries } from './chartGeometry';
 export type CartesianKind = 'line' | 'area' | 'bar';
 interface Props {
     kind?: CartesianKind;
@@ -10,10 +10,13 @@ interface Props {
     stacked?: boolean;
     /** The minimum plot height in px; the chart grows with its cell beyond it. */
     height?: number;
+    /** ChartWidget::money() / precision(): how the values read. */
+    format?: ChartValueFormat | null;
 }
 declare const _default: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
     title: string;
     height: number;
+    format: ChartValueFormat | null;
     description: string;
     kind: CartesianKind;
     stacked: boolean;

package/dist/components/dashboard/ChartWidget.vue.d.ts

@@ -1,4 +1,4 @@
-import { type RawDataset } from './chartGeometry';
+import { type ChartValueFormat, type RawDataset } from './chartGeometry';
 interface ChartData {
     /**
      * The backend's ChartWidget::data() returns `chartType`. The older wrapper
@@ -9,6 +9,8 @@ interface ChartData {
     labels?: Array<string | number>;
     datasets?: RawDataset[];
     stacked?: boolean;
+    /** ChartWidget::money() / precision(); null — plain numbers. */
+    format?: ChartValueFormat | null;
 }
 interface Props {
     type?: string;
@@ -20,6 +22,7 @@ interface Props {
     labels?: Array<string | number>;
     datasets?: RawDataset[];
     stacked?: boolean;
+    format?: ChartValueFormat | 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>;
 export default _default;

package/dist/components/dashboard/DonutChartWidget.vue.d.ts

@@ -1,3 +1,4 @@
+import { type ChartValueFormat } from './chartGeometry';
 interface Slice {
     label: string;
     value: number;
@@ -8,9 +9,12 @@ interface Props {
     data: Slice[];
     /** A doughnut's hole; a pie is drawn without one. */
     hole?: boolean;
+    /** ChartWidget::money() / precision(): how the values read. */
+    format?: ChartValueFormat | null;
 }
 declare const _default: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
     title: string;
+    format: ChartValueFormat | null;
     hole: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 export default _default;

package/dist/components/dashboard/RadarChartWidget.vue.d.ts

@@ -1,15 +1,18 @@
 import './chart.css';
-import { type ChartSeries } from './chartGeometry';
+import { type ChartSeries, type ChartValueFormat } from './chartGeometry';
 interface Props {
     title?: string;
     description?: string;
     labels: string[];
     series: ChartSeries[];
     height?: number;
+    /** ChartWidget::money() / precision(): how the values read. */
+    format?: ChartValueFormat | null;
 }
 declare const _default: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
     title: string;
     height: number;
+    format: ChartValueFormat | null;
     description: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 export default _default;

package/dist/components/dashboard/RecentTableWidget.vue.d.ts

@@ -1,14 +1,22 @@
 import { type UidTableColumn } from '@dskripchenko/ui';
+import type { CellMeta } from '../resource/cellFormat';
 /**
- * The backend's RecentListWidget::data() returns the columns as
- * `[{column, label}]` while UidTable expects `{key, label}`, so they are
- * converted here.
+ * The backend's RecentListWidget::data() sends each column as
+ * TableColumn::toArray() — {name, label, preset, meta, align} — plus the
+ * older `column` key; UidTable expects `{key, label}`, so they are converted
+ * here. The cells are drawn by the AdminTableCell a resource list uses, so
+ * asMoney(), asDate(), asBadge() and asLink() look the same on a dashboard.
+ * A column with no preset still gets its ISO dates formatted (formatCell).
  */
 interface BackendColumn {
     column?: string;
+    name?: string;
     key?: string;
     label: string;
     align?: 'left' | 'center' | 'right';
+    width?: string | null;
+    preset?: string | null;
+    meta?: CellMeta | null;
 }
 interface Props {
     title?: string;

package/dist/components/dashboard/chartGeometry.d.ts

@@ -50,9 +50,21 @@ export interface NiceScale {
  * always inside, so bars and areas grow from a real baseline.
  */
 export declare function niceScale(min: number, max: number, count?: number): NiceScale;
-/** An axis tick: compact (1.2K, 3M), in the panel's locale. */
-export declare function formatTick(v: number): string;
-/** A value in a tooltip or the data table: full, with grouping, in the panel's locale. */
-export declare function formatValue(v: number | null): string;
+/**
+ * How a chart shows its values (ChartWidget::money() / precision()): money in
+ * a currency, or a number with fixed decimals. Absent — a plain number.
+ */
+export interface ChartValueFormat {
+    style?: 'currency' | 'decimal' | string;
+    currency?: string;
+    decimals?: number;
+}
+/** An axis tick: compact (1.2K, 3M — $1.2K with money), in the panel's locale. */
+export declare function formatTick(v: number, format?: ChartValueFormat | null): string;
+/**
+ * A value in a tooltip or the data table: full, with grouping, in the panel's
+ * locale — as money when the chart says so.
+ */
+export declare function formatValue(v: number | null, format?: ChartValueFormat | null): string;
 /** A rough text width in px for the axis font — enough to keep labels apart. */
 export declare function estimateTextWidth(text: string, fontPx?: number): number;

package/dist/components/resource/resourceNoun.d.ts

@@ -0,0 +1,68 @@
+/**
+ * The phrases that name a resource's records: page titles, confirmations,
+ * toasts and empty states.
+ *
+ * The manifest's `label` is plural ("Authors") and reads wrong inside a
+ * sentence about one record. `singular_label` (Resource::singularLabel()) is
+ * the name of one record as it reads mid-sentence ("author"), or null when the
+ * resource has none in this locale.
+ *
+ * Every phrase is a Russian source string translated through the JSON
+ * dictionary. A translation may use placeholders its source does not: Russian
+ * would need the noun in the accusative, which a nominative singular cannot
+ * give, so its source says "delete this record", while the English
+ * translation says "Delete this :singular?". Every phrase therefore receives
+ * the whole set:
+ *
+ *   :singular  the record's name, or the translated word "record" without one
+ *   :Singular  the same with a capital letter, for the start of a sentence
+ *   :label     the resource label as the manifest gives it
+ *   :plural    the label lowered for the middle of a sentence
+ */
+import type { ManifestResourceMeta } from '../../stores/manifest';
+type Meta = Pick<ManifestResourceMeta, 'label'> & {
+    singular_label?: string | null;
+};
+/**
+ * Lowers a caption for the middle of a sentence. A word in capitals ("API",
+ * "URL") is an acronym and keeps its case.
+ */
+export declare function nounCase(text: string): string;
+/** The resource's singular in the current locale, or null without one. */
+export declare function singularOf(meta: Meta | null | undefined): string | null;
+/** The placeholder set every phrase receives; see the header. */
+export declare function nounParams(meta: Meta | null | undefined, slug: string): Record<string, string>;
+/** The create page's title: "Create author", or "New record: Authors". */
+export declare function createTitle(meta: Meta | null | undefined, slug: string): string;
+/**
+ * The name of a record without a title: "Author #12", or the older
+ * "Authors: record #12" when the resource has no singular.
+ */
+export declare function recordFallbackTitle(meta: Meta | null | undefined, slug: string, id: string | number): string;
+/**
+ * The edit page's title: "Edit author: Ivan Petrov" (the Russian source names
+ * only the record), "Edit author #12" without a record title.
+ */
+export declare function editTitle(meta: Meta | null | undefined, slug: string, id: string | number, recordTitle: string | null): string;
+/**
+ * The delete confirmation: "Delete author “Ivan Petrov”?" when the record has
+ * a title, "Delete this author?" otherwise.
+ */
+export declare function deleteConfirmText(meta: Meta | null | undefined, slug: string, recordTitle?: string | null): string;
+/** The toast after a create: "Author created." */
+export declare function createdToast(meta: Meta | null | undefined, slug: string): string;
+/** The toast after a delete: "Author deleted." */
+export declare function deletedToast(meta: Meta | null | undefined, slug: string): string;
+/**
+ * The empty state's description: "No authors yet. Create the first author." or,
+ * for who may not create, "No authors yet."
+ */
+export declare function emptyDescription(meta: Meta | null | undefined, slug: string, canCreate: boolean): string;
+/** The create button's tooltip; the same words as the create page's title. */
+export declare function createTooltip(meta: Meta | null | undefined, slug: string): string;
+/**
+ * Picks a record's title from its data: Resource::recordTitle() first, then the
+ * record's own title, name or label.
+ */
+export declare function recordTitleOf(record: Record<string, unknown> | null | undefined): string | null;
+export {};

package/dist/components/resource/resourceNoun.test.d.ts

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