@shamar/adonis 0.1.0

package/dist/shamar/menu.js

@@ -0,0 +1,93 @@
+const GROUP_ICONS = {
+    Administration: 'cog',
+    General: 'squares-2x2',
+    CRM: 'users',
+    Settings: 'cog',
+};
+function compareNavigationItems(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);
+}
+function firstGroupHref(group, basePath) {
+    const sorted = [...group.items].sort(compareNavigationItems);
+    return `${basePath}/${sorted[0]?.slug ?? ''}`;
+}
+export function menuLayoutContext(groups, basePath, currentSlug, pageTitle, record) {
+    const menuRoots = [
+        {
+            label: 'Dashboard',
+            icon: 'home',
+            href: basePath,
+            rootIndex: 0,
+            active: !currentSlug,
+        },
+        ...groups.map((group, index) => {
+            const href = firstGroupHref(group, basePath);
+            const active = Boolean(currentSlug && group.items.some((item) => item.slug === currentSlug));
+            return {
+                label: group.name,
+                icon: group.icon ?? GROUP_ICONS[group.name] ?? 'squares-2x2',
+                href,
+                rootIndex: index + 1,
+                active,
+            };
+        }),
+    ];
+    const menuActiveRootIndex = currentSlug
+        ? (menuRoots.find((root) => root.active)?.rootIndex ?? null)
+        : 0;
+    const menuActiveRoot = menuActiveRootIndex !== null
+        ? (menuRoots.find((root) => root.rootIndex === menuActiveRootIndex) ?? null)
+        : null;
+    const activeGroup = currentSlug
+        ? groups.find((group) => group.items.some((item) => item.slug === currentSlug))
+        : undefined;
+    const menuSecondary = activeGroup
+        ? activeGroup.items.sort(compareNavigationItems).map((item) => ({
+            label: item.label,
+            href: `${basePath}/${item.slug}`,
+            active: item.slug === currentSlug,
+            icon: item.icon,
+        }))
+        : [];
+    const breadcrumbs = [{ label: 'Home', href: basePath }];
+    if (menuActiveRoot && menuActiveRoot.label !== 'Dashboard') {
+        breadcrumbs.push({ label: menuActiveRoot.label, href: menuActiveRoot.href });
+    }
+    if (currentSlug && activeGroup) {
+        const resource = activeGroup.items.find((item) => item.slug === currentSlug);
+        if (resource) {
+            breadcrumbs.push({ label: resource.label, href: `${basePath}/${resource.slug}` });
+        }
+    }
+    const mode = record?.mode;
+    const recordTitle = record?.recordTitle?.trim();
+    const recordHref = record?.recordHref;
+    if (mode === 'create') {
+        breadcrumbs.push({ label: pageTitle || 'New' });
+    }
+    else if (mode === 'edit' && recordTitle) {
+        breadcrumbs.push({
+            label: recordTitle,
+            href: recordHref,
+        });
+        breadcrumbs.push({ label: 'Edit' });
+    }
+    else if (mode === 'show' && recordTitle) {
+        breadcrumbs.push({ label: recordTitle });
+    }
+    else if (pageTitle && breadcrumbs[breadcrumbs.length - 1]?.label !== pageTitle) {
+        breadcrumbs.push({ label: pageTitle });
+    }
+    return {
+        menuRoots,
+        menuActiveRoot,
+        menuActiveRootIndex,
+        menuSecondary,
+        breadcrumbs,
+    };
+}
+//# sourceMappingURL=menu.js.map

package/dist/shamar/menu.js.map

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

package/dist/shamar/paths.d.ts

@@ -0,0 +1,5 @@
+export declare function shamarAssetsDir(): string;
+export declare function shamarAdminCssPath(): string;
+export declare function shamarAlpineJsPath(): string;
+export declare function shamarUiJsPath(): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/shamar/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/shamar/paths.ts"],"names":[],"mappings":"AAKA,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC"}

package/dist/shamar/paths.js

