@shamar/core 0.1.6 → 0.2.0

package/dist/page-content.d.ts

@@ -0,0 +1,92 @@
+import { form } from './form.js';
+import { infolist } from './infolist.js';
+import { table } from './table.js';
+import type { FieldConfig, FormSchema, InfolistSchema, ListQuery, ResourceMeta, ResourceModel, TableSchema } from './types.js';
+import type { PageRequestContext, PageSaveResult } from './page.js';
+export type PageSectionKind = 'edge' | 'form' | 'table' | 'infolist';
+export type PageSectionData = Record<string, unknown> | ((ctx: PageRequestContext) => Record<string, unknown> | Promise<Record<string, unknown>>);
+export type PageSectionRecord = Record<string, unknown> | ((ctx: PageRequestContext) => Record<string, unknown> | Promise<Record<string, unknown>>);
+export interface PageSectionMeta {
+    key: string;
+    title?: string;
+    kind: PageSectionKind;
+    /** Edge view name (edge sections). */
+    view?: string;
+    /** Form schema (form sections). */
+    form?: FormSchema;
+    fields?: FieldConfig[];
+    /** Resource-shaped meta for table sections. */
+    listResource?: ResourceMeta;
+    /** Resource-shaped meta for infolist sections. */
+    infolistResource?: ResourceMeta;
+    defaultPerPage?: number;
+}
+export interface PageEdgeSectionHandlers {
+    data?: PageSectionData;
+}
+export interface PageFormSectionHandlers {
+    fill?: (ctx: PageRequestContext) => Record<string, unknown> | Promise<Record<string, unknown>>;
+    save: (data: Record<string, unknown>, ctx: PageRequestContext) => PageSaveResult | void | Promise<PageSaveResult | void>;
+}
+export interface PageTableSectionHandlers {
+    query?: Partial<ListQuery> | ((ctx: PageRequestContext) => Partial<ListQuery> | Promise<Partial<ListQuery>>);
+}
+export interface PageInfolistSectionHandlers {
+    record: PageSectionRecord;
+}
+export interface PageSectionHandlers {
+    edge?: PageEdgeSectionHandlers;
+    form?: PageFormSectionHandlers;
+    table?: PageTableSectionHandlers;
+    infolist?: PageInfolistSectionHandlers;
+}
+export declare class PageSectionDefinition {
+    readonly meta: PageSectionMeta;
+    readonly handlers: PageSectionHandlers;
+    constructor(meta: PageSectionMeta, handlers: PageSectionHandlers);
+}
+export interface PageEdgeSectionOptions {
+    title?: string;
+    view: string;
+    data?: PageSectionData;
+}
+export interface PageFormSectionOptions {
+    title?: string;
+    form: FormSchema | (() => FormSchema);
+    fill?: (ctx: PageRequestContext) => Record<string, unknown> | Promise<Record<string, unknown>>;
+    save: (data: Record<string, unknown>, ctx: PageRequestContext) => PageSaveResult | void | Promise<PageSaveResult | void>;
+}
+export interface PageTableSectionOptions {
+    title?: string;
+    model: ResourceModel;
+    connection?: string;
+    recordTitleField?: string;
+    softDelete?: boolean | {
+        field?: string;
+    };
+    defaultPerPage?: number;
+    /** Resource slug used for row links (defaults to section key). */
+    linkResourceSlug?: string;
+    table: TableSchema | (() => TableSchema);
+    query?: PageTableSectionHandlers['query'];
+}
+export interface PageInfolistSectionOptions {
+    title?: string;
+    infolist: InfolistSchema | (() => InfolistSchema);
+    record: PageSectionRecord;
+}
+export declare class PageContentBuilder {
+    private readonly sections;
+    edge(key: string, options: PageEdgeSectionOptions): this;
+    form(key: string, options: PageFormSectionOptions): this;
+    table(key: string, options: PageTableSectionOptions): this;
+    infolist(key: string, options: PageInfolistSectionOptions): this;
+    build(): PageSectionDefinition[];
+}
+/**
+ * Declarative page sections — forms, tables, infolists, and Edge blocks on one `Page`.
+ */
+export declare function pageContent(fn: (builder: PageContentBuilder) => void): PageSectionDefinition[];
+/** Convenience re-exports for section builders. */
+export { form, table, infolist };
+//# sourceMappingURL=page-content.d.ts.map

