k3-plugin-api 1.4.5 → 1.6.0

package/{index.ts → dist/index.d.cts}

@@ -1,20 +1,15 @@
-import type React from "react";
+import React from "react";
 
-// ─── Plugin Runtime API ─────────────────────────────────────────────────────
-
-/**
- * Internal getter function injected by K3 at runtime.
- */
-let _getSettings: ((pluginId: string) => unknown) | null = null;
+//#region index.d.ts
 
 /**
  * Get plugin-specific settings from the K3 store.
  * Returns a snapshot of the current settings - not reactive.
  * Use this in plugin components that need access to settings configured in the admin.
- * 
+ *
  * @param pluginId - The unique plugin ID (e.g. "acme.my-plugin")
  * @returns The settings object for this plugin, or `{}` if none are configured
- * 
+ *
  * @example
  * ```typescript
  * const settings = getSettings("acme.my-plugin") as { apiKey?: string };
@@ -23,62 +18,121 @@ let _getSettings: ((pluginId: string) => unknown) | null = null;
  * }
  * ```
  */
-export function getSettings(pluginId: string): unknown {
-  if (!_getSettings) {
-    throw new Error(
-      "k3-plugin-api not initialized. Make sure K3 calls init() before using getSettings().",
-    );
-  }
-  return _getSettings(pluginId);
-}
-
+declare function getSettings(pluginId: string): unknown;
+/**
+ * Get plugin-specific settings from the K3 store as a reactive hook.
+ * Re-renders the component whenever the settings change.
+ * Use this in plugin React components.
+ *
+ * @param pluginId - The unique plugin ID (e.g. "acme.my-plugin")
+ * @returns The settings object for this plugin, or `{}` if none are configured
+ *
+ * @example
+ * ```typescript
+ * const settings = useK3PluginSettings("acme.my-plugin") as { apiKey?: string };
+ * ```
+ */
+declare function useK3PluginSettings(pluginId: string): unknown;
+/**
+ * Reactive hook – returns all current configuration variables as a key-value map.
+ * Keys are the variable's stable `key` string. Values are resolved (labels, not raw IDs).
+ * Re-renders whenever any selection changes.
+ *
+ * @example
+ * ```typescript
+ * const variables = useConfigurationVariables();
+ * const color = variables["color"] as K3SimplifiedValue;
+ * ```
+ */
+declare function useConfigurationVariables(): K3ConfigurationVariables;
+/**
+ * Reactive hook – returns the resolved value for a specific variable by its key,
+ * or `undefined` if the variable has no active selection.
+ *
+ * @param variableKey - The stable key of the variable (as defined in the admin)
+ *
+ * @example
+ * ```typescript
+ * const width = useConfigurationVariable("width") as number;
+ * const material = useConfigurationVariable("material") as K3SimplifiedValue;
+ * ```
+ */
+declare function useConfigurationVariable(variableKey: string): K3ConfigurationVariableEntry | undefined;
+/**
+ * Reactive hook – returns the current Bill of Materials (Stückliste).
+ * Re-renders whenever the BOM changes (i.e. on any selection change).
+ *
+ * @example
+ * ```typescript
+ * const bom = useBOM() as K3BomEntry[];
+ * const total = bom.reduce((sum, e) => sum + e.price.price * e.qty, 0);
+ * ```
+ */
+declare function useBOM(): K3BomEntry[];
+/**
+ * Reactive hook – returns the current total price as a raw number.
+ * Re-renders whenever the price changes.
+ */
+declare function useTotalPrice(): number;
+/**
+ * Reactive hook – returns the current total price formatted as a locale string
+ * (e.g. `"1.299,00 €"`), ready for display.
+ * Re-renders whenever the price changes.
+ */
+declare function useFormattedTotalPrice(): string;
+/**
+ * Reactive hook – returns the current K3 app metadata, including the booked
+ * product identifier. Returns `null` while the app has not yet loaded.
+ *
+ * @example
+ * ```typescript
+ * const app = useApp() as K3AppInfo | null;
+ * if (app?.product === "k3-pro") {
+ *   // enable pro-only features
+ * }
+ * ```
+ */
+declare function useApp(): K3AppInfo | null;
 /**
  * Called by K3 when the plugin is loaded to inject runtime API functions.
  * @internal This function is called by K3 automatically - plugins should not call it directly.
  */
