@lambda-development/erp-core 0.1.0

package/dist/lib/branding.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Branding / theme configuration.
+ *
+ * The visual theme is already CSS-variable based (see index.css `:root`
+ * tokens, surfaced to Tailwind as `brand`, `surface`, `fg`, `line`, …). A
+ * customer deployment built on the published library rebrands by calling
+ * `configureBranding` at startup: override the product name, point at a logo,
+ * and/or override any of the `:root` design tokens at runtime.
+ *
+ * For deeper restyling the customer's own Tailwind build (which scans this
+ * package — the "consumer scans source" model) can add utilities freely; this
+ * helper covers the common case of swapping name/logo/colors without a custom
+ * stylesheet.
+ */
+export interface Branding {
+    /** Product name — used for the document title and as the sidebar fallback. */
+    appName: string;
+    /** Optional logo URL (falls back to the core CSS-mask logo when unset). */
+    logoUrl?: string;
+    /**
+     * CSS custom properties to set on :root, e.g. { "--brand": "260 80% 55%" }.
+     * The leading "--" is optional. Values follow the token format in index.css
+     * (HSL channel triplets for color tokens).
+     */
+    tokens?: Record<string, string>;
+}
+export declare function configureBranding(next: Partial<Branding>): void;
+export declare function getBranding(): Branding;

package/dist/lib/component-registry.d.ts

@@ -0,0 +1,4 @@
+import { ComponentType } from 'react';
+export declare function registerComponent(name: string, component: ComponentType<any>): void;
+/** Resolve a registered override, falling back to the core default. */
+export declare function getComponent<P>(name: string, fallback: ComponentType<P>): ComponentType<P>;

package/dist/lib/doctypes.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Doctype metadata registry.
+ *
+ * This drives the generic list and form pages. Instead of coding 8 separate
+ * pages, a single registry defines the fields, columns, and actions for each
+ * document type.
+ */
+export interface FieldDef {
+    name: string;
+    label: string;
+    type: "text" | "number" | "currency" | "date" | "link" | "select" | "textarea";
+    required?: boolean;
+    readOnly?: boolean;
+    linkDoctype?: string;
+    linkDoctypeField?: string;
+    options?: Array<string | {
+        value: string;
+        label: string;
+    }>;
+    optionsSource?: "currency";
+    default?: any;
+    hint?: string;
+}
+export interface ChildTableDef {
+    label: string;
+    key: string;
+    fields: FieldDef[];
+}
+export interface ConversionDef {
+    label: string;
+    targetDoctype: string;
+}
+export interface DoctypeConfig {
+    slug: string;
+    label: string;
+    dateField: string;
+    partyField?: string;
+    partyLabel?: string;
+    amountField?: string;
+    fields: FieldDef[];
+    childTables: ChildTableDef[];
+    listColumns: string[];
+    canSubmit: boolean;
+    canCancel: boolean;
+    conversions: ConversionDef[];
+}
+export declare function getDoctypeConfig(slug: string): DoctypeConfig | undefined;
+/**
+ * Register (or override) a doctype config. A customer deployment built on the
+ * published library calls this at startup to add a new document type or swap
+ * the form/list schema of a core one. The list/form pages read CONFIGS live
+ * via getDoctypeConfig, so a registration takes effect immediately.
+ */
+export declare function registerDoctype(config: DoctypeConfig): void;
+export declare function getAllDoctypeConfigs(): DoctypeConfig[];
+export declare const DOCTYPE_SLUGS: string[];

package/dist/lib/nav.d.ts

@@ -0,0 +1,21 @@
+import { ReactNode } from 'react';
+export interface NavItem {
+    label: string;
+    path: string;
+}
+export interface NavGroup {
+    label: string;
+    icon: ReactNode;
+    items: NavItem[];
+}
+/** Live list the sidebar renders from. */
+export declare function getNavGroups(): NavGroup[];
+/**
+ * Add a nav group, or replace an existing one with the same label. Pass
+ * `index` to control placement (default: appended at the end).
+ */
+export declare function registerNavGroup(group: NavGroup, opts?: {
+    index?: number;
+}): void;
+/** Append an item to an existing group (creating the group if absent). */
+export declare function registerNavItem(groupLabel: string, item: NavItem): void;

package/dist/lib/utils.d.ts

@@ -0,0 +1,10 @@
+/** Merge class names (simplified clsx). */
+export declare function cn(...classes: (string | false | null | undefined)[]): string;
+/** Format a number as currency. */
+export declare function formatCurrency(value: number | null | undefined, currency?: string): string;
+/** Format a number with commas. */
+export declare function formatNumber(value: number | null | undefined, decimals?: number): string;
+/** Format a date string for display. */
+export declare function formatDate(value: string | null | undefined): string;
+/** Safely parse a float, defaulting to 0. */
+export declare function flt(value: unknown, precision?: number): number;

