@fayz-ai/plugin-admin 0.1.0

package/dist/index.js

@@ -0,0 +1,215 @@
+import React from 'react';
+import { registerTranslations, createSafeDataProvider, useTranslation } from '@fayz-ai/core';
+import { createStore } from 'zustand/vanilla';
+import { createPluginContext, dedup } from '@fayz-ai/saas';
+import { PanelTop, LayoutTemplate, Settings2, Smartphone, Palette } from 'lucide-react';
+import { ModulePage } from '@fayz-ai/ui';
+import { jsx, jsxs } from 'react/jsx-runtime';
+
+// src/index.ts
+
+// src/data/mock.ts
+function createMockAdminProvider(snapshot) {
+  return {
+    async getSettings() {
+      return snapshot;
+    }
+  };
+}
+
+// src/data/supabase.ts
+function createSupabaseAdminProvider(snapshot) {
+  return {
+    async getSettings() {
+      return snapshot;
+    }
+  };
+}
+function createAdminStore(provider) {
+  return createStore((set) => ({
+    settings: null,
+    settingsLoading: false,
+    async fetchSettings() {
+      return dedup("admin:settings", async () => {
+        set({ settingsLoading: true });
+        try {
+          const settings = await provider.getSettings();
+          set({ settings, settingsLoading: false });
+        } catch {
+          set({ settingsLoading: false });
+        }
+      });
+    }
+  }));
+}
+
+// src/locales/en.ts
+var en = {
+  "admin.layout.title": "Layout",
+  "admin.layout.sidebar": "Sidebar",
+  "admin.layout.topbar": "Topbar",
+  "admin.layout.minimal": "Minimal",
+  "admin.moduleNav.title": "Module navigation",
+  "admin.moduleNav.rail": "Side rail for the installed modules",
+  "admin.moduleNav.tabs": "Tabs for the installed modules",
+  "admin.mobileHeader.title": "Mobile header",
+  "admin.mobileHeader.minimal": "Minimal header bar",
+  "admin.mobileHeader.transparent": "Transparent, edge-to-edge content",
+  "admin.mobileHeader.hidden": "Hidden",
+  "admin.branding.title": "Branding",
+  "admin.branding.on": "Org branding settings are visible to operators",
+  "admin.branding.off": "Org branding settings are hidden",
+  "admin.readOnlyNotice": "Read-only preview. Editing these settings here is coming soon \u2014 for now they are set in your app config."
+};
+
+// src/locales/pt-BR.ts
+var ptBR = {
+  "admin.layout.title": "Layout",
+  "admin.layout.sidebar": "Barra lateral",
+  "admin.layout.topbar": "Barra superior",
+  "admin.layout.minimal": "Minimalista",
+  "admin.moduleNav.title": "Navega\xE7\xE3o dos m\xF3dulos",
+  "admin.moduleNav.rail": "Barra lateral para os m\xF3dulos instalados",
+  "admin.moduleNav.tabs": "Abas para os m\xF3dulos instalados",
+  "admin.mobileHeader.title": "Cabe\xE7alho mobile",
+  "admin.mobileHeader.minimal": "Cabe\xE7alho minimalista",
+  "admin.mobileHeader.transparent": "Transparente, conte\xFAdo de ponta a ponta",
+  "admin.mobileHeader.hidden": "Oculto",
+  "admin.branding.title": "Identidade visual",
+  "admin.branding.on": "As configura\xE7\xF5es de marca est\xE3o vis\xEDveis para operadores",
+  "admin.branding.off": "As configura\xE7\xF5es de marca est\xE3o ocultas",
+  "admin.readOnlyNotice": "Pr\xE9-visualiza\xE7\xE3o somente leitura. A edi\xE7\xE3o por aqui chega em breve \u2014 por enquanto essas op\xE7\xF5es s\xE3o definidas na configura\xE7\xE3o do app."
+};
+
+// src/locales/index.ts
+var adminLocales = {
+  en,
+  "pt-BR": ptBR
+};
+var ctx = createPluginContext("AdminPage");
+var AdminContextProvider = ctx.ContextProvider;
+ctx.useConfig;
+ctx.useProvider;
+ctx.useStore;
+var LAYOUT_VARIANTS = ["sidebar", "topbar", "minimal"];
+function SettingCard({ icon: Icon, title, children }) {
+  return /* @__PURE__ */ jsxs("div", { className: "rounded-xl border border-border bg-background/60 p-4", children: [
+    /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2 mb-2", children: [
+      /* @__PURE__ */ jsx("div", { className: "h-8 w-8 rounded-lg bg-foreground/[0.04] flex items-center justify-center shrink-0", children: /* @__PURE__ */ jsx(Icon, { className: "h-4 w-4 text-muted-foreground" }) }),
+      /* @__PURE__ */ jsx("div", { className: "text-sm font-medium", children: title })
+    ] }),
+    children
+  ] });
+}
+function AdminPage({ config, provider, store }) {
+  const t = useTranslation();
+  return /* @__PURE__ */ jsx(AdminContextProvider, { config, provider, store, children: /* @__PURE__ */ jsxs(ModulePage, { title: config.labels.pageTitle, subtitle: config.labels.pageSubtitle, nav: [], children: [
+    /* @__PURE__ */ jsxs("div", { className: "grid grid-cols-1 sm:grid-cols-2 gap-4", children: [
+      /* @__PURE__ */ jsx(SettingCard, { icon: config.layout === "topbar" ? PanelTop : LayoutTemplate, title: t("admin.layout.title"), children: /* @__PURE__ */ jsx("div", { className: "flex flex-wrap gap-2 text-sm", children: LAYOUT_VARIANTS.map((variant) => /* @__PURE__ */ jsx(
+        "span",
+        {
+          className: "rounded-md border px-2.5 py-1.5 " + (config.layout === variant ? "border-primary/40 bg-primary/5 text-foreground" : "border-border text-muted-foreground"),
+          children: t(`admin.layout.${variant}`)
+        },
+        variant
+      )) }) }),
+      /* @__PURE__ */ jsx(SettingCard, { icon: Settings2, title: t("admin.moduleNav.title"), children: /* @__PURE__ */ jsx("p", { className: "text-xs text-muted-foreground", children: t(`admin.moduleNav.${config.moduleNav}`) }) }),
+      /* @__PURE__ */ jsx(SettingCard, { icon: Smartphone, title: t("admin.mobileHeader.title"), children: /* @__PURE__ */ jsx("p", { className: "text-xs text-muted-foreground", children: t(`admin.mobileHeader.${config.mobileHeader}`) }) }),
+      /* @__PURE__ */ jsx(SettingCard, { icon: Palette, title: t("admin.branding.title"), children: /* @__PURE__ */ jsx("p", { className: "text-xs text-muted-foreground", children: config.branding ? t("admin.branding.on") : t("admin.branding.off") }) })
+    ] }),
+    /* @__PURE__ */ jsx("p", { className: "mt-6 text-xs text-muted-foreground", children: t("admin.readOnlyNotice") })
+  ] }) });
+}
+
+// src/index.ts
+var DEFAULT_LABELS = {
+  pageTitle: "Admin",
+  pageSubtitle: "Your app's layout, navigation, and branding."
+};
+function resolveConfig(options) {
+  return {
+    labels: DEFAULT_LABELS,
+    layout: options?.layout ?? "sidebar",
+    moduleNav: options?.moduleNav ?? "tabs",
+    mobileHeader: options?.mobileHeader ?? "minimal",
+    navTransition: options?.navTransition ?? "slide",
+    orgSettings: options?.orgSettings ?? true,
+    branding: options?.branding ?? true
+  };
+}
+function toSnapshot(config) {
+  const { labels: _labels, ...snapshot } = config;
+  return snapshot;
+}
+function createAdminPlugin(options) {
+  const config = resolveConfig(options);
+  registerTranslations(adminLocales);
+  const snapshot = toSnapshot(config);
+  const provider = options?.dataProvider ?? createSafeDataProvider(
+    () => createSupabaseAdminProvider(snapshot),
+    () => createMockAdminProvider(snapshot)
+  );
+  const store = createAdminStore(provider);
+  const PageComponent = () => React.createElement(AdminPage, { config, provider, store });
+  return {
+    id: "admin",
+    name: config.labels.pageTitle,
+    icon: "LayoutTemplate",
+    version: "1.0.0",
+    scope: options?.scope ?? "universal",
+    verticalId: options?.verticalId,
+    // Shell/admin-config is a Panel-side concept (layout, module nav, branding
+    // for an admin app) — targets the saas/admin-template world, not the
+    // ecommerce storefront. Same declaration plugin-crm uses for its
+    // business-ops surface.
+    scaffolds: ["saas"],
+    defaultEnabled: true,
+    dependencies: [],
+    declaredFeatures: [
+      { id: "admin", label: config.labels.pageTitle, group: config.labels.pageTitle }
+    ],
+    navigation: [
+      {
+        section: "secondary",
+        position: 90,
+        label: config.labels.pageTitle,
+        route: "/admin",
+        icon: "LayoutTemplate",
+        permission: { feature: "admin", action: "read" }
+      }
+    ],
+    routes: [
+      {
+        path: "/admin",
+        component: PageComponent,
+        permission: { feature: "admin", action: "read" }
+      }
+    ],
+    widgets: [],
+    aiTools: [
+      {
+        id: "admin.get-shell-settings",
+        name: "getShellSettings",
+        description: "Returns the app shell configuration: layout variant, module nav style, mobile header treatment, and whether org/branding settings are shown.",
+        icon: "LayoutTemplate",
+        mode: "read",
+        category: "Admin",
+        parameters: {
+          type: "object",
+          properties: {}
+        },
+        suggestions: [
+          { label: "What layout is this app using?" },
+          { label: "Is branding customization on?" }
+        ],
+        permission: { feature: "admin", action: "read" }
+      }
+    ],
+    settings: [],
+    locales: adminLocales
+  };
+}
+
+export { createAdminPlugin };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/data/mock.ts","../src/data/supabase.ts","../src/store.ts","../src/locales/en.ts","../src/locales/pt-BR.ts","../src/locales/index.ts","../src/AdminContext.tsx","../src/AdminPage.tsx","../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { AdminDataProvider, AdminSettingsSnapshot } from './types'\n\n/**\n * Mock provider — returns the statically resolved shell-config snapshot\n * (from plugin options / FayzAppConfig defaults). No in-memory mutation:\n * this plugin doesn't write settings yet.\n */\nexport function createMockAdminProvider(snapshot: AdminSettingsSnapshot): AdminDataProvider {\n  return {\n    async getSettings() {\n      return snapshot\n    },\n  }\n}\n","import type { AdminDataProvider, AdminSettingsSnapshot } from './types'\n\n/**\n * Supabase provider — foundation stub. There is no shell-config table yet:\n * layout/moduleNav/mobileHeader/branding are still owned by FayzAppConfig at\n * build time, not a runtime-editable record. This provider exists so the\n * plugin follows the standard createSafeDataProvider(supabase, mock) seam\n * from day one; it returns the same static snapshot the mock provider does\n * until a real read/write path is wired (see README.md).\n */\nexport function createSupabaseAdminProvider(snapshot: AdminSettingsSnapshot): AdminDataProvider {\n  return {\n    async getSettings() {\n      return snapshot\n    },\n  }\n}\n","import { createStore, type StoreApi } from 'zustand/vanilla'\nimport { dedup } from '@fayz-ai/saas'\nimport type { AdminDataProvider, AdminSettingsSnapshot } from './data/types'\n\nexport interface AdminUIState {\n  settings: AdminSettingsSnapshot | null\n  settingsLoading: boolean\n\n  fetchSettings(): Promise<void>\n}\n\nexport function createAdminStore(provider: AdminDataProvider): StoreApi<AdminUIState> {\n  return createStore<AdminUIState>((set) => ({\n    settings: null,\n    settingsLoading: false,\n\n    async fetchSettings() {\n      return dedup('admin:settings', async () => {\n        set({ settingsLoading: true })\n        try {\n          const settings = await provider.getSettings()\n          set({ settings, settingsLoading: false })\n        } catch {\n          set({ settingsLoading: false })\n        }\n      })\n    },\n  }))\n}\n","export const en: Record<string, string> = {\n  'admin.layout.title': 'Layout',\n  'admin.layout.sidebar': 'Sidebar',\n  'admin.layout.topbar': 'Topbar',\n  'admin.layout.minimal': 'Minimal',\n  'admin.moduleNav.title': 'Module navigation',\n  'admin.moduleNav.rail': 'Side rail for the installed modules',\n  'admin.moduleNav.tabs': 'Tabs for the installed modules',\n  'admin.mobileHeader.title': 'Mobile header',\n  'admin.mobileHeader.minimal': 'Minimal header bar',\n  'admin.mobileHeader.transparent': 'Transparent, edge-to-edge content',\n  'admin.mobileHeader.hidden': 'Hidden',\n  'admin.branding.title': 'Branding',\n  'admin.branding.on': 'Org branding settings are visible to operators',\n  'admin.branding.off': 'Org branding settings are hidden',\n  'admin.readOnlyNotice': 'Read-only preview. Editing these settings here is coming soon — for now they are set in your app config.',\n}\n","export const ptBR: Record<string, string> = {\n  'admin.layout.title': 'Layout',\n  'admin.layout.sidebar': 'Barra lateral',\n  'admin.layout.topbar': 'Barra superior',\n  'admin.layout.minimal': 'Minimalista',\n  'admin.moduleNav.title': 'Navegação dos módulos',\n  'admin.moduleNav.rail': 'Barra lateral para os módulos instalados',\n  'admin.moduleNav.tabs': 'Abas para os módulos instalados',\n  'admin.mobileHeader.title': 'Cabeçalho mobile',\n  'admin.mobileHeader.minimal': 'Cabeçalho minimalista',\n  'admin.mobileHeader.transparent': 'Transparente, conteúdo de ponta a ponta',\n  'admin.mobileHeader.hidden': 'Oculto',\n  'admin.branding.title': 'Identidade visual',\n  'admin.branding.on': 'As configurações de marca estão visíveis para operadores',\n  'admin.branding.off': 'As configurações de marca estão ocultas',\n  'admin.readOnlyNotice': 'Pré-visualização somente leitura. A edição por aqui chega em breve — por enquanto essas opções são definidas na configuração do app.',\n}\n","import { en } from './en'\nimport { ptBR } from './pt-BR'\n\nexport const adminLocales: Record<string, Record<string, string>> = {\n  en,\n  'pt-BR': ptBR,\n}\n","import { createPluginContext } from '@fayz-ai/saas'\nimport type { AdminDataProvider, AdminSettingsSnapshot } from './data/types'\nimport type { AdminUIState } from './store'\n\n// ---------------------------------------------------------------------------\n// Config\n// ---------------------------------------------------------------------------\n\nexport interface AdminPluginLabels {\n  pageTitle: string\n  pageSubtitle: string\n}\n\n/** Resolved shell config + labels, handed to AdminPage. Mirrors AdminSettingsSnapshot. */\nexport interface ResolvedAdminConfig extends AdminSettingsSnapshot {\n  labels: AdminPluginLabels\n}\n\nconst ctx = createPluginContext<ResolvedAdminConfig, AdminDataProvider, AdminUIState>('AdminPage')\n\nexport const AdminContextProvider = ctx.ContextProvider\nexport const useAdminConfig = ctx.useConfig\nexport const useAdminProvider = ctx.useProvider\nexport const useAdminStore = ctx.useStore\n","import React from 'react'\nimport type { StoreApi } from 'zustand/vanilla'\nimport { LayoutTemplate, PanelTop, Settings2, Smartphone, Palette } from 'lucide-react'\nimport { useTranslation } from '@fayz-ai/core'\nimport { ModulePage } from '@fayz-ai/ui'\nimport { AdminContextProvider, type ResolvedAdminConfig } from './AdminContext'\nimport type { AdminDataProvider } from './data/types'\nimport type { AdminUIState } from './store'\n\nconst LAYOUT_VARIANTS = ['sidebar', 'topbar', 'minimal'] as const\n\nfunction SettingCard({ icon: Icon, title, children }: {\n  icon: typeof LayoutTemplate\n  title: string\n  children: React.ReactNode\n}) {\n  return (\n    <div className=\"rounded-xl border border-border bg-background/60 p-4\">\n      <div className=\"flex items-center gap-2 mb-2\">\n        <div className=\"h-8 w-8 rounded-lg bg-foreground/[0.04] flex items-center justify-center shrink-0\">\n          <Icon className=\"h-4 w-4 text-muted-foreground\" />\n        </div>\n        <div className=\"text-sm font-medium\">{title}</div>\n      </div>\n      {children}\n    </div>\n  )\n}\n\n/**\n * Read-only foundation view. Renders the shell config this app already\n * resolved (layout, module nav, mobile header, branding) so an operator can\n * see it at a glance — it does not yet let them change it. See README.md for\n * the write-path this is scaffolding toward.\n */\nexport function AdminPage({ config, provider, store }: {\n  config: ResolvedAdminConfig\n  provider: AdminDataProvider\n  store: StoreApi<AdminUIState>\n}) {\n  const t = useTranslation()\n\n  return (\n    <AdminContextProvider config={config} provider={provider} store={store}>\n      <ModulePage title={config.labels.pageTitle} subtitle={config.labels.pageSubtitle} nav={[]}>\n        <div className=\"grid grid-cols-1 sm:grid-cols-2 gap-4\">\n          <SettingCard icon={config.layout === 'topbar' ? PanelTop : LayoutTemplate} title={t('admin.layout.title')}>\n            <div className=\"flex flex-wrap gap-2 text-sm\">\n              {LAYOUT_VARIANTS.map((variant) => (\n                <span\n                  key={variant}\n                  className={\n                    'rounded-md border px-2.5 py-1.5 ' +\n                    (config.layout === variant\n                      ? 'border-primary/40 bg-primary/5 text-foreground'\n                      : 'border-border text-muted-foreground')\n                  }\n                >\n                  {t(`admin.layout.${variant}`)}\n                </span>\n              ))}\n            </div>\n          </SettingCard>\n\n          <SettingCard icon={Settings2} title={t('admin.moduleNav.title')}>\n            <p className=\"text-xs text-muted-foreground\">{t(`admin.moduleNav.${config.moduleNav}`)}</p>\n          </SettingCard>\n\n          <SettingCard icon={Smartphone} title={t('admin.mobileHeader.title')}>\n            <p className=\"text-xs text-muted-foreground\">{t(`admin.mobileHeader.${config.mobileHeader}`)}</p>\n          </SettingCard>\n\n          <SettingCard icon={Palette} title={t('admin.branding.title')}>\n            <p className=\"text-xs text-muted-foreground\">\n              {config.branding ? t('admin.branding.on') : t('admin.branding.off')}\n            </p>\n          </SettingCard>\n        </div>\n\n        <p className=\"mt-6 text-xs text-muted-foreground\">{t('admin.readOnlyNotice')}</p>\n      </ModulePage>\n    </AdminContextProvider>\n  )\n}\n","import React from 'react'\nimport type { PluginManifest } from '@fayz-ai/core'\nimport { createSafeDataProvider, registerTranslations } from '@fayz-ai/core'\nimport type { ResolvedAdminConfig, AdminPluginLabels } from './AdminContext'\nimport type { AdminDataProvider, AdminSettingsSnapshot } from './data/types'\nimport type { AdminPluginOptions } from './types'\nimport { createMockAdminProvider } from './data/mock'\nimport { createSupabaseAdminProvider } from './data/supabase'\nimport { createAdminStore } from './store'\nimport { adminLocales } from './locales'\nimport { AdminPage } from './AdminPage'\n\n// ---------------------------------------------------------------------------\n// Defaults\n// ---------------------------------------------------------------------------\n\nconst DEFAULT_LABELS: AdminPluginLabels = {\n  pageTitle: 'Admin',\n  pageSubtitle: \"Your app's layout, navigation, and branding.\",\n}\n\n// ---------------------------------------------------------------------------\n// Config resolver\n// ---------------------------------------------------------------------------\n\nfunction resolveConfig(options?: AdminPluginOptions): ResolvedAdminConfig {\n  return {\n    labels: DEFAULT_LABELS,\n    layout: options?.layout ?? 'sidebar',\n    moduleNav: options?.moduleNav ?? 'tabs',\n    mobileHeader: options?.mobileHeader ?? 'minimal',\n    navTransition: options?.navTransition ?? 'slide',\n    orgSettings: options?.orgSettings ?? true,\n    branding: options?.branding ?? true,\n  }\n}\n\nfunction toSnapshot(config: ResolvedAdminConfig): AdminSettingsSnapshot {\n  const { labels: _labels, ...snapshot } = config\n  return snapshot\n}\n\n// ---------------------------------------------------------------------------\n// Factory\n// ---------------------------------------------------------------------------\n\nexport function createAdminPlugin(options?: AdminPluginOptions): PluginManifest {\n  const config = resolveConfig(options)\n  // Register locales globally so the plugin's translations resolve even when the\n  // host shell does not mount @fayz-ai/core's I18nProvider (incremental de-bridge).\n  registerTranslations(adminLocales)\n  const snapshot = toSnapshot(config)\n  const provider = options?.dataProvider ?? createSafeDataProvider(\n    () => createSupabaseAdminProvider(snapshot),\n    () => createMockAdminProvider(snapshot),\n  )\n  const store = createAdminStore(provider)\n\n  const PageComponent: React.FC<unknown> = () =>\n    React.createElement(AdminPage, { config, provider, store })\n\n  return {\n    id: 'admin',\n    name: config.labels.pageTitle,\n    icon: 'LayoutTemplate',\n    version: '1.0.0',\n    scope: options?.scope ?? 'universal',\n    verticalId: options?.verticalId,\n    // Shell/admin-config is a Panel-side concept (layout, module nav, branding\n    // for an admin app) — targets the saas/admin-template world, not the\n    // ecommerce storefront. Same declaration plugin-crm uses for its\n    // business-ops surface.\n    scaffolds: ['saas'],\n    defaultEnabled: true,\n    dependencies: [],\n    declaredFeatures: [\n      { id: 'admin', label: config.labels.pageTitle, group: config.labels.pageTitle },\n    ],\n\n    navigation: [\n      {\n        section: 'secondary',\n        position: 90,\n        label: config.labels.pageTitle,\n        route: '/admin',\n        icon: 'LayoutTemplate',\n        permission: { feature: 'admin', action: 'read' as const },\n      },\n    ],\n\n    routes: [\n      {\n        path: '/admin',\n        component: PageComponent as unknown as React.ComponentType<unknown>,\n        permission: { feature: 'admin', action: 'read' as const },\n      },\n    ],\n\n    widgets: [],\n\n    aiTools: [\n      {\n        id: 'admin.get-shell-settings',\n        name: 'getShellSettings',\n        description: 'Returns the app shell configuration: layout variant, module nav style, mobile header treatment, and whether org/branding settings are shown.',\n        icon: 'LayoutTemplate',\n        mode: 'read' as const,\n        category: 'Admin',\n        parameters: {\n          type: 'object' as const,\n          properties: {},\n        },\n        suggestions: [\n          { label: 'What layout is this app using?' },\n          { label: 'Is branding customization on?' },\n        ],\n        permission: { feature: 'admin', action: 'read' as const },\n      },\n    ],\n\n    settings: [],\n\n    locales: adminLocales,\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Re-exports\n// ---------------------------------------------------------------------------\n\nexport type { AdminDataProvider, AdminSettingsSnapshot } from './data/types'\nexport type { ResolvedAdminConfig, AdminPluginLabels } from './AdminContext'\nexport type { AdminPluginOptions } from './types'\n"]}