package/dist/page-content.d.ts.map

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

package/dist/page-content.js

@@ -0,0 +1,128 @@
+import { form } from './form.js';
+import { infolist } from './infolist.js';
+import { table } from './table.js';
+export class PageSectionDefinition {
+    meta;
+    handlers;
+    constructor(meta, handlers) {
+        this.meta = meta;
+        this.handlers = handlers;
+    }
+}
+function resolveFormSchema(value) {
+    return typeof value === 'function' ? value() : value;
+}
+function resolveTableSchema(value) {
+    return typeof value === 'function' ? value() : value;
+}
+function resolveInfolistSchema(value) {
+    return typeof value === 'function' ? value() : value;
+}
+function buildTableListResource(sectionKey, options, tableSchema) {
+    const searchableFields = tableSchema.columns
+        .filter((column) => column.searchable)
+        .map((column) => column.name);
+    return {
+        slug: options.linkResourceSlug ?? sectionKey,
+        label: options.title ?? sectionKey,
+        singularLabel: options.title ?? sectionKey,
+        model: options.model,
+        connection: options.connection,
+        recordTitleField: options.recordTitleField ?? 'name',
+        fields: [],
+        form: { fields: [], sections: [], schema: [] },
+        columns: tableSchema.columns,
+        infolist: { entries: [], sections: [], schema: [] },
+        hasExplicitInfolist: false,
+        actions: [],
+        searchableFields: [...new Set(searchableFields)],
+        defaultSort: tableSchema.defaultSort,
+        defaultFilters: tableSchema.defaultFilters,
+        defaultGroupBy: tableSchema.defaultGroupBy,
+        softDelete: options.softDelete,
+        defaultPerPage: options.defaultPerPage,
+    };
+}
+function buildInfolistResource(sectionKey, options, schema) {
+    return {
+        slug: sectionKey,
+        label: options.title ?? sectionKey,
+        singularLabel: options.title ?? sectionKey,
+        model: 'PageRecord',
+        recordTitleField: 'id',
+        fields: [],
+        form: { fields: [], sections: [], schema: [] },
+        columns: [],
+        infolist: schema,
+        hasExplicitInfolist: true,
+        actions: [],
+        searchableFields: [],
+    };
+}
+export class PageContentBuilder {
+    sections = [];
+    edge(key, options) {
+        this.sections.push(new PageSectionDefinition({
+            key,
+            title: options.title,
+            kind: 'edge',
+            view: options.view,
+        }, { edge: { data: options.data } }));
+        return this;
+    }
+    form(key, options) {
+        const formSchema = resolveFormSchema(options.form);
+        this.sections.push(new PageSectionDefinition({
+            key,
+            title: options.title,
+            kind: 'form',
+            form: formSchema,
+            fields: formSchema.fields,
+        }, {
+            form: {
+                fill: options.fill,
+                save: options.save,
+            },
+        }));
+        return this;
+    }
+    table(key, options) {
+        const tableSchema = resolveTableSchema(options.table);
+        this.sections.push(new PageSectionDefinition({
+            key,
+            title: options.title,
+            kind: 'table',
+            listResource: buildTableListResource(key, options, tableSchema),
+            defaultPerPage: options.defaultPerPage,
+        }, {
+            table: options.query ? { query: options.query } : undefined,
+        }));
+        return this;
+    }
+    infolist(key, options) {
+        const schema = resolveInfolistSchema(options.infolist);
+        this.sections.push(new PageSectionDefinition({
+            key,
+            title: options.title,
+            kind: 'infolist',
+            infolistResource: buildInfolistResource(key, options, schema),
+        }, {
+            infolist: { record: options.record },
+        }));
+        return this;
+    }
+    build() {
+        return [...this.sections];
+    }
+}
+/**
+ * Declarative page sections — forms, tables, infolists, and Edge blocks on one `Page`.
+ */
+export function pageContent(fn) {
+    const builder = new PageContentBuilder();
+    fn(builder);
+    return builder.build();
+}
+/** Convenience re-exports for section builders. */
+export { form, table, infolist };
+//# sourceMappingURL=page-content.js.map

