@shamar/adonis 0.1.0

package/resources/views/shamar/partials/schema-node.edge

@@ -0,0 +1,289 @@
+{{--
+  Recursive Filament-style schema node.
+  Expects: node, schemaMode ('form' | 'detail'), mode (create|edit for forms), record (for detail)
+--}}
+@if(node.kind === 'field' && schemaMode === 'form' && node.field)
+  @let(field = node.field)
+  @if(!field.hiddenOnForm && !(field.createOnly && mode === 'edit'))
+    <div
+      class="shamar-field-cell"
+      style="{{ resolveGridItemStyle(field, 2) }}"
+      x-show="isVisible('{{ field.name }}')"
+    >
+      @include('shamar::partials/field-input')
+    </div>
+  @endif
+
+@elseif(node.kind === 'entry' && schemaMode === 'detail' && node.entry)
+  @let(field = node.entry)
+  @include('shamar::partials/detail-entry')
+
+@elseif(node.kind === 'placeholder')
+  <div class="shamar-placeholder" style="{{ resolveGridItemStyle(node, 2) }}">
+    @if(node.title)
+      <div class="shamar-placeholder__label">{{ node.title }}</div>
+    @endif
+    @if(node.content)
+      <div class="shamar-placeholder__content">{{ node.content }}</div>
+    @endif
+  </div>
+
+@elseif(node.kind === 'callout')
+  <div class="shamar-callout shamar-callout--{{ node.status ?? 'info' }}" style="{{ resolveGridItemStyle(node, 2) }}">
+    @if(node.title)
+      <div class="shamar-callout__title">{{ node.title }}</div>
+    @endif
+    @if(node.content || node.description)
+      <div class="shamar-callout__body">{{ node.content ?? node.description }}</div>
+    @endif
+    @if(node.children && node.children.length)
+      <div class="shamar-callout__children">
+        @each(childNode in node.children)
+          @!component('shamar::partials/schema-node', {
+            node: childNode,
+            schemaMode: schemaMode,
+            mode: mode,
+            record: record,
+            formErrors: formErrors,
+            relationUi: relationUi,
+          })
+        @endeach
+      </div>
+    @endif
+  </div>
+
+@elseif(node.kind === 'empty_state')
+  <div class="shamar-empty-state" style="{{ resolveGridItemStyle(node, 2) }}">
+    @if(node.title)
+      <h3 class="shamar-empty-state__title">{{ node.title }}</h3>
+    @endif
+    @if(node.description)
+      <p class="shamar-empty-state__description">{{ node.description }}</p>
+    @endif
+  </div>
+
+@elseif(node.kind === 'tabs')
+  <div
+    class="shamar-tabs{{ node.card !== false ? ' shamar-tabs--contained' : '' }}{{ node.vertical ? ' shamar-tabs--vertical' : '' }}"
+    style="{{ resolveGridItemStyle(node, 2) }}"
+    x-data='shamarTabs({{ node.activeTab ?? 1 }})'
+  >
+    <div class="shamar-tabs__list" role="tablist">
+      @each((tab, tabIndex) in (node.children || []))
+        <button
+          type="button"
+          class="shamar-tabs__tab"
+          role="tab"
+          :class="{ 'is-active': active === {{ tabIndex + 1 }} }"
+          @click="active = {{ tabIndex + 1 }}"
+        >
+          <span>{{ tab.title || ('Tab ' + (tabIndex + 1)) }}</span>
+          @if(tab.badge !== undefined && tab.badge !== null)
+            <span class="shamar-tabs__badge">{{ tab.badge }}</span>
+          @endif
+        </button>
+      @endeach
+    </div>
+    <div class="shamar-tabs__panels">
+      @each((tab, tabIndex) in (node.children || []))
+        <div class="shamar-tabs__panel" x-show="active === {{ tabIndex + 1 }}" role="tabpanel">
+          <div
+            class="shamar-form-grid{{ tab.dense ? ' is-dense' : '' }}{{ tab.gap === false ? ' is-gapless' : '' }}"
+            style="--shamar-form-cols: {{ tab.columns ?? node.columns ?? 2 }}"
+          >
+            @each(childNode in (tab.children || []))
+              @!component('shamar::partials/schema-node', {
+            node: childNode,
+            schemaMode: schemaMode,
+            mode: mode,
+            record: record,
+            formErrors: formErrors,
+            relationUi: relationUi,
+          })
+            @endeach
+          </div>
+        </div>
+      @endeach
+    </div>
+  </div>
+
+@elseif(node.kind === 'wizard')
+  <div
+    class="shamar-wizard{{ node.card !== false ? ' shamar-card rounded-xl' : '' }}"
+    style="{{ resolveGridItemStyle(node, 2) }}"
+    x-data='shamarWizard({{ (node.children || []).length }})'
+  >
+    <ol class="shamar-wizard__steps">
+      @each((step, stepIndex) in (node.children || []))
+        <li class="shamar-wizard__step" :class="{ 'is-active': step === {{ stepIndex + 1 }}, 'is-done': step > {{ stepIndex + 1 }} }">
+          <span class="shamar-wizard__index">{{ stepIndex + 1 }}</span>
+          <span class="shamar-wizard__label">{{ step.title || ('Step ' + (stepIndex + 1)) }}</span>
+        </li>
+      @endeach
+    </ol>
+    <div class="shamar-wizard__panels">
+      @each((step, stepIndex) in (node.children || []))
+        <div class="shamar-wizard__panel" x-show="step === {{ stepIndex + 1 }}">
+          @if(step.description)
+            <p class="shamar-wizard__description">{{ step.description }}</p>
+          @endif
+          <div
+            class="shamar-form-grid{{ step.dense ? ' is-dense' : '' }}{{ step.gap === false ? ' is-gapless' : '' }}"
+            style="--shamar-form-cols: {{ step.columns ?? 2 }}"
+          >
+            @each(childNode in (step.children || []))
+              @!component('shamar::partials/schema-node', {
+            node: childNode,
+            schemaMode: schemaMode,
+            mode: mode,
+            record: record,
+            formErrors: formErrors,
+            relationUi: relationUi,
+          })
+            @endeach
+          </div>
+        </div>
+      @endeach
+    </div>
+    <div class="shamar-wizard__nav">
+      <button type="button" class="shamar-wizard__btn" x-show="step > 1" @click="prev()">Previous</button>
+      <button type="button" class="shamar-wizard__btn shamar-wizard__btn--primary" x-show="step < total" @click="next()">Next</button>
+    </div>
+  </div>
+
+@elseif(node.kind === 'flex')
+  <div
+    class="shamar-flex shamar-flex--from-{{ node.from ?? 'md' }}"
+    style="{{ resolveGridItemStyle(node, 2) }}"
+  >
+    @each(childNode in (node.children || []))
+      <div class="shamar-flex__item{{ childNode.grow === false ? ' shamar-flex__item--fixed' : '' }}">
+        @!component('shamar::partials/schema-node', {
+            node: childNode,
+            schemaMode: schemaMode,
+            mode: mode,
+            record: record,
+            formErrors: formErrors,
+            relationUi: relationUi,
+          })
+      </div>
+    @endeach
+  </div>
+
+@elseif(node.kind === 'grid' || node.kind === 'group' || node.kind === 'plain')
+  <div
+    class="{{ node.kind === 'group' ? 'shamar-group' : (node.kind === 'grid' ? 'shamar-grid-wrap' : 'shamar-form-plain') }}"
+    style="{{ resolveGridItemStyle(node, 2) }}"
+  >
+    <div
+      class="{{ schemaMode === 'detail' ? 'shamar-detail-grid' : 'shamar-form-grid' }}{{ node.dense ? ' is-dense' : '' }}{{ node.gap === false ? ' is-gapless' : '' }}"
+      style="--shamar-form-cols: {{ node.columns || 2 }}; --shamar-detail-cols: {{ node.columns || 2 }}"
+    >
+      @each(childNode in (node.children || []))
+        @!component('shamar::partials/schema-node', {
+            node: childNode,
+            schemaMode: schemaMode,
+            mode: mode,
+            record: record,
+            formErrors: formErrors,
+            relationUi: relationUi,
+          })
+      @endeach
+    </div>
+  </div>
+
+@elseif(node.kind === 'fieldset')
+  <fieldset
+    class="shamar-form-fieldset{{ node.card ? ' shamar-form-fieldset--card' : '' }}{{ node.dense ? ' is-dense' : '' }}"
+    style="{{ resolveGridItemStyle(node, 2) }}"
+  >
+    @if(node.title)
+      <legend class="shamar-form-fieldset__legend">{{ node.title }}</legend>
+    @endif
+    @if(node.description)
+      <p class="shamar-form-fieldset__description">{{ node.description }}</p>
+    @endif
+    <div
+      class="{{ schemaMode === 'detail' ? 'shamar-detail-grid' : 'shamar-form-grid' }}{{ node.gap === false ? ' is-gapless' : '' }}"
+      style="--shamar-form-cols: {{ node.columns || 2 }}; --shamar-detail-cols: {{ node.columns || 2 }}"
+    >
+      @each(childNode in (node.children || []))
+        @!component('shamar::partials/schema-node', {
+            node: childNode,
+            schemaMode: schemaMode,
+            mode: mode,
+            record: record,
+            formErrors: formErrors,
+            relationUi: relationUi,
+          })
+      @endeach
+    </div>
+  </fieldset>
+
+@elseif(node.kind === 'section' || node.kind === 'tab' || node.kind === 'step')
+  <section
+    class="shamar-form-section rounded-xl{{ node.card !== false && node.kind === 'section' ? ' shamar-card' : '' }}{{ node.card === false && node.kind === 'section' ? ' shamar-form-section--plain' : '' }}"
+    style="{{ resolveGridItemStyle(node, 2) }}"
+    @if(node.collapsible)
+      x-data="{ open: {{ node.collapsed ? 'false' : 'true' }} }"
+    @endif
+  >
+    @if(node.title || node.icon || node.description || node.collapsible)
+      <header
+        class="shamar-form-section__header{{ node.description ? '' : ' shamar-form-section__header--centered' }}{{ node.collapsible ? ' shamar-form-section__header--collapsible' : '' }}"
+        @if(node.collapsible)
+          @click="open = !open"
+          role="button"
+          :aria-expanded="open"
+        @endif
+      >
+        @if(node.icon)
+          <span class="shamar-form-section__icon" aria-hidden="true" data-icon="{{ node.icon }}">
+            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" class="w-5 h-5">
+              <path stroke-linecap="round" stroke-linejoin="round" d="M3.75 6.75h16.5M3.75 12h16.5m-16.5 5.25h16.5" />
+            </svg>
+          </span>
+        @endif
+        @if(node.title || node.description)
+          <div class="shamar-form-section__titles min-w-0">
+            @if(node.title)
+              <h3 class="shamar-form-section__title">{{ node.title }}</h3>
+            @endif
+            @if(node.description)
+              <p class="shamar-form-section__description">{{ node.description }}</p>
+            @endif
+          </div>
+        @endif
+        @if(node.collapsible)
+          <span class="shamar-form-section__chevron" aria-hidden="true" :class="{ 'is-open': open }">
+            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" width="16" height="16">
+              <path stroke-linecap="round" stroke-linejoin="round" d="M19.5 8.25l-7.5 7.5-7.5-7.5" />
+            </svg>
+          </span>
+        @endif
+      </header>
+    @endif
+    <div
+      class="shamar-form-section__body"
+      @if(node.collapsible)
+        x-show="open"
+      @endif
+    >
+      <div
+        class="{{ schemaMode === 'detail' ? 'shamar-detail-grid' : 'shamar-form-grid' }}{{ node.dense ? ' is-dense' : '' }}{{ node.gap === false ? ' is-gapless' : '' }}"
+        style="--shamar-form-cols: {{ node.columns || 2 }}; --shamar-detail-cols: {{ node.columns || 2 }}"
+      >
+        @each(childNode in (node.children || []))
+          @!component('shamar::partials/schema-node', {
+            node: childNode,
+            schemaMode: schemaMode,
+            mode: mode,
+            record: record,
+            formErrors: formErrors,
+            relationUi: relationUi,
+          })
+        @endeach
+      </div>
+    </div>
+  </section>
+@endif

