@declarion/react 0.1.34 → 0.1.45

package/dist-lib/stores/appearance.d.ts

@@ -1,5 +1,5 @@
-export type ThemeId = "light" | "dark" | string;
-export type AccentId = "violet" | "blue" | "teal" | "amber" | "rose" | string;
+export type ThemeId = "light" | "dark";
+export type AccentId = "violet" | "blue" | "teal" | "amber" | "rose";
 export type Density = "compact" | "comfortable" | "cozy";
 export type SidebarMode = "wide" | "collapsed";
 export type TabsPosition = "top" | "bottom";
@@ -21,6 +21,10 @@ export declare function applyAppearance(a: Appearance): void;
 interface AppearanceState extends Appearance {
     set: <K extends keyof Appearance>(key: K, value: Appearance[K]) => void;
     setMany: (patch: Partial<Appearance>) => void;
+    /** Apply tenant defaults from server params. ONLY fills keys the user has
+     *  not already set locally — any field present in localStorage wins.
+     *  That preserves the user's Tweaks choices across reloads while still
+     *  picking up tenant defaults on first visit. */
     hydrateFromParams: (params: Record<string, unknown>) => void;
 }
 export declare const useAppearanceStore: import("zustand").UseBoundStore<import("zustand").StoreApi<AppearanceState>>;

package/dist-lib/types/api.d.ts