package/dist/locales/en.d.ts

@@ -0,0 +1,2 @@
+export declare const en: Record<string, string>;
+//# sourceMappingURL=en.d.ts.map

package/dist/locales/en.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"en.d.ts","sourceRoot":"","sources":["../../src/locales/en.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAgBrC,CAAA"}

package/dist/locales/index.d.ts

@@ -0,0 +1,2 @@
+export declare const adminLocales: Record<string, Record<string, string>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/locales/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/locales/index.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAG/D,CAAA"}

package/dist/locales/pt-BR.d.ts

@@ -0,0 +1,2 @@
+export declare const ptBR: Record<string, string>;
+//# sourceMappingURL=pt-BR.d.ts.map

package/dist/locales/pt-BR.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pt-BR.d.ts","sourceRoot":"","sources":["../../src/locales/pt-BR.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAgBvC,CAAA"}

package/dist/store.d.ts

@@ -0,0 +1,9 @@
+import { type StoreApi } from 'zustand/vanilla';
+import type { AdminDataProvider, AdminSettingsSnapshot } from './data/types';
+export interface AdminUIState {
+    settings: AdminSettingsSnapshot | null;
+    settingsLoading: boolean;
+    fetchSettings(): Promise<void>;
+}
+export declare function createAdminStore(provider: AdminDataProvider): StoreApi<AdminUIState>;
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAE5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AAE5E,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,qBAAqB,GAAG,IAAI,CAAA;IACtC,eAAe,EAAE,OAAO,CAAA;IAExB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC/B;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,QAAQ,CAAC,YAAY,CAAC,CAiBpF"}

