@shamar/core 0.1.0

package/dist/permissions.js

@@ -0,0 +1,152 @@
+import { POLICY_ABILITIES } from './policy-types.js';
+/** Build a permission key, e.g. `products:create`. */
+export function permissionKey(resource, ability) {
+    return `${resource}:${ability}`;
+}
+/**
+ * Check a full permission name (`companies:viewAny`, `companies:*`, `*`).
+ * Wildcards: `*`, `{resource}:*`, `*:{ability}`.
+ */
+export function can(user, permission) {
+    if (!user)
+        return false;
+    const permissions = user.permissions ?? [];
+    if (permissions.includes('*') || permissions.includes(permission)) {
+        return true;
+    }
+    const [resource, ability] = permission.split(':');
+    if (!resource || !ability)
+        return false;
+    if (permissions.includes(`${resource}:*`))
+        return true;
+    if (ability !== '*' && permissions.includes(`*:${ability}`))
+        return true;
+    return false;
+}
+export function isAdmin(user) {
+    if (!user)
+        return false;
+    if (can(user, '*'))
+        return true;
+    return Boolean(user.roleIds?.includes('admin') || user.roles?.includes('admin'));
+}
+export function userHasPermission(user, slug, ability) {
+    if (!user)
+        return false;
+    return (can(user, '*') ||
+        can(user, `${slug}:*`) ||
+        can(user, `${slug}:${ability}`) ||
+        can(user, `*:${ability}`));
+}
+/** True if the user has any of the named permissions (wildcard-aware). */
+export function canAny(user, permissions) {
+    return permissions.some((entry) => can(user, entry));
+}
+export function hasExplicitPermissions(permissions) {
+    return Array.isArray(permissions) && permissions.length > 0;
+}
+/** Wildcard grant covers a more specific permission candidate. */
+export function covers(wildcard, candidate) {
+    if (!wildcard || !candidate || wildcard === candidate)
+        return false;
+    if (wildcard === '*')
+        return true;
+    if (wildcard.endsWith(':*')) {
+        const prefix = wildcard.slice(0, -1);
+        return candidate.startsWith(prefix);
+    }
+    if (wildcard.startsWith('*:')) {
+        const suffix = wildcard.slice(2);
+        return candidate.endsWith(`:${suffix}`);
+    }
+    return false;
+}
+/**
+ * Whether a granted permission covers a required ability.
+ */
+export function matchesPermission(granted, required) {
+    const grants = [...granted];
+    if (grants.length === 0)
+        return false;
+    if (grants.includes('*'))
+        return true;
+    if (grants.includes(required))
+        return true;
+    for (const grant of grants) {
+        if (covers(grant, required))
+            return true;
+    }
+    return false;
+}
+/**
+ * Normalize resource `permissions()` entries into full `{slug}:{ability}` names.
+ */
+export function normalizeCustomPermissions(slug, entries) {
+    const out = [];
+    for (const entry of entries) {
+        const raw = typeof entry === 'string' ? entry : entry.name;
+        const label = typeof entry === 'string' ? undefined : entry.label;
+        if (!raw?.trim())
+            continue;
+        const name = raw === '*' || raw.includes(':') ? raw.trim() : `${slug}:${raw.trim()}`;
+        out.push(label ? { name, label } : { name });
+    }
+    return out;
+}
+function humanizePolicyAbility(ability) {
+    if (ability === '*')
+        return 'All';
+    if (ability === 'viewAny')
+        return 'View any';
+    if (ability === 'view')
+        return 'View';
+    if (ability === 'create')
+        return 'Create';
+    if (ability === 'edit')
+        return 'Update';
+    if (ability === 'delete')
+        return 'Delete';
+    return ability.charAt(0).toUpperCase() + ability.slice(1);
+}
+/**
+ * Build the full permission catalog from registered resources.
+ * Upsert these rows on app boot — never create permissions manually in admin.
+ */
+export function buildPermissionCatalog(registry) {
+    const entries = [
+        {
+            name: '*',
+            resource: '*',
+            ability: '*',
+            label: 'Superuser (all)',
+        },
+    ];
+    for (const meta of registry.all()) {
+        for (const ability of POLICY_ABILITIES) {
+            const name = permissionKey(meta.slug, ability);
+            entries.push({
+                name,
+                resource: meta.slug,
+                ability,
+                label: `${meta.label} — ${humanizePolicyAbility(ability)}`,
+            });
+        }
+        entries.push({
+            name: permissionKey(meta.slug, '*'),
+            resource: meta.slug,
+            ability: '*',
+            label: `${meta.label} — All`,
+        });
+        for (const custom of meta.customPermissions ?? []) {
+            const colon = custom.name.indexOf(':');
+            entries.push({
+                name: custom.name,
+                resource: colon > 0 ? custom.name.slice(0, colon) : meta.slug,
+                ability: colon > 0 ? custom.name.slice(colon + 1) : custom.name,
+                label: custom.label ?? custom.name,
+            });
+        }
+    }
+    return entries;
+}
+//# sourceMappingURL=permissions.js.map

