@zentto/studio-core 0.1.0 → 0.3.0

package/dist/index.d.ts

@@ -21,4 +21,6 @@ export { resolveFlavor, applyFlavor, applyFlavorToSchema, } from './persistence/
 export type { NavItem, NavItemKind, PageConfig, PageContentType, GridPageConfig, GridColumnDef, CrudConfig, ReportPageConfig, CardsPageConfig, CardItem, TabsPageConfig, SplitPageConfig, ChartPageConfig, BrandingConfig, UserContext, AppConfig, NotificationConfig, } from './app-types.js';
 export { TEMPLATE_BLANK, TEMPLATE_CRM, TEMPLATE_ECOMMERCE, TEMPLATE_HR, APP_TEMPLATES, getAppTemplate, listAppTemplates, } from './templates/app-templates.js';
 export type { AppTemplateId } from './templates/app-templates.js';
+export type { IconResolver, ComponentResolver, PageRenderer, ActionHandler, DataFetcher, NotificationHandler, ConfirmHandler, StudioProvider, } from './providers.js';
+export { DEFAULT_PROVIDER, mergeProviders, resolveIcon } from './providers.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,YAAY,EACV,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,oBAAoB,EACzD,WAAW,EAAE,YAAY,EAAE,YAAY,EACvC,cAAc,EAAE,cAAc,EAC9B,cAAc,EAAE,gBAAgB,EAAE,gBAAgB,EAClD,UAAU,EAAE,YAAY,EACxB,cAAc,EAAE,UAAU,EAAE,IAAI,EAChC,OAAO,EACP,cAAc,EAAE,MAAM,EAAE,gBAAgB,EACxC,WAAW,EAAE,UAAU,EACvB,YAAY,EACZ,UAAU,EAAE,SAAS,EACrB,cAAc,EAAE,oBAAoB,EACpC,aAAa,EAAE,iBAAiB,GACjC,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,SAAS,GACV,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,SAAS,EACT,YAAY,EACZ,YAAY,GACb,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,aAAa,EACb,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,aAAa,EACb,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAG1D,OAAO,EACL,eAAe,EACf,aAAa,GACd,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAGvE,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGjD,OAAO,EACL,aAAa,EACb,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,mBAAmB,GACpB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGzE,OAAO,EACL,mBAAmB,EACnB,YAAY,GACb,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,OAAO,EACL,aAAa,EACb,eAAe,EACf,UAAU,GACX,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EACL,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAGvE,OAAO,EACL,aAAa,EACb,WAAW,EACX,mBAAmB,GACpB,MAAM,iCAAiC,CAAC;AAGzC,YAAY,EACV,OAAO,EAAE,WAAW,EACpB,UAAU,EAAE,eAAe,EAC3B,cAAc,EAAE,aAAa,EAAE,UAAU,EACzC,gBAAgB,EAChB,eAAe,EAAE,QAAQ,EACzB,cAAc,EAAE,eAAe,EAAE,eAAe,EAChD,cAAc,EAAE,WAAW,EAC3B,SAAS,EAAE,kBAAkB,GAC9B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,cAAc,EAAE,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAC7D,aAAa,EAAE,cAAc,EAAE,gBAAgB,GAChD,MAAM,8BAA8B,CAAC;AACtC,YAAY,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -28,4 +28,5 @@ export { saveSchemaLocal, loadSchemaLocal, deleteSchemaLocal, listSchemasLocal,
 export { resolveFlavor, applyFlavor, applyFlavorToSchema, } from './persistence/flavor-manager.js';
 // App templates
 export { TEMPLATE_BLANK, TEMPLATE_CRM, TEMPLATE_ECOMMERCE, TEMPLATE_HR, APP_TEMPLATES, getAppTemplate, listAppTemplates, } from './templates/app-templates.js';