package/dist/types.d.ts

@@ -0,0 +1,23 @@
+import type { PluginScope, VerticalId } from '@fayz-ai/core';
+import type { AdminDataProvider } from './data/types';
+export interface AdminPluginOptions {
+    /** Shell layout variant (mirrors FayzAppConfig.layout). Default: 'sidebar'. */
+    layout?: 'sidebar' | 'topbar' | 'minimal';
+    /** How module-internal navigation renders (mirrors FayzAppConfig.moduleNav). Default: 'tabs'. */
+    moduleNav?: 'rail' | 'tabs';
+    /** Mobile header treatment (mirrors FayzAppConfig.mobileHeader). Default: 'minimal'. */
+    mobileHeader?: 'minimal' | 'transparent' | 'hidden';
+    /** Page navigation animation (mirrors FayzAppConfig.navTransition). Default: 'slide'. */
+    navTransition?: 'slide' | 'fade' | 'none';
+    /** Show org-level settings tabs (mirrors FayzAppConfig.orgSettings). Default: true. */
+    orgSettings?: boolean;
+    /** Show branding/company settings tabs (mirrors FayzAppConfig.branding). Default: true. */
+    branding?: boolean;
+    /** Plugin scope */
+    scope?: PluginScope;
+    /** Vertical ID */
+    verticalId?: VerticalId;
+    /** Data provider override (defaults to safe auto-selection) */
+    dataProvider?: AdminDataProvider;
+}
+//# 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":"AAWA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAErD,MAAM,WAAW,kBAAkB;IACjC,+EAA+E;IAC/E,MAAM,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAA;IACzC,iGAAiG;IACjG,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC3B,wFAAwF;IACxF,YAAY,CAAC,EAAE,SAAS,GAAG,aAAa,GAAG,QAAQ,CAAA;IACnD,yFAAyF;IACzF,aAAa,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAA;IACzC,uFAAuF;IACvF,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,OAAO,CAAA;IAElB,mBAAmB;IACnB,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,kBAAkB;IAClB,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,iBAAiB,CAAA;CACjC"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@fayz-ai/plugin-admin",
+  "version": "0.1.0",
+  "description": "[experimental] Fayz SDK — admin shell settings plugin (read-only foundation)",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "dependencies": {
+    "lucide-react": "^0.400.0",
+    "zustand": "^4.5.0",
+    "@fayz-ai/core": "^0.7.1",
+    "@fayz-ai/ui": "^0.7.0",
+    "@fayz-ai/saas": "^0.7.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.0",
+    "react": "^18.3.0",
+    "tsup": "^8.2.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.1.9"
+  },
+  "license": "MIT",
+  "keywords": [
+    "fayz",
+    "fayz-plugin",
+    "fayz-sdk"
+  ],
+  "scripts": {
+    "build": "tsup && tsc --emitDeclarationOnly --declaration --declarationMap --noEmit false",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "clean": "rm -rf dist"
+  }
+}