package/dist/pages/admin/settings.d.ts

@@ -0,0 +1 @@
+export default function SettingsPage(): import("react/jsx-runtime").JSX.Element;

package/dist/pages/admin/users.d.ts

@@ -0,0 +1 @@
+export default function UsersPage(): import("react/jsx-runtime").JSX.Element;

package/dist/pages/chat.d.ts

@@ -0,0 +1 @@
+export default function ChatPage(): import("react/jsx-runtime").JSX.Element;

package/dist/pages/dashboard.d.ts

@@ -0,0 +1 @@
+export default function DashboardPage(): import("react/jsx-runtime").JSX.Element;

package/dist/pages/demo.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Shareable entry point that mirrors the "Enter Live Demo" button on /login.
+ * Creates a fresh chat session (as the public_manager fallback user if the
+ * visitor has no cookie) and redirects to /chat/{id}?demo=1 for replay.
+ */
+export default function DemoPage(): import("react/jsx-runtime").JSX.Element;

package/dist/pages/documents/document-form.d.ts

@@ -0,0 +1,2 @@
+export declare function linkRefHref(linkDoctype: string | undefined | null, value: string): string | null;
+export default function DocumentFormPage(): import("react/jsx-runtime").JSX.Element;

package/dist/pages/documents/document-list.d.ts

@@ -0,0 +1 @@
+export default function DocumentListPage(): import("react/jsx-runtime").JSX.Element;

package/dist/pages/login.d.ts

@@ -0,0 +1 @@
+export default function LoginPage(): import("react/jsx-runtime").JSX.Element;

package/dist/pages/masters/master-form.d.ts

@@ -0,0 +1 @@
+export default function MasterFormPage(): import("react/jsx-runtime").JSX.Element;

package/dist/pages/masters/master-list.d.ts

@@ -0,0 +1 @@
+export default function MasterListPage(): import("react/jsx-runtime").JSX.Element;

package/dist/pages/opening-balances.d.ts

@@ -0,0 +1 @@
+export default function OpeningBalancesPage(): import("react/jsx-runtime").JSX.Element;

package/dist/pages/reports/analytics.d.ts

@@ -0,0 +1 @@
+export default function AnalyticsPage(): import("react/jsx-runtime").JSX.Element;

package/dist/pages/reports/ap-aging.d.ts

@@ -0,0 +1 @@
+export default function ApAgingPage(): import("react/jsx-runtime").JSX.Element;

package/dist/pages/reports/ar-aging.d.ts

@@ -0,0 +1 @@
+export default function ArAgingPage(): import("react/jsx-runtime").JSX.Element;

package/dist/pages/reports/balance-sheet.d.ts

@@ -0,0 +1 @@
+export default function BalanceSheetPage(): import("react/jsx-runtime").JSX.Element;

package/dist/pages/reports/general-ledger.d.ts

@@ -0,0 +1 @@
+export default function GeneralLedgerPage(): import("react/jsx-runtime").JSX.Element;

package/dist/pages/reports/profit-loss.d.ts

@@ -0,0 +1 @@
+export default function ProfitLossPage(): import("react/jsx-runtime").JSX.Element;

package/dist/pages/reports/stock-balance.d.ts

@@ -0,0 +1 @@
+export default function StockBalancePage(): import("react/jsx-runtime").JSX.Element;

package/dist/pages/reports/trial-balance.d.ts

@@ -0,0 +1 @@
+export default function TrialBalancePage(): import("react/jsx-runtime").JSX.Element;

package/dist/pages/setup.d.ts

@@ -0,0 +1 @@
+export default function SetupPage(): import("react/jsx-runtime").JSX.Element;

package/dist/pages/tutorial.d.ts

@@ -0,0 +1 @@
+export default function TutorialPage(): import("react/jsx-runtime").JSX.Element;

package/dist/routes.d.ts

@@ -0,0 +1,19 @@
+import { RouteObject } from 'react-router-dom';
+/**
+ * Register a route from a customer deployment.
+ *  - area "app" (default): added under the protected app shell (sidebar +
+ *    header), so it's an authenticated page like the core ones.
+ *  - area "top": added at the root (e.g. a public/unauthenticated page).
+ *
+ * A registered route whose `path` (or index) matches a core route replaces
+ * it — that's how you override a core page wholesale.
+ */
+export declare function registerRoute(route: RouteObject, opts?: {
+    area?: "app" | "top";
+}): void;
+/**
+ * Build the full route table, merging any customer-registered routes over the
+ * core ones. Call this when constructing the router (the demo does so via
+ * bootstrap) — after plugins have registered, so overrides take effect.
+ */
+export declare function buildRoutes(): RouteObject[];