package/resources/views/shamar/partials/shell-close.edge

@@ -0,0 +1,20 @@
+      </main>
+    </div>
+  </div>
+
+  @include('shamar::partials/dialog-host')
+
+  <script>
+    function shamarShell() {
+      return {
+        sidebarOpen: false,
+        toggleTheme() {
+          const root = document.documentElement;
+          const next = root.classList.toggle('dark');
+          localStorage.setItem('shamar-theme', next ? 'dark' : 'light');
+        },
+      };
+    }
+  </script>
+</body>
+</html>

package/resources/views/shamar/partials/shell-open.edge

@@ -0,0 +1,51 @@
+<!DOCTYPE html>
+<html lang="en" class="h-full">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>{{ pageTitle }} · {{ panelTitle }}</title>
+  @if(branding.fontUrl)
+    <link rel="stylesheet" href="{{ branding.fontUrl }}" />
+  @endif
+  <link rel="stylesheet" href="{{ basePath }}/assets/admin.css" />
+  <link rel="stylesheet" href="{{ basePath }}/assets/branding.css" />
+  <meta name="csrf-token" content="{{ csrfToken }}" />
+  <script>
+    (function () {
+      const stored = localStorage.getItem('shamar-theme');
+      if (stored === 'dark' || (!stored && window.matchMedia('(prefers-color-scheme: dark)').matches)) {
+        document.documentElement.classList.add('dark');
+      }
+    })();
+  </script>
+  <script defer src="{{ basePath }}/assets/shamar-ui.js"></script>
+  <script defer src="{{ basePath }}/assets/alpine.min.js"></script>
+  <style>[x-cloak] { display: none !important; }</style>
+</head>
+<body
+  class="min-h-screen bg-shamar-shell text-body antialiased flex md:flex-row"
+  x-data="shamarShell()"
+  data-shamar-base-path="{{ basePath }}"
+>
+  <div
+    x-show="sidebarOpen"
+    x-cloak
+    x-transition.opacity
+    class="fixed inset-0 z-20 bg-black/30 md:hidden"
+    @click="sidebarOpen = false"
+  ></div>
+
+  @include('shamar::partials/nav')
+
+  <div class="flex min-w-0 flex-1 flex-col min-h-screen w-full">
+    @include('shamar::partials/topbar')
+
+    <div class="flex-1 flex flex-col min-h-0 overflow-x-hidden w-full p-3 md:p-4 gap-4">
+
+      @include('shamar::partials/toast')
+
+      @if(pageTitle)
+        @include('shamar::partials/page-heading')
+      @endif
+
+      <main class="flex-1 min-h-0 overflow-auto">