@@ -0,0 +1,16 @@
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const packageRoot = join(dirname(fileURLToPath(import.meta.url)), '../..');
+export function shamarAssetsDir() {
+    return join(packageRoot, 'assets');
+}
+export function shamarAdminCssPath() {
+    return join(shamarAssetsDir(), 'admin.css');
+}
+export function shamarAlpineJsPath() {
+    return join(shamarAssetsDir(), 'alpine.min.js');
+}
+export function shamarUiJsPath() {
+    return join(shamarAssetsDir(), 'shamar-ui.js');
+}
+//# sourceMappingURL=paths.js.map

package/dist/shamar/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/shamar/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAE3E,MAAM,UAAU,eAAe;IAC7B,OAAO,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,IAAI,CAAC,eAAe,EAAE,EAAE,WAAW,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,IAAI,CAAC,eAAe,EAAE,EAAE,eAAe,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,IAAI,CAAC,eAAe,EAAE,EAAE,cAAc,CAAC,CAAC;AACjD,CAAC"}

package/dist/shamar/relation-fields.d.ts

@@ -0,0 +1,54 @@
+import type { FieldConfig, RelationConfig, RelationSearchResult, ResourceMeta, ResourceRegistry } from '@shamar/core';
+import { relationTitleAttribute } from '@shamar/core';
+export interface RelationUiConfig {
+    name: string;
+    relatedResource: string;
+    singularLabel: string;
+    searchUrl: string;
+    quickCreateUrl: string | null;
+    createUrl: string | null;
+    detailUrlBase: string;
+    attachUrl?: string | null;
+    detachUrl?: string | null;
+    readonly: boolean;
+    required: boolean;
+    kind: RelationConfig['kind'];
+    widget: NonNullable<RelationConfig['widget']>;
+    foreignKey?: string;
+    parentId?: string | null;
+    /** BelongsTo */
+    initialId?: string | null;
+    initialLabel?: string;
+    /** M2M / HasMany */
+    initialItems?: RelationSearchResult[];
+    /** Preloaded options for radio / checkbox list */
+    options?: RelationSearchResult[];
+    checkboxColumns?: number;
+    checkboxFramed?: boolean;
+    cascadeWildcards?: boolean;
+    groupBy?: string;
+    /** Attribute used as dehydrated form values (default `id`). */
+    valueAttribute?: string;
+    /** True when hasMany on create — show empty state until parent is saved */
+    requiresParent?: boolean;
+}
+export declare function isRelationField(field: FieldConfig): boolean;
+export declare function relationWidget(field: FieldConfig): NonNullable<RelationConfig['widget']>;
+/**
+ * Build Alpine `data-shamar-m2o/m2m-config` payload for a relation field.
+ */
+export declare function buildRelationUiConfig(options: {
+    field: FieldConfig;
+    parentMeta: ResourceMeta;
+    relatedMeta: ResourceMeta;
+    basePath: string;
+    record: Record<string, unknown> | null;
+    initialItems?: RelationSearchResult[];
+    preloadedOptions?: RelationSearchResult[];
+    operation: 'create' | 'edit' | 'show';
+}): RelationUiConfig;
+export declare function resolveRelatedMeta(registry: ResourceRegistry, relation: RelationConfig): ResourceMeta;
+export declare function collectRelationIds(field: FieldConfig, record: Record<string, unknown> | null): string[];
+export declare function recordSummaryLabel(meta: ResourceMeta, record: Record<string, unknown>, titleAttribute?: string): string;
+export { relationTitleAttribute };
+//# sourceMappingURL=relation-fields.d.ts.map

package/dist/shamar/relation-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relation-fields.d.ts","sourceRoot":"","sources":["../../src/shamar/relation-fields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,EACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAEtD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IAC7B,MAAM,EAAE,WAAW,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,gBAAgB;IAChB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB;IACpB,YAAY,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACtC,kDAAkD;IAClD,OAAO,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACjC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2EAA2E;IAC3E,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAE3D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAExF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAC7C,KAAK,EAAE,WAAW,CAAC;IACnB,UAAU,EAAE,YAAY,CAAC;IACzB,WAAW,EAAE,YAAY,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACvC,YAAY,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACtC,gBAAgB,CAAC,EAAE,oBAAoB,EAAE,CAAC;IAC1C,SAAS,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;CACvC,GAAG,gBAAgB,CA+DnB;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,gBAAgB,EAC1B,QAAQ,EAAE,cAAc,GACvB,YAAY,CAEd;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GACrC,MAAM,EAAE,CAUV;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,CASR;AAED,OAAO,EAAE,sBAAsB,EAAE,CAAC"}