package/dist/page-content.js.map

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

package/dist/page-registry.d.ts

@@ -0,0 +1,16 @@
+import type { PageMeta } from './page.js';
+import type { Page, PageClass } from './page.js';
+export declare class PageRegistry {
+    private readonly meta;
+    private readonly classes;
+    constructor(pageClasses?: PageClass[]);
+    all(): PageMeta[];
+    get(slug: string): PageMeta | undefined;
+    require(slug: string): PageMeta;
+    pageClass(slug: string): PageClass | undefined;
+    has(slug: string): boolean;
+    /** Pages visible in panel navigation. */
+    navigationItems(): PageMeta[];
+}
+export type { Page };
+//# sourceMappingURL=page-registry.d.ts.map

package/dist/page-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-registry.d.ts","sourceRoot":"","sources":["../src/page-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEjD,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA+B;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;gBAE5C,WAAW,GAAE,SAAS,EAAO;IAWzC,GAAG,IAAI,QAAQ,EAAE;IAIjB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAIvC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;IAM/B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI9C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,yCAAyC;IACzC,eAAe,IAAI,QAAQ,EAAE;CAU9B;AAED,YAAY,EAAE,IAAI,EAAE,CAAC"}

package/dist/page-registry.js

@@ -0,0 +1,45 @@
+export class PageRegistry {
+    meta = new Map();
+    classes = new Map();
+    constructor(pageClasses = []) {
+        for (const PageClass of pageClasses) {
+            const configured = PageClass.configure();
+            if (this.meta.has(configured.slug)) {
+                throw new Error(`Duplicate Shamar page slug: ${configured.slug}`);
+            }
+            this.meta.set(configured.slug, configured);
+            this.classes.set(configured.slug, PageClass);
+        }
+    }
+    all() {
+        return [...this.meta.values()];
+    }
+    get(slug) {
+        return this.meta.get(slug);
+    }
+    require(slug) {
+        const meta = this.get(slug);
+        if (!meta)
+            throw new Error(`Unknown Shamar page: ${slug}`);
+        return meta;
+    }
+    pageClass(slug) {
+        return this.classes.get(slug);
+    }
+    has(slug) {
+        return this.meta.has(slug);
+    }
+    /** Pages visible in panel navigation. */
+    navigationItems() {
+        return this.all()
+            .filter((page) => !page.navigationHidden)
+            .sort((a, b) => {
+            const sortA = a.navigationSort ?? Number.POSITIVE_INFINITY;
+            const sortB = b.navigationSort ?? Number.POSITIVE_INFINITY;
+            if (sortA !== sortB)
+                return sortA - sortB;
+            return a.label.localeCompare(b.label);
+        });
+    }
+}
+//# sourceMappingURL=page-registry.js.map

package/dist/page-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-registry.js","sourceRoot":"","sources":["../src/page-registry.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,YAAY;IACN,IAAI,GAAG,IAAI,GAAG,EAAoB,CAAC;IACnC,OAAO,GAAG,IAAI,GAAG,EAAqB,CAAC;IAExD,YAAY,cAA2B,EAAE;QACvC,KAAK,MAAM,SAAS,IAAI,WAAW,EAAE,CAAC;YACpC,MAAM,UAAU,GAAG,SAAS,CAAC,SAAS,EAAE,CAAC;YACzC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnC,MAAM,IAAI,KAAK,CAAC,+BAA+B,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;YACpE,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YAC3C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,GAAG;QACD,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACjC,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO,CAAC,IAAY;QAClB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,EAAE,CAAC,CAAC;QAC3D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,SAAS,CAAC,IAAY;QACpB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,yCAAyC;IACzC,eAAe;QACb,OAAO,IAAI,CAAC,GAAG,EAAE;aACd,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC;aACxC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACb,MAAM,KAAK,GAAG,CAAC,CAAC,cAAc,IAAI,MAAM,CAAC,iBAAiB,CAAC;YAC3D,MAAM,KAAK,GAAG,CAAC,CAAC,cAAc,IAAI,MAAM,CAAC,iBAAiB,CAAC;YAC3D,IAAI,KAAK,KAAK,KAAK;gBAAE,OAAO,KAAK,GAAG,KAAK,CAAC;YAC1C,OAAO,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;IACP,CAAC;CACF"}

