@shamar/adonis 0.1.0

package/dist/shamar/list-headers.js

@@ -0,0 +1,218 @@
+import { getRecordValue, humanizeLabel } from '@shamar/core';
+function isBooleanColumn(column) {
+    return (column.type === 'boolean' ||
+        column.format === 'boolean' ||
+        column.format === 'toggle');
+}
+function findFormField(meta, columnName) {
+    const direct = meta.fields.find((field) => field.name === columnName);
+    if (direct)
+        return direct;
+    if (!columnName.includes('.'))
+        return undefined;
+    const [relName] = columnName.split('.');
+    if (!relName)
+        return undefined;
+    return meta.fields.find((field) => {
+        if (!field.relation || field.relation.kind !== 'belongsTo')
+            return false;
+        if (field.name === `${relName}Id`)
+            return true;
+        const resource = field.relation.resource;
+        // companies → company, users → user
+        const singular = resource.endsWith('ies')
+            ? `${resource.slice(0, -3)}y`
+            : resource.endsWith('s')
+                ? resource.slice(0, -1)
+                : resource;
+        return singular === relName;
+    });
+}
+function selectOptions(field) {
+    if (!Array.isArray(field.options) || field.options.length === 0)
+        return undefined;
+    return field.options.map((opt) => ({
+        label: String(opt.label ?? opt.value),
+        value: opt.value,
+    }));
+}
+/**
+ * Build toolbar headers for Filters / Group menus.
+ * Boolean columns, matching Select fields, and BelongsTo display columns are included by default.
+ */
+export function buildListHeaders(meta) {
+    const headers = [];
+    for (const column of meta.columns) {
+        const label = column.label ?? humanizeLabel(column.name);
+        const field = findFormField(meta, column.name);
+        const explicitFilter = column.filterable === true;
+        const explicitGroup = column.groupable === true;
+        const denyFilter = column.filterable === false;
+        const denyGroup = column.groupable === false;
+        let filter_kind;
+        let group_kind;
+        let filterField = column.name;
+        let options;
+        if (isBooleanColumn(column) && !denyFilter) {
+            filter_kind = 'boolean';
+            if (!denyGroup)
+                group_kind = 'boolean';
+        }
+        else if (field?.type === 'select' && field.options?.length && !denyFilter) {
+            filter_kind = 'select';
+            options = selectOptions(field);
+            if (!denyGroup)
+                group_kind = 'select';
+        }
+        else if (field?.relation?.kind === 'belongsTo' && !denyFilter) {
+            filter_kind = 'm2o';
+            filterField = field.name;
+            if (!denyGroup)
+                group_kind = 'm2o';
+        }
+        else if (explicitFilter && field?.type === 'select' && field.options?.length) {
+            filter_kind = 'select';
+            options = selectOptions(field);
+        }
+        else if (explicitFilter && field?.relation?.kind === 'belongsTo') {
+            filter_kind = 'm2o';
+            filterField = field.name;
+        }
+        if (explicitGroup && !group_kind) {
+            if (isBooleanColumn(column))
+                group_kind = 'boolean';
+            else if (field?.type === 'select')
+                group_kind = 'select';
+            else if (field?.relation?.kind === 'belongsTo') {
+                group_kind = 'm2o';
+                filterField = field.name;
+            }
+            else {
+                group_kind = 'select';
+            }
+        }
+        if (!filter_kind && !group_kind && !explicitFilter && !explicitGroup) {
+            continue;
+        }
+        if (explicitFilter && !filter_kind && isBooleanColumn(column)) {
+            filter_kind = 'boolean';
+        }
+        if (!filter_kind && !group_kind)
+            continue;
+        headers.push({
+            name: column.name,
+            label,
+            filter_kind,
+            group_kind,
+            filterField: filterField !== column.name ? filterField : undefined,
+            options,
+        });
+    }
+    return headers;
+}
+export function parseListFilters(raw) {
+    if (raw == null || raw === '')
+        return [];
+    let parsed = raw;
+    if (typeof raw === 'string') {
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch {
+            return [];
+        }
+    }
+    if (!Array.isArray(parsed))
+        return [];
+    const filters = [];
+    for (const entry of parsed) {
+        if (!entry || typeof entry !== 'object')
+            continue;
+        const item = entry;
+        const field = String(item.field ?? '').trim();
+        if (!field)
+            continue;
+        const op = item.op === '!=' || item.op === 'ilike' || item.op === '='
+            ? item.op
+            : '=';
+        filters.push({
+            field,
+            op,
+            value: item.value,
+            label: item.label != null ? String(item.label) : undefined,
+        });
+    }
+    return filters;
+}
+/** Fill missing chip labels for default / URL filters using list headers. */
+export function labelListFilters(filters, headers) {
+    return filters.map((filter) => {
+        if (filter.label)
+            return { ...filter };
+        const header = headers.find((entry) => entry.name === filter.field || entry.filterField === filter.field);
+        const labelBase = header?.label ?? filter.field;
+        let valueLabel = String(filter.value ?? '');
+        if (typeof filter.value === 'boolean') {
+            valueLabel = filter.value ? 'Yes' : 'No';
+        }
+        else if (header?.options?.length) {
+            const match = header.options.find((opt) => String(opt.value) === String(filter.value));
+            if (match)
+                valueLabel = match.label;
+        }
+        return {
+            ...filter,
+            label: `${labelBase}: ${valueLabel}`,
+        };
+    });
+}
+/**
+ * Resolve resource defaultFilters, mapping column names to filter fields when needed.
+ */
+export function resolveDefaultFilters(meta, headers) {
+    const defaults = meta.defaultFilters ?? [];
+    if (!defaults.length)
+        return [];
+    const mapped = defaults.map((filter) => {
+        const header = headers.find((entry) => entry.name === filter.field || entry.filterField === filter.field);
+        return {
+            ...filter,
+            field: header?.filterField || filter.field,
+        };
+    });
+    return labelListFilters(mapped, headers);
+}
+/** Group consecutive records for table rendering (caller should sort by groupBy first). */
+export function groupRecordsForDisplay(items, groupBy, headers) {
+    if (!groupBy || !items.length)
+        return null;
+    const header = headers.find((h) => h.name === groupBy || h.filterField === groupBy);
+    const sections = [];
+    for (const item of items) {
+        const raw = getRecordValue(item, groupBy);
+        const key = raw == null || raw === '' ? '__empty__' : String(raw);
+        let label;
+        if (raw == null || raw === '') {
+            label = 'None';
+        }
+        else if (typeof raw === 'boolean') {
+            label = raw ? 'Yes' : 'No';
+        }
+        else if (header?.options?.length) {
+            const match = header.options.find((opt) => String(opt.value) === String(raw));
+            label = match ? match.label : String(raw);
+        }
+        else {
+            label = String(raw);
+        }
+        const last = sections[sections.length - 1];
+        if (last && last.key === key) {
+            last.items.push(item);
+        }
+        else {
+            sections.push({ key, label, items: [item] });
+        }
+    }
+    return sections;
+}
+//# sourceMappingURL=list-headers.js.map