@@ -1,4 +1,4 @@
-import type { AccentDef, LocalizedString, ThemeDef } from "./schema";
+import type { AccentDef, LocalizedString } from "./schema";
 export interface ListMeta {
     total: number;
     page: number;
@@ -27,7 +27,9 @@ export declare class ApiError extends Error {
     code: string;
     /** Bulk operation item index (present on validation errors for array requests). */
     index?: number;
-    constructor(status: number, message: string, code: string, index?: number);
+    /** Raw JSON body for endpoints that return a non-standard error envelope (e.g. invoke:each batch). */
+    raw?: unknown;
+    constructor(status: number, message: string, code: string, index?: number, raw?: unknown);
 }
 export type TenantEnv = "production" | "staging" | "dev" | string;
 export interface Tenant {
@@ -94,7 +96,6 @@ export interface PublicBranding {
 /** Envelope returned by GET /api/params/public. */
 export interface PublicParamsResponse {
     parameters: PublicParam[];
-    themes?: Record<string, ThemeDef>;
     accents?: Record<string, AccentDef>;
     branding?: PublicBranding;
 }

package/dist-lib/types/schema.d.ts

@@ -202,11 +202,18 @@ export declare function extractPkValues(entity: Entity, record: Record<string, u
 export declare function pkValuesToId(pkValues: PkValues): string;
 export declare function isCompositePk(entity: Entity): boolean;
 export type SizeValue = string;
+export interface SectionBadgeConfig {
+    text: LocalizedString;
+    tone?: "indigo" | "emerald" | "amber" | "rose" | "sky" | "violet" | "slate" | "teal";
+    dot?: boolean;
+}
 export interface SectionNode {
     name: LocalizedString;
     items: LayoutNode[];
     collapsed?: boolean;
     columns?: number;
+    icon?: string;
+    badge?: SectionBadgeConfig;
 }
 export interface RowConfig {
     items: LayoutNode[];
@@ -426,8 +433,10 @@ export interface Action {
     primary?: boolean;
     /** Forces confirm + danger styling. */
     destructive?: boolean;
-    /** UI shows toast + Jobs link instead of result modal. */
+    /** UI shows a toast instead of a blocking result modal; adds a navigation link if progress_screen is set. */
     long_running?: boolean;
+    /** Screen code to navigate to after a long_running action starts (resolved via schema.screens). */
+    progress_screen?: string;
     /** When true, action shown grayed until >=1 row selected. */
     bulk_selection_required?: boolean;
     resolved_params?: OrderedMap<HandlerParam>;
@@ -466,69 +475,7 @@ export interface Branding {
     auth_tagline?: LocalizedString;
     auth_subtagline?: LocalizedString;
     auth_badges?: LocalizedString[];
-}
-export interface ThemeDef {
-    extends?: string;
-    background?: string;
-    foreground?: string;
-    card?: string;
-    card_foreground?: string;
-    popover?: string;
-    popover_foreground?: string;
-    primary?: string;
-    primary_foreground?: string;
-    secondary?: string;
-    secondary_foreground?: string;
-    muted?: string;
-    muted_foreground?: string;
-    accent?: string;
-    accent_foreground?: string;
-    destructive?: string;
-    destructive_foreground?: string;
-    border?: string;
-    input?: string;
-    ring?: string;
-    sidebar?: string;
-    sidebar_foreground?: string;
-    sidebar_border?: string;
-    sidebar_accent?: string;
-    sidebar_muted?: string;
-    radius?: string;
-    surface?: string;
-    surface_2?: string;
-    surface_3?: string;
-    border_strong?: string;
-    divider?: string;
-    text_2?: string;
-    text_3?: string;
-    text_4?: string;
-    text_placeholder?: string;
-    rail?: string;
-    rail_fg?: string;
-    rail_muted?: string;
-    rail_active?: string;
-    rail_hover?: string;
-    sidebar_hover?: string;
-    sidebar_active?: string;
-    pills?: Record<string, {
-        fg: string;
-        bg: string;
-    }>;
-    success_soft?: string;
-    warn_soft?: string;
-    danger_soft?: string;
-    info_soft?: string;
-    shadow_xs?: string;
-    shadow_sm?: string;
-    shadow_md?: string;
-    shadow_lg?: string;
-    font_sans?: string;
-    font_mono?: string;
-    env_tones?: Record<string, {
-        fg: string;
-        bg: string;
-        border?: string;
-    }>;
+    css_url?: string;
 }
 export interface Schema {
     languages: LanguageDef[];
@@ -541,7 +488,6 @@ export interface Schema {
     enums: Record<string, EnumDef>;
     parameters: Record<string, ParameterDef>;
     branding?: Branding;
-    themes?: Record<string, ThemeDef>;
     areas?: AreaDef[];
     accents?: Record<string, AccentDef>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@declarion/react",
-  "version": "0.1.34",
+  "version": "0.1.45",
   "private": false,
   "license": "MIT",
   "description": "React SDK for Declarion, the schema-driven business apps platform.",

package/dist-lib/JsonEditor-C5NOzsey.js

@@ -1,71 +0,0 @@
-import { jsx as b } from "react/jsx-runtime";
-import { useRef as i, useEffect as a } from "react";
-import { Mode as d, createJSONEditor as E } from "vanilla-jsoneditor";
-import "vanilla-jsoneditor/themes/jse-theme-dark.css";
-function p(t) {
-  if (t == null) return { text: "" };
-  if (typeof t == "string")
-    try {
-      return { json: JSON.parse(t) };
-    } catch {
-      return { text: t };
-    }
-  return { json: t };
-}
-function R({ value: t, onChange: c, readOnly: r }) {
-  const o = i(null), s = i(null), n = i(c);
-  return a(() => {
-    n.current = c;
-  }, [c]), a(() => {
-    if (!o.current) return;
-    const j = {
-      content: p(t),
-      readOnly: r ?? !1,
-      mode: r ? d.tree : d.text,
-      mainMenuBar: !r,
-      navigationBar: !1,
-      statusBar: !1,
-      onChange: (e, u, x) => {
-        if (!(r || !n.current) && !x.contentErrors) {
-          if ("json" in e)
-            n.current(e.json);
-          else if ("text" in e)
-            try {
-              n.current(JSON.parse(e.text));
-            } catch {
-              n.current(e.text);
-            }
-        }
-      }
-    }, f = () => {
-      var u;
-      const e = document.documentElement.classList.contains("dark");
-      (u = o.current) == null || u.classList.toggle("jse-theme-dark", e);
-    };
-    f();
-    const m = new MutationObserver(f);
-    m.observe(document.documentElement, {
-      attributes: !0,
-      attributeFilter: ["class"]
-    });
-    const l = E({
-      target: o.current,
-      props: j
-    });
-    return s.current = l, () => {
-      m.disconnect(), l.destroy(), s.current = null;
-    };
-  }, [r]), a(() => {
-    !s.current || !r || s.current.updateProps({ content: p(t) });
-  }, [t, r]), /* @__PURE__ */ b(
-    "div",
-    {
-      ref: o,
-      className: r ? "json-editor-readonly" : "json-editor-editable"
-    }
-  );
-}
-export {
-  R as JsonEditor
-};
-//# sourceMappingURL=JsonEditor-C5NOzsey.js.map

package/dist-lib/JsonEditor-C5NOzsey.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"JsonEditor-C5NOzsey.js","sources":["../src/components/fields/JsonEditor.tsx"],"sourcesContent":["import { useRef, useEffect } from \"react\";\nimport {\n  createJSONEditor,\n  Mode,\n  type Content,\n  type OnChangeStatus,\n  type JSONEditorPropsOptional,\n} from \"vanilla-jsoneditor\";\n// Dark theme CSS vars for vanilla-jsoneditor (sets --jse-* custom properties)\nimport \"vanilla-jsoneditor/themes/jse-theme-dark.css\";\n\ninterface JsonEditorProps {\n  value: unknown;\n  onChange?: (value: unknown) => void;\n  readOnly?: boolean;\n  // Future: JSON Schema for in-editor validation (Ajv). Accept now, wire later.\n  schema?: Record<string, unknown>;\n}\n\nfunction toContent(v: unknown): Content {\n  if (v == null) return { text: \"\" };\n  if (typeof v === \"string\") {\n    try {\n      return { json: JSON.parse(v) };\n    } catch {\n      return { text: v };\n    }\n  }\n  return { json: v };\n}\n\nexport function JsonEditor({ value, onChange, readOnly }: JsonEditorProps) {\n  const containerRef = useRef<HTMLDivElement>(null);\n  const editorRef = useRef<ReturnType<typeof createJSONEditor> | null>(null);\n  const onChangeRef = useRef(onChange);\n  useEffect(() => { onChangeRef.current = onChange; }, [onChange]);\n\n  // Create / recreate editor when readOnly changes\n  useEffect(() => {\n    if (!containerRef.current) return;\n\n    const props: JSONEditorPropsOptional = {\n      content: toContent(value),\n      readOnly: readOnly ?? false,\n      mode: readOnly ? Mode.tree : Mode.text,\n      mainMenuBar: !readOnly,\n      navigationBar: false,\n      statusBar: false,\n      onChange: (content: Content, _prev: Content, status: OnChangeStatus) => {\n        if (readOnly || !onChangeRef.current) return;\n        if (status.contentErrors) return;\n        if (\"json\" in content) {\n          onChangeRef.current(content.json);\n        } else if (\"text\" in content) {\n          try {\n            onChangeRef.current(JSON.parse(content.text));\n          } catch {\n            onChangeRef.current(content.text);\n          }\n        }\n      },\n    };\n\n    const syncDarkClass = () => {\n      const isDark = document.documentElement.classList.contains(\"dark\");\n      containerRef.current?.classList.toggle(\"jse-theme-dark\", isDark);\n    };\n    syncDarkClass();\n\n    // Watch for dark mode toggles\n    const observer = new MutationObserver(syncDarkClass);\n    observer.observe(document.documentElement, {\n      attributes: true,\n      attributeFilter: [\"class\"],\n    });\n\n    const editor = createJSONEditor({\n      target: containerRef.current,\n      props,\n    });\n    editorRef.current = editor;\n\n    return () => {\n      observer.disconnect();\n      editor.destroy();\n      editorRef.current = null;\n    };\n  }, [readOnly]); // eslint-disable-line react-hooks/exhaustive-deps\n\n  // Update content when value changes externally (read-only mode only)\n  useEffect(() => {\n    if (!editorRef.current || !readOnly) return;\n    editorRef.current.updateProps({ content: toContent(value) });\n  }, [value, readOnly]);\n\n  return (\n    <div\n      ref={containerRef}\n      className={readOnly ? \"json-editor-readonly\" : \"json-editor-editable\"}\n    />\n  );\n}\n"],"names":["toContent","v","JsonEditor","value","onChange","readOnly","containerRef","useRef","editorRef","onChangeRef","useEffect","props","Mode","content","_prev","status","syncDarkClass","isDark","_a","observer","editor","createJSONEditor","jsx"],"mappings":";;;;AAmBA,SAASA,EAAUC,GAAqB;AACtC,MAAIA,KAAK,KAAM,QAAO,EAAE,MAAM,GAAA;AAC9B,MAAI,OAAOA,KAAM;AACf,QAAI;AACF,aAAO,EAAE,MAAM,KAAK,MAAMA,CAAC,EAAA;AAAA,IAC7B,QAAQ;AACN,aAAO,EAAE,MAAMA,EAAA;AAAA,IACjB;AAEF,SAAO,EAAE,MAAMA,EAAA;AACjB;AAEO,SAASC,EAAW,EAAE,OAAAC,GAAO,UAAAC,GAAU,UAAAC,KAA6B;AACzE,QAAMC,IAAeC,EAAuB,IAAI,GAC1CC,IAAYD,EAAmD,IAAI,GACnEE,IAAcF,EAAOH,CAAQ;AACnC,SAAAM,EAAU,MAAM;AAAE,IAAAD,EAAY,UAAUL;AAAA,EAAU,GAAG,CAACA,CAAQ,CAAC,GAG/DM,EAAU,MAAM;AACd,QAAI,CAACJ,EAAa,QAAS;AAE3B,UAAMK,IAAiC;AAAA,MACrC,SAASX,EAAUG,CAAK;AAAA,MACxB,UAAUE,KAAY;AAAA,MACtB,MAAMA,IAAWO,EAAK,OAAOA,EAAK;AAAA,MAClC,aAAa,CAACP;AAAA,MACd,eAAe;AAAA,MACf,WAAW;AAAA,MACX,UAAU,CAACQ,GAAkBC,GAAgBC,MAA2B;AACtE,YAAI,EAAAV,KAAY,CAACI,EAAY,YACzB,CAAAM,EAAO;AACX,cAAI,UAAUF;AACZ,YAAAJ,EAAY,QAAQI,EAAQ,IAAI;AAAA,mBACvB,UAAUA;AACnB,gBAAI;AACF,cAAAJ,EAAY,QAAQ,KAAK,MAAMI,EAAQ,IAAI,CAAC;AAAA,YAC9C,QAAQ;AACN,cAAAJ,EAAY,QAAQI,EAAQ,IAAI;AAAA,YAClC;AAAA;AAAA,MAEJ;AAAA,IAAA,GAGIG,IAAgB,MAAM;;AAC1B,YAAMC,IAAS,SAAS,gBAAgB,UAAU,SAAS,MAAM;AACjE,OAAAC,IAAAZ,EAAa,YAAb,QAAAY,EAAsB,UAAU,OAAO,kBAAkBD;AAAA,IAC3D;AACA,IAAAD,EAAA;AAGA,UAAMG,IAAW,IAAI,iBAAiBH,CAAa;AACnD,IAAAG,EAAS,QAAQ,SAAS,iBAAiB;AAAA,MACzC,YAAY;AAAA,MACZ,iBAAiB,CAAC,OAAO;AAAA,IAAA,CAC1B;AAED,UAAMC,IAASC,EAAiB;AAAA,MAC9B,QAAQf,EAAa;AAAA,MACrB,OAAAK;AAAA,IAAA,CACD;AACD,WAAAH,EAAU,UAAUY,GAEb,MAAM;AACX,MAAAD,EAAS,WAAA,GACTC,EAAO,QAAA,GACPZ,EAAU,UAAU;AAAA,IACtB;AAAA,EACF,GAAG,CAACH,CAAQ,CAAC,GAGbK,EAAU,MAAM;AACd,IAAI,CAACF,EAAU,WAAW,CAACH,KAC3BG,EAAU,QAAQ,YAAY,EAAE,SAASR,EAAUG,CAAK,GAAG;AAAA,EAC7D,GAAG,CAACA,GAAOE,CAAQ,CAAC,GAGlB,gBAAAiB;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,KAAKhB;AAAA,MACL,WAAWD,IAAW,yBAAyB;AAAA,IAAA;AAAA,EAAA;AAGrD;"}

package/dist-lib/lib/theme-utils.d.ts

@@ -1,3 +0,0 @@
-import type { ThemeDef } from "../types/schema";
-export declare const THEME_TOKENS: string[];
-export declare function themeDefToTokens(def: ThemeDef): Record<string, string>;

package/dist-lib/stores/theme.d.ts

@@ -1,10 +0,0 @@
-type ThemeTokens = Record<string, string>;
-interface ThemeState {
-    selectedTheme: string;
-    effectiveTheme: string;
-    availableThemes: Record<string, ThemeTokens>;
-    setTheme: (name: string) => void;
-    setAvailableThemes: (themes: Record<string, ThemeTokens>) => void;
-}
-export declare const useThemeStore: import("zustand").UseBoundStore<import("zustand").StoreApi<ThemeState>>;
-export {};