@fayz-ai/plugin-inventory 0.9.0-next.1 → 0.9.1

package/dist/{InventoryPage.d.ts → views/InventoryPage.d.ts}

@@ -1,8 +1,8 @@
 import React from 'react';
 import type { StoreApi } from 'zustand/vanilla';
-import { type ResolvedInventoryConfig } from './InventoryContext';
-import type { InventoryDataProvider } from './data/types';
-import type { InventoryUIState } from './store';
+import { type ResolvedInventoryConfig } from '../context';
+import type { InventoryDataProvider } from '../data/types';
+import type { InventoryUIState } from '../store';
 import type { PluginRegistryDef } from '@fayz-ai/core';
 export declare function InventoryPage({ config, provider, store, registries }: {
     config: ResolvedInventoryConfig;

package/dist/views/InventoryPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InventoryPage.d.ts","sourceRoot":"","sources":["../../src/views/InventoryPage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4B,MAAM,OAAO,CAAA;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAE/C,OAAO,EAA4B,KAAK,uBAAuB,EAAE,MAAM,YAAY,CAAA;AACnF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAqB,MAAM,eAAe,CAAA;AA+CzE,wBAAgB,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE;IACrE,MAAM,EAAE,uBAAuB,CAAA;IAC/B,QAAQ,EAAE,qBAAqB,CAAA;IAC/B,KAAK,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAA;IACjC,UAAU,CAAC,EAAE,iBAAiB,EAAE,CAAA;CACjC,qBAqHA"}

package/dist/views/ProductCrudForm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProductCrudForm.d.ts","sourceRoot":"","sources":["../../src/views/ProductCrudForm.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAgBzB,wBAAgB,eAAe,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;CAAE,qBAuF7F"}
+{"version":3,"file":"ProductCrudForm.d.ts","sourceRoot":"","sources":["../../src/views/ProductCrudForm.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAgBzB,wBAAgB,eAAe,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;CAAE,qBA2F7F"}

package/dist/views/dashboardWidgets.d.ts

@@ -1,6 +1,6 @@
 import type { StoreApi } from 'zustand';
 import type { DashboardWidgetDef } from '@fayz-ai/core';
-import { type ResolvedInventoryConfig } from '../InventoryContext';
+import { type ResolvedInventoryConfig } from '../context';
 import type { InventoryDataProvider } from '../data/types';
 import type { InventoryUIState } from '../store';
 export declare function createInventoryDashboardWidgets(ctx: {

package/dist/views/dashboardWidgets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dashboardWidgets.d.ts","sourceRoot":"","sources":["../../src/views/dashboardWidgets.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AACvC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAMvD,OAAO,EAAmF,KAAK,uBAAuB,EAAE,MAAM,qBAAqB,CAAA;AACnJ,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAiEhD,wBAAgB,+BAA+B,CAAC,GAAG,EAAE;IACnD,MAAM,EAAE,uBAAuB,CAAA;IAC/B,QAAQ,EAAE,qBAAqB,CAAA;IAC/B,KAAK,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAA;CAClC,GAAG,kBAAkB,EAAE,CAoBvB"}
+{"version":3,"file":"dashboardWidgets.d.ts","sourceRoot":"","sources":["../../src/views/dashboardWidgets.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AACvC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAMvD,OAAO,EAAmF,KAAK,uBAAuB,EAAE,MAAM,YAAY,CAAA;AAC1I,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAiEhD,wBAAgB,+BAA+B,CAAC,GAAG,EAAE;IACnD,MAAM,EAAE,uBAAuB,CAAA;IAC/B,QAAQ,EAAE,qBAAqB,CAAA;IAC/B,KAAK,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAA;CAClC,GAAG,kBAAkB,EAAE,CAoBvB"}

package/dist/views/productEntity.d.ts

@@ -1,5 +1,5 @@
 import type { EntityDef } from '@fayz-ai/core';
-import { type InventoryCurrency, type ProductTypeOption } from '../InventoryContext';
+import { type InventoryCurrency, type ProductTypeOption } from '../context';
 type T = (key: string, params?: Record<string, string | number>) => string;
 export declare function buildProductEntity(t: T, productTypes: ProductTypeOption[], currency: InventoryCurrency): EntityDef;
 export {};

package/dist/views/productEntity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"productEntity.d.ts","sourceRoot":"","sources":["../../src/views/productEntity.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAY,MAAM,eAAe,CAAA;AACxD,OAAO,EAAkB,KAAK,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAgBpG,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KAAK,MAAM,CAAA;AAE1E,wBAAgB,kBAAkB,CAChC,CAAC,EAAE,CAAC,EACJ,YAAY,EAAE,iBAAiB,EAAE,EACjC,QAAQ,EAAE,iBAAiB,GAC1B,SAAS,CAmGX"}
+{"version":3,"file":"productEntity.d.ts","sourceRoot":"","sources":["../../src/views/productEntity.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAY,MAAM,eAAe,CAAA;AACxD,OAAO,EAAkB,KAAK,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAgB3F,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KAAK,MAAM,CAAA;AAE1E,wBAAgB,kBAAkB,CAChC,CAAC,EAAE,CAAC,EACJ,YAAY,EAAE,iBAAiB,EAAE,EACjC,QAAQ,EAAE,iBAAiB,GAC1B,SAAS,CAmGX"}

package/package.json

@@ -3,7 +3,7 @@
   "fayz": {
     "status": "beta"
   },
-  "version": "0.9.0-next.1",
+  "version": "0.9.1",
   "description": "Fayz SDK — plugin-inventory plugin",
   "type": "module",
   "sideEffects": false,
@@ -12,14 +12,12 @@
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "source": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     }
   },
   "files": [
-    "dist",
-    "src"
+    "dist"
   ],
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",
@@ -29,9 +27,9 @@
   },
   "dependencies": {
     "@tanstack/react-table": "^8.20.0",
-    "@fayz-ai/core": "^0.9.0-next.1",
-    "@fayz-ai/ui": "^0.9.0-next.1",
-    "@fayz-ai/saas": "^0.9.0-next.1"
+    "@fayz-ai/core": "^0.10.0",
+    "@fayz-ai/ui": "^0.10.0",
+    "@fayz-ai/admin": "^0.10.0"
   },
   "devDependencies": {
     "@types/react": "^18.3.0",

package/dist/InventoryContext.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"InventoryContext.d.ts","sourceRoot":"","sources":["../src/InventoryContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAuB,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAA;AACxF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AACpD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE/C,MAAM,WAAW,gBAAgB;IAC/B,iFAAiF;IACjF,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB,cAAc,EAAE,OAAO,CAAA;IACvB,aAAa,EAAE,OAAO,CAAA;CACvB;AAED,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAA;AAE9C,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,gBAAgB,CAAA;IACzB,MAAM,EAAE,qBAAqB,CAAA;IAC7B,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,YAAY,EAAE,iBAAiB,EAAE,CAAA;IACjC,SAAS,EAAE,cAAc,EAAE,CAAA;CAC5B;AAID,eAAO,MAAM,wBAAwB;;;;;EAAsB,CAAA;AAC3D,eAAO,MAAM,kBAAkB,+BAAgB,CAAA;AAC/C,eAAO,MAAM,oBAAoB,6BAAkB,CAAA;AACnD,eAAO,MAAM,iBAAiB,oDAAe,CAAA;AAE7C,OAAO,EAAE,cAAc,EAAE,CAAA"}

package/dist/InventoryPage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"InventoryPage.d.ts","sourceRoot":"","sources":["../src/InventoryPage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4B,MAAM,OAAO,CAAA;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAE/C,OAAO,EAA4B,KAAK,uBAAuB,EAAE,MAAM,oBAAoB,CAAA;AAC3F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAqB,MAAM,eAAe,CAAA;AA+CzE,wBAAgB,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE;IACrE,MAAM,EAAE,uBAAuB,CAAA;IAC/B,QAAQ,EAAE,qBAAqB,CAAA;IAC/B,KAAK,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAA;IACjC,UAAU,CAAC,EAAE,iBAAiB,EAAE,CAAA;CACjC,qBAqHA"}

package/dist/registries.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"registries.d.ts","sourceRoot":"","sources":["../src/registries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAsEtD,eAAO,MAAM,mBAAmB,EAAE,iBAAiB,EAwClD,CAAA"}

package/src/InventoryContext.tsx

@@ -1,42 +0,0 @@
-import { createPluginContext, formatCurrency, type CurrencyConfig } from '@fayz-ai/saas'
-import type { InventoryPluginLabels } from './index'
-import type { InventoryDataProvider } from './data/types'
-import type { InventoryUIState } from './store'
-
-export interface InventoryModules {
-  /** Product catalogue screens. Off when the host registers products elsewhere. */
-  products: boolean
-  recipes: boolean
-  stockLocations: boolean
-  batchTracking: boolean
-}
-
-export type InventoryCurrency = CurrencyConfig
-
-export interface ProductTypeOption {
-  value: string
-  label: string
-}
-
-export interface LocationOption {
-  id: string
-  name: string
-  isHQ?: boolean
-}
-
-export interface ResolvedInventoryConfig {
-  modules: InventoryModules
-  labels: InventoryPluginLabels
-  currency: InventoryCurrency
-  productTypes: ProductTypeOption[]
-  locations: LocationOption[]
-}
-
-const ctx = createPluginContext<ResolvedInventoryConfig, InventoryDataProvider, InventoryUIState>('InventoryPage')
-
-export const InventoryContextProvider = ctx.ContextProvider
-export const useInventoryConfig = ctx.useConfig
-export const useInventoryProvider = ctx.useProvider
-export const useInventoryStore = ctx.useStore
-
-export { formatCurrency }

package/src/InventoryPage.tsx

@@ -1,176 +0,0 @@
-import React, { useState, useMemo } from 'react'
-import type { StoreApi } from 'zustand/vanilla'
-import { ModulePage, PageTransition, type ModuleNavItem } from '@fayz-ai/ui'
-import { InventoryContextProvider, type ResolvedInventoryConfig } from './InventoryContext'
-import type { InventoryDataProvider } from './data/types'
-import type { InventoryUIState } from './store'
-import type { PluginRegistryDef, PluginQuickAction } from '@fayz-ai/core'
-import { useModuleNavigation, ModuleActionBar, createViewRouter } from '@fayz-ai/saas'
-import { useTranslation } from '@fayz-ai/core'
-import { DashboardView } from './views/DashboardView'
-import { ProductListView } from './views/ProductListView'
-import { ProductCrudForm } from './views/ProductCrudForm'
-import { StockMovementView } from './views/StockMovementView'
-import { MovementHistoryView } from './views/MovementHistoryView'
-import { RecipesView } from './views/RecipesView'
-import { RecipeFormView } from './views/RecipeFormView'
-import { RecipeDetailView } from './views/RecipeDetailView'
-import { InventoryGeneralSettings } from './components/InventoryGeneralSettings'
-import { InventoryOnboarding } from './components/InventoryOnboarding'
-
-function buildNav(config: ResolvedInventoryConfig, view: string, navigate: (v: string) => void, t: (key: string) => string): ModuleNavItem[] {
-  const items: ModuleNavItem[] = [
-    { id: 'dashboard', label: t('inventory.nav.dashboard'), icon: 'BarChart3', active: view === 'dashboard', onClick: () => navigate('dashboard') },
-    ...(config.modules.products ? [{
-      id: 'products', label: t('inventory.nav.products'), icon: 'Package', active: view.startsWith('products'),
-      children: [
-        { id: 'products-new', label: t('inventory.nav.new'), active: view === 'products-new', onClick: () => navigate('products-new') },
-        { id: 'products-list', label: t('inventory.nav.list'), active: view === 'products-list', onClick: () => navigate('products-list') },
-      ],
-    } as ModuleNavItem] : []),
-    {
-      id: 'stock', label: t('inventory.nav.stock'), icon: 'ArrowUpCircle',
-      children: [
-        { id: 'stock-entry', label: t('inventory.nav.entry'), active: view === 'stock-entry', onClick: () => navigate('stock-entry') },
-        { id: 'stock-exit', label: t('inventory.nav.exit'), active: view === 'stock-exit', onClick: () => navigate('stock-exit') },
-        { id: 'stock-history', label: t('inventory.nav.history'), active: view === 'stock-history', onClick: () => navigate('stock-history') },
-      ],
-    },
-  ]
-
-  if (config.modules.recipes) {
-    items.push({
-      id: 'recipes', label: config.labels.recipes, icon: 'BookOpen',
-      children: [
-        { id: 'recipes-list', label: config.labels.recipesList, active: view === 'recipes-list' || view.startsWith('recipes-detail:'), onClick: () => navigate('recipes-list') },
-        { id: 'recipes-new', label: config.labels.recipesNew, active: view === 'recipes-new', onClick: () => navigate('recipes-new') },
-      ],
-    })
-  }
-
-  return items
-}
-
-export function InventoryPage({ config, provider, store, registries }: {
-  config: ResolvedInventoryConfig
-  provider: InventoryDataProvider
-  store: StoreApi<InventoryUIState>
-  registries?: PluginRegistryDef[]
-}) {
-  const t = useTranslation()
-  const { view, direction, navigate } = useModuleNavigation('/inventory', {
-    dashboard: 0,
-    'products-list': 0, 'products-new': 1,
-    'stock-entry': 1, 'stock-exit': 1, 'stock-history': 0,
-    'recipes-list': 0, 'recipes-new': 1, 'recipes-detail': 1,
-    settings: 1,
-  }, 'dashboard')
-
-  const [onboardingComplete, setOnboardingComplete] = useState(() => {
-    try { return localStorage.getItem('saas-core:inventory-onboarded') === 'true' } catch { return false }
-  })
-
-  const isSettings = view === 'settings'
-  const isSummary = view === 'dashboard' || view === ''
-  const nav = buildNav(config, view, navigate, t)
-
-  const quickActions = useMemo<PluginQuickAction[]>(() => {
-    const actions: PluginQuickAction[] = [
-      // Dropped with the catalogue module: offering "new product" while the
-      // screen is gone would dead-end the user.
-      ...(config.modules.products ? [{
-        id: 'new-product',
-        label: t('inventory.quickActions.newProduct'),
-        icon: 'Package',
-        description: t('inventory.quickActions.newProductDesc'),
-        action: () => navigate('products-new'),
-      } as PluginQuickAction] : []),
-      {
-        id: 'stock-entry',
-        label: t('inventory.quickActions.stockEntry'),
-        icon: 'ArrowUpRight',
-        description: t('inventory.quickActions.stockEntryDesc'),
-        action: () => navigate('stock-entry'),
-      },
-      {
-        id: 'stock-exit',
-        label: t('inventory.quickActions.stockExit'),
-        icon: 'ArrowDownRight',
-        description: t('inventory.quickActions.stockExitDesc'),
-        action: () => navigate('stock-exit'),
-      },
-    ]
-    return actions
-  }, [])
-
-  if (!onboardingComplete) {
-    return (
-      <InventoryContextProvider config={config} provider={provider} store={store}>
-        <InventoryOnboarding onComplete={() => { setOnboardingComplete(true); try { localStorage.setItem('saas-core:inventory-onboarded', 'true') } catch {} }} />
-      </InventoryContextProvider>
-    )
-  }
-
-  if (isSettings && registries && registries.length > 0) {
-    return (
-      <InventoryContextProvider config={config} provider={provider} store={store}>
-        <PageTransition transitionKey="settings" direction={direction}>
-          <div style={{ padding: '24px' }}>
-            <div style={{ marginBottom: '16px' }}>
-              <h1 style={{ fontSize: '20px', fontWeight: 600, margin: 0 }}>{t('inventory.settingsPage.title')}</h1>
-              <p style={{ color: 'var(--muted-foreground, #6b7280)', margin: '4px 0 0', fontSize: '14px' }}>
-                {t('inventory.settingsPage.subtitle')}
-              </p>
-            </div>
-            <InventoryGeneralSettings />
-          </div>
-        </PageTransition>
-      </InventoryContextProvider>
-    )
-  }
-
-  const renderView = createViewRouter([
-    // Routes go with the module, not just the nav entry: leaving them mounted
-    // keeps a second product form reachable by URL.
-    ...(config.modules.products ? [
-      { id: 'products-list', render: () => <ProductListView onNew={() => navigate('products-new')} onEdit={(id: string) => navigate(`products-edit:${id}`)} /> },
-      { id: 'products-new', render: () => <ProductCrudForm onSaved={() => navigate('products-list')} /> },
-      { id: 'products-edit', render: ({ id }: { id?: string }) => <ProductCrudForm editId={id!} onSaved={() => navigate('products-list')} /> },
-    ] : []),
-    { id: 'stock-entry', render: () => <StockMovementView defaultType="entry" onSaved={() => navigate('stock-history')} /> },
-    { id: 'stock-exit', render: () => <StockMovementView defaultType="exit" onSaved={() => navigate('stock-history')} /> },
-    { id: 'stock-history', render: () => <MovementHistoryView onViewDetail={(id) => navigate(`stock-detail:${id}`)} /> },
-    { id: 'stock-detail', render: ({ id }) => {
-      const movement = store.getState().movements.find((m) => m.id === id)
-      return movement
-        ? <StockMovementView defaultType={movement.movementType} viewMovement={movement} onSaved={() => navigate('stock-history')} />
-        : <MovementHistoryView onViewDetail={(mid) => navigate(`stock-detail:${mid}`)} />
-    } },
-    { id: 'recipes-list', render: () => <RecipesView onNew={() => navigate('recipes-new')} onView={(id) => navigate(`recipes-detail:${id}`)} /> },
-    { id: 'recipes-new', render: () => <RecipeFormView onSaved={(id) => id ? navigate(`recipes-detail:${id}`) : navigate('recipes-list')} /> },
-    { id: 'recipes-detail', render: ({ id }) => <RecipeDetailView recipeId={id!} onBack={() => navigate('recipes-list')} /> },
-    { id: 'dashboard', render: () => <DashboardView /> },
-  ], 'dashboard')
-
-  return (
-    <InventoryContextProvider config={config} provider={provider} store={store}>
-      <ModulePage
-        title={config.labels.pageTitle}
-        subtitle={config.labels.pageSubtitle}
-        nav={nav}
-        showHeader={isSummary}
-        viewKey={view}
-        direction={direction}
-        headerAction={
-          <ModuleActionBar
-            quickActions={quickActions}
-            settingsPath={registries && registries.length > 0 ? '/settings/inventory' : undefined}
-            settingsLabel="Inventory Settings"
-          />
-        }
-      >
-        {renderView(view)}
-      </ModulePage>
-    </InventoryContextProvider>
-  )
-}

package/src/README.md

@@ -1,177 +0,0 @@
-# Inventory Plugin
-
-Product catalog, stock management, movement tracking, and recipe/production formulas for any SaaS vertical.
-
-## Quick Start
-
-```typescript
-import { createInventoryPlugin } from '@fayz-ai/saas-core/plugins/inventory'
-
-// In your defineSaas config:
-plugins: [
-  createInventoryPlugin({
-    currency: { code: 'BRL', locale: 'pt-BR', symbol: 'R$' },
-  }),
-]
-```
-
-## Configuration
-
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `modules.recipes` | boolean | true | Production recipes/technical specs |
-| `modules.stockLocations` | boolean | true | Multi-location stock |
-| `modules.batchTracking` | boolean | false | Batch numbers + expiry dates |
-| `productTypes` | array | ingredient, sale, intermediate, asset | Available product classifications |
-| `currency` | object | BRL/pt-BR | Currency code, locale, symbol |
-| `locations` | array | [] | Business units (shows unit picker when 1+) |
-| `dataProvider` | InventoryDataProvider | mock | Custom data provider |
-| `navPosition` | number | 4 | Navigation order |
-
-## Architecture
-
-```
-src/plugins/inventory/
-  index.ts                    # createInventoryPlugin() factory
-  types.ts                    # Pure TS domain types (zero deps)
-  registries.ts               # CRUD entities: units, categories, locations
-  store.ts                    # Zustand UI state + provider actions
-  InventoryContext.tsx         # React contexts: config, provider, store
-  InventoryPage.tsx            # Main page with ModulePage layout
-  data/
-    types.ts                  # InventoryDataProvider interface
-    mock.ts                   # In-memory mock provider
-  views/                      # Dashboard, Products, Stock, Recipes
-  components/                 # Settings, onboarding
-  migrations/                 # SQL migration files
-```
-
-### Data Flow
-
-Same pattern as the Financial plugin:
-
-```
-createInventoryPlugin(options)
-  → resolves config
-  → creates provider (mock or custom)
-  → creates zustand store
-  → returns PluginManifest
-
-InventoryPage
-  → InventoryContextProvider wraps all views
-  → useModuleNavigation for view switching + animations
-  → views call useInventoryStore(selector) for data
-```
-
-## Type System
-
-### Product Types
-
-Products are classified by type — a product can be one type at a time:
-
-| Type | Description | Example |
-|------|-------------|---------|
-| `ingredient` | Raw material consumed in production | Hair dye, flour |
-| `sale` | Sold directly to customers | Shampoo bottle, menu item |
-| `intermediate` | Produced internally from ingredients | Pre-mixed color, dough |
-| `asset` | Fixed asset for patrimony tracking | Equipment, furniture |
-
-The `productTypes` option lets verticals customize available types:
-
-```typescript
-// Restaurant — simplified types
-createInventoryPlugin({
-  productTypes: [
-    { value: 'ingredient', label: 'Ingredient' },
-    { value: 'sale', label: 'Menu Item' },
-  ],
-})
-```
-
-### Stock Movements
-
-| Movement Type | Direction | Description |
-|--------------|-----------|-------------|
-| `entry` | +quantity | Receiving goods from supplier |
-| `exit` | -quantity | Using/selling goods |
-| `adjustment` | +/- | Quantity correction after audit |
-| `transfer` | neutral | Between stock locations |
-| `loss` | -quantity | Waste, damage, or expiry |
-
-### Core Entities
-
-| Entity | Purpose |
-|--------|---------|
-| `Product` | Master product with type, pricing, stock levels |
-| `StockMovement` | Transaction log: entries, exits, adjustments |
-| `StockPosition` | Physical inventory by location + batch + expiry |
-| `StockLocation` | Warehouses, storage areas |
-| `Recipe` | Production formula for intermediate/final products |
-| `RecipeIngredient` | What goes into a recipe |
-| `MeasurementUnit` | Units of measure (kg, L, unit, box) |
-| `ProductCategory` | Hierarchical product organization |
-
-## Registries (Plugin Settings)
-
-Accessible via gear icon or global Settings > Inventory tab:
-
-| Registry | Seed Data |
-|----------|-----------|
-| Measurement Units | Unit, Box, Kg, g, L, mL |
-| Product Categories | — |
-| Stock Locations | — |
-
-## Database Migrations
-
-Run in order:
-
-1. `001_inventory_base.sql` — product_categories, stock_locations, products, stock_movements, stock_positions
-2. `002_recipes.sql` — recipes, recipe_ingredients
-3. `003_measurement_units.sql` — measurement_units
-
-All tables use `tenant_id` for multi-tenant isolation.
-
-## Views
-
-| View | Route suffix | Description |
-|------|-------------|-------------|
-| Dashboard | `/inventory` | KPIs: total products, low stock, stock value |
-| Products List | `/inventory/products/list` | Filterable by type |
-| Products New | `/inventory/products/new` | Create product |
-| Stock Entry | `/inventory/stock/entry` | Record goods received |
-| Stock Exit | `/inventory/stock/exit` | Record goods consumed |
-| Stock History | `/inventory/stock/history` | Movement log |
-| Recipes | `/inventory/recipes/list` | Production formulas |
-| Settings | `/inventory/settings/*` | Registry management |
-
-## Extending
-
-### Custom Data Provider
-
-```typescript
-import type { InventoryDataProvider } from '@fayz-ai/saas-core/plugins/inventory'
-
-const supabaseProvider: InventoryDataProvider = {
-  async getProducts(query) { /* Supabase query */ },
-  async createMovement(input) { /* Supabase insert + trigger */ },
-  // ... implement all methods
-}
-
-createInventoryPlugin({ dataProvider: supabaseProvider })
-```
-
-### Future: Unit Conversion System
-
-The types support multi-unit products (base unit, content unit, purchase unit) following the beautyplace pattern. Example:
-
-```
-Shampoo bottle (base: UNIT)
-  - Content: 300mL per unit
-  - Purchase: BOX of 12 units
-```
-
-This will be implemented when the Supabase provider is built.
-
-### Future: DANFE/NF-e Import
-
-Invoice XML import for automatic stock entry — will be added as a sub-module.

package/src/components/InventoryGeneralSettings.tsx

@@ -1,39 +0,0 @@
-import React from 'react'
-import { SettingsGroup, ToggleRow, useTenantPluginSettings } from '@fayz-ai/saas'
-import { useTranslation } from '@fayz-ai/core'
-
-// Per-tenant defaults = the values that used to be hardcoded here. Persisted +
-// re-hydrated per tenant; behavioural consumption is a follow-up.
-const INVENTORY_DEFAULTS = {
-  lowStockAlerts: true,
-  requireReason: true,
-  autoDeduct: false,
-  requireSku: false,
-  allowNegative: false,
-  lowStockEmail: false,
-  expiryWarnings: true,
-}
-
-export function InventoryGeneralSettings() {
-  const t = useTranslation()
-  const s = useTenantPluginSettings('inventory', INVENTORY_DEFAULTS)
-  return (
-    <div className="space-y-4">
-      <SettingsGroup title={t('inventory.settings.stockManagement')} description={t('inventory.settings.stockManagementDesc')}>
-        <ToggleRow label={t('inventory.settings.lowStockAlerts')} description={t('inventory.settings.lowStockAlertsDesc')} checked={s.get('lowStockAlerts')} onChange={(v) => s.set('lowStockAlerts', v)} />
-        <ToggleRow label={t('inventory.settings.requireReason')} description={t('inventory.settings.requireReasonDesc')} checked={s.get('requireReason')} onChange={(v) => s.set('requireReason', v)} />
-        <ToggleRow label={t('inventory.settings.autoDeduct')} description={t('inventory.settings.autoDeductDesc')} checked={s.get('autoDeduct')} onChange={(v) => s.set('autoDeduct', v)} />
-      </SettingsGroup>
-
-      <SettingsGroup title={t('inventory.settings.products')} description={t('inventory.settings.productsDesc')}>
-        <ToggleRow label={t('inventory.settings.requireSku')} description={t('inventory.settings.requireSkuDesc')} checked={s.get('requireSku')} onChange={(v) => s.set('requireSku', v)} />
-        <ToggleRow label={t('inventory.settings.allowNegative')} description={t('inventory.settings.allowNegativeDesc')} checked={s.get('allowNegative')} onChange={(v) => s.set('allowNegative', v)} />
-      </SettingsGroup>
-
-      <SettingsGroup title={t('inventory.settings.notifications')} description={t('inventory.settings.notificationsDesc')}>
-        <ToggleRow label={t('inventory.settings.lowStockEmail')} description={t('inventory.settings.lowStockEmailDesc')} checked={s.get('lowStockEmail')} onChange={(v) => s.set('lowStockEmail', v)} />
-        <ToggleRow label={t('inventory.settings.expiryWarnings')} description={t('inventory.settings.expiryWarningsDesc')} checked={s.get('expiryWarnings')} onChange={(v) => s.set('expiryWarnings', v)} />
-      </SettingsGroup>
-    </div>
-  )
-}

package/src/components/InventoryOnboarding.tsx

@@ -1,60 +0,0 @@
-import React, { useState } from 'react'
-import { Package, Ruler, MapPin, ChevronRight, Check } from 'lucide-react'
-import { useTranslation } from '@fayz-ai/core'
-import { Button } from '@fayz-ai/ui'
-
-const STEPS = [
-  { id: 'welcome', icon: Package, titleKey: 'inventory.onboarding.welcome', descKey: 'inventory.onboarding.description' },
-  { id: 'units', icon: Ruler, titleKey: 'inventory.onboarding.units.title', descKey: 'inventory.onboarding.units.description' },
-  { id: 'locations', icon: MapPin, titleKey: 'inventory.onboarding.locations.title', descKey: 'inventory.onboarding.locations.description' },
-]
-
-export function InventoryOnboarding({ onComplete }: { onComplete: () => void }) {
-  const t = useTranslation()
-  const [step, setStep] = useState(0)
-  const current = STEPS[step]
-  const isLast = step === STEPS.length - 1
-  const Icon = current.icon
-
-  return (
-    <div className="flex items-center justify-center py-12">
-      <div className="w-full max-w-lg">
-        <div className="flex items-center gap-1 mb-8">
-          {STEPS.map((_, i) => (
-            <div key={i} className={`h-1 flex-1 rounded-full transition-colors ${i <= step ? 'bg-primary' : 'bg-muted'}`} />
-          ))}
-        </div>
-        <div className="rounded-card border bg-card p-8 text-center space-y-6 shadow-sm">
-          <div className="flex justify-center">
-            <div className="flex h-16 w-16 items-center justify-center rounded-2xl bg-primary/10">
-              <Icon className="h-8 w-8 text-primary" />
-            </div>
-          </div>
-          <div>
-            <h2 className="text-xl font-bold">{t(current.titleKey)}</h2>
-            <p className="text-sm text-muted-foreground mt-2 max-w-sm mx-auto">{t(current.descKey)}</p>
-          </div>
-          <div className="flex items-center justify-center gap-3 pt-2">
-            {step > 0 && (
-              <Button variant="outline" size="lg" onClick={() => setStep(step - 1)}>{t('common.back')}</Button>
-            )}
-            {isLast ? (
-              <Button variant="default" size="lg" onClick={onComplete}>
-                <Check className="h-4 w-4" /> {t('inventory.onboarding.start')}
-              </Button>
-            ) : (
-              <Button variant="default" size="lg" onClick={() => setStep(step + 1)}>
-                {step === 0 ? t('inventory.onboarding.getStarted') : t('common.continue')} <ChevronRight className="h-4 w-4" />
-              </Button>
-            )}
-          </div>
-          {step === 0 && (
-            <button onClick={onComplete} className="text-xs text-muted-foreground hover:text-foreground transition-colors">
-              {t('inventory.onboarding.skip')}
-            </button>
-          )}
-        </div>
-      </div>
-    </div>
-  )
-}

package/src/components/InventorySettings.tsx

@@ -1,27 +0,0 @@
-import React from 'react'
-import { ChevronLeft } from 'lucide-react'
-import { PluginRegistryManager } from '@fayz-ai/saas'
-import type { PluginRegistryDef } from '@fayz-ai/core'
-import { useTranslation } from '@fayz-ai/core'
-
-export function InventorySettings({ registries, routeBase, onClose }: {
-  registries: PluginRegistryDef[]
-  routeBase: string
-  onClose: () => void
-}) {
-  const t = useTranslation()
-  return (
-    <div className="space-y-4">
-      <div className="flex items-center gap-3">
-        <button onClick={onClose} className="flex h-8 w-8 items-center justify-center rounded-lg border hover:bg-muted bg-card shadow-button active:shadow-button-inset transition-colors">
-          <ChevronLeft className="h-4 w-4" />
-        </button>
-        <div>
-          <h2 className="text-lg font-bold">{t('inventory.settingsPage.title')}</h2>
-          <p className="text-xs text-muted-foreground">{t('inventory.settingsPage.subtitle')}</p>
-        </div>
-      </div>
-      <PluginRegistryManager registries={registries} routeBase={routeBase} />
-    </div>
-  )
-}

package/src/data/index.ts

@@ -1,2 +0,0 @@
-export type { InventoryDataProvider } from './types'
-export { createMockInventoryProvider } from './mock'