package/dist/shamar/relation-fields.js

@@ -0,0 +1,94 @@
+import { relationTitleAttribute } from '@shamar/core';
+export function isRelationField(field) {
+    return field.relation != null;
+}
+export function relationWidget(field) {
+    return field.relation?.widget ?? (field.multiple ? 'combobox' : 'combobox');
+}
+/**
+ * Build Alpine `data-shamar-m2o/m2m-config` payload for a relation field.
+ */
+export function buildRelationUiConfig(options) {
+    const { field, parentMeta, relatedMeta, basePath, record, operation } = options;
+    const relation = field.relation;
+    const widget = relation.widget ?? 'combobox';
+    const parentId = record?.id != null ? String(record.id) : null;
+    const searchParams = new URLSearchParams({ field: field.name });
+    // Do not scope search by parent — Add/search should find all related records.
+    // Linked rows are provided via `initialItems` from a scoped adapter.search.
+    const searchUrl = `${basePath}/${parentMeta.slug}/relation-search?${searchParams.toString()}`;
+    const quickCreateUrl = relation.createOption
+        ? `${basePath}/${parentMeta.slug}/relation-quick-create`
+        : null;
+    const attachUrl = relation.kind === 'hasMany'
+        ? `${basePath}/${parentMeta.slug}/relation-attach`
+        : null;
+    const detachUrl = relation.kind === 'hasMany'
+        ? `${basePath}/${parentMeta.slug}/relation-detach`
+        : null;
+    let createUrl = null;
+    if (relation.createAndEditOption) {
+        createUrl = `${basePath}/${relatedMeta.slug}/create`;
+        if (relation.kind === 'hasMany' && relation.foreignKey && parentId) {
+            createUrl += `?${encodeURIComponent(relation.foreignKey)}=${encodeURIComponent(parentId)}`;
+        }
+    }
+    const initialItems = options.initialItems ?? [];
+    const first = initialItems[0];
+    return {
+        name: field.name,
+        relatedResource: relatedMeta.slug,
+        singularLabel: relatedMeta.singularLabel,
+        searchUrl,
+        quickCreateUrl,
+        createUrl,
+        detailUrlBase: `${basePath}/${relatedMeta.slug}`,
+        attachUrl,
+        detachUrl,
+        readonly: options.operation === 'show' || !!field.readonly,
+        required: !!field.required,
+        kind: relation.kind,
+        widget,
+        foreignKey: relation.foreignKey,
+        parentId,
+        initialId: relation.kind === 'belongsTo'
+            ? first?.id ?? (record?.[field.name] != null ? String(record[field.name]) : null)
+            : null,
+        initialLabel: relation.kind === 'belongsTo' ? first?.label ?? '' : undefined,
+        initialItems: relation.kind === 'belongsTo' ? undefined : initialItems,
+        options: options.preloadedOptions,
+        checkboxColumns: field.checkboxColumns ?? relation.checkboxColumns ?? 2,
+        checkboxFramed: field.checkboxFramed ?? relation.checkboxFramed ?? true,
+        cascadeWildcards: field.cascadeWildcards ?? relation.cascadeWildcards ?? false,
+        groupBy: field.groupBy ?? relation.groupBy ?? '',
+        valueAttribute: relation.valueAttribute ?? 'id',
+        requiresParent: relation.kind === 'hasMany' && (operation === 'create' || !parentId),
+    };
+}
+export function resolveRelatedMeta(registry, relation) {
+    return registry.require(relation.resource);
+}
+export function collectRelationIds(field, record) {
+    if (!record)
+        return [];
+    const raw = record[field.name];
+    if (Array.isArray(raw)) {
+        return raw.map((item) => String(item)).filter(Boolean);
+    }
+    if (raw != null && raw !== '') {
+        return [String(raw)];
+    }
+    return [];
+}
+export function recordSummaryLabel(meta, record, titleAttribute) {
+    const attr = titleAttribute ??
+        meta.recordTitleField ??
+        meta.fields.find((field) => field.name === 'name')?.name ??
+        'id';
+    const value = record[attr];
+    if (value != null && String(value).trim())
+        return String(value);
+    return String(record.id ?? '');
+}
+export { relationTitleAttribute };
+//# sourceMappingURL=relation-fields.js.map

