@framework-m/desk 0.4.2

package/dist/views/types.d.ts

@@ -0,0 +1,97 @@
+import { ComponentType } from 'react';
+/**
+ * Supported view types
+ */
+export type ViewType = "list" | "kanban" | "calendar" | "gantt" | "tree";
+/**
+ * Common view props
+ */
+export interface ViewProps {
+    /** DocType/resource name */
+    resource: string;
+    /** JSON Schema for the DocType */
+    schema?: Record<string, unknown>;
+    /** Optional extra props */
+    [key: string]: unknown;
+}
+/**
+ * View registration
+ */
+export interface ViewRegistration {
+    /** View type identifier */
+    type: ViewType;
+    /** Display label */
+    label: string;
+    /** View component */
+    component: ComponentType<ViewProps>;
+    /** Icon (emoji or component) */
+    icon?: string;
+}
+/**
+ * Kanban config
+ */
+export interface KanbanConfig {
+    /** Field to group by (status field) */
+    groupField: string;
+    /** Column definitions */
+    columns: KanbanColumn[];
+    /** Card title field */
+    titleField?: string;
+    /** Card description field */
+    descriptionField?: string;
+}
+export interface KanbanColumn {
+    /** Column ID (status value) */
+    id: string;
+    /** Display title */
+    title: string;
+    /** Column color */
+    color?: string;
+}
+/**
+ * Calendar config
+ */
+export interface CalendarConfig {
+    /** Start date field */
+    startField: string;
+    /** End date field (optional) */
+    endField?: string;
+    /** Event title field */
+    titleField: string;
+    /** Color field (optional) */
+    colorField?: string;
+}
+/**
+ * Tree view config
+ * Used by DocTypes with a parent_field (e.g., Territory, Account chart)
+ */
+export interface TreeConfig {
+    /** Backend field that links to parent node ID */
+    parentField: string;
+    /** Field used as the display label */
+    labelField: string;
+    /** Optional sort order field (e.g., lft for nested sets) */
+    orderField?: string;
+    /** Whether to allow drag-and-drop reparenting */
+    allowReparent?: boolean;
+    /** Whether to allow inline Add Child */
+    allowAddChild?: boolean;
+    /** Whether to allow inline Rename */
+    allowRename?: boolean;
+}
+/**
+ * Gantt config
+ */
+export interface GanttConfig {
+    /** Task name field */
+    nameField: string;
+    /** Start date field */
+    startField: string;
+    /** End date field */
+    endField: string;
+    /** Progress field (0-100) */
+    progressField?: string;
+    /** Parent task field for hierarchy */
+    parentField?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/views/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,2BAA2B;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2BAA2B;IAC3B,IAAI,EAAE,QAAQ,CAAC;IACf,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,SAAS,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACpC,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,uBAAuB;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,wCAAwC;IACxC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qCAAqC;IACrC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/workspace/WorkspaceSection.d.ts

@@ -0,0 +1,16 @@
+import { DeskWorkspace } from './types';
+/**
+ * WorkspaceSection props
+ */
+export interface WorkspaceSectionProps {
+    /** Workspace to render */
+    workspace: DeskWorkspace;
+    /** Whether collapsed */
+    collapsed?: boolean;
+}
+/**
+ * WorkspaceSection Component
+ */
+export declare function WorkspaceSection({ workspace, collapsed }: WorkspaceSectionProps): import("react/jsx-runtime").JSX.Element;
+export default WorkspaceSection;
+//# sourceMappingURL=WorkspaceSection.d.ts.map

package/dist/workspace/WorkspaceSection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkspaceSection.d.ts","sourceRoot":"","sources":["../../src/workspace/WorkspaceSection.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAiB,MAAM,SAAS,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,0BAA0B;IAC1B,SAAS,EAAE,aAAa,CAAC;IACzB,wBAAwB;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,SAAS,EAAE,SAAiB,EAAE,EAAE,qBAAqB,2CAmFvF;AAED,eAAe,gBAAgB,CAAC"}

package/dist/workspace/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Workspace Module
+ *
+ * Desk Workspace navigation configuration.
+ * Per checklist 6.4: Desk Workspace Configuration.
+ */
+export type { DeskWorkspace, WorkspaceItem, Shortcut, Link, Chart, WorkspaceResponse, } from './types';
+export { useWorkspaces } from './useWorkspaces';
+export type { UseWorkspacesOptions, UseWorkspacesResult } from './useWorkspaces';
+export { WorkspaceSection } from './WorkspaceSection';
+export type { WorkspaceSectionProps } from './WorkspaceSection';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workspace/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,aAAa,EACb,aAAa,EACb,QAAQ,EACR,IAAI,EACJ,KAAK,EACL,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAGjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/workspace/types.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Desk Workspace Types
+ *
+ * Types for Desk Workspace navigation configuration.
+ * Per checklist 6.4: Desk Workspace Configuration.
+ *
+ * Terminology:
+ * - Desk Workspace = End-user navigation groupings in sidebar
+ * - NOT Studio Workspace (which is the Git monorepo)
+ */
+/**
+ * Shortcut item - quick link to a DocType
+ */
+export interface Shortcut {
+    type: "shortcut";
+    /** Display label */
+    label: string;
+    /** DocType/resource name */
+    doctype: string;
+    /** Icon (emoji or component name) */
+    icon?: string;
+    /** Optional color */
+    color?: string;
+    /** Open in new tab */
+    newTab?: boolean;
+}
+/**
+ * Link item - external or custom URL
+ */
+export interface Link {
+    type: "link";
+    /** Display label */
+    label: string;
+    /** URL to navigate to */
+    url: string;
+    /** Icon (emoji or component name) */
+    icon?: string;
+    /** Open in new tab */
+    newTab?: boolean;
+}
+/**
+ * Chart item - dashboard widget
+ */
+export interface Chart {
+    type: "chart";
+    /** Display label */
+    label: string;
+    /** Chart type */
+    chartType: "number" | "line" | "bar" | "pie" | "donut";
+    /** Data source (resource name or report) */
+    source: string;
+    /** Field to aggregate */
+    field?: string;
+    /** Aggregation method */
+    aggregate?: "count" | "sum" | "avg";
+    /** Filter conditions */
+    filters?: Record<string, unknown>;
+    /** Chart color */
+    color?: string;
+}
+/**
+ * Workspace item - union of all item types
+ */
+export type WorkspaceItem = Shortcut | Link | Chart;
+/**
+ * Desk Workspace definition
+ */
+export interface DeskWorkspace {
+    /** Unique identifier */
+    name: string;
+    /** Display name in sidebar */
+    label: string;
+    /** Sidebar icon (emoji or component name) */
+    icon: string;
+    /** Workspace contents */
+    items: WorkspaceItem[];
+    /** Roles that can see this workspace (empty = all) */
+    roles: string[];
+    /** Sort order in sidebar */
+    sequence?: number;
+    /** Custom color */
+    color?: string;
+    /** Whether workspace is hidden */
+    hidden?: boolean;
+}
+/**
+ * Workspace API response
+ */
+export interface WorkspaceResponse {
+    /** List of workspaces */
+    workspaces: DeskWorkspace[];
+    /** User's roles (for client-side filtering) */
+    userRoles?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/workspace/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/workspace/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,UAAU,CAAC;IACjB,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB;IACjB,SAAS,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,CAAC;IACvD,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,SAAS,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,KAAK,CAAC;IACpC,wBAAwB;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,IAAI,GAAG,KAAK,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,sDAAsD;IACtD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yBAAyB;IACzB,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB"}

package/dist/workspace/useWorkspaces.d.ts

@@ -0,0 +1,38 @@
+import { DeskWorkspace } from './types';
+/**
+ * Hook options
+ */
+export interface UseWorkspacesOptions {
+    /** Whether to filter by user roles (default: true) */
+    filterByRoles?: boolean;
+}
+/**
+ * Hook return type
+ */
+export interface UseWorkspacesResult {
+    /** List of workspaces */
+    workspaces: DeskWorkspace[];
+    /** Whether loading */
+    isLoading: boolean;
+    /** Error message */
+    error: string | null;
+    /** Refetch workspaces */
+    refetch: () => void;
+}
+/**
+ * useWorkspaces Hook
+ *
+ * Fetches workspaces from /api/meta/workspaces and filters by user roles.
+ *
+ * @example
+ * ```tsx
+ * const { workspaces, isLoading } = useWorkspaces();
+ *
+ * // In sidebar
+ * {workspaces.map(ws => (
+ *   <WorkspaceSection key={ws.name} workspace={ws} />
+ * ))}
+ * ```
+ */
+export declare function useWorkspaces({ filterByRoles }?: UseWorkspacesOptions): UseWorkspacesResult;
+//# sourceMappingURL=useWorkspaces.d.ts.map

package/dist/workspace/useWorkspaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkspaces.d.ts","sourceRoot":"","sources":["../../src/workspace/useWorkspaces.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAqB,MAAM,SAAS,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,sDAAsD;IACtD,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,yBAAyB;IACzB,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,sBAAsB;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,oBAAoB;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,yBAAyB;IACzB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAUD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,EAAE,aAAoB,EAAE,GAAE,oBAAyB,GAAG,mBAAmB,CA4EtG"}

package/package.json

@@ -0,0 +1,89 @@
+{
+  "name": "@framework-m/desk",
+  "version": "0.4.2",
+  "description": "Business components, hooks, views, and providers for Framework M applications",
+  "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"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "framework-m",
+    "refine",
+    "data-provider",
+    "auth-provider",
+    "live-provider",
+    "desk",
+    "erp"
+  ],
+  "author": "Framework M Team",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.com/framework-m/framework-m.git",
+    "directory": "libs/framework-m-desk"
+  },
+  "dependencies": {
+    "@framework-m/ui": "^0.1.0"
+  },
+  "peerDependencies": {
+    "@refinedev/core": "^5.0.0",
+    "@refinedev/react-table": "^6.0.0",
+    "@rjsf/core": "^6.0.0",
+    "@rjsf/utils": "^6.0.0",
+    "@rjsf/validator-ajv8": "^6.0.0",
+    "@tanstack/react-table": "^8.0.0",
+    "i18next": "^25.0.0",
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0",
+    "react-i18next": "^16.0.0",
+    "react-router": "^7.0.0"
+  },
+  "devDependencies": {
+    "@refinedev/core": "^5.0.10",
+    "@refinedev/react-table": "^6.0.1",
+    "@rjsf/core": "^6.4.1",
+    "@rjsf/utils": "^6.4.1",
+    "@rjsf/validator-ajv8": "^6.4.1",
+    "@tanstack/react-query": "^5.90.21",
+    "@tanstack/react-table": "^8.21.3",
+    "@testing-library/react": "^16.3.2",
+    "@types/node": "^20.19.37",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.1.0",
+    "@vitejs/plugin-react": "^4.7.0",
+    "happy-dom": "^20.8.4",
+    "i18next": "^25.8.18",
+    "i18next-browser-languagedetector": "^8.2.1",
+    "i18next-http-backend": "^3.0.2",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "react-i18next": "^16.5.8",
+    "react-router": "^7.13.1",
+    "typescript": "^5.9.3",
+    "vite": "^6.4.1",
+    "vite-plugin-dts": "^4.5.1",
+    "vitest": "^4.1.0",
+    "@framework-m/ui": "0.2.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc && vite build",
+    "dev": "vite build --watch",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  }
+}