package/resources/views/shamar/partials/toast.edge

@@ -0,0 +1,5 @@
+@if(flashJson)
+  <script id="shamar-initial-flash" type="application/json">{{{ flashJson }}}</script>
+@endif
+
+<div id="shamar-toast-stack" aria-live="polite" aria-atomic="true"></div>

package/resources/views/shamar/partials/topbar.edge

@@ -0,0 +1,115 @@
+<header class="flex items-center gap-3 px-4 md:px-6 min-h-[60px] shrink-0 bg-shamar-shell sticky top-0 z-30 overflow-visible">
+  <button
+    type="button"
+    @click="sidebarOpen = true"
+    aria-label="Open menu"
+    class="md:hidden p-1.5 -ml-1.5 rounded-md text-body hover:bg-surface-hover"
+  >
+    <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24" stroke-width="2">
+      <path stroke-linecap="round" stroke-linejoin="round" d="M4 6h16M4 12h16M4 18h16"/>
+    </svg>
+  </button>
+
+  <div class="hidden md:flex flex-1 min-w-0 overflow-visible">
+    <nav
+      class="shamar-app-menu flex-1 min-w-0 flex flex-wrap items-center gap-1 overflow-visible"
+      x-data="{ openKey: '' }"
+      @click.outside="openKey = ''"
+      @keydown.escape.window="openKey = ''"
+      aria-label="{{ menuActiveRoot ? `${menuActiveRoot.label} menu` : 'App menu' }}"
+    >
+      @if(menuActiveRoot)
+        @if(!menuSecondary.length)
+          <span class="shrink-0 text-sm font-semibold text-heading truncate max-w-[12rem]">{{ menuActiveRoot.label }}</span>
+        @endif
+      @endif
+
+      @each(item in menuSecondary)
+        @if(item.children && item.children.length)
+          <div class="relative shrink-0">
+            <button
+              type="button"
+              @click="openKey = openKey === 'sec-{{ $index }}' ? '' : 'sec-{{ $index }}'"
+              class="flex items-center gap-1 px-2.5 py-1.5 rounded-md text-sm whitespace-nowrap {{ item.active ? 'bg-surface-inset text-fg-brand font-medium' : 'text-body hover:text-heading hover:bg-surface-hover' }}"
+              :aria-expanded="(openKey === 'sec-{{ $index }}').toString()"
+            >
+              {{ item.label }}
+              <svg class="w-3 h-3 text-body-subtle transition-transform" :class="{ 'rotate-180': openKey === 'sec-{{ $index }}' }" fill="none" stroke="currentColor" viewBox="0 0 24 24" stroke-width="2.5">
+                <path stroke-linecap="round" stroke-linejoin="round" d="M19.5 8.25l-7.5 7.5-7.5-7.5"/>
+              </svg>
+            </button>
+            <div
+              x-show="openKey === 'sec-{{ $index }}'"
+              x-cloak
+              x-transition
+              class="absolute left-0 top-full z-50 mt-1 min-w-[10rem] shamar-card rounded-xl shadow-lg py-1"
+            >
+              @each(child in item.children)
+                <a href="{{ child.href }}" class="block px-3 py-1.5 text-sm whitespace-nowrap {{ child.active ? 'text-fg-brand font-medium bg-surface-inset' : 'text-body hover:bg-surface-hover hover:text-heading' }}">{{ child.label }}</a>
+              @endeach
+            </div>
+          </div>
+        @else
+          <a href="{{ item.href }}" class="shrink-0 px-2.5 py-1.5 rounded-md text-sm whitespace-nowrap {{ item.active ? 'bg-surface-inset text-fg-brand font-medium' : 'text-body hover:text-heading hover:bg-surface-hover' }}">{{ item.label }}</a>
+        @endif
+      @endeach
+    </nav>
+  </div>
+
+  @if(menuActiveRoot)
+    <p class="md:hidden flex-1 min-w-0 text-sm font-semibold text-heading truncate px-0.5">{{ menuActiveRoot.label }}</p>
+  @else
+    <div class="md:hidden flex-1 min-w-0" aria-hidden="true"></div>
+  @endif
+
+  <div class="flex items-center gap-2 shrink-0">
+    <button
+      type="button"
+      @click="toggleTheme()"
+      aria-label="Toggle dark mode"
+      class="p-1.5 rounded-md text-body hover:bg-surface-hover hover:text-heading"
+    >
+      <svg class="w-4 h-4 dark:hidden" fill="none" stroke="currentColor" viewBox="0 0 24 24" stroke-width="1.8">
+        <path stroke-linecap="round" stroke-linejoin="round" d="M20.354 15.354A9 9 0 018.646 3.646 9.003 9.003 0 0012 21a9.003 9.003 0 008.354-5.646z"/>
+      </svg>
+      <svg class="w-4 h-4 hidden dark:block" fill="none" stroke="currentColor" viewBox="0 0 24 24" stroke-width="1.8">
+        <path stroke-linecap="round" stroke-linejoin="round" d="M12 3v1m0 16v1m9-9h-1M4 12H3m15.364-6.364l-.707.707M6.343 17.657l-.707.707M17.657 17.657l-.707-.707M6.343 6.343l-.707-.707M12 8a4 4 0 100 8 4 4 0 000-8z"/>
+      </svg>
+    </button>
+
+    <div class="relative" x-data="{ open: false }" @click.outside="open = false">
+      <button
+        type="button"
+        @click="open = !open"
+        aria-haspopup="true"
+        :aria-expanded="open.toString()"
+        class="flex items-center gap-2 pl-1 pr-2 py-1 rounded-md hover:bg-surface-hover"
+      >
+        <span class="w-7 h-7 rounded-full bg-fg-brand text-white text-xs font-semibold flex items-center justify-center shrink-0">{{ userInitial }}</span>
+        <span class="hidden sm:inline text-sm font-medium text-body max-w-[120px] truncate">{{ user.name }}</span>
+        <svg class="w-3 h-3 text-body-subtle hidden sm:block" fill="none" stroke="currentColor" viewBox="0 0 24 24" stroke-width="2">
+          <path stroke-linecap="round" stroke-linejoin="round" d="M19.5 8.25l-7.5 7.5-7.5-7.5"/>
+        </svg>
+      </button>
+      <div x-show="open" x-cloak x-transition class="absolute right-0 top-full mt-2 w-56 shamar-card rounded-xl shadow-lg overflow-hidden z-50">
+        <div class="px-4 py-3 border-b border-default">
+          <p class="text-sm font-semibold text-heading truncate">{{ user.name }}</p>
+          @if(user.email)
+            <p class="text-xs text-body-subtle">{{ user.email }}</p>
+          @endif
+        </div>
+        <div class="py-1 text-sm">
+          <a href="{{ basePath }}" class="block px-4 py-1.5 text-body hover:bg-surface-hover hover:text-heading">Admin</a>
+          @if(logoutPath)
+            <form method="post" action="{{ logoutPath }}" class="block">
+              @include('shamar::partials/csrf')
+              <button type="submit" class="w-full text-left px-4 py-1.5 text-body hover:bg-surface-hover hover:text-heading">
+                Sign out
+              </button>
+            </form>
+          @endif
+        </div>
+      </div>
+    </div>
+  </div>
+</header>

