@mugwork/mug 0.1.0

package/dist/packages/surface-renderer/src/index.d.ts

@@ -0,0 +1,4 @@
+export { renderForm, renderMetaTags, renderPwaTags, renderInstallBanner } from "./form-renderer.js";
+export type { Breadcrumb, Condition, FormAccess, SessionData } from "./form-renderer.js";
+export { renderPortal, renderPortalDetail, renderDevBanner, bindUserParam, paginateQuery, detailQuery, collectSectionQueries, findTableSection, renderSection } from "./portal-renderer.js";
+export type { PortalConfig, PortalColumn, PortalField, PortalAction, PortalLink, PortalTab, PortalSection, TableSection, StatsSection, ProgressSection, TextSection, ChartSection, GallerySection, AccordionSection } from "./portal-renderer.js";

package/dist/packages/surface-renderer/src/index.js

@@ -0,0 +1,2 @@
+export { renderForm, renderMetaTags, renderPwaTags, renderInstallBanner } from "./form-renderer.js";
+export { renderPortal, renderPortalDetail, renderDevBanner, bindUserParam, paginateQuery, detailQuery, collectSectionQueries, findTableSection, renderSection } from "./portal-renderer.js";

package/dist/packages/surface-renderer/src/portal-renderer.d.ts

@@ -0,0 +1,177 @@
+import type { Breadcrumb, BrandingConfig, Condition, FormAccess, SessionData } from "./form-renderer.js";
+export type { Breadcrumb, BrandingConfig, Condition, FormAccess, SessionData };
+export interface PortalColumn {
+    key: string;
+    label: string;
+    format?: "date" | "datetime" | "currency" | "currency-whole" | "currency-short" | "number" | "percent";
+    dateFormat?: "short";
+    badge?: boolean;
+    badgeColors?: Record<string, string>;
+}
+export interface PortalField {
+    key: string;
+    label: string;
+    format?: "date" | "datetime" | "currency" | "currency-whole" | "currency-short" | "number" | "percent" | "multiline";
+    badge?: boolean;
+    badgeColors?: Record<string, string>;
+}
+export interface TimelineEvent {
+    delay: number;
+    event: "toast" | "preview" | "stream" | "update" | "highlight";
+    message?: string;
+    channel?: "email" | "sms";
+    to?: string;
+    subject?: string;
+    body?: string;
+    target?: string;
+    text?: string;
+    row?: string;
+    action?: string;
+    field?: string;
+    value?: string;
+}
+export interface PortalAction {
+    name: string;
+    label: string;
+    workflow?: string;
+    timeline?: TimelineEvent[];
+    style?: "primary" | "danger" | "success" | "warning" | "default";
+    color?: string;
+    showWhen?: Condition;
+    confirm?: string;
+    afterMessage?: string;
+    afterColor?: string;
+    afterActions?: {
+        label: string;
+        action: string;
+        style?: string;
+    }[];
+}
+export interface PortalLink {
+    label: string;
+    href: string;
+}
+export interface TableSection {
+    type: "table";
+    query: string;
+    primaryKey?: string;
+    pageSize?: number;
+    columns: PortalColumn[];
+    detail?: {
+        title?: string;
+        fields: PortalField[];
+    };
+    actions?: PortalAction[];
+    emptyMessage?: string;
+}
+export interface StatsSection {
+    type: "stats";
+    query: string;
+    items: {
+        label: string;
+        column: string;
+        format?: "number" | "currency" | "currency-whole" | "currency-short" | "percent";
+        color?: string;
+        valueColor?: string;
+        href?: string;
+    }[];
+}
+export interface ProgressSection {
+    type: "progress";
+    query: string;
+    labelColumn: string;
+    valueColumn: string;
+    maxColumn: string;
+    subtitleTemplate?: string;
+    color?: string;
+    colorColumn?: string;
+    colorThresholds?: {
+        percent: number;
+        color: string;
+    }[];
+}
+export interface TextSection {
+    type: "text";
+    content: string;
+}
+export interface ChartSection {
+    type: "chart";
+    query: string;
+    chartType: "bar" | "donut";
+    labelColumn?: string;
+    valueColumn?: string;
+    title?: string;
+    color?: string;
+    colorColumn?: string;
+    colors?: Record<string, string>;
+}
+export interface GallerySection {
+    type: "gallery";
+    query: string;
+    imageColumn: string;
+    titleColumn?: string;
+    fields?: PortalField[];
+    columns?: number;
+}
+export interface AccordionSection {
+    type: "accordion";
+    label: string;
+    open?: boolean;
+    sections: PortalSection[];
+}
+export type PortalSection = TableSection | StatsSection | ProgressSection | TextSection | ChartSection | GallerySection | AccordionSection;
+export interface PortalTab {
+    id: string;
+    label: string;
+    color?: string;
+    countQuery?: string;
+    sections: PortalSection[];
+    links?: PortalLink[];
+}
+export interface PortalConfig {
+    type: "portal";
+    workspace: string;
+    surfaceId: string;
+    title: string;
+    description?: string;
+    access: FormAccess;
+    database?: string;
+    sections?: PortalSection[];
+    tabs: PortalTab[];
+    branding?: BrandingConfig;
+    timezone?: string;
+    autoplay?: TimelineEvent[];
+}
+export declare function bindUserParam(sql: string, session: SessionData | null): {
+    sql: string;
+    userParams: string[];
+};
+export declare function paginateQuery(sql: string, userParams: string[], page: number, pageSize: number): {
+    countSql: string;
+    dataSql: string;
+    countParams: string[];
+    dataParams: (string | number)[];
+};
+export declare function detailQuery(sql: string, userParams: string[], primaryKey: string, rowId: string): {
+    sql: string;
+    params: (string | number)[];
+};
+export declare function formatDateTime(value: unknown, style?: "short" | "long", tz?: string): string;
+export declare function renderStatsSection(section: StatsSection, rows: Record<string, unknown>[]): string;
+export declare function renderProgressSection(section: ProgressSection, rows: Record<string, unknown>[]): string;
+export declare function renderTextSection(section: TextSection): string;
+export declare function renderChartSection(section: ChartSection, rows: Record<string, unknown>[]): string;
+export declare function renderGallerySection(section: GallerySection, rows: Record<string, unknown>[]): string;
+export declare function renderAccordionSection(section: AccordionSection, renderedChildren: string): string;
+export declare function renderSection(section: PortalSection, queryResults: Map<string, Record<string, unknown>[]>, tableCounts: Map<string, number>, pages: Record<string, number>, sectionKey: string, sectionIndex: number, base: string, activeTabId: string): string;
+export declare function collectSectionQueries(sections: PortalSection[], keyPrefix: string): {
+    key: string;
+    query: string;
+}[];
+export declare function renderPortal(config: PortalConfig, queryResults: Map<string, Record<string, unknown>[]>, tableCounts: Map<string, number>, pages: Record<string, number>, activeTabId: string | null, session: SessionData | null, basePath?: string, breadcrumb?: Breadcrumb, tabCounts?: Map<string, number>, embed?: boolean): string;
+export declare function findTableSection(config: PortalConfig, tabId: string, sectionIndex: number): {
+    tab: PortalTab;
+    section: TableSection;
+} | null;
+export declare function renderPortalDetail(config: PortalConfig, tableSection: TableSection, row: Record<string, unknown>, session: SessionData | null, tabId: string, basePath?: string, embed?: boolean): string;
+export declare function renderDevBanner(currentIdentity: string, registeredUsers?: string[], accentColor?: string, workspaceName?: string, badge?: string): string;