package/dist/permissions.js.map

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

package/dist/policy-types.d.ts

@@ -0,0 +1,23 @@
+import type { ShamarUser } from './types.js';
+/** Loom / Filament policy abilities. */
+export type PolicyAbility = 'viewAny' | 'view' | 'create' | 'edit' | 'delete';
+/** Equality filters applied to list queries (record-level scoping). */
+export interface QueryScope {
+    equals?: Record<string, unknown>;
+}
+/**
+ * Policy class contract — Loom-style static methods.
+ * Assign to `Resource.policy` or register in `auth.policies`.
+ */
+export type PolicyClass = {
+    new (...args: unknown[]): unknown;
+    ownerField?: string;
+    viewAny?(user: ShamarUser, slug?: string): boolean;
+    view?(user: ShamarUser, record: Record<string, unknown>, slug?: string): boolean;
+    create?(user: ShamarUser, slug?: string): boolean;
+    edit?(user: ShamarUser, record: Record<string, unknown>, slug?: string): boolean;
+    delete?(user: ShamarUser, record: Record<string, unknown>, slug?: string): boolean;
+    scopeList?(user: ShamarUser, slug?: string): QueryScope | undefined;
+};
+export declare const POLICY_ABILITIES: PolicyAbility[];
+//# sourceMappingURL=policy-types.d.ts.map

package/dist/policy-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy-types.d.ts","sourceRoot":"","sources":["../src/policy-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,wCAAwC;AACxC,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE9E,uEAAuE;AACvE,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACnD,IAAI,CAAC,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACjF,MAAM,CAAC,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAClD,IAAI,CAAC,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACjF,MAAM,CAAC,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACnF,SAAS,CAAC,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;CACrE,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,aAAa,EAM3C,CAAC"}

package/dist/policy-types.js

@@ -0,0 +1,8 @@
+export const POLICY_ABILITIES = [
+    'viewAny',
+    'view',
+    'create',
+    'edit',
+    'delete',
+];
+//# sourceMappingURL=policy-types.js.map

package/dist/policy-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy-types.js","sourceRoot":"","sources":["../src/policy-types.ts"],"names":[],"mappings":"AAyBA,MAAM,CAAC,MAAM,gBAAgB,GAAoB;IAC/C,SAAS;IACT,MAAM;IACN,QAAQ;IACR,MAAM;IACN,QAAQ;CACT,CAAC"}

package/dist/reactivity.d.ts