package/resources/views/shamar/show.edge

@@ -0,0 +1,17 @@
+@let(mode = 'show')
+@include('shamar::partials/shell-open')
+
+<div class="mx-auto max-w-5xl space-y-6" data-shamar-record-view="show">
+  @each(node in detailSchema)
+    @!component('shamar::partials/schema-node', {
+      node: node,
+      schemaMode: 'detail',
+      mode: mode,
+      record: record,
+      formErrors: formErrors,
+      relationUi: relationUi,
+    })
+  @endeach
+</div>
+
+@include('shamar::partials/shell-close')

package/stubs/config/shamar.stub

@@ -0,0 +1,29 @@
+{{{
+  exports({ to: app.configPath('shamar.ts') })
+}}}
+import { defineConfig, panel } from '@shamar/adonis'
+// import UserResource from '#resources/user_resource'
+
+/**
+ * Persistence: {{ orm }}
+ * - lucid    → Lucid SQL models (@shamar/lucid)
+ * - mongoose → Mongoose models (@shamar/mongoose)
+ *
+ * App owns the DB connection lifecycle (Lucid database provider or mongoose.connect).
+ *
+ * Prefer panels + discoverResources. Legacy `path` + `resources` still works
+ * as a single default panel.
+ */
+export default defineConfig({
+  orm: '{{ orm }}',
+  branding: {
+    name: 'Shamar Admin',
+  },
+  panels: [
+    panel('admin')
+      .path('/admin')
+      .discoverResources('app/resources/admin')
+      // .resources([UserResource])
+      ,
+  ],
+})