+export { DEFAULT_PROVIDER, mergeProviders, resolveIcon } from './providers.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAmBnC,oBAAoB;AACpB,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AAEnC,oBAAoB;AACpB,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,SAAS,GACV,MAAM,wBAAwB,CAAC;AAEhC,eAAe;AACf,OAAO,EACL,SAAS,EACT,YAAY,EACZ,YAAY,GACb,MAAM,0BAA0B,CAAC;AAElC,aAAa;AACb,OAAO,EACL,aAAa,EACb,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAEhC,cAAc;AACd,OAAO,EACL,aAAa,EACb,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AAGjC,gBAAgB;AAChB,OAAO,EACL,eAAe,EACf,aAAa,GACd,MAAM,2BAA2B,CAAC;AAGnC,YAAY;AACZ,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,iBAAiB;AACjB,OAAO,EACL,aAAa,EACb,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,mBAAmB,GACpB,MAAM,8BAA8B,CAAC;AAEtC,SAAS;AACT,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AAGjC,OAAO;AACP,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEzE,eAAe;AACf,OAAO,EACL,mBAAmB,EACnB,YAAY,GACb,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,aAAa,EACb,eAAe,EACf,UAAU,GACX,MAAM,4BAA4B,CAAC;AAEpC,cAAc;AACd,OAAO,EACL,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,+BAA+B,CAAC;AAGvC,UAAU;AACV,OAAO,EACL,aAAa,EACb,WAAW,EACX,mBAAmB,GACpB,MAAM,iCAAiC,CAAC;AAczC,gBAAgB;AAChB,OAAO,EACL,cAAc,EAAE,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAC7D,aAAa,EAAE,cAAc,EAAE,gBAAgB,GAChD,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAmBnC,oBAAoB;AACpB,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AAEnC,oBAAoB;AACpB,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,SAAS,GACV,MAAM,wBAAwB,CAAC;AAEhC,eAAe;AACf,OAAO,EACL,SAAS,EACT,YAAY,EACZ,YAAY,GACb,MAAM,0BAA0B,CAAC;AAElC,aAAa;AACb,OAAO,EACL,aAAa,EACb,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAEhC,cAAc;AACd,OAAO,EACL,aAAa,EACb,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AAGjC,gBAAgB;AAChB,OAAO,EACL,eAAe,EACf,aAAa,GACd,MAAM,2BAA2B,CAAC;AAGnC,YAAY;AACZ,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,iBAAiB;AACjB,OAAO,EACL,aAAa,EACb,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,mBAAmB,GACpB,MAAM,8BAA8B,CAAC;AAEtC,SAAS;AACT,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AAGjC,OAAO;AACP,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEzE,eAAe;AACf,OAAO,EACL,mBAAmB,EACnB,YAAY,GACb,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,aAAa,EACb,eAAe,EACf,UAAU,GACX,MAAM,4BAA4B,CAAC;AAEpC,cAAc;AACd,OAAO,EACL,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,+BAA+B,CAAC;AAGvC,UAAU;AACV,OAAO,EACL,aAAa,EACb,WAAW,EACX,mBAAmB,GACpB,MAAM,iCAAiC,CAAC;AAczC,gBAAgB;AAChB,OAAO,EACL,cAAc,EAAE,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAC7D,aAAa,EAAE,cAAc,EAAE,gBAAgB,GAChD,MAAM,8BAA8B,CAAC;AAStC,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/providers.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Icon resolver function.
+ * Host app maps icon names to rendered HTML strings.
+ *
+ * @example
+ * // In React host app:
+ * import { renderToString } from 'react-dom/server';
+ * import * as MuiIcons from '@mui/icons-material';
+ *
+ * const iconResolver = (name: string, props?: Record<string, unknown>) => {
+ *   const Icon = (MuiIcons as any)[name];
+ *   if (Icon) return renderToString(<Icon {...props} />);
+ *   return name; // fallback to text/emoji
+ * };
+ */
+export type IconResolver = (name: string, props?: {
+    size?: number;
+    color?: string;
+    className?: string;
+}) => string;
+/**
+ * Component resolver function.
+ * Host app maps component names to rendered HTML strings.
+ * Used for custom field types the studio doesn't know about.
+ *
+ * @example
+ * const componentResolver = (name: string, props: Record<string, unknown>) => {
+ *   if (name === 'MyCustomChart') return '<my-chart ...>';
+ *   if (name === 'GoogleMap') return '<iframe src="...">';
+ *   return null; // not handled
+ * };
+ */
+export type ComponentResolver = (name: string, props: Record<string, unknown>) => string | null;
+/**
+ * Page renderer function.
+ * Host app renders a full page given a page ID and data.
+ * Returns HTML string to inject into the content area.
+ */
+export type PageRenderer = (pageId: string, data: Record<string, unknown>) => string | null;
+/**
+ * Action handler function.
+ * Host app handles custom actions (API calls, navigation, etc.)
+ */
+export type ActionHandler = (actionId: string, actionType: string, data: Record<string, unknown>) => Promise<{
+    success: boolean;
+    data?: unknown;
+    error?: string;
+}>;
+/**
+ * Data fetcher function.
+ * Host app fetches data (can use its own auth tokens, interceptors, etc.)
+ */
+export type DataFetcher = (url: string, options: {
+    method: string;
+    headers?: Record<string, string>;
+    body?: unknown;
+}) => Promise<unknown>;
+/**
+ * Toast/notification handler.
+ * Host app shows notifications in its own style.
+ */
+export type NotificationHandler = (type: 'success' | 'error' | 'warning' | 'info', title: string, message?: string) => void;
+/**
+ * Confirmation handler.
+ * Host app shows its own confirmation dialog.
+ */
+export type ConfirmHandler = (title: string, message: string, options?: {
+    variant?: string;
+    okText?: string;
+    cancelText?: string;
+}) => Promise<boolean>;
+/**
+ * StudioProvider — the bridge between studio and the host app.
+ * Host app creates this and passes it to <zentto-studio-app> or <zentto-studio-renderer>.
+ * Every function is optional — studio falls back to built-in behavior.
+ */
+export interface StudioProvider {
+    /** Resolve icon names to HTML (MUI icons, FontAwesome, custom SVGs) */
+    resolveIcon?: IconResolver;
+    /** Resolve custom components to HTML */
+    resolveComponent?: ComponentResolver;
+    /** Render custom pages */
+    renderPage?: PageRenderer;
+    /** Handle actions (submit, apiCall, custom) */
+    handleAction?: ActionHandler;
+    /** Fetch data with host app's auth/interceptors */
+    fetchData?: DataFetcher;
+    /** Show notifications in host app's style */
+    notify?: NotificationHandler;
+    /** Show confirmation dialogs in host app's style */
+    confirm?: ConfirmHandler;
+    /** Navigate in the host app's router */
+    navigate?: (path: string) => void;
+    /** Open a URL in a new tab or modal */
+    openUrl?: (url: string, target?: '_blank' | '_self' | 'modal') => void;
+    /** Get the current user (may change over time) */
+    getUser?: () => {
+        id?: string;
+        name?: string;
+        email?: string;
+        roles?: string[];
+        avatar?: string;
+    } | null;
+    /** Get auth headers for API calls */
+    getAuthHeaders?: () => Record<string, string>;
+    /** Register a custom field type with a web component tag */
+    customFields?: Record<string, {
+        tagName: string;
+        label: string;
+        icon: string;
+        category?: string;
+        defaultProps?: Record<string, unknown>;
+    }>;
+    /** CSS class mappings (e.g., MUI class names the host uses) */
+    cssClasses?: Record<string, string>;
+    /** Additional config the host app wants to pass through */
+    extra?: Record<string, unknown>;
+}
+export declare const DEFAULT_PROVIDER: StudioProvider;
+export declare function mergeProviders(...providers: (StudioProvider | undefined)[]): StudioProvider;
+/**
+ * Resolve an icon name using the provider chain:
+ * 1. Provider's resolveIcon (MUI, FontAwesome, etc.)
+ * 2. Built-in emoji map
+ * 3. Raw string (emoji/text passthrough)
+ */
+export declare function resolveIcon(name: string | undefined, provider?: StudioProvider, props?: {
+    size?: number;
+    color?: string;
+}): string;
+//# sourceMappingURL=providers.d.ts.map