package/dist/shamar/relation-fields.js.map

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

package/dist/shamar/resource-actions.d.ts

@@ -0,0 +1,9 @@
+import type { ActionConfig, ResourceMeta } from '@shamar/core';
+import type { ResourcePolicyFlags } from './auth.js';
+/** Filter resource actions by placement and CRUD policy flags. */
+export declare function resourceActionsFor(meta: ResourceMeta, placement: ActionConfig['placement'], policy: ResourcePolicyFlags): ActionConfig[];
+/** Row actions visible for a specific record (e.g. revoke vs reactivate). */
+export declare function visibleRowActions(meta: ResourceMeta, policy: ResourcePolicyFlags, record?: Record<string, unknown> | null): ActionConfig[];
+/** Derive Active/Revoked when a resource uses `revokedAt` + a `status` column/entry. */
+export declare function decorateRevokedStatus(records: Record<string, unknown>[]): void;
+//# sourceMappingURL=resource-actions.d.ts.map

package/dist/shamar/resource-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-actions.d.ts","sourceRoot":"","sources":["../../src/shamar/resource-actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAYpD,kEAAkE;AAClE,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,YAAY,EAClB,SAAS,EAAE,YAAY,CAAC,WAAW,CAAC,EACpC,MAAM,EAAE,mBAAmB,GAC1B,YAAY,EAAE,CAIhB;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,mBAAmB,EAC3B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GACtC,YAAY,EAAE,CAQhB;AAED,wFAAwF;AACxF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,CAO9E"}

package/dist/shamar/resource-actions.js

@@ -0,0 +1,42 @@
+function actionAllowed(action, policy) {
+    const gate = action.ability ?? action.name;
+    if (gate === 'create')
+        return policy.create;
+    if (gate === 'edit' || gate === 'update')
+        return policy.update;
+    if (gate === 'delete')
+        return policy.delete;
+    if (gate === 'view' || gate === 'viewAny')
+        return true;
+    // Custom actions without an ability: allow when the user can manage records.
+    return policy.delete || policy.update;
+}
+/** Filter resource actions by placement and CRUD policy flags. */
+export function resourceActionsFor(meta, placement, policy) {
+    return (meta.actions ?? []).filter((action) => action.placement === placement && actionAllowed(action, policy));
+}
+/** Row actions visible for a specific record (e.g. revoke vs reactivate). */
+export function visibleRowActions(meta, policy, record) {
+    return resourceActionsFor(meta, 'row', policy).filter((action) => {
+        if (action.name === 'edit' && !policy.update)
+            return false;
+        if (action.name === 'delete' && !policy.delete)
+            return false;
+        if (action.name === 'revoke' && record?.revokedAt)
+            return false;
+        if (action.name === 'reactivate' && !record?.revokedAt)
+            return false;
+        return true;
+    });
+}
+/** Derive Active/Revoked when a resource uses `revokedAt` + a `status` column/entry. */
+export function decorateRevokedStatus(records) {
+    for (const record of records) {
+        if (!('revokedAt' in record))
+            continue;
+        const revokedAt = record.revokedAt;
+        record.status =
+            revokedAt != null && String(revokedAt).trim() !== '' ? 'Revoked' : 'Active';
+    }
+}
+//# sourceMappingURL=resource-actions.js.map