package/dist/workers/report-runtime.worker.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@lambda-development/erp-core",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./styles.css": "./src/index.css",
+    "./tailwind-preset": "./tailwind.preset.ts"
+  },
+  "files": [
+    "dist",
+    "src/index.css",
+    "tailwind.preset.ts"
+  ],
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -b && vite build",
+    "build:lib": "vite build --config vite.lib.config.ts",
+    "preview": "vite preview"
+  },
+  "peerDependencies": {
+    "@tanstack/react-query": "^5.60.0",
+    "@tanstack/react-table": "^8.20.0",
+    "i18next": "^26.2.0",
+    "lucide-react": "^0.460.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "react-i18next": "^17.0.8",
+    "react-router-dom": "^7.0.0",
+    "recharts": "^3.8.1"
+  },
+  "devDependencies": {
+    "@tanstack/react-query": "^5.60.0",
+    "@tanstack/react-table": "^8.20.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@vitejs/plugin-react": "^4.3.0",
+    "autoprefixer": "^10.4.20",
+    "i18next": "^26.2.0",
+    "lucide-react": "^0.460.0",
+    "postcss": "^8.4.49",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "react-i18next": "^17.0.8",
+    "react-router-dom": "^7.0.0",
+    "recharts": "^3.8.1",
+    "tailwindcss": "^3.4.0",
+    "typescript": "~5.6.0",
+    "vite": "^6.0.0",
+    "vite-plugin-dts": "^4.3.0"
+  }
+}

package/src/index.css