@@ -0,0 +1,23 @@
+import type { FieldContext, FormOperation } from './types.js';
+export declare function createFieldContext(options: {
+    state: Record<string, unknown>;
+    record?: Record<string, unknown> | null;
+    operation: FormOperation;
+    changed?: string;
+}): FieldContext;
+/** Snapshot of mutable state after Get/Set mutations. */
+export declare function readContextState(ctx: FieldContext): Record<string, unknown>;
+export declare function evaluateAfterStateUpdated(field: {
+    name: string;
+    afterStateUpdated?: (ctx: FieldContext) => void | Promise<void>;
+}, options: {
+    state: Record<string, unknown>;
+    record?: Record<string, unknown> | null;
+    operation: FormOperation;
+}): Promise<Record<string, unknown>>;
+export declare function resolveClosure<T>(value: T | ((ctx: FieldContext) => T) | undefined, ctx: FieldContext, fallback?: T): T | undefined;
+export declare function resolveGridItemStyle(item: {
+    columnSpan?: number | 'full';
+    columnStart?: number;
+}, sectionColumns?: number): string;
+//# sourceMappingURL=reactivity.d.ts.map

package/dist/reactivity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactivity.d.ts","sourceRoot":"","sources":["../src/reactivity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE9D,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxC,SAAS,EAAE,aAAa,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,YAAY,CAgBf;AAED,yDAAyD;AACzD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAO3E;AAED,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE;IACL,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjE,EACD,OAAO,EAAE;IACP,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxC,SAAS,EAAE,aAAa,CAAC;CAC1B,GACA,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAqBlC;AAED,wBAAgB,cAAc,CAAC,CAAC,EAC9B,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,YAAY,KAAK,CAAC,CAAC,GAAG,SAAS,EACjD,GAAG,EAAE,YAAY,EACjB,QAAQ,CAAC,EAAE,CAAC,GACX,CAAC,GAAG,SAAS,CAMf;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,EAC5D,cAAc,SAAI,GACjB,MAAM,CAYR"}

package/dist/reactivity.js

@@ -0,0 +1,68 @@
+export function createFieldContext(options) {
+    const state = { ...options.state };
+    return {
+        get state() {
+            return options.changed != null ? state[options.changed] : state;
+        },
+        record: options.record ?? null,
+        operation: options.operation,
+        get(name) {
+            return state[name];
+        },
+        set(name, value) {
+            state[name] = value;
+        },
+    };
+}
+/** Snapshot of mutable state after Get/Set mutations. */
+export function readContextState(ctx) {
+    // FieldContext.set mutates the closed-over object; re-read via known keys by
+    // wrapping set/get — callers should prefer evaluateAfterStateUpdated return.
+    const out = {};
+    // No enumerable store on ctx; evaluate hooks return patched state explicitly.
+    void out;
+    return out;
+}
+export async function evaluateAfterStateUpdated(field, options) {
+    const state = { ...options.state };
+    const ctx = {
+        get state() {
+            return state[field.name];
+        },
+        record: options.record ?? null,
+        operation: options.operation,
+        get(name) {
+            return state[name];
+        },
+        set(name, value) {
+            state[name] = value;
+        },
+    };
+    if (field.afterStateUpdated) {
+        await field.afterStateUpdated(ctx);
+    }
+    return state;
+}
+export function resolveClosure(value, ctx, fallback) {
+    if (value === undefined)
+        return fallback;
+    if (typeof value === 'function') {
+        return value(ctx);
+    }
+    return value;
+}
+export function resolveGridItemStyle(item, sectionColumns = 2) {
+    const parts = [];
+    if (item.columnStart != null) {
+        parts.push(`grid-column-start: ${item.columnStart}`);
+    }
+    if (item.columnSpan === 'full') {
+        parts.push(`grid-column: 1 / -1`);
+    }
+    else if (typeof item.columnSpan === 'number' && item.columnSpan > 1) {
+        const span = Math.min(item.columnSpan, sectionColumns);
+        parts.push(`grid-column: span ${span} / span ${span}`);
+    }
+    return parts.join('; ');
+}
+//# sourceMappingURL=reactivity.js.map