package/dist/shamar/resource-actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-actions.js","sourceRoot":"","sources":["../../src/shamar/resource-actions.ts"],"names":[],"mappings":"AAGA,SAAS,aAAa,CAAC,MAAoB,EAAE,MAA2B;IACtE,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAA;IAC1C,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,MAAM,CAAA;IAC3C,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,MAAM,CAAA;IAC9D,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,MAAM,CAAA;IAC3C,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA;IACtD,6EAA6E;IAC7E,OAAO,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAA;AACvC,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,kBAAkB,CAChC,IAAkB,EAClB,SAAoC,EACpC,MAA2B;IAE3B,OAAO,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,MAAM,CAChC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAC5E,CAAA;AACH,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,iBAAiB,CAC/B,IAAkB,EAClB,MAA2B,EAC3B,MAAuC;IAEvC,OAAO,kBAAkB,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE;QAC/D,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM;YAAE,OAAO,KAAK,CAAA;QAC1D,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,MAAM;YAAE,OAAO,KAAK,CAAA;QAC5D,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,EAAE,SAAS;YAAE,OAAO,KAAK,CAAA;QAC/D,IAAI,MAAM,CAAC,IAAI,KAAK,YAAY,IAAI,CAAC,MAAM,EAAE,SAAS;YAAE,OAAO,KAAK,CAAA;QACpE,OAAO,IAAI,CAAA;IACb,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,qBAAqB,CAAC,OAAkC;IACtE,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,CAAC,WAAW,IAAI,MAAM,CAAC;YAAE,SAAQ;QACtC,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAA;QAClC,MAAM,CAAC,MAAM;YACX,SAAS,IAAI,IAAI,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAA;IAC/E,CAAC;AACH,CAAC"}

package/dist/shamar/view-context.d.ts

@@ -0,0 +1,79 @@
+import type { ResourceMeta, ResourceRegistry } from '@shamar/core';
+import type { AuthorizationContext } from '@shamar/cherubim';
+import type { Authorizer } from '@shamar/cherubim';
+import type { ShamarConfig } from '../config.js';
+import { type ShamarBranding } from './branding.js';
+import { menuLayoutContext, type NavigationGroup, type RecordBreadcrumbOptions } from './menu.js';
+import { type ListViewQuery, type PaginationContext } from './list-query.js';
+import type { PaginatedResult } from '@shamar/core';
+export interface AdminShellContext {
+    basePath: string;
+    panelTitle: string;
+    pageTitle: string;
+    branding: ShamarBranding;
+    navGroups: NavigationGroup[];
+    menuRoots: ReturnType<typeof menuLayoutContext>['menuRoots'];
+    menuActiveRoot: ReturnType<typeof menuLayoutContext>['menuActiveRoot'];
+    menuSecondary: ReturnType<typeof menuLayoutContext>['menuSecondary'];
+    breadcrumbs: ReturnType<typeof menuLayoutContext>['breadcrumbs'];
+    user: {
+        name: string;
+        email?: string;
+    };
+    userInitial: string;
+    logoutPath?: string;
+    showCreateButton?: boolean;
+    showEditButton?: boolean;
+    showDeleteButton?: boolean;
+    showBackToList?: boolean;
+    flash?: {
+        type: string;
+        message: string;
+    };
+    flashJson?: string;
+}
+export declare function navigationGroups(registry: ResourceRegistry, options?: {
+    authorizer?: Authorizer;
+    authCtx?: AuthorizationContext;
+}): NavigationGroup[];
+export declare function buildShellContext(options: {
+    config: ShamarConfig;
+    registry: ResourceRegistry;
+    meta?: ResourceMeta;
+    pageTitle: string;
+    basePath?: string;
+    branding?: ShamarConfig['branding'];
+    authorizer?: Authorizer;
+    authCtx?: AuthorizationContext;
+    showCreateButton?: boolean;
+    showEditButton?: boolean;
+    showDeleteButton?: boolean;
+    showBackToList?: boolean;
+    flash?: {
+        type: string;
+        message: string;
+    };
+    recordBreadcrumb?: RecordBreadcrumbOptions;
+}): AdminShellContext;
+export declare function buildListContext(options: {
+    basePath: string;
+    meta: ResourceMeta;
+    query: ListViewQuery;
+    result: PaginatedResult;
+}): {
+    query: ListViewQuery;
+    pagination: PaginationContext;
+    perPageValue: string;
+};
+export declare function readFlash(ctx: {
+    session: {
+        flashMessages?: {
+            has(k: string): boolean;
+            get(k: string): unknown;
+        };
+    };
+}): {
+    type: string;
+    message: string;
+} | undefined;
+//# sourceMappingURL=view-context.d.ts.map

package/dist/shamar/view-context.d.ts.map

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

package/dist/shamar/view-context.js