@@ -0,0 +1,105 @@
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+
+/* ───────────────────────────────────────────────────────────────────
+   Design tokens. Values are space-separated HSL components so they
+   plug into Tailwind via `hsl(var(--token) / <alpha-value>)` and
+   support opacity modifiers like `bg-brand/90`.
+
+   Anchored to the Lambda logo gradient: brand sits between the cyan
+   (#66D4FF) and pink (#ff6eb4) gradient stops.
+   ─────────────────────────────────────────────────────────────────── */
+:root {
+  /* Brand */
+  --brand: 220 78% 57%;          /* ≈ #2f6ff0 — saturated cobalt blue */
+  --brand-fg: 0 0% 100%;
+
+  /* Surfaces */
+  --surface: 0 0% 100%;          /* primary card / panel */
+  --surface-muted: 220 14% 98%;  /* page background — slightly cooler than white */
+  --surface-subtle: 220 14% 96%; /* hovered rows, secondary cards, sidebar active */
+
+  /* Lines & text */
+  --border: 220 13% 91%;
+  --text: 222 47% 11%;
+  --text-muted: 220 9% 46%;
+}
+
+@layer base {
+  body {
+    /* `bg-surface-muted` and `text-fg` are the new defaults but applying
+       them at the body level avoids touching every page component on
+       day 1. Tailwind's `bg-gray-50` on <body> is replaced here. */
+    @apply bg-surface-muted text-fg antialiased;
+    font-feature-settings: "cv02", "cv03", "cv04", "cv11"; /* Inter polish */
+  }
+
+  /* Fluid easing app-wide. Hover/transition properties feel less
+     mechanical with this curve. */
+  * {
+    transition-timing-function: cubic-bezier(0.16, 1, 0.3, 1);
+  }
+}
+
+/* iOS Safari auto-zooms when a focused input/textarea has font-size
+   below 16px and doesn't zoom back out, making the whole page feel
+   broken after the keyboard closes. 16px is the minimum that
+   suppresses it. !important is needed because most of our inputs
+   use Tailwind's `text-sm` (14px), which is a class selector and
+   beats a plain element selector on specificity. Mobile-only — desktop
+   keeps its 14px. */
+@media (max-width: 768px) {
+  input,
+  textarea,
+  select {
+    font-size: 16px !important;
+  }
+}
+
+/* Sidebar Lambda ERP logo — PNG silhouette used as a mask with an animated
+   multi-colour gradient showing through. */
+.lambda-logo-icon {
+  width: 70px;
+  height: 15px;
+  flex-shrink: 0;
+  background: linear-gradient(135deg, #cbd5e1, #b0bacb, #c2ccd8, #94a3b8, #cbd5e1);
+  background-size: 300% 300%;
+  animation: lambda-logo-gradient 12s ease infinite;
+  -webkit-mask-image: url('/logo_lad_erp.png');
+  -webkit-mask-size: contain;
+  -webkit-mask-repeat: no-repeat;
+  -webkit-mask-position: center;
+  mask-image: url('/logo_lad_erp.png');
+  mask-size: contain;
+  mask-repeat: no-repeat;
+  mask-position: center;
+}
+
+@keyframes lambda-logo-gradient {
+  0%   { background-position: 0% 50%; }
+  50%  { background-position: 100% 50%; }
+  100% { background-position: 0% 50%; }
+}
+
+/* Thin, Claude.ai-style scrollbar applied app-wide. Firefox honours
+   `scrollbar-width` / `scrollbar-color`; Chromium/Safari need the
+   `::-webkit-scrollbar-*` pseudo-elements to match. */
+* {
+  scrollbar-width: thin;
+  scrollbar-color: rgba(31, 31, 30, 0.35) transparent;
+}
+*::-webkit-scrollbar {
+  width: 8px;
+  height: 8px;
+}
+*::-webkit-scrollbar-track {
+  background: transparent;
+}
+*::-webkit-scrollbar-thumb {
+  background-color: rgba(31, 31, 30, 0.35);
+  border-radius: 4px;
+}
+*::-webkit-scrollbar-thumb:hover {
+  background-color: rgba(31, 31, 30, 0.5);
+}

package/tailwind.preset.ts

@@ -0,0 +1,70 @@
+import type { Config } from "tailwindcss";
+
+// Shared Tailwind theme for the ERP core, published as a preset so the demo
+// app and any customer deployment get identical design tokens. Add it with
+// `presets: [erpPreset]` in tailwind.config. Colours are backed by the CSS
+// variables defined in src/index.css (shipped as `@lambda-development/erp-core/styles.css`)
+// — rebrand by overriding those variables, not by editing this preset.
+const preset: Partial<Config> = {
+  theme: {
+    extend: {
+      // Token-backed colours. Values come from CSS variables in index.css,
+      // which means swapping themes (e.g. dark mode later) means changing
+      // the variables, not editing every component.
+      //
+      // Using `hsl(var(--x) / <alpha-value>)` lets Tailwind opacity
+      // modifiers work: `bg-brand/90`, `text-fg-muted/70`, etc.
+      colors: {
+        brand: {
+          DEFAULT: "hsl(var(--brand) / <alpha-value>)",
+          fg: "hsl(var(--brand-fg) / <alpha-value>)",
+        },
+        surface: {
+          DEFAULT: "hsl(var(--surface) / <alpha-value>)",
+          muted: "hsl(var(--surface-muted) / <alpha-value>)",
+          subtle: "hsl(var(--surface-subtle) / <alpha-value>)",
+        },
+        fg: {
+          DEFAULT: "hsl(var(--text) / <alpha-value>)",
+          muted: "hsl(var(--text-muted) / <alpha-value>)",
+        },
+        line: "hsl(var(--border) / <alpha-value>)",
+      },
+      fontFamily: {
+        sans: [
+          "Inter",
+          "system-ui",
+          "-apple-system",
+          "Segoe UI",
+          "Roboto",
+          "sans-serif",
+        ],
+      },
+      boxShadow: {
+        // Multi-layer soft shadows — closer in feel to Linear / Vercel
+        // than Tailwind's default. The card-hover variant is for
+        // interactive cards (hover, focus-within).
+        card: "0 1px 2px rgba(0,0,0,0.04), 0 4px 12px rgba(0,0,0,0.03)",
+        "card-hover": "0 1px 2px rgba(0,0,0,0.05), 0 8px 24px rgba(0,0,0,0.05)",
+        // Subtle inset highlight for primary buttons — gives the
+        // top edge a 1px lift that's almost invisible but reads as depth.
+        "button-highlight": "inset 0 1px 0 rgba(255,255,255,0.16)",
+        // Saturated colored surfaces (user chat bubble, brand CTAs) need
+        // a different shadow recipe than neutral cards: a black drop
+        // shadow alone barely registers on a vivid purple. Combining
+        //   1) a 1px inset top highlight   — reads as polished glass,
+        //   2) a tight dark drop           — defines the bubble edge,
+        //   3) a soft brand-tinted glow    — makes the bubble feel like
+        //      it's casting its own colour onto the page (kept subtle),
+        // gives the bubble physical presence without looking gimmicky.
+        "bubble-user": [
+          "inset 0 1px 0 rgba(255,255,255,0.22)",
+          "0 1px 2px rgba(0,0,0,0.05)",
+          "0 3px 8px -2px hsl(var(--brand) / 0.18)",
+        ].join(", "),
+      },
+    },
+  },
+};
+
+export default preset;