package/dist/reactivity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactivity.js","sourceRoot":"","sources":["../src/reactivity.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,kBAAkB,CAAC,OAKlC;IACC,MAAM,KAAK,GAAG,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAEnC,OAAO;QACL,IAAI,KAAK;YACP,OAAO,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAClE,CAAC;QACD,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;QAC9B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,GAAG,CAAC,IAAY;YACd,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;QACD,GAAG,CAAC,IAAY,EAAE,KAAc;YAC9B,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QACtB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,gBAAgB,CAAC,GAAiB;IAChD,6EAA6E;IAC7E,6EAA6E;IAC7E,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,8EAA8E;IAC9E,KAAK,GAAG,CAAC;IACT,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,KAGC,EACD,OAIC;IAED,MAAM,KAAK,GAAG,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IACnC,MAAM,GAAG,GAAiB;QACxB,IAAI,KAAK;YACP,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;QACD,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;QAC9B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,GAAG,CAAC,IAAY;YACd,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;QACD,GAAG,CAAC,IAAY,EAAE,KAAc;YAC9B,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QACtB,CAAC;KACF,CAAC;IAEF,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;QAC5B,MAAM,KAAK,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,KAAiD,EACjD,GAAiB,EACjB,QAAY;IAEZ,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IACzC,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;QAChC,OAAQ,KAAkC,CAAC,GAAG,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,IAA4D,EAC5D,cAAc,GAAG,CAAC;IAElB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,sBAAsB,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,IAAI,CAAC,UAAU,KAAK,MAAM,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IACpC,CAAC;SAAM,IAAI,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;QACvD,KAAK,CAAC,IAAI,CAAC,qBAAqB,IAAI,WAAW,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/record-value.d.ts

@@ -0,0 +1,31 @@
+import type { RelationConfig, ResourceMeta } from './types.js';
+/**
+ * Read a value from a record using dot notation.
+ * `company.name` → `record.company.name`
+ * `categories.name` → maps `name` across `record.categories[]`
+ */
+export declare function getRecordValue(record: Record<string, unknown>, path: string): unknown;
+/** Singularize a resource slug for path matching (`companies` → `company`). */
+export declare function singularizeResourceSlug(slug: string): string;
+export interface RelationDisplayBinding {
+    /** Full dot path, e.g. `company.name`. */
+    path: string;
+    /** First segment, e.g. `company` — nested key on the hydrated record. */
+    root: string;
+    /** Remaining segments joined, e.g. `name`. */
+    attribute: string;
+    /** Form FK / M2M field on the parent record, e.g. `companyId`. */
+    fieldName: string;
+    relation: RelationConfig;
+}
+/** Collect column/entry names that use dot notation. */
+export declare function collectDisplayPaths(meta: ResourceMeta): string[];
+/**
+ * Map a dot path to a form relationship field on the same resource.
+ * `company.name` → `companyId` BelongsTo `companies`
+ * `categories.name` → `categoryIds` ManyToMany `categories`
+ */
+export declare function resolveRelationDisplayBinding(meta: ResourceMeta, path: string): RelationDisplayBinding | null;
+/** Resolve all display bindings for a resource meta. */
+export declare function resolveRelationDisplayBindings(meta: ResourceMeta): RelationDisplayBinding[];
+//# sourceMappingURL=record-value.d.ts.map

package/dist/record-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-value.d.ts","sourceRoot":"","sources":["../src/record-value.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE5E;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,EAAE,MAAM,GACX,OAAO,CA8BT;AAED,+EAA+E;AAC/E,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAU5D;AAED,MAAM,WAAW,sBAAsB;IACrC,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAED,wDAAwD;AACxD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,EAAE,CAShE;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,MAAM,GACX,sBAAsB,GAAG,IAAI,CAuB/B;AAiBD,wDAAwD;AACxD,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,YAAY,GACjB,sBAAsB,EAAE,CAY1B"}

package/dist/record-value.js