package/dist/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"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"}

package/dist/providers.js

@@ -0,0 +1,64 @@
+// @zentto/studio-core — Provider system
+// Allows host apps to inject their own icons, components, and renderers
+// The studio doesn't know what MUI, FontAwesome, or any library is —
+// it just calls the provider and the host resolves it.
+// ─── Default (no-op) provider ─────────────────────────────────────
+export const DEFAULT_PROVIDER = {};
+// ─── Helper to merge providers ────────────────────────────────────
+export function mergeProviders(...providers) {
+    const merged = {};
+    for (const p of providers) {
+        if (!p)
+            continue;
+        Object.assign(merged, p);
+        // Merge customFields deeply
+        if (p.customFields) {
+            merged.customFields = { ...merged.customFields, ...p.customFields };
+        }
+    }
+    return merged;
+}
+// ─── Icon resolution with fallback chain ──────────────────────────
+const BUILTIN_ICONS = {
+    // Navigation
+    home: '🏠', dashboard: '📊', settings: '⚙️', search: '🔍', menu: '☰',
+    // Actions
+    add: '➕', edit: '✏️', delete: '🗑️', save: '💾', cancel: '✕', refresh: '🔄',
+    close: '✕', check: '✓', copy: '📋', download: '⬇️', upload: '⬆️', print: '🖨️',
+    // Status
+    success: '✅', error: '❌', warning: '⚠️', info: 'ℹ️', loading: '⏳',
+    // Content
+    user: '👤', users: '👥', company: '🏢', email: '📧', phone: '📱',
+    calendar: '📅', clock: '🕐', map: '🗺️', location: '📍',
+    // Business
+    invoice: '📄', order: '📋', product: '📦', cart: '🛒', money: '💰',
+    bank: '🏦', chart: '📈', report: '📊', file: '📁', folder: '📂',
+    // UI
+    star: '⭐', heart: '❤️', flag: '🚩', tag: '🏷️', lock: '🔒', unlock: '🔓',
+    eye: '👁️', notification: '🔔', link: '🔗', code: '💻',
+    // Arrows
+    arrowUp: '↑', arrowDown: '↓', arrowLeft: '←', arrowRight: '→',
+    chevronRight: '▶', chevronDown: '▼', chevronUp: '▲', chevronLeft: '◀',
+};
+/**
+ * Resolve an icon name using the provider chain:
+ * 1. Provider's resolveIcon (MUI, FontAwesome, etc.)
+ * 2. Built-in emoji map
+ * 3. Raw string (emoji/text passthrough)
+ */
+export function resolveIcon(name, provider, props) {
+    if (!name)
+        return '';
+    // 1. Try provider
+    if (provider?.resolveIcon) {
+        const result = provider.resolveIcon(name, props);
+        if (result)
+            return result;
+    }
+    // 2. Built-in emoji map
+    if (name in BUILTIN_ICONS)
+        return BUILTIN_ICONS[name];
+    // 3. Passthrough (emoji, SVG string, or text)
+    return name;
+}
+//# sourceMappingURL=providers.js.map

package/dist/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zentto/studio-core",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Core logic engine for Zentto Studio — runtime UI builder. Schema validation, expression engine, data binding, and rule evaluation.",
   "type": "module",
   "main": "dist/index.js",
@@ -11,7 +11,10 @@
       "import": "./dist/index.js"
     }
   },
-  "files": ["dist", "README.md"],
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",