-export function init(api: {
+declare function init(api: {
   getSettings: (pluginId: string) => unknown;
-}): void {
-  _getSettings = api.getSettings;
-}
-
-// ─── HOC type (mirrors K3 internal, no K3 imports) ──────────────────────────
-
+  usePluginSettings: (pluginId: string) => unknown;
+  useConfigurationVariables: () => K3ConfigurationVariables;
+  useConfigurationVariable: (variableKey: string) => K3ConfigurationVariableEntry | undefined;
+  useBOM: () => unknown[];
+  useTotalPrice: () => number;
+  useFormattedTotalPrice: () => string;
+  useApp: () => unknown | null;
+}): void;
 /** A Higher-Order Component: takes the default component, returns a new one. */
-export type HOC<P = Record<string, unknown>> = (
-  comp: React.FC<P>,
-) => React.FC<P>;
-
+type HOC<P = Record<string, unknown>> = (comp: React.FC<P>) => React.FC<P>;
 /** Four editor languages supported by K3. */
-export type LocalizedString = {
+type LocalizedString = {
   de?: string;
   en?: string;
   nl?: string;
   fr?: string;
 };
-
 /** An HOC slot with a required description for the admin UI. */
-export interface HOCWithDescription<P = Record<string, unknown>> {
+interface HOCWithDescription<P = Record<string, unknown>> {
   hoc: HOC<P>;
   /** Describe what this extension point does. Shown in the plugin extensions dialog. */
   description: string | LocalizedString;
 }
-
 /** A logic callback with a required description for the admin UI. */
-export interface CallbackWithDescription<T> {
+interface CallbackWithDescription<T> {
   fn: T;
   /** Describe what this callback does. Shown in the plugin extensions dialog. */
   description: string | LocalizedString;
 }
-
-// ─── Public Plugin Descriptor ───────────────────────────────────────────────
-
-export interface K3PluginDescriptor {
+interface K3PluginDescriptor {
   /** Unique stable identifier, e.g. "vendor.myplugin". Required for collision detection. */
   id: string;
   /** Semver string, e.g. "1.0.0". */
   version: string;
-
   /** UI extension points: layout HOCs, input HOCs, dialog HOCs. */
   ui?: K3UIExtensions;
   /** Viewer / 3D extension points: canvas, scene components, layout components, dynamic models. */
@@ -89,14 +143,10 @@ export interface K3PluginDescriptor {
     settings: unknown;
     onSave: (settings: unknown) => void;
   }>;
-
   /** @deprecated Use viewer.models instead. */
   dynamicModels?: DynamicModel[];
 }
-
-// ─── UI Extensions ──────────────────────────────────────────────────────────
-
-export interface K3UIExtensions {
+interface K3UIExtensions {
   /** Override layout shell components. */
   layout?: K3LayoutExtensions;
   /** Register new variable visualisations (renderers) per variable data type. */
@@ -104,8 +154,7 @@ export interface K3UIExtensions {
   /** Override dialog components. */
   dialogs?: K3DialogExtensions;
 }
-
-export interface K3LayoutExtensions {
+interface K3LayoutExtensions {
   /** Wraps the outermost app shell component. */
   root?: HOCWithDescription;
   /** Wraps the top header bar containing branding, navigation buttons, and scene controls. */
@@ -155,12 +204,11 @@ export interface K3LayoutExtensions {
   /** Wraps each individual variable label inside a group panel. */
   variableLabel?: HOCWithDescription;
 }
-
 /**
  * Props passed to a plugin variable component (VariableVisualisation.component) at runtime.
  * Use these to render a fully custom variable input UI.
  */
-export interface K3VariableComponentProps {
+interface K3VariableComponentProps {
   /** The variable definition for which this component is rendered. */
   variable: {
     /** Database ID of the variable. */
@@ -207,20 +255,18 @@ export interface K3VariableComponentProps {
    * Number variables: onChange(values[0].id, { inputValue: numericValue })
    * List/color/boolean: onChange(value.id)
    */
-  onChange: (
-    valueId: string | number,
-    metadata?: { inputValue?: number },
-  ) => void;
+  onChange: (valueId: string | number, metadata?: {
+    inputValue?: number;
+  }) => void;
   /** When `true`, the variable is locked and user interaction should be blocked. */
   disabled?: boolean;
 }
-
 /**
  * A plugin-registered variable renderer (VariableVisualisation).
  * Displayed as a selectable option in the admin visualisation chooser.
  * The component owns its full UI — label, input, chrome.
  */
-export interface VariableVisualisation {
+interface VariableVisualisation {
   /**
    * Globally unique template key, e.g. "acme.mySlider".
    * Set variable.settings.template = this key to use this visualisation.
@@ -234,8 +280,7 @@ export interface VariableVisualisation {
   /** Full variable renderer component. Receives K3VariableComponentProps. */
   component: React.ComponentType<K3VariableComponentProps>;
 }
-
-export interface K3InputExtensions {
+interface K3InputExtensions {
   /** Register new visualisations for list-type variables. */
   list?: VariableVisualisation[];
   /** Register new visualisations for color-type variables. */
@@ -255,15 +300,13 @@ export interface K3InputExtensions {
   /** Register new visualisations for information-type variables. */
   information?: VariableVisualisation[];
 }
-
-export interface K3DialogExtensions {
+interface K3DialogExtensions {
   /** Extension points for the order / summary dialog (contact form, price table, confirmation). */
   order?: K3OrderDialogExtensions;
   /** Extension points for inline selection-warning components shown in the sidebar. */
   warnings?: K3WarningExtensions;
 }
-
-export interface K3OrderDialogExtensions {
+interface K3OrderDialogExtensions {
   /** Wraps the entire order dialog modal. */
   root?: HOCWithDescription;
   /** Wraps the dialog headline / title element. */
@@ -283,8 +326,7 @@ export interface K3OrderDialogExtensions {
   /** Wraps the error confirmation screen shown after a failed order submission. */
   confirmationError?: HOCWithDescription;
 }
-
-export interface K3WarningExtensions {
+interface K3WarningExtensions {
   /** Wraps the full invalid-selection warning component (red badge next to a variable value). */
   invalidSelection?: HOCWithDescription;
   /** Wraps the icon inside the invalid-selection warning. */
@@ -294,14 +336,65 @@ export interface K3WarningExtensions {
   /** Wraps the tooltip content shown when a number variable value is out of bounds. */
   numberWarningTooltip?: HOCWithDescription;
 }
-
-// ─── Viewer Extensions ──────────────────────────────────────────────────────
-
+/**
+ * Simplified app metadata exposed to plugins.
+ * Useful for reading the booked product and subscription info.
+ */
+interface K3AppInfo {
+  /** Database ID of the app. */
+  id: number;
+  /** Human-readable app label. */
+  label: string;
+  /** Unique stable app code. */
+  code: string;
+  /**
+   * Identifier of the booked product (e.g. `"k3-pro"`).
+   * Use this to conditionally enable features based on the customer's plan.
+   */
+  product?: string;
+  /** Subscription billing interval for this app. */
+  interval?: "month" | "year";
+  /** Feature flags of the currently booked product. */
+  productDetails?: Record<string, unknown>;
+  [key: string]: unknown;
+}
+/**
+ * A resolved value option (list, color, boolean, image, upload, multiSelect).
+ * Contains human-readable labels and the underlying data value.
+ */
+interface K3SimplifiedValue {
+  /** Database ID of the value. */
+  id: number | string;
+  /** Stable key of the value, if defined. */
+  key?: string | null;
+  /** Translated display label. */
+  label: string;
+  /** Underlying data: hex color string, boolean flag, or generic string payload. */
+  value?: string | boolean | null;
+  /** Thumbnail image URL. */
+  thumbnail?: string | null;
+}
+/**
+ * A single configuration variable entry. The concrete type depends on the variable type:
+ * - Number variables → `number`
+ * - Text variables → `string`
+ * - List / Color / Boolean / Image / Upload → `K3SimplifiedValue`
+ * - MultiSelect → `K3SimplifiedValue[]`
+ * - Component variables → `K3ComponentInstanceVariables[]` (recursive)
+ */
+type K3ConfigurationVariableEntry = number | string | K3SimplifiedValue | K3SimplifiedValue[] | K3ComponentInstanceVariables[];
+/** A single component instance's variables, keyed by variable key. */
+type K3ComponentInstanceVariables = Record<string, K3ConfigurationVariableEntry>;
+/**
+ * The full configuration variables map, keyed by the variable's stable `key` string.
+ * Returned by `useConfigurationVariables()`.
+ */
+type K3ConfigurationVariables = Record<string, K3ConfigurationVariableEntry>;
 /**
  * A single Bill-of-Materials entry exposed to plugin components.
  * Mirrors the internal BOMEntry shape using only primitive/simple types.
  */
-export interface K3BomEntry {
+interface K3BomEntry {
   article: {
     id: number;
     /** Article number as defined in the K3 admin. */
@@ -316,18 +409,20 @@ export interface K3BomEntry {
   /** Optional override quantity from the article amount modal. */
   amount?: number | null;
   /** Price of a single unit of this article. */
-  price: { price: number; unit?: string };
+  price: {
+    price: number;
+    unit?: string;
+  };
   /** Whether this is a main article (`true`) or an accessory/surcharge (`false`). */
   main?: boolean;
 }
-
 /**
  * Props automatically injected into every `customLayoutComponents` entry.
  *
  * @remarks TODO(WIP) — This interface will grow as more configurator data is
  * exposed to plugins.
  */
-export interface CustomLayoutComponentProps {
+interface CustomLayoutComponentProps {
   /** The slot name this component was mounted under. */
   name: string;
   /**
@@ -343,8 +438,7 @@ export interface CustomLayoutComponentProps {
   /** Any additional props forwarded by the layout. */
   [key: string]: unknown;
 }
-
-export interface K3ViewerExtensions {
+interface K3ViewerExtensions {
   /** Wraps the root Three.js / R3F canvas element. */
   canvas?: HOCWithDescription;
   /**
@@ -354,11 +448,7 @@ export interface K3ViewerExtensions {
    *
    * Components receive {@link CustomLayoutComponentProps} with BOM and total price data.
    */
-  // TODO(WIP): CustomLayoutComponentProps will be extended as more data becomes available
-  customLayoutComponents?: Record<
-    string,
-    React.ComponentType<CustomLayoutComponentProps>
-  >;
+  customLayoutComponents?: Record<string, React.ComponentType<CustomLayoutComponentProps>>;
   /** Dynamic 3D model definitions contributed by this plugin. Equivalent to the top-level `dynamicModels`. */
   models?: DynamicModel[];
   /** Override the label / hotspot overlay components rendered on the 3D canvas. */
@@ -369,21 +459,20 @@ export interface K3ViewerExtensions {
     mobile?: HOCWithDescription;
   };
 }
-
-// ─── Logic Callback Types ────────────────────────────────────────────────────
-
 /** [x, y, z] coordinate tuple used on camera objects. */
-export type K3Coordinates = [number, number, number];
-
+type K3Coordinates = [number, number, number];
 /**
  * Restricts a camera to a specific configurator context.
  * `"group"` / `"variable"` — camera activates only when that item is in view; `id` is the entity's database ID.
  * `"general"` — camera is always available regardless of the active group or variable.
  */
-export type K3CameraScope =
-  | { type: "group" | "variable"; id: number }
-  | { type: "general"; id?: null };
-
+type K3CameraScope = {
+  type: "group" | "variable";
+  id: number;
+} | {
+  type: "general";
+  id?: null;
+};
 interface K3BaseCamera {
   /** Unique database ID of the camera record. */
   id: string;
@@ -396,7 +485,10 @@ interface K3BaseCamera {
   /** Euler rotation [x, y, z] in radians. */
   rotation: K3Coordinates;
   /** Optional override for the screenshot render resolution in pixels. */
-  resolution?: { width: number; height: number };
+  resolution?: {
+    width: number;
+    height: number;
+  };
   /** Transition easing threshold used by the camera animation driver. */
   threshold?: number;
   /**
@@ -411,16 +503,19 @@ interface K3BaseCamera {
   zoom?: number;
   [key: string]: unknown;
 }
-
 /** A perspective camera configured in the K3 scene editor. */
-export interface K3PerspectiveCamera extends K3BaseCamera {
+interface K3PerspectiveCamera extends K3BaseCamera {
   type: "PerspectiveCamera";
   /** Intrinsic perspective parameters: field-of-view in degrees, aspect ratio, near/far clip planes. */
-  baseSettings?: { fov: number; aspect: number; near: number; far: number };
+  baseSettings?: {
+    fov: number;
+    aspect: number;
+    near: number;
+    far: number;
+  };
 }
-
 /** An orthographic camera configured in the K3 scene editor. */
-export interface K3OrthographicCamera extends K3BaseCamera {
+interface K3OrthographicCamera extends K3BaseCamera {
   type: "OrthographicCamera";
   /** Intrinsic orthographic parameters: frustum left/right/top/bottom extents and near/far clip planes. */
   baseSettings?: {
@@ -432,24 +527,20 @@ export interface K3OrthographicCamera extends K3BaseCamera {
     far: number;
   };
 }
-
 /** A scene camera — perspective or orthographic. Passed to screenshot / camera-list callbacks. */
-export type K3Camera = K3PerspectiveCamera | K3OrthographicCamera;
-
+type K3Camera = K3PerspectiveCamera | K3OrthographicCamera;
 /** Pixel dimensions used for screenshot rendering. */
-export interface K3ScreenshotDimensions {
+interface K3ScreenshotDimensions {
   width: number;
   height: number;
 }
-
 /** AR platform identifier. */
-export type K3ARPlatform = "iOS" | "AndroidOS";
-
+type K3ARPlatform = "iOS" | "AndroidOS";
 /**
  * Minimal structural representation of a Three.js scene graph node.
  * Cast to `import("three").Object3D` for full Three.js access.
  */
-export interface K3Scene {
+interface K3Scene {
   /** Three.js object type string, e.g. `"Scene"`, `"Mesh"`, `"Group"`. */
   type: string;
   /** Direct child nodes of this scene graph node. */
@@ -459,9 +550,8 @@ export interface K3Scene {
   traverse(callback: (object: K3Scene) => void): void;
   getObjectByName(name: string): K3Scene | undefined;
 }
-
 /** Context passed to `core.onExportAR`. */
-export interface K3ARExportContext {
+interface K3ARExportContext {
   /** Platform the AR export is targeting. */
   platform: K3ARPlatform;
   /**
@@ -470,9 +560,8 @@ export interface K3ARExportContext {
    */
   scene: K3Scene;
 }
-
 /** An uploaded file in a save operation (e.g. a screenshot per camera). */
-export interface K3UploadFile {
+interface K3UploadFile {
   /** Camera name or custom key identifying this file. */
   key: string;
   /** The file data. */
@@ -480,9 +569,8 @@ export interface K3UploadFile {
   /** Optional explicit file name. */
   fileName?: string;
 }
-
 /** Result returned to `core.onOpenPdf` after a save/order action. */
-export interface K3SaveResult {
+interface K3SaveResult {
   /** Generated configuration code. */
   code?: string;
   /** Pricing verification info. */
@@ -503,12 +591,11 @@ export interface K3SaveResult {
   pdfName?: string;
   [key: string]: unknown;
 }
-
 /**
  * Payload dispatched when a configuration is saved (e.g. "order", "cart", "pdf").
  * Passed to `config.onSaveEvent`.
  */
-export interface K3ConfigurationSavedEvent {
+interface K3ConfigurationSavedEvent {
   type: "K3ConfigurationSaved";
   /** Save action key, e.g. "cart", "pdf", "email". */
   actionKey: string;
@@ -523,9 +610,8 @@ export interface K3ConfigurationSavedEvent {
   };
   [key: string]: unknown;
 }
-
 /** A persisted configuration object. Passed to `config.onUpdate` and `config.onSave`. */
-export interface K3Configuration {
+interface K3Configuration {
   /** Database ID of the saved configuration record. */
   id: number | string;
   /** ID of the K3 app this configuration belongs to. */
@@ -550,12 +636,10 @@ export interface K3Configuration {
   files: Record<string, Record<string, string>>;
   [key: string]: unknown;
 }
-
 /** A configuration not yet persisted (no `id` or `code`). */
-export type K3NewConfiguration = Omit<K3Configuration, "id" | "code">;
-
+type K3NewConfiguration = Omit<K3Configuration, "id" | "code">;
 /** An individual variable selection state. */
-export interface K3Selection {
+interface K3Selection {
   /** Unique selection ID. */
   id: string;
   /** ID of the variable this selection belongs to. */
@@ -573,59 +657,81 @@ export interface K3Selection {
   };
   [key: string]: unknown;
 }
-
 /** Full application snapshot passed to `core.preprocessFullApp` before the store initialises. */
-export interface K3FullApp {
-  app: { id: number; [key: string]: unknown };
-  client: { id: number; [key: string]: unknown };
-  groups: Array<{ id: number; [key: string]: unknown }>;
-  variables: Array<{ id: number; [key: string]: unknown }>;
-  values: Array<{ id: number | string; [key: string]: unknown }>;
-  articles: Array<{ id: number; [key: string]: unknown }>;
-  prices: Array<{ id: number; [key: string]: unknown }>;
-  materials: Array<{ id: number; [key: string]: unknown }>;
-  models: Array<{ id: number; [key: string]: unknown }>;
-  images: Array<{ id: number; [key: string]: unknown }>;
-  rules: Array<{ id: number; [key: string]: unknown }>;
-  ruleItems: Array<{ id: number; [key: string]: unknown }>;
+interface K3FullApp {
+  app: {
+    id: number;
+    [key: string]: unknown;
+  };
+  client: {
+    id: number;
+    [key: string]: unknown;
+  };
+  groups: Array<{
+    id: number;
+    [key: string]: unknown;
+  }>;
+  variables: Array<{
+    id: number;
+    [key: string]: unknown;
+  }>;
+  values: Array<{
+    id: number | string;
+    [key: string]: unknown;
+  }>;
+  articles: Array<{
+    id: number;
+    [key: string]: unknown;
+  }>;
+  prices: Array<{
+    id: number;
+    [key: string]: unknown;
+  }>;
+  materials: Array<{
+    id: number;
+    [key: string]: unknown;
+  }>;
+  models: Array<{
+    id: number;
+    [key: string]: unknown;
+  }>;
+  images: Array<{
+    id: number;
+    [key: string]: unknown;
+  }>;
+  rules: Array<{
+    id: number;
+    [key: string]: unknown;
+  }>;
+  ruleItems: Array<{
+    id: number;
+    [key: string]: unknown;
+  }>;
   [key: string]: unknown;
 }
-
-// ─── Logic / Callback Extensions ────────────────────────────────────────────
-
-export interface K3LogicExtensions {
+interface K3LogicExtensions {
   /** Hooks into the configuration data lifecycle (create, update, save). */
   config?: {
     /**
      * Called every time the active configuration object is updated in the store (e.g. on every selection change).
      * Return a modified copy to alter prices, codes, or any other configuration field.
      */
-    onUpdate?: CallbackWithDescription<
-      (config: K3Configuration) => K3Configuration
-    >;
+    onUpdate?: CallbackWithDescription<(config: K3Configuration) => K3Configuration>;
     /**
      * Called just before a configuration is persisted (order, cart, email, …).
      * Return a modified copy to inject extra fields or override values before saving.
      */
-    onSave?: CallbackWithDescription<
-      (
-        config: K3Configuration | K3NewConfiguration,
-      ) => K3Configuration | K3NewConfiguration
-    >;
+    onSave?: CallbackWithDescription<(config: K3Configuration | K3NewConfiguration) => K3Configuration | K3NewConfiguration>;
     /**
      * Called with the list of screenshot files that will be uploaded alongside the save.
      * Return a modified array to add, remove, or rename files.
      */
-    onSaveFiles?: CallbackWithDescription<
-      (files: K3UploadFile[]) => K3UploadFile[]
-    >;
+    onSaveFiles?: CallbackWithDescription<(files: K3UploadFile[]) => K3UploadFile[]>;
     /**
      * Called after a successful save action with the dispatched event payload.
      * Return a modified payload to add custom fields consumed by downstream integrations.
      */
-    onSaveEvent?: CallbackWithDescription<
-      (payload: K3ConfigurationSavedEvent) => K3ConfigurationSavedEvent
-    >;
+    onSaveEvent?: CallbackWithDescription<(payload: K3ConfigurationSavedEvent) => K3ConfigurationSavedEvent>;
   };
   /** Hooks into the camera and screenshot pipeline. */
   camera?: {
@@ -633,23 +739,17 @@ export interface K3LogicExtensions {
      * Called with the list of cameras used for automated screenshot capture.
      * Return a modified array to add, remove, or reorder screenshot cameras.
      */
-    onSetScreenshotCameras?: CallbackWithDescription<
-      (cameras: K3Camera[]) => K3Camera[]
-    >;
+    onSetScreenshotCameras?: CallbackWithDescription<(cameras: K3Camera[]) => K3Camera[]>;
     /**
      * Called with the full list of scene cameras available in the viewer.
      * Return a modified array to filter or reorder cameras shown in the UI.
      */
-    onSetCameraList?: CallbackWithDescription<
-      (cameras: K3Camera[]) => K3Camera[]
-    >;
+    onSetCameraList?: CallbackWithDescription<(cameras: K3Camera[]) => K3Camera[]>;
     /**
      * Called to determine the pixel dimensions used when rendering screenshots.
      * Return modified dimensions to override the default canvas size.
      */
-    getScreenshotDimensions?: CallbackWithDescription<
-      (dim: K3ScreenshotDimensions) => K3ScreenshotDimensions
-    >;
+    getScreenshotDimensions?: CallbackWithDescription<(dim: K3ScreenshotDimensions) => K3ScreenshotDimensions>;
   };
   /** Core app lifecycle hooks. */
   core?: {
@@ -667,19 +767,14 @@ export interface K3LogicExtensions {
      * Called when the user triggers an AR export.
      * Receives the target platform and live Three.js scene; must return a `Blob` of the AR file.
      */
-    onExportAR?: CallbackWithDescription<
-      (ctx: K3ARExportContext) => Promise<Blob>
-    >;
+    onExportAR?: CallbackWithDescription<(ctx: K3ARExportContext) => Promise<Blob>>;
   };
 }
-
-// ─── Model Slot Types ────────────────────────────────────────────────────────
-
 /**
  * Declares a named slot where child models can be placed inside a parent dynamic model.
  * Attach an array of these to `DynamicModel.slotDefinitions`.
  */
-export interface SlotDefinition {
+interface SlotDefinition {
   /** Unique identifier (UUID) — primary key used in rule columns to reference this slot. */
   id: string;
   /** Human-readable name shown in the admin slot picker. */
@@ -687,14 +782,16 @@ export interface SlotDefinition {
   /** Optional fallback model ID rendered when no rule assigns a model to this slot. */
   defaultModelId?: string | number;
 }
-
 /**
  * A resolved model instance placed into a slot at runtime.
  * Received via `DynamicModelComponentProps.slots[slotId]`.
  */
-export interface SlotModelInstance {
+interface SlotModelInstance {
   /** The model data object for this slot instance. */
-  model: { id: string | number; [key: string]: unknown };
+  model: {
+    id: string | number;
+    [key: string]: unknown;
+  };
   /** URL of the model's 3D file, or `undefined` if this is a dynamic model with a component. */
   fileURL: string | undefined;
   /** The React component used to render this model if it is a dynamic model otherwise `undefined`. */
@@ -718,12 +815,11 @@ export interface SlotModelInstance {
   /** Recursively nested slot instances when the slotted model itself has slots. */
   slots?: Record<string, SlotModelInstance[]>;
 }
-
 /**
  * Props automatically injected into every `DynamicModel.component` at runtime.
  * Extend this with your custom prop types: `DynamicModelComponentProps & { myProp: string }`.
  */
-export interface DynamicModelComponentProps {
+interface DynamicModelComponentProps {
   /**
    * Resolved child model instances keyed by slot ID.
    * Only present when the model has `slotDefinitions` and at least one slot is filled.
@@ -731,10 +827,7 @@ export interface DynamicModelComponentProps {
   slots?: Record<string, SlotModelInstance[]>;
   [key: string]: unknown;
 }
-
-// ─── Legacy types (unchanged) ────────────────────────────────────────────────
-
-export interface DynamicModel {
+interface DynamicModel {
   /** Unique type key used to reference this model from rule items, e.g. `"acme.my-model"`. */
   type: string;
   /** Human-readable display name shown in the admin model picker. */
@@ -761,19 +854,12 @@ export interface DynamicModel {
    */
   defaultProps: {
     slotDefinitions?: SlotDefinition[];
-    [key: string]:
-      | string
-      | number
-      | boolean
-      | ModelPropDefault
-      | undefined
-      | SlotDefinition[];
+    [key: string]: string | number | boolean | ModelPropDefault | undefined | SlotDefinition[];
   };
   /** Optional tag used to group or filter models in the admin UI. */
   tag?: string;
 }
-
-export interface ModelProp {
+interface ModelProp {
   /**
    * Editor widget type for this prop in the admin dialog.
    * `"basic"` — plain text/number input.
@@ -789,30 +875,26 @@ export interface ModelProp {
   /** For type="model": allow selecting multiple models. */
   multiple?: boolean;
 }
-
 /** All variable type string literals. */
-export const VariableType = {
-  List: "list",
-  Color: "color",
-  Number: "number",
-  Text: "text",
-  MultiSelect: "multiSelect",
-  Boolean: "boolean",
-  Image: "image",
-  Upload: "upload",
-  Components: "components",
-  Information: "information",
-} as const;
-
-export type VariableTypes = (typeof VariableType)[keyof typeof VariableType];
-
-export interface ModelPropDefault {
+declare const VariableType: {
+  readonly List: "list";
+  readonly Color: "color";
+  readonly Number: "number";
+  readonly Text: "text";
+  readonly MultiSelect: "multiSelect";
+  readonly Boolean: "boolean";
+  readonly Image: "image";
+  readonly Upload: "upload";
+  readonly Components: "components";
+  readonly Information: "information";
+};
+type VariableTypes = (typeof VariableType)[keyof typeof VariableType];
+interface ModelPropDefault {
   /** An expression string evaluated at runtime instead of a static value (e.g. `"group.width * 2"`). */
   expression?: string;
 }
-
 /** K3 Value object (list / color / boolean selection). */
-export interface Value {
+interface Value {
   /** Unique database ID of the value. */
   id: number | string;
   /** Optional stable string key for the value, usable as an alternative identifier. */
@@ -822,16 +904,16 @@ export interface Value {
   /** Human-readable display label shown in the configurator UI. */
   label: string;
 }
-
 /**
  * Context passed to plugin dynamic model components at runtime.
  */
-export interface PluginModelContext {
+interface PluginModelContext {
   /** Only set during screenshot rendering. */
   screenshotCameraName?: string;
   /** The unique ID of the model action this instance is rendered for. */
   modelActionId?: string;
 }
-
 /** @deprecated Use K3PluginDescriptor */
-export type K3Plugin = Pick<K3PluginDescriptor, "dynamicModels">;
+type K3Plugin = Pick<K3PluginDescriptor, "dynamicModels">;
+//#endregion
+export { CallbackWithDescription, CustomLayoutComponentProps, DynamicModel, DynamicModelComponentProps, HOC, HOCWithDescription, K3ARExportContext, K3ARPlatform, K3AppInfo, K3BomEntry, K3Camera, K3CameraScope, K3ComponentInstanceVariables, K3Configuration, K3ConfigurationSavedEvent, K3ConfigurationVariableEntry, K3ConfigurationVariables, K3Coordinates, K3DialogExtensions, K3FullApp, K3InputExtensions, K3LayoutExtensions, K3LogicExtensions, K3NewConfiguration, K3OrderDialogExtensions, K3OrthographicCamera, K3PerspectiveCamera, K3Plugin, K3PluginDescriptor, K3SaveResult, K3Scene, K3ScreenshotDimensions, K3Selection, K3SimplifiedValue, K3UIExtensions, K3UploadFile, K3VariableComponentProps, K3ViewerExtensions, K3WarningExtensions, LocalizedString, ModelProp, ModelPropDefault, PluginModelContext, SlotDefinition, SlotModelInstance, Value, VariableType, VariableTypes, VariableVisualisation, getSettings, init, useApp, useBOM, useConfigurationVariable, useConfigurationVariables, useFormattedTotalPrice, useK3PluginSettings, useTotalPrice };