@@ -0,0 +1,118 @@
+/**
+ * Read a value from a record using dot notation.
+ * `company.name` → `record.company.name`
+ * `categories.name` → maps `name` across `record.categories[]`
+ */
+export function getRecordValue(record, path) {
+    if (!path.includes('.')) {
+        return record[path];
+    }
+    const parts = path.split('.').filter(Boolean);
+    if (parts.length === 0)
+        return undefined;
+    let current = record;
+    for (const part of parts) {
+        if (current == null)
+            return undefined;
+        if (Array.isArray(current)) {
+            const mapped = current
+                .map((item) => {
+                if (item == null)
+                    return undefined;
+                if (typeof item === 'object') {
+                    return item[part];
+                }
+                return part === 'value' || part === 'id' ? item : undefined;
+            })
+                .filter((value) => value != null && value !== '');
+            return mapped.length > 0 ? mapped : undefined;
+        }
+        if (typeof current !== 'object')
+            return undefined;
+        current = current[part];
+    }
+    return current;
+}
+/** Singularize a resource slug for path matching (`companies` → `company`). */
+export function singularizeResourceSlug(slug) {
+    const trimmed = slug.trim();
+    if (!trimmed)
+        return trimmed;
+    if (trimmed.endsWith('ies') && trimmed.length > 3) {
+        return `${trimmed.slice(0, -3)}y`;
+    }
+    if (trimmed.endsWith('s') && trimmed.length > 1) {
+        return trimmed.slice(0, -1);
+    }
+    return trimmed;
+}
+/** Collect column/entry names that use dot notation. */
+export function collectDisplayPaths(meta) {
+    const names = new Set();
+    for (const column of meta.columns) {
+        if (column.name.includes('.'))
+            names.add(column.name);
+    }
+    for (const entry of meta.infolist.entries) {
+        if (entry.name.includes('.'))
+            names.add(entry.name);
+    }
+    return [...names];
+}
+/**
+ * Map a dot path to a form relationship field on the same resource.
+ * `company.name` → `companyId` BelongsTo `companies`
+ * `categories.name` → `categoryIds` ManyToMany `categories`
+ */
+export function resolveRelationDisplayBinding(meta, path) {
+    if (!path.includes('.'))
+        return null;
+    const segments = path.split('.').filter(Boolean);
+    if (segments.length < 2)
+        return null;
+    const root = segments[0];
+    const attribute = segments.slice(1).join('.');
+    for (const field of meta.fields) {
+        if (!field.relation)
+            continue;
+        if (!relationPathMatchesField(root, field))
+            continue;
+        return {
+            path,
+            root,
+            attribute,
+            fieldName: field.name,
+            relation: field.relation,
+        };
+    }
+    return null;
+}
+function relationPathMatchesField(root, field) {
+    const relation = field.relation;
+    if (!relation)
+        return false;
+    const resource = relation.resource;
+    const singular = singularizeResourceSlug(resource);
+    const fieldRoot = field.name.replace(/Ids?$/, '');
+    if (root === resource || root === singular)
+        return true;
+    if (root === field.name || root === fieldRoot)
+        return true;
+    if (relation.kind === 'belongsTo' && root === field.name.replace(/Id$/, ''))
+        return true;
+    return false;
+}
+/** Resolve all display bindings for a resource meta. */
+export function resolveRelationDisplayBindings(meta) {
+    const seen = new Set();
+    const bindings = [];
+    for (const path of collectDisplayPaths(meta)) {
+        const binding = resolveRelationDisplayBinding(meta, path);
+        if (!binding || seen.has(binding.path))
+            continue;
+        seen.add(binding.path);
+        bindings.push(binding);
+    }
+    return bindings;
+}
+//# sourceMappingURL=record-value.js.map

package/dist/record-value.js.map

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

package/dist/registry.d.ts