package/src/AdminContext.tsx

@@ -0,0 +1,24 @@
+import { createPluginContext } from '@fayz-ai/saas'
+import type { AdminDataProvider, AdminSettingsSnapshot } from './data/types'
+import type { AdminUIState } from './store'
+
+// ---------------------------------------------------------------------------
+// Config
+// ---------------------------------------------------------------------------
+
+export interface AdminPluginLabels {
+  pageTitle: string
+  pageSubtitle: string
+}
+
+/** Resolved shell config + labels, handed to AdminPage. Mirrors AdminSettingsSnapshot. */
+export interface ResolvedAdminConfig extends AdminSettingsSnapshot {
+  labels: AdminPluginLabels
+}
+
+const ctx = createPluginContext<ResolvedAdminConfig, AdminDataProvider, AdminUIState>('AdminPage')
+
+export const AdminContextProvider = ctx.ContextProvider
+export const useAdminConfig = ctx.useConfig
+export const useAdminProvider = ctx.useProvider
+export const useAdminStore = ctx.useStore

package/src/AdminPage.tsx

@@ -0,0 +1,84 @@
+import React from 'react'
+import type { StoreApi } from 'zustand/vanilla'
+import { LayoutTemplate, PanelTop, Settings2, Smartphone, Palette } from 'lucide-react'
+import { useTranslation } from '@fayz-ai/core'
+import { ModulePage } from '@fayz-ai/ui'
+import { AdminContextProvider, type ResolvedAdminConfig } from './AdminContext'
+import type { AdminDataProvider } from './data/types'
+import type { AdminUIState } from './store'
+
+const LAYOUT_VARIANTS = ['sidebar', 'topbar', 'minimal'] as const
+
+function SettingCard({ icon: Icon, title, children }: {
+  icon: typeof LayoutTemplate
+  title: string
+  children: React.ReactNode
+}) {
+  return (
+    <div className="rounded-xl border border-border bg-background/60 p-4">
+      <div className="flex items-center gap-2 mb-2">
+        <div className="h-8 w-8 rounded-lg bg-foreground/[0.04] flex items-center justify-center shrink-0">
+          <Icon className="h-4 w-4 text-muted-foreground" />
+        </div>
+        <div className="text-sm font-medium">{title}</div>
+      </div>
+      {children}
+    </div>
+  )
+}
+
+/**
+ * Read-only foundation view. Renders the shell config this app already
+ * resolved (layout, module nav, mobile header, branding) so an operator can
+ * see it at a glance — it does not yet let them change it. See README.md for
+ * the write-path this is scaffolding toward.
+ */
+export function AdminPage({ config, provider, store }: {
+  config: ResolvedAdminConfig
+  provider: AdminDataProvider
+  store: StoreApi<AdminUIState>
+}) {
+  const t = useTranslation()
+
+  return (
+    <AdminContextProvider config={config} provider={provider} store={store}>
+      <ModulePage title={config.labels.pageTitle} subtitle={config.labels.pageSubtitle} nav={[]}>
+        <div className="grid grid-cols-1 sm:grid-cols-2 gap-4">
+          <SettingCard icon={config.layout === 'topbar' ? PanelTop : LayoutTemplate} title={t('admin.layout.title')}>
+            <div className="flex flex-wrap gap-2 text-sm">
+              {LAYOUT_VARIANTS.map((variant) => (
+                <span
+                  key={variant}
+                  className={
+                    'rounded-md border px-2.5 py-1.5 ' +
+                    (config.layout === variant
+                      ? 'border-primary/40 bg-primary/5 text-foreground'
+                      : 'border-border text-muted-foreground')
+                  }
+                >
+                  {t(`admin.layout.${variant}`)}
+                </span>
+              ))}
+            </div>
+          </SettingCard>
+
+          <SettingCard icon={Settings2} title={t('admin.moduleNav.title')}>
+            <p className="text-xs text-muted-foreground">{t(`admin.moduleNav.${config.moduleNav}`)}</p>
+          </SettingCard>
+
+          <SettingCard icon={Smartphone} title={t('admin.mobileHeader.title')}>
+            <p className="text-xs text-muted-foreground">{t(`admin.mobileHeader.${config.mobileHeader}`)}</p>
+          </SettingCard>
+
+          <SettingCard icon={Palette} title={t('admin.branding.title')}>
+            <p className="text-xs text-muted-foreground">
+              {config.branding ? t('admin.branding.on') : t('admin.branding.off')}
+            </p>
+          </SettingCard>
+        </div>
+
+        <p className="mt-6 text-xs text-muted-foreground">{t('admin.readOnlyNotice')}</p>
+      </ModulePage>
+    </AdminContextProvider>
+  )
+}