package/dist/page.d.ts

@@ -0,0 +1,132 @@
+import { form } from './form.js';
+import { infolist } from './infolist.js';
+import { table } from './table.js';
+import type { PageSectionDefinition, PageSectionMeta } from './page-content.js';
+import type { ActionConfig, FieldConfig, FormSchema, ResourceMeta, ResourceModel, ShamarUser } from './types.js';
+export type PageKind = 'custom' | 'form' | 'list' | 'composite';
+/** Minimal request context passed into page lifecycle hooks. */
+export interface PageRequestContext {
+    user?: ShamarUser | null;
+    panelId?: string;
+    /** Raw request body / query bag when available. */
+    input?: Record<string, unknown>;
+}
+export interface PageSaveResult {
+    message?: string;
+    /** Redirect path after save (absolute or panel-relative). */
+    redirectTo?: string;
+}
+export interface PageActionResult {
+    message?: string;
+    redirectTo?: string;
+}
+/**
+ * Configured page metadata for routing, nav, and rendering.
+ */
+export interface PageMeta {
+    kind: PageKind;
+    slug: string;
+    label: string;
+    navigationGroup?: string;
+    navigationSubGroup?: string;
+    navigationSort?: number;
+    navigationHidden?: boolean;
+    icon?: string;
+    /** Edge view override (defaults by kind). */
+    view?: string;
+    contentMaxWidth?: string;
+    defaultPerPage?: number;
+    actions: ActionConfig[];
+    /** Form schema when kind is `form`. */
+    form?: FormSchema;
+    fields?: FieldConfig[];
+    /**
+     * Resource-shaped meta for list pages so adapter.list + index UI can be reused.
+     * Only set when kind is `list`.
+     */
+    listResource?: ResourceMeta;
+    /** Declarative sections when kind is `composite`. */
+    sections?: PageSectionMeta[];
+}
+/**
+ * Filament-style panel page — custom view, declarative sections, or header actions.
+ * Use {@link FormPage} or {@link ListPage} for a single form or table shortcut.
+ */
+export declare abstract class Page {
+    static slug: string;
+    static label: string;
+    static navigationGroup?: string;
+    static navigationSubGroup?: string;
+    static navigationSort?: number;
+    static navigationHidden?: boolean;
+    static icon?: string;
+    /** Edge view name (e.g. `pages/welcome`). Defaults to `shamar::page`. */
+    static view?: string;
+    static contentMaxWidth?: string;
+    static canAccess(_user: ShamarUser | null | undefined): boolean;
+    static headerActions(): ActionConfig[];
+    /**
+     * Extra locals for the page view (merged after fill for form pages).
+     */
+    static mount(_ctx: PageRequestContext): Record<string, unknown> | Promise<Record<string, unknown>>;
+    static handleAction(_name: string, _ctx: PageRequestContext): PageActionResult | null | undefined | Promise<PageActionResult | null | undefined>;
+    /**
+     * Declarative sections (forms, tables, infolists, Edge blocks).
+     * When non-empty, the page renders as a composite layout (`shamar::page-sections`).
+     */
+    static content(): PageSectionDefinition[];
+    static configure(): PageMeta;
+}
+/**
+ * Filament-style settings / form page — mount/fill data, save on POST.
+ */
+export declare abstract class FormPage extends Page {
+    static form(): ReturnType<typeof form>;
+    /**
+     * Initial form state. Defaults to `{}`; override to load a singleton / settings row.
+     */
+    static fill(_ctx: PageRequestContext): Record<string, unknown> | Promise<Record<string, unknown>>;
+    /**
+     * Persist form data. Required for useful form pages.
+     */
+    static save(_data: Record<string, unknown>, _ctx: PageRequestContext): PageSaveResult | void | Promise<PageSaveResult | void>;
+    static configure(): PageMeta;
+}
+/**
+ * Canonical singleton settings page for panels (branding, prefs, app config).
+ * Same API as {@link FormPage}; defaults to a `7xl` content column so every
+ * project’s settings screen shares one layout.
+ */
+export declare abstract class SettingsPage extends FormPage {
+    static contentMaxWidth: string;
+    static view: string;
+}
+/**
+ * Standalone list page — reuses Resource table builders + list UI without full CRUD routes.
+ */
+export declare abstract class ListPage extends Page {
+    static model: ResourceModel;
+    static connection?: string;
+    static recordTitleField: string;
+    static softDelete?: boolean | {
+        field?: string;
+    };
+    static defaultPerPage?: number;
+    static table(): ReturnType<typeof table>;
+    /**
+     * Optional show/infolist for row clicks (`GET /:slug/:id`).
+     * Defaults to entries derived from {@link table} columns.
+     */
+    static infolist(): ReturnType<typeof infolist> | undefined;
+    static listActions(): ActionConfig[];
+    static configure(): PageMeta;
+}
+export type PageClass = typeof Page;
+/** True when `value` is FormPage or a subclass (including {@link SettingsPage}). */
+export declare function isFormPage(value: PageClass): value is typeof FormPage;
+/** True when `value` is SettingsPage or a subclass. */
+export declare function isSettingsPage(value: PageClass): value is typeof SettingsPage;
+export declare function isListPage(value: PageClass): value is typeof ListPage;
+/** True when the page declares one or more {@link Page.content} sections. */
+export declare function hasPageSections(value: PageClass): boolean;
+//# sourceMappingURL=page.d.ts.map