@@ -0,0 +1,74 @@
+import { canViewResource } from './auth.js';
+import { resolveBranding } from './branding.js';
+import { menuLayoutContext } from './menu.js';
+import { buildPaginationContext, normalizeListQuery, } from './list-query.js';
+export function navigationGroups(registry, options) {
+    const canView = (slug) => {
+        if (!options?.authorizer || !options.authCtx)
+            return true;
+        return canViewResource(options.authorizer, options.authCtx, registry, slug);
+    };
+    return registry
+        .navigationGroups()
+        .map((group) => ({
+        name: group.name,
+        items: group.items.filter((item) => canView(item.slug)),
+    }))
+        .filter((group) => group.items.length > 0);
+}
+export function buildShellContext(options) {
+    const basePath = options.basePath ?? options.config.path ?? '/admin';
+    const groups = navigationGroups(options.registry, {
+        authorizer: options.authorizer,
+        authCtx: options.authCtx,
+    });
+    const menu = menuLayoutContext(groups, basePath, options.meta?.slug, options.pageTitle, options.recordBreadcrumb);
+    const brandingInput = options.branding ?? options.config.branding;
+    const branding = resolveBranding(brandingInput);
+    const authUser = options.authCtx?.user;
+    const userName = authUser?.name ?? brandingInput?.name ?? branding.brandName;
+    const flash = options.flash;
+    const flashJson = flash ? JSON.stringify(flash).replace(/</g, '\\u003c') : undefined;
+    return {
+        basePath,
+        panelTitle: branding.brandName,
+        pageTitle: options.pageTitle,
+        branding,
+        navGroups: groups,
+        menuRoots: menu.menuRoots,
+        menuActiveRoot: menu.menuActiveRoot,
+        menuSecondary: menu.menuSecondary,
+        breadcrumbs: menu.breadcrumbs,
+        user: {
+            name: userName,
+            email: authUser?.email,
+        },
+        userInitial: userName.slice(0, 2).toUpperCase(),
+        logoutPath: options.config.auth?.logoutPath,
+        showCreateButton: options.showCreateButton,
+        showEditButton: options.showEditButton,
+        showDeleteButton: options.showDeleteButton,
+        showBackToList: options.showBackToList,
+        flash,
+        flashJson,
+    };
+}
+export function buildListContext(options) {
+    const query = normalizeListQuery(options.query);
+    const pagination = buildPaginationContext(options.basePath, options.meta.slug, query, options.result);
+    const perPageValue = query.perPage >= 1000 || options.query.perPage === 'all' ? 'all' : String(query.perPage);
+    return { query, pagination, perPageValue };
+}
+export function readFlash(ctx) {
+    const messages = ctx.session.flashMessages;
+    if (!messages)
+        return undefined;
+    if (messages.has('success')) {
+        return { type: 'success', message: String(messages.get('success')) };
+    }
+    if (messages.has('error')) {
+        return { type: 'error', message: String(messages.get('error')) };
+    }
+    return undefined;
+}
+//# sourceMappingURL=view-context.js.map