package/src/contract.test.ts

@@ -0,0 +1,40 @@
+// Integrity test for plugin-admin's manifest shape, using the shared assertion
+// from @fayz-ai/core/testing (no UI import — pure, inline manifest, per
+// docs/PLUGIN-PATTERNS.md → integrity). Mirrors plugin-financial/src/contract.test.ts.
+import { describe, it, expect } from 'vitest'
+import { assertPluginManifestContract, PluginContractError } from '@fayz-ai/core/testing'
+import type { PluginManifest } from '@fayz-ai/core'
+
+const Dummy = () => null
+
+function manifest(overrides: Partial<PluginManifest> = {}): PluginManifest {
+  return {
+    id: 'admin',
+    name: 'Admin',
+    icon: 'LayoutTemplate',
+    version: '1.0.0',
+    navigation: [{ section: 'secondary', position: 90, label: 'Admin', route: '/admin', icon: 'LayoutTemplate' } as any],
+    routes: [{ path: '/admin', component: Dummy } as any],
+    ...overrides,
+  }
+}
+
+describe('plugin-admin · assertPluginManifestContract', () => {
+  it('passes the real manifest shape (nav route matches declared route)', () => {
+    expect(() => assertPluginManifestContract(manifest())).not.toThrow()
+  })
+
+  it('rejects a missing id', () => {
+    expect(() => assertPluginManifestContract(manifest({ id: '' }))).toThrow(PluginContractError)
+  })
+
+  it('rejects a nav entry pointing at an undeclared route', () => {
+    expect(() => assertPluginManifestContract(manifest({
+      navigation: [{ section: 'secondary', position: 90, label: 'Admin', route: '/nowhere', icon: 'LayoutTemplate' } as any],
+    }))).toThrow(/no matching route/)
+  })
+
+  it('rejects a plugin that contributes nothing mountable', () => {
+    expect(() => assertPluginManifestContract(manifest({ navigation: [], routes: [], settings: [] }))).toThrow(/nothing/)
+  })
+})

