k3-plugin-api 1.4.3 → 1.5.0

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

@@ -1,110 +1,72 @@
-import type React from "react";
+import React from "react";
 
-// ─── Plugin Runtime Hooks ───────────────────────────────────────────────────
+//#region index.d.ts
 
 /**
- * K3 runtime hooks available to plugins after initialization.
- * Set via `init()` when the plugin is loaded.
- */
-export interface K3Hooks {
-  /**
-   * React hook to access plugin-specific settings.
-   * @param pluginId - The unique plugin ID (e.g. "acme.my-plugin")
-   * @returns The settings object for this plugin, or `{}` if none are configured
-   */
-  useSettings: (pluginId: string) => unknown;
-  /**
-   * React hook to access the current Bill-of-Materials.
-   * @returns Array of BOM entries derived from the current selection
-   */
-  useBOM: () => K3BomEntry[];
-  /**
-   * React hook to access the current total price.
-   * @returns The effective total price (MOV-adjusted or overall price)
-   */
-  usePrice: () => number;
-}
-
-/**
- * Internal hook container that gets mutated by init().
- * This object is shared across Module Federation boundaries.
+ * 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 };
+ * if (settings.apiKey) {
+ *   // Use API key
+ * }
+ * ```
  */
-const _hooks = {
-  useSettings: ((pluginId: string) => {
-    throw new Error(
-      "k3-plugin-api not initialized. Make sure K3 calls init() before using hooks.",
-    );
-  }) as K3Hooks["useSettings"],
-
-  useBOM: (() => {
-    throw new Error(
-      "k3-plugin-api not initialized. Make sure K3 calls init() before using hooks.",
-    );
-  }) as K3Hooks["useBOM"],
-
-  usePrice: (() => {
-    throw new Error(
-      "k3-plugin-api not initialized. Make sure K3 calls init() before using hooks.",
-    );
-  }) as K3Hooks["usePrice"],
-};
-
+declare function getSettings(pluginId: string): unknown;
 /**
- * Hook functions injected by K3 at runtime.
- * Use these in your plugin components to access configurator state.
+ * 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 };
+ * ```
  */
-export const useSettings: K3Hooks["useSettings"] = (pluginId: string) =>
-  _hooks.useSettings(pluginId);
-export const useBOM: K3Hooks["useBOM"] = () => _hooks.useBOM();
-export const usePrice: K3Hooks["usePrice"] = () => _hooks.usePrice();
-
+declare function useK3PluginSettings(pluginId: string): unknown;
 /**
- * Called by K3 when the plugin is loaded to inject runtime hooks.
+ * 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(hooks: K3Hooks): void {
-  _hooks.useSettings = hooks.useSettings;
-  _hooks.useBOM = hooks.useBOM;
-  _hooks.usePrice = hooks.usePrice;
-}
-
-// ─── HOC type (mirrors K3 internal, no K3 imports) ──────────────────────────
-
+declare function init(api: {
+  getSettings: (pluginId: string) => unknown;
+  usePluginSettings: (pluginId: string) => unknown;
+}): 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. */
@@ -115,14 +77,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. */
@@ -130,8 +88,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. */
@@ -181,12 +138,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. */
@@ -233,20 +189,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.
@@ -260,8 +214,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. */
@@ -281,15 +234,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. */
@@ -309,8 +260,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. */
@@ -320,14 +270,11 @@ export interface K3WarningExtensions {
   /** Wraps the tooltip content shown when a number variable value is out of bounds. */
   numberWarningTooltip?: HOCWithDescription;
 }
-
-// ─── Viewer Extensions ──────────────────────────────────────────────────────
-
 /**
  * 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. */
@@ -342,18 +289,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;
   /**
@@ -369,8 +318,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;
   /**
@@ -380,11 +328,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. */
@@ -395,21 +339,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;
@@ -422,7 +365,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;
   /**
@@ -437,16 +383,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?: {
@@ -458,24 +407,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. */
@@ -485,9 +430,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;
   /**
@@ -496,9 +440,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. */
@@ -506,9 +449,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. */
@@ -529,12 +471,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;
@@ -549,9 +490,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. */
@@ -576,12 +516,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. */
@@ -599,59 +537,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?: {
@@ -659,23 +619,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?: {
@@ -693,19 +647,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. */
@@ -713,14 +662,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`. */
@@ -744,12 +695,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.
@@ -757,10 +707,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. */
@@ -787,19 +734,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.
@@ -815,30 +755,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. */
@@ -848,16 +784,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, K3BomEntry, K3Camera, K3CameraScope, K3Configuration, K3ConfigurationSavedEvent, K3Coordinates, K3DialogExtensions, K3FullApp, K3InputExtensions, K3LayoutExtensions, K3LogicExtensions, K3NewConfiguration, K3OrderDialogExtensions, K3OrthographicCamera, K3PerspectiveCamera, K3Plugin, K3PluginDescriptor, K3SaveResult, K3Scene, K3ScreenshotDimensions, K3Selection, K3UIExtensions, K3UploadFile, K3VariableComponentProps, K3ViewerExtensions, K3WarningExtensions, LocalizedString, ModelProp, ModelPropDefault, PluginModelContext, SlotDefinition, SlotModelInstance, Value, VariableType, VariableTypes, VariableVisualisation, getSettings, init, useK3PluginSettings };