package/dist/shamar/view-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-context.js","sourceRoot":"","sources":["../../src/shamar/view-context.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAuB,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAsD,MAAM,WAAW,CAAC;AAClG,OAAO,EACL,sBAAsB,EACtB,kBAAkB,GAGnB,MAAM,iBAAiB,CAAC;AAwBzB,MAAM,UAAU,gBAAgB,CAC9B,QAA0B,EAC1B,OAGC;IAED,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,EAAE;QAC/B,IAAI,CAAC,OAAO,EAAE,UAAU,IAAI,CAAC,OAAO,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAC1D,OAAO,eAAe,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC9E,CAAC,CAAC;IAEF,OAAO,QAAQ;SACZ,gBAAgB,EAAE;SAClB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACf,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;KACxD,CAAC,CAAC;SACF,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAejC;IACC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,QAAQ,CAAC;IACrE,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,QAAQ,EAAE;QAChD,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,iBAAiB,CAC5B,MAAM,EACN,QAAQ,EACR,OAAO,CAAC,IAAI,EAAE,IAAI,EAClB,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,gBAAgB,CACzB,CAAC;IACF,MAAM,aAAa,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;IAClE,MAAM,QAAQ,GAAG,eAAe,CAAC,aAAa,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC;IACvC,MAAM,QAAQ,GAAG,QAAQ,EAAE,IAAI,IAAI,aAAa,EAAE,IAAI,IAAI,QAAQ,CAAC,SAAS,CAAC;IAC7E,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC5B,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAErF,OAAO;QACL,QAAQ;QACR,UAAU,EAAE,QAAQ,CAAC,SAAS;QAC9B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,QAAQ;QACR,SAAS,EAAE,MAAM;QACjB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,QAAQ,EAAE,KAAK;SACvB;QACD,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE;QAC/C,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU;QAC3C,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;QAC1C,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;QAC1C,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,KAAK;QACL,SAAS;KACV,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAKhC;IACC,MAAM,KAAK,GAAG,kBAAkB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,UAAU,GAAG,sBAAsB,CACvC,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,IAAI,CAAC,IAAI,EACjB,KAAK,EACL,OAAO,CAAC,MAAM,CACf,CAAC;IACF,MAAM,YAAY,GAChB,KAAK,CAAC,OAAO,IAAI,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAE3F,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAIzB;IACC,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC;IAC3C,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChC,IAAI,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;IACvE,CAAC;IACD,IAAI,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;IACnE,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,15 @@
+import type { DataAdapter, ResourceRegistry } from '@shamar/core';
+import type { Authorizer } from '@shamar/cherubim';
+import type { ShamarRuntime, PanelRuntime } from './runtime.js';
+import type { ShamarConfig } from './config.js';
+declare module '@adonisjs/core/types' {
+    interface ContainerBindings {
+        'shamar.runtime': ShamarRuntime;
+        'shamar.config': ShamarConfig;
+        'shamar.registry': ResourceRegistry;
+        'shamar.adapter': DataAdapter;
+        'shamar.panels': PanelRuntime[];
+        'shamar.authorizer': Authorizer;
+    }
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,QAAQ,sBAAsB,CAAC;IACpC,UAAU,iBAAiB;QACzB,gBAAgB,EAAE,aAAa,CAAC;QAChC,eAAe,EAAE,YAAY,CAAC;QAC9B,iBAAiB,EAAE,gBAAgB,CAAC;QACpC,gBAAgB,EAAE,WAAW,CAAC;QAC9B,eAAe,EAAE,YAAY,EAAE,CAAC;QAChC,mBAAmB,EAAE,UAAU,CAAC;KACjC;CACF"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@shamar/adonis",
+  "version": "0.1.0",
+  "description": "AdonisJS service provider for Shamar admin — routes, controllers, middleware, Edge views.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./provider": {
+      "types": "./dist/provider.d.ts",
+      "import": "./dist/provider.js"
+    },
+    "./require_api_key_middleware": {
+      "types": "./dist/middleware/require_api_key_middleware.d.ts",
+      "import": "./dist/middleware/require_api_key_middleware.js"
+    }
+  },
+  "files": [
+    "dist",
+    "resources",
+    "assets",
+    "stubs"
+  ],
+  "dependencies": {
+    "@shamar/cherubim": "0.1.0",
+    "@shamar/lucid": "0.1.0",
+    "@shamar/mongoose": "0.1.0",
+    "@shamar/core": "0.1.0"
+  },
+  "peerDependencies": {
+    "@adonisjs/core": ">=6.0.0",
+    "@adonisjs/lucid": ">=21.0.0",
+    "edge.js": ">=6.0.0",
+    "mongoose": ">=8.0.0"
+  },
+  "peerDependenciesMeta": {
+    "edge.js": {
+      "optional": true
+    },
+    "mongoose": {
+      "optional": true
+    },
+    "@adonisjs/lucid": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@adonisjs/core": "^7.3.5",
+    "edge.js": "^6.5.1",
+    "@types/node": "^22.0.0",
+    "tsx": "^4.20.0",
+    "typescript": "^5.7.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "build:css": "pnpm dlx @tailwindcss/cli@4.3.2 -i ./assets/input.css -o ./assets/admin.css --minify",
+    "test": "tsx --test test/**/*.test.ts"
+  }
+}