package/src/data/capability.test.ts

@@ -0,0 +1,30 @@
+// Capability test — proves the data slice end-to-end against the mock
+// provider, per docs/PLUGIN-PATTERNS.md → capability anatomy. plugin-admin is
+// a read-only foundation (no writes yet): the slice to prove is that the
+// resolved shell-config snapshot round-trips through the provider unchanged,
+// and that both mock and supabase stubs honor the same contract.
+import { describe, it, expect } from 'vitest'
+import { createMockAdminProvider } from './mock'
+import { createSupabaseAdminProvider } from './supabase'
+import type { AdminSettingsSnapshot } from './types'
+
+const SNAPSHOT: AdminSettingsSnapshot = {
+  layout: 'topbar',
+  moduleNav: 'rail',
+  mobileHeader: 'transparent',
+  navTransition: 'fade',
+  orgSettings: false,
+  branding: true,
+}
+
+describe('plugin-admin capability · data slice', () => {
+  it('mock provider surfaces the resolved snapshot as-is', async () => {
+    const provider = createMockAdminProvider(SNAPSHOT)
+    expect(await provider.getSettings()).toEqual(SNAPSHOT)
+  })
+
+  it('supabase stub provider honors the same contract (no backend table yet)', async () => {
+    const provider = createSupabaseAdminProvider(SNAPSHOT)
+    expect(await provider.getSettings()).toEqual(SNAPSHOT)
+  })
+})