@@ -0,0 +1,16 @@
+import type { ResourceMeta } from './types.js';
+import type { Resource } from './resource.js';
+export declare class ResourceRegistry {
+    private readonly meta;
+    private readonly classes;
+    constructor(resourceClasses: Array<typeof Resource>);
+    all(): ResourceMeta[];
+    get(slug: string): ResourceMeta | undefined;
+    require(slug: string): ResourceMeta;
+    resourceClass(slug: string): typeof Resource | undefined;
+    navigationGroups(): Array<{
+        name: string;
+        items: ResourceMeta[];
+    }>;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmC;IACxD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;gBAElD,eAAe,EAAE,KAAK,CAAC,OAAO,QAAQ,CAAC;IAWnD,GAAG,IAAI,YAAY,EAAE;IAIrB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAI3C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY;IAMnC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,QAAQ,GAAG,SAAS;IAIxD,gBAAgB,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,YAAY,EAAE,CAAA;KAAE,CAAC;CAkBnE"}

package/dist/registry.js

@@ -0,0 +1,49 @@
+export class ResourceRegistry {
+    meta = new Map();
+    classes = new Map();
+    constructor(resourceClasses) {
+        for (const ResourceClass of resourceClasses) {
+            const configured = ResourceClass.configure();
+            if (this.meta.has(configured.slug)) {
+                throw new Error(`Duplicate Shamar resource slug: ${configured.slug}`);
+            }
+            this.meta.set(configured.slug, configured);
+            this.classes.set(configured.slug, ResourceClass);
+        }
+    }
+    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 resource: ${slug}`);
+        return meta;
+    }
+    resourceClass(slug) {
+        return this.classes.get(slug);
+    }
+    navigationGroups() {
+        const groups = new Map();
+        for (const meta of this.all()) {
+            const group = meta.navigationGroup ?? 'General';
+            const items = groups.get(group) ?? [];
+            items.push(meta);
+            groups.set(group, items);
+        }
+        return [...groups.entries()].map(([name, items]) => ({
+            name,
+            items: items.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=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,gBAAgB;IACV,IAAI,GAAG,IAAI,GAAG,EAAwB,CAAC;IACvC,OAAO,GAAG,IAAI,GAAG,EAA2B,CAAC;IAE9D,YAAY,eAAuC;QACjD,KAAK,MAAM,aAAa,IAAI,eAAe,EAAE,CAAC;YAC5C,MAAM,UAAU,GAAG,aAAa,CAAC,SAAS,EAAE,CAAC;YAC7C,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnC,MAAM,IAAI,KAAK,CAAC,mCAAmC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;YACxE,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,aAAa,CAAC,CAAC;QACnD,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,4BAA4B,IAAI,EAAE,CAAC,CAAC;QAC/D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,aAAa,CAAC,IAAY;QACxB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,gBAAgB;QACd,MAAM,MAAM,GAAG,IAAI,GAAG,EAA0B,CAAC;QACjD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe,IAAI,SAAS,CAAC;YAChD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YACtC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;YACnD,IAAI;YACJ,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBACzB,MAAM,KAAK,GAAG,CAAC,CAAC,cAAc,IAAI,MAAM,CAAC,iBAAiB,CAAC;gBAC3D,MAAM,KAAK,GAAG,CAAC,CAAC,cAAc,IAAI,MAAM,CAAC,iBAAiB,CAAC;gBAC3D,IAAI,KAAK,KAAK,KAAK;oBAAE,OAAO,KAAK,GAAG,KAAK,CAAC;gBAC1C,OAAO,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACxC,CAAC,CAAC;SACH,CAAC,CAAC,CAAC;IACN,CAAC;CACF"}

package/dist/relation.d.ts

@@ -0,0 +1,28 @@
+import type { FieldConfig, RelationConfig, RelationKind, RelationWidget } from './types.js';
+export interface RelationshipOptions {
+    kind?: RelationKind;
+    foreignKey?: string;
+    widget?: RelationWidget;
+    createOption?: boolean;
+    createAndEditOption?: boolean;
+    preloadLimit?: number;
+    groupBy?: string;
+    checkboxColumns?: number;
+    checkboxFramed?: boolean;
+    cascadeWildcards?: boolean;
+    /** Dehydrated value attribute (default `id`). Use `name` for ability keys. */
+    valueAttribute?: string;
+}
+/** Default widget for each relation kind. */
+export declare function defaultRelationWidget(kind: RelationKind): RelationWidget;
+/**
+ * Build a normalized {@link RelationConfig} from Filament-style arguments.
+ */
+export declare function buildRelationConfig(resource: string, titleAttribute: string, options?: RelationshipOptions): RelationConfig;
+/**
+ * Apply relationship config onto a field, adjusting type/multiple/dehydrated defaults.
+ */
+export declare function applyRelationship(config: FieldConfig, resource: string, titleAttribute: string, options?: RelationshipOptions): void;
+/** Title attribute used for labels / quick-create. */
+export declare function relationTitleAttribute(relation: RelationConfig): string;
+//# sourceMappingURL=relation.d.ts.map

package/dist/relation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relation.d.ts","sourceRoot":"","sources":["../src/relation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,YAAY,EACZ,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,8EAA8E;IAC9E,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,6CAA6C;AAC7C,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,YAAY,GAAG,cAAc,CAUxE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE,mBAAwB,GAChC,cAAc,CAkBhB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE,mBAAwB,GAChC,IAAI,CA0BN;AAED,sDAAsD;AACtD,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAEvE"}

package/dist/relation.js

@@ -0,0 +1,69 @@
+/** Default widget for each relation kind. */
+export function defaultRelationWidget(kind) {
+    switch (kind) {
+        case 'hasMany':
+            return 'table';
+        case 'manyToMany':
+            return 'combobox';
+        case 'belongsTo':
+        default:
+            return 'combobox';
+    }
+}
+/**
+ * Build a normalized {@link RelationConfig} from Filament-style arguments.
+ */
+export function buildRelationConfig(resource, titleAttribute, options = {}) {
+    const kind = options.kind ?? 'belongsTo';
+    return {
+        kind,
+        resource,
+        labelField: titleAttribute,
+        titleAttribute,
+        foreignKey: options.foreignKey,
+        widget: options.widget ?? defaultRelationWidget(kind),
+        createOption: options.createOption,
+        createAndEditOption: options.createAndEditOption,
+        preloadLimit: options.preloadLimit,
+        groupBy: options.groupBy,
+        checkboxColumns: options.checkboxColumns,
+        checkboxFramed: options.checkboxFramed,
+        cascadeWildcards: options.cascadeWildcards,
+        valueAttribute: options.valueAttribute,
+    };
+}
+/**
+ * Apply relationship config onto a field, adjusting type/multiple/dehydrated defaults.
+ */
+export function applyRelationship(config, resource, titleAttribute, options = {}) {
+    const relation = buildRelationConfig(resource, titleAttribute, options);
+    config.relation = relation;
+    config.searchable = config.searchable ?? true;
+    if (relation.kind === 'manyToMany') {
+        config.multiple = true;
+    }
+    if (relation.kind === 'hasMany') {
+        // Children own the FK; parent field is managed via widgets, not dehydrated.
+        config.dehydrated = false;
+        config.multiple = true;
+    }
+    if (relation.widget === 'radio') {
+        config.type = 'radio';
+    }
+    else if (relation.widget === 'checkboxList') {
+        config.type = 'checkboxList';
+        config.multiple = true;
+    }
+    else if (relation.widget === 'table') {
+        config.type = 'relationTable';
+        config.multiple = true;
+    }
+    else if (config.type !== 'radio' && config.type !== 'checkboxList') {
+        config.type = 'relation';
+    }
+}
+/** Title attribute used for labels / quick-create. */
+export function relationTitleAttribute(relation) {
+    return relation.titleAttribute ?? relation.labelField;
+}
+//# sourceMappingURL=relation.js.map