package/dist/shamar/list-headers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-headers.js","sourceRoot":"","sources":["../../src/shamar/list-headers.ts"],"names":[],"mappings":"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"}

package/dist/shamar/list-query.d.ts

@@ -0,0 +1,229 @@
+import type { ListQuery, PaginatedResult, ResourceMeta } from '@shamar/core';
+export interface ListViewQuery {
+    search?: string;
+    sort?: string;
+    direction?: string;
+    perPage?: number | string;
+    page?: number | string;
+    filters?: string | unknown[];
+    groupBy?: string;
+    trashed?: string | boolean;
+}
+export interface PaginationLink {
+    type: 'page' | 'ellipsis';
+    page?: number;
+    label?: string;
+    active?: boolean;
+    href?: string;
+}
+export interface PaginationContext {
+    page: number;
+    pageCount: number;
+    total: number;
+    formAction: string;
+    prevHref?: string;
+    nextHref?: string;
+    links: PaginationLink[];
+}
+export declare const LIST_ALL_RECORDS_PER_PAGE = 1000;
+/** Max IDs loaded for cyclic prev/next on show/edit (PyVELM-style). */
+export declare const RECORD_NAV_CAP = 5000;
+export interface RecordPager {
+    prevUrl: string;
+    nextUrl: string;
+    index: number;
+    total: number;
+    /** Query string including leading `?`, or empty. */
+    navQuery: string;
+}
+export declare function normalizeListQuery(raw: ListViewQuery, defaults?: {
+    perPage?: number;
+}): ListQuery;
+export declare function buildListQueryString(query?: ListViewQuery, overrides?: ListViewQuery): string;
+export declare function listResourcePath(basePath: string, slug: string, query?: ListViewQuery, overrides?: ListViewQuery): string;
+export declare function buildPaginationContext(basePath: string, slug: string, query: ListViewQuery, result: PaginatedResult): PaginationContext;
+export declare function sortColumnUrl(basePath: string, slug: string, query: ListViewQuery, column: string): string;
+/** List context preserved on show/edit links (search/sort only). */
+export declare function recordNavQuery(query?: ListViewQuery): string;
+export declare function recordPath(basePath: string, slug: string, id: string | number, mode: 'show' | 'edit', navQuery?: string): string;
+/**
+ * Build cyclic prev/next pager for the current ordered ID list.
+ * Returns null when the record is not in the set.
+ */
+export declare function buildRecordPager(options: {
+    basePath: string;
+    slug: string;
+    recordId: string;
+    mode: 'show' | 'edit';
+    ids: string[];
+    navQuery?: string;
+}): RecordPager | null;
+export declare function cellValue(record: Record<string, unknown>, column: {
+    name: string;
+    type?: string;
+    format?: string;
+    currency?: {
+        code: string;
+        locale?: string;
+        precision?: number;
+    };
+}): string;
+export declare function detailValue(record: Record<string, unknown>, field: {
+    name: string;
+    type?: string;
+    format?: string;
+    currency?: {
+        code: string;
+        locale?: string;
+        precision?: number;
+    };
+}): string;
+/** Labels for badge rendering — one entry per array item (tags, multi-select, etc.). */
+export declare function badgeValues(record: Record<string, unknown>, field: {
+    name: string;
+}): string[];
+/** Parse Date, ISO strings, YYYY-MM-DD, epoch ms, and Luxon-like objects. */
+export declare function parseDateValue(value: unknown): Date | null;
+/**
+ * Human-readable date / datetime (locale-aware).
+ * e.g. "Jan 15, 2024" or "Jan 15, 2024, 3:45 PM"
+ */
+export declare function formatDateValue(value: unknown, mode: 'date' | 'datetime'): string | null;
+/**
+ * Normalize stored dates for native `date` / `datetime-local` inputs (local calendar).
+ */
+export declare function toFormDateInputValue(value: unknown, mode: 'date' | 'datetime'): string;
+/** Coerce adapter values into form-control-friendly state. */
+export declare function toFormControlValue(value: unknown, field: {
+    type: string;
+    currency?: {
+        precision?: number;
+    };
+}): unknown;
+/** Parse currency-ish user input into a finite number (or empty string). */
+export declare function parseCurrencyInput(value: unknown): number | '';
+export declare function recordTitle(meta: ResourceMeta, record: Record<string, unknown>): string;
+export declare function formInputType(field: {
+    type: string;
+    revealable?: boolean;
+}): string;
+/**
+ * Extra native attributes for text-like controls (min/max/length/pattern/etc.).
+ * Returned as a raw HTML attribute string for Edge `{{{ fieldInputAttrs(field) }}}`.
+ */
+export declare function fieldInputAttrs(field: {
+    autocomplete?: string;
+    inputMode?: string;
+    minLength?: number;
+    maxLength?: number;
+    minValue?: number | string;
+    maxValue?: number | string;
+    step?: number | string;
+    pattern?: string;
+    accept?: string;
+    datalist?: string[];
+    name?: string;
+    extraInputAttributes?: Record<string, string>;
+}): string;
+export declare function fieldChecked(record: Record<string, unknown> | null, field: {
+    name: string;
+}): boolean;
+export declare function formSections(meta: ResourceMeta): {
+    name: string;
+    title: string;
+    description: string | undefined;
+    kind: "section" | "fieldset" | "plain";
+    icon: string | undefined;
+    card: boolean;
+    columns: 2 | 1 | 3 | 4;
+    collapsible: boolean | undefined;
+    collapsed: boolean | undefined;
+    dense: boolean | undefined;
+    gap: boolean | undefined;
+    extraAttributes: Record<string, string> | undefined;
+    fields: import("@shamar/core").FieldConfig[];
+}[] | {
+    name: string;
+    title: string;
+    kind: "plain";
+    fields: import("@shamar/core").FieldConfig[];
+    columns: 2;
+}[];
+/** Nested schema tree for form rendering (Filament 5). */
+export declare function formSchemaTree(meta: ResourceMeta): import("@shamar/core").SchemaNode[] | {
+    kind: "section" | "fieldset" | "plain";
+    name: string;
+    title: string | undefined;
+    description: string | undefined;
+    icon: string | undefined;
+    card: boolean | undefined;
+    columns: 1 | 2 | 3 | 4;
+    children: {
+        kind: "field";
+        name: string;
+        columnSpan: import("@shamar/core").ColumnSpan | undefined;
+        columnStart: number | undefined;
+        field: import("@shamar/core").FieldConfig;
+    }[];
+}[];
+export declare function detailSections(meta: ResourceMeta): {
+    name: string;
+    title: string;
+    description: string | undefined;
+    kind: "section" | "fieldset" | "plain";
+    icon: string | undefined;
+    card: boolean;
+    columns: 2 | 1 | 3 | 4;
+    collapsible: boolean | undefined;
+    collapsed: boolean | undefined;
+    dense: boolean | undefined;
+    gap: boolean | undefined;
+    extraAttributes: Record<string, string> | undefined;
+    entries: import("@shamar/core").InfolistEntryConfig[];
+    fields: {
+        name: string;
+        type: string;
+        label: string;
+        help: string | undefined;
+        hint: string | undefined;
+        columnSpan: unknown;
+        columnStart: number | undefined;
+        format: string | undefined;
+        url: string | boolean | undefined;
+        copyable: boolean | undefined;
+        icon: string | undefined;
+        falseIcon: string | undefined;
+        currency: {
+            code: string;
+            locale?: string;
+            precision?: number;
+        } | undefined;
+        alignment: string | undefined;
+    }[];
+}[] | {
+    name: string;
+    title: string;
+    kind: "plain";
+    fields: import("@shamar/core").FieldConfig[];
+    columns: 2;
+    entries: never[];
+}[];
+/** Nested schema tree for detail/infolist rendering. */
+export declare function detailSchemaTree(meta: ResourceMeta): import("@shamar/core").SchemaNode[] | {
+    kind: "section" | "fieldset" | "plain";
+    name: string;
+    title: string | undefined;
+    description: string | undefined;
+    icon: string | undefined;
+    card: boolean | undefined;
+    columns: 1 | 2 | 3 | 4;
+    children: {
+        kind: "entry";
+        name: string;
+        columnSpan: import("@shamar/core").ColumnSpan | undefined;
+        columnStart: number | undefined;
+        entry: import("@shamar/core").InfolistEntryConfig;
+    }[];
+}[];
+export { resolveGridItemStyle } from '@shamar/core';
+//# sourceMappingURL=list-query.d.ts.map

package/dist/shamar/list-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-query.d.ts","sourceRoot":"","sources":["../../src/shamar/list-query.ts"],"names":[],"mappings":"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"}