package/src/data/mock.ts

@@ -0,0 +1,14 @@
+import type { AdminDataProvider, AdminSettingsSnapshot } from './types'
+
+/**
+ * Mock provider — returns the statically resolved shell-config snapshot
+ * (from plugin options / FayzAppConfig defaults). No in-memory mutation:
+ * this plugin doesn't write settings yet.
+ */
+export function createMockAdminProvider(snapshot: AdminSettingsSnapshot): AdminDataProvider {
+  return {
+    async getSettings() {
+      return snapshot
+    },
+  }
+}

package/src/data/supabase.ts

@@ -0,0 +1,17 @@
+import type { AdminDataProvider, AdminSettingsSnapshot } from './types'
+
+/**
+ * Supabase provider — foundation stub. There is no shell-config table yet:
+ * layout/moduleNav/mobileHeader/branding are still owned by FayzAppConfig at
+ * build time, not a runtime-editable record. This provider exists so the
+ * plugin follows the standard createSafeDataProvider(supabase, mock) seam
+ * from day one; it returns the same static snapshot the mock provider does
+ * until a real read/write path is wired (see README.md).
+ */
+export function createSupabaseAdminProvider(snapshot: AdminSettingsSnapshot): AdminDataProvider {
+  return {
+    async getSettings() {
+      return snapshot
+    },
+  }
+}

package/src/data/types.ts

@@ -0,0 +1,20 @@
+// ---------------------------------------------------------------------------
+// Admin Plugin — Data Provider
+// ---------------------------------------------------------------------------
+// A snapshot of the app's shell config, resolved once at plugin creation. This
+// is a read-only reflection today, not a persisted, editable record — see the
+// module doc comment in ../types.ts.
+// ---------------------------------------------------------------------------
+
+export interface AdminSettingsSnapshot {
+  layout: 'sidebar' | 'topbar' | 'minimal'
+  moduleNav: 'rail' | 'tabs'
+  mobileHeader: 'minimal' | 'transparent' | 'hidden'
+  navTransition: 'slide' | 'fade' | 'none'
+  orgSettings: boolean
+  branding: boolean
+}
+
+export interface AdminDataProvider {
+  getSettings(): Promise<AdminSettingsSnapshot>
+}