package/dist/page.d.ts.map

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

package/dist/page.js

@@ -0,0 +1,222 @@
+import { form } from './form.js';
+import { columnsToInfolistSchema } from './infolist.js';
+import { table } from './table.js';
+/**
+ * Filament-style panel page — custom view, declarative sections, or header actions.
+ * Use {@link FormPage} or {@link ListPage} for a single form or table shortcut.
+ */
+export class Page {
+    static slug = 'page';
+    static label = 'Page';
+    static navigationGroup;
+    static navigationSubGroup;
+    static navigationSort;
+    static navigationHidden;
+    static icon;
+    /** Edge view name (e.g. `pages/welcome`). Defaults to `shamar::page`. */
+    static view;
+    static contentMaxWidth;
+    static canAccess(_user) {
+        return true;
+    }
+    static headerActions() {
+        return [];
+    }
+    /**
+     * Extra locals for the page view (merged after fill for form pages).
+     */
+    static mount(_ctx) {
+        return {};
+    }
+    static handleAction(_name, _ctx) {
+        return null;
+    }
+    /**
+     * Declarative sections (forms, tables, infolists, Edge blocks).
+     * When non-empty, the page renders as a composite layout (`shamar::page-sections`).
+     */
+    static content() {
+        return [];
+    }
+    static configure() {
+        const definitions = this.content();
+        if (definitions.length > 0) {
+            const sections = definitions.map((section) => {
+                const meta = { ...section.meta };
+                if (meta.kind === 'infolist' && meta.infolistResource) {
+                    meta.infolistResource = {
+                        ...meta.infolistResource,
+                        slug: `${this.slug}__${meta.key}`,
+                    };
+                }
+                return meta;
+            });
+            return {
+                kind: 'composite',
+                slug: this.slug,
+                label: this.label,
+                navigationGroup: this.navigationGroup,
+                navigationSubGroup: this.navigationSubGroup,
+                navigationSort: this.navigationSort,
+                navigationHidden: this.navigationHidden,
+                icon: this.icon,
+                view: this.view ?? 'shamar::page-sections',
+                contentMaxWidth: this.contentMaxWidth,
+                actions: this.headerActions(),
+                sections,
+            };
+        }
+        return {
+            kind: 'custom',
+            slug: this.slug,
+            label: this.label,
+            navigationGroup: this.navigationGroup,
+            navigationSubGroup: this.navigationSubGroup,
+            navigationSort: this.navigationSort,
+            navigationHidden: this.navigationHidden,
+            icon: this.icon,
+            view: this.view,
+            contentMaxWidth: this.contentMaxWidth,
+            actions: this.headerActions(),
+        };
+    }
+}
+/**
+ * Filament-style settings / form page — mount/fill data, save on POST.
+ */
+export class FormPage extends Page {
+    static form() {
+        return form(() => undefined);
+    }
+    /**
+     * Initial form state. Defaults to `{}`; override to load a singleton / settings row.
+     */
+    static fill(_ctx) {
+        return {};
+    }
+    /**
+     * Persist form data. Required for useful form pages.
+     */
+    static save(_data, _ctx) {
+        return undefined;
+    }
+    static configure() {
+        const formSchema = this.form();
+        return {
+            ...super.configure(),
+            kind: 'form',
+            form: formSchema,
+            fields: formSchema.fields,
+            view: this.view ?? 'shamar::page-form',
+        };
+    }
+}
+/**
+ * Canonical singleton settings page for panels (branding, prefs, app config).
+ * Same API as {@link FormPage}; defaults to a `7xl` content column so every
+ * project’s settings screen shares one layout.
+ */
+export class SettingsPage extends FormPage {
+    static contentMaxWidth = '7xl';
+    static view = 'shamar::page-form';
+}
+/**
+ * Standalone list page — reuses Resource table builders + list UI without full CRUD routes.
+ */
+export class ListPage extends Page {
+    static model = 'Record';
+    static connection;
+    static recordTitleField = 'name';
+    static softDelete;
+    static defaultPerPage;
+    static table() {
+        return table(() => undefined);
+    }
+    /**
+     * Optional show/infolist for row clicks (`GET /:slug/:id`).
+     * Defaults to entries derived from {@link table} columns.
+     */
+    static infolist() {
+        return undefined;
+    }
+    static listActions() {
+        // Read-only list by default — no create/edit/delete chrome.
+        return [];
+    }
+    static configure() {
+        const tableSchema = this.table();
+        const actionList = this.listActions();
+        const explicitInfolist = this.infolist();
+        const infolistSchema = explicitInfolist ?? columnsToInfolistSchema(tableSchema.columns);
+        const searchableFields = tableSchema.columns
+            .filter((column) => column.searchable)
+            .map((column) => column.name);
+        const listResource = {
+            slug: this.slug,
+            label: this.label,
+            singularLabel: this.label,
+            model: this.model,
+            connection: this.connection,
+            navigationGroup: this.navigationGroup,
+            navigationSubGroup: this.navigationSubGroup,
+            navigationSort: this.navigationSort,
+            recordTitleField: this.recordTitleField,
+            icon: this.icon,
+            fields: [],
+            form: { fields: [], sections: [], schema: [] },
+            columns: tableSchema.columns,
+            infolist: infolistSchema,
+            hasExplicitInfolist: explicitInfolist !== undefined,
+            actions: actionList,
+            searchableFields: [...new Set(searchableFields)],
+            defaultSort: tableSchema.defaultSort,
+            defaultFilters: tableSchema.defaultFilters,
+            defaultGroupBy: tableSchema.defaultGroupBy,
+            softDelete: this.softDelete,
+            contentMaxWidth: this.contentMaxWidth,
+            defaultPerPage: this.defaultPerPage,
+        };
+        return {
+            ...super.configure(),
+            kind: 'list',
+            defaultPerPage: this.defaultPerPage,
+            actions: [...this.headerActions(), ...actionList.filter((a) => a.placement === 'header')],
+            view: this.view ?? 'shamar::page-list',
+            listResource,
+        };
+    }
+}
+/** True when `value` is FormPage or a subclass (including {@link SettingsPage}). */
+export function isFormPage(value) {
+    let current = value;
+    while (typeof current === 'function') {
+        if (current === FormPage || current === SettingsPage)
+            return true;
+        current = Object.getPrototypeOf(current);
+    }
+    return false;
+}
+/** True when `value` is SettingsPage or a subclass. */
+export function isSettingsPage(value) {
+    let current = value;
+    while (typeof current === 'function') {
+        if (current === SettingsPage)
+            return true;
+        current = Object.getPrototypeOf(current);
+    }
+    return false;
+}
+export function isListPage(value) {
+    let current = value;
+    while (typeof current === 'function') {
+        if (current === ListPage)
+            return true;
+        current = Object.getPrototypeOf(current);
+    }
+    return false;
+}
+/** True when the page declares one or more {@link Page.content} sections. */
+export function hasPageSections(value) {
+    return value.content().length > 0;
+}
+//# sourceMappingURL=page.js.map