@aicut/core 0.2.0 → 0.3.0

package/dist/lighting/index.d.cts

@@ -16,10 +16,6 @@ interface LightingLocale {
     lightingViewPerspective: string;
     lightingViewFront: string;
     lightingResetParams: string;
-    /** Aria label / tooltip for the × button that closes the Smart panel. */
-    lightingSmartClose: string;
-    /** Tooltip / label for the controls-header Smart Mode toggle. */
-    lightingSmartToggle: string;
     lightingDirLeft: string;
     lightingDirRight: string;
     lightingDirTop: string;
@@ -67,47 +63,26 @@ interface LightingEditorOptions {
     config?: Partial<LightingConfig>;
     /** Initial camera view. Default `"perspective"`. */
     view?: LightingView;
-    /**
-     * Whether the Smart Mode feature is wired in at all. When false the
-     * slot column never renders and the controls header hides the
-     * Smart Mode toggle — the layout becomes a clean 2-column
-     * (scene + controls). Default `true`.
-     */
-    smartEnabled?: boolean;
-    /**
-     * When `smartEnabled` is true, whether the Smart Mode slot panel
-     * starts open. Hosts toggle later via `api.setSmartOpen(bool)` or
-     * by clicking the library-rendered × button. Default `true`.
-     */
-    smartOpen?: boolean;
     /** Theme tokens — same shape as the video Editor's theme. */
     theme?: Theme;
     /** Locale overrides on top of English defaults (`localeEn` + `lightingLocaleEn`). */
     locale?: Partial<Locale & LightingLocale>;
     /** Fires on any config mutation (drag, slider, preset click, toggle). */
     onChange?: (cfg: LightingConfig) => void;
-    /**
-     * Surface event for the host's own "Generate" button — the library
-     * never wires this. Use `api.requestGenerate()` from your UI.
-     */
-    onGenerate?: (cfg: LightingConfig) => void;
-    /** Fires when the user toggles the Smart Mode panel via × / toggle. */
-    onSmartOpenChange?: (open: boolean) => void;
 }
 /** Safe, conservative defaults for first mount. */
 declare const DEFAULT_LIGHTING_CONFIG: LightingConfig;
 
 /**
- * Top-level lighting picker. Mirrors `Editor`'s lifecycle — `static
- * create(opts)`, wipes the container, owns DOM + WebGL, exposes
- * `destroy()` and reactive `setTheme` / `setLocale`. Separate from
- * the video Editor; the two can coexist in the same host page.
+ * Top-level lighting picker. Two columns: a 3D scene (sphere + subject
+ * plane + draggable light dot + cone beam) and a controls panel
+ * (brightness / color / 6-direction key-light grid / rim toggle).
  *
- * Layout (left → right):
- *   [scene 240px]  [controls 220px]  [smartSlot (drawer)]
- * The smart slot is host-supplied. Library renders a × close button
- * + a "Smart mode" toggle in the controls header when the slot is
- * available; `smartEnabled: false` removes the slot entirely.
+ * Deliberately scoped to JUST the picker — the host owns everything
+ * around it (smart-mode UI, generate buttons, layout, close handling,
+ * theming above the editor). Render <LightingEditor> alongside your
+ * own Smart panel in your own flex/grid; the library doesn't try to
+ * model "open / closed drawer" semantics for you.
  */
 declare class LightingEditor {
     private root;
@@ -115,22 +90,10 @@ declare class LightingEditor {
     private config;
     private view;
     private locale;
-    private smartEnabled;
-    private smartOpen;
     private scene;
     private controls;
     private sceneViewport;
     private viewToggleEl;
-    private body;
-    private smartWrapper;
-    private smartCloseBtn;
-    private smartToggleEl;
-    private smartToggleThumb;
-    /** Host slot the React/Vue wrapper portals/teleports into. Stable
-     *  reference across smartOpen toggles — only the wrapper around it
-     *  collapses/expands. Always present even when `smartEnabled: false`
-     *  so portals don't blow up; just detached from the visible tree. */
-    readonly smartSlot: HTMLDivElement;
     private resizeObs;
     private destroyed;
     static create(opts: LightingEditorOptions): LightingEditor;
@@ -140,33 +103,12 @@ declare class LightingEditor {
     setSubjectImage(url: string): void;
     setView(v: LightingView): void;
     getView(): LightingView;
-    /** Enable/disable the entire Smart Mode feature at runtime. */
-    setSmartEnabled(enabled: boolean): void;
-    isSmartEnabled(): boolean;
-    /** Open/close the smart slot drawer when enabled. No-op when disabled. */
-    setSmartOpen(open: boolean): void;
-    isSmartOpen(): boolean;
     setTheme(theme: Theme): void;
     setLocale(locale: Partial<Locale & LightingLocale>): void;
-    requestGenerate(): void;
     destroy(): void;
     private applyMutation;
     private buildViewToggle;
     private syncViewToggle;
-    /**
-     * Build the smart slot column wrapper: × close button + the actual
-     * host slot. Wrapper handles the drawer animation; slot reference
-     * stays stable so portals don't have to relocate.
-     */
-    private buildSmartWrapper;
-    /** Pill-style toggle that lives in the controls header. Re-opens
-     *  the smart drawer when the host has closed it via ×. */
-    private buildSmartToggle;
-    /** Re-translate smart-related labels after a locale swap. */
-    private syncSmartLocale;
-    /** Mirror smart state to data-* attrs + toggle thumb position.
-     *  Drives the CSS that collapses the column when closed. */
-    private syncSmartState;
 }
 
 /**

package/dist/lighting/index.d.ts

@@ -16,10 +16,6 @@ interface LightingLocale {
     lightingViewPerspective: string;
     lightingViewFront: string;
     lightingResetParams: string;
-    /** Aria label / tooltip for the × button that closes the Smart panel. */
-    lightingSmartClose: string;
-    /** Tooltip / label for the controls-header Smart Mode toggle. */
-    lightingSmartToggle: string;
     lightingDirLeft: string;
     lightingDirRight: string;
     lightingDirTop: string;
@@ -67,47 +63,26 @@ interface LightingEditorOptions {
     config?: Partial<LightingConfig>;
     /** Initial camera view. Default `"perspective"`. */
     view?: LightingView;
-    /**
-     * Whether the Smart Mode feature is wired in at all. When false the
-     * slot column never renders and the controls header hides the
-     * Smart Mode toggle — the layout becomes a clean 2-column
-     * (scene + controls). Default `true`.
-     */
-    smartEnabled?: boolean;
-    /**
-     * When `smartEnabled` is true, whether the Smart Mode slot panel
-     * starts open. Hosts toggle later via `api.setSmartOpen(bool)` or
-     * by clicking the library-rendered × button. Default `true`.
-     */
-    smartOpen?: boolean;
     /** Theme tokens — same shape as the video Editor's theme. */
     theme?: Theme;
     /** Locale overrides on top of English defaults (`localeEn` + `lightingLocaleEn`). */
     locale?: Partial<Locale & LightingLocale>;
     /** Fires on any config mutation (drag, slider, preset click, toggle). */
     onChange?: (cfg: LightingConfig) => void;
-    /**
-     * Surface event for the host's own "Generate" button — the library
-     * never wires this. Use `api.requestGenerate()` from your UI.
-     */
-    onGenerate?: (cfg: LightingConfig) => void;
-    /** Fires when the user toggles the Smart Mode panel via × / toggle. */
-    onSmartOpenChange?: (open: boolean) => void;
 }
 /** Safe, conservative defaults for first mount. */
 declare const DEFAULT_LIGHTING_CONFIG: LightingConfig;
 
 /**
- * Top-level lighting picker. Mirrors `Editor`'s lifecycle — `static
- * create(opts)`, wipes the container, owns DOM + WebGL, exposes
- * `destroy()` and reactive `setTheme` / `setLocale`. Separate from
- * the video Editor; the two can coexist in the same host page.
+ * Top-level lighting picker. Two columns: a 3D scene (sphere + subject
+ * plane + draggable light dot + cone beam) and a controls panel
+ * (brightness / color / 6-direction key-light grid / rim toggle).
  *
- * Layout (left → right):
- *   [scene 240px]  [controls 220px]  [smartSlot (drawer)]
- * The smart slot is host-supplied. Library renders a × close button
- * + a "Smart mode" toggle in the controls header when the slot is
- * available; `smartEnabled: false` removes the slot entirely.
+ * Deliberately scoped to JUST the picker — the host owns everything
+ * around it (smart-mode UI, generate buttons, layout, close handling,
+ * theming above the editor). Render <LightingEditor> alongside your
+ * own Smart panel in your own flex/grid; the library doesn't try to
+ * model "open / closed drawer" semantics for you.
  */
 declare class LightingEditor {
     private root;
@@ -115,22 +90,10 @@ declare class LightingEditor {
     private config;
     private view;
     private locale;
-    private smartEnabled;
-    private smartOpen;
     private scene;
     private controls;
     private sceneViewport;
     private viewToggleEl;
-    private body;
-    private smartWrapper;
-    private smartCloseBtn;
-    private smartToggleEl;
-    private smartToggleThumb;
-    /** Host slot the React/Vue wrapper portals/teleports into. Stable
-     *  reference across smartOpen toggles — only the wrapper around it
-     *  collapses/expands. Always present even when `smartEnabled: false`
-     *  so portals don't blow up; just detached from the visible tree. */
-    readonly smartSlot: HTMLDivElement;
     private resizeObs;
     private destroyed;
     static create(opts: LightingEditorOptions): LightingEditor;
@@ -140,33 +103,12 @@ declare class LightingEditor {
     setSubjectImage(url: string): void;
     setView(v: LightingView): void;
     getView(): LightingView;
-    /** Enable/disable the entire Smart Mode feature at runtime. */
-    setSmartEnabled(enabled: boolean): void;
-    isSmartEnabled(): boolean;
-    /** Open/close the smart slot drawer when enabled. No-op when disabled. */
-    setSmartOpen(open: boolean): void;
-    isSmartOpen(): boolean;
     setTheme(theme: Theme): void;
     setLocale(locale: Partial<Locale & LightingLocale>): void;
-    requestGenerate(): void;
     destroy(): void;
     private applyMutation;
     private buildViewToggle;
     private syncViewToggle;
-    /**
-     * Build the smart slot column wrapper: × close button + the actual
-     * host slot. Wrapper handles the drawer animation; slot reference
-     * stays stable so portals don't have to relocate.
-     */
-    private buildSmartWrapper;
-    /** Pill-style toggle that lives in the controls header. Re-opens
-     *  the smart drawer when the host has closed it via ×. */
-    private buildSmartToggle;
-    /** Re-translate smart-related labels after a locale swap. */
-    private syncSmartLocale;
-    /** Mirror smart state to data-* attrs + toggle thumb position.
-     *  Drives the CSS that collapses the column when closed. */
-    private syncSmartState;
 }
 
 /**

package/dist/lighting/index.js

@@ -209,8 +209,6 @@ var lightingLocaleEn = {
   lightingViewPerspective: "Perspective",
   lightingViewFront: "Front",
   lightingResetParams: "Reset",
-  lightingSmartClose: "Close Smart mode",
-  lightingSmartToggle: "Smart mode",
   lightingDirLeft: "Left",
   lightingDirRight: "Right",
   lightingDirTop: "Top",
@@ -228,8 +226,6 @@ var lightingLocaleZh = {
   lightingViewPerspective: "\u900F\u89C6",
   lightingViewFront: "\u6B63\u9762",
   lightingResetParams: "\u91CD\u7F6E\u53C2\u6570",
-  lightingSmartClose: "\u5173\u95ED\u667A\u80FD\u6A21\u5F0F",
-  lightingSmartToggle: "\u667A\u80FD\u6A21\u5F0F",
   lightingDirLeft: "\u5DE6\u4FA7",
   lightingDirRight: "\u53F3\u4FA7",
   lightingDirTop: "\u9876\u90E8",
@@ -18984,22 +18980,10 @@ var LightingEditor = class _LightingEditor {
   config;
   view;
   locale;
-  smartEnabled;
-  smartOpen;
   scene;
   controls;
   sceneViewport;
   viewToggleEl;
-  body;
-  smartWrapper = null;
-  smartCloseBtn = null;
-  smartToggleEl = null;
-  smartToggleThumb = null;
-  /** Host slot the React/Vue wrapper portals/teleports into. Stable
-   *  reference across smartOpen toggles — only the wrapper around it
-   *  collapses/expands. Always present even when `smartEnabled: false`
-   *  so portals don't blow up; just detached from the visible tree. */
-  smartSlot;
   resizeObs = null;
   destroyed = false;
   static create(opts) {
@@ -19010,8 +18994,6 @@ var LightingEditor = class _LightingEditor {
     this.root = opts.container;
     this.config = { ...DEFAULT_LIGHTING_CONFIG, ...opts.config };
     this.view = opts.view ?? "perspective";
-    this.smartEnabled = opts.smartEnabled !== false;
-    this.smartOpen = opts.smartOpen !== false;
     this.locale = {
       ...mergeLocale(opts.locale),
       ...mergeLightingLocale(opts.locale)
@@ -19020,9 +19002,9 @@ var LightingEditor = class _LightingEditor {
     this.root.innerHTML = "";
     if (!this.root.style.position) this.root.style.position = "relative";
     applyTheme(this.root, opts.theme);
-    this.body = document.createElement("div");
-    this.body.className = "aicut-lighting-body";
-    this.root.appendChild(this.body);
+    const body = document.createElement("div");
+    body.className = "aicut-lighting-body";
+    this.root.appendChild(body);
     const sceneCol = document.createElement("div");
     sceneCol.className = "aicut-lighting-scene-col";
     this.viewToggleEl = this.buildViewToggle();
@@ -19031,7 +19013,7 @@ var LightingEditor = class _LightingEditor {
     this.sceneViewport.className = "aicut-lighting-scene-viewport";
     this.sceneViewport.setAttribute("data-testid", "aicut-lighting-scene");
     sceneCol.appendChild(this.sceneViewport);
-    this.body.appendChild(sceneCol);
+    body.appendChild(sceneCol);
     this.controls = new LightingControls(this.locale, {
       onBrightnessChange: (level) => this.applyMutation({ brightness: level }),
       onColorChange: (hex) => this.applyMutation({ color: hex }),
@@ -19042,17 +19024,7 @@ var LightingEditor = class _LightingEditor {
       onRimToggle: (on) => this.applyMutation({ rim: on }),
       onReset: () => this.setConfig(DEFAULT_LIGHTING_CONFIG, "reset")
     });
-    this.body.appendChild(this.controls.root);
-    this.smartSlot = document.createElement("div");
-    this.smartSlot.className = "aicut-lighting-smart-slot";
-    this.smartSlot.setAttribute("data-testid", "aicut-lighting-smart");
-    if (this.smartEnabled) {
-      this.smartWrapper = this.buildSmartWrapper();
-      this.body.appendChild(this.smartWrapper);
-      this.smartToggleEl = this.buildSmartToggle();
-      this.controls.headerSlot.appendChild(this.smartToggleEl);
-    }
-    this.syncSmartState();
+    body.appendChild(this.controls.root);
     this.scene = new LightingScene(this.sceneViewport, this.view);
     this.scene.setLightDirection(this.config.keyDirection);
     this.scene.setBrightness(this.config.brightness);
@@ -19105,42 +19077,6 @@ var LightingEditor = class _LightingEditor {
   getView() {
     return this.view;
   }
-  /** Enable/disable the entire Smart Mode feature at runtime. */
-  setSmartEnabled(enabled) {
-    if (enabled === this.smartEnabled) return;
-    this.smartEnabled = enabled;
-    if (enabled) {
-      if (!this.smartWrapper) {
-        this.smartWrapper = this.buildSmartWrapper();
-        this.body.appendChild(this.smartWrapper);
-      }
-      if (!this.smartToggleEl) {
-        this.smartToggleEl = this.buildSmartToggle();
-        this.controls.headerSlot.appendChild(this.smartToggleEl);
-      }
-    } else {
-      this.smartWrapper?.remove();
-      this.smartWrapper = null;
-      this.smartCloseBtn = null;
-      this.smartToggleEl?.remove();
-      this.smartToggleEl = null;
-      this.smartToggleThumb = null;
-    }
-    this.syncSmartState();
-  }
-  isSmartEnabled() {
-    return this.smartEnabled;
-  }
-  /** Open/close the smart slot drawer when enabled. No-op when disabled. */
-  setSmartOpen(open) {
-    if (!this.smartEnabled || open === this.smartOpen) return;
-    this.smartOpen = open;
-    this.syncSmartState();
-    this.opts.onSmartOpenChange?.(open);
-  }
-  isSmartOpen() {
-    return this.smartOpen;
-  }
   setTheme(theme) {
     applyTheme(this.root, theme);
   }
@@ -19151,10 +19087,6 @@ var LightingEditor = class _LightingEditor {
     };
     this.controls.setLocale(this.locale);
     this.syncViewToggle();
-    this.syncSmartLocale();
-  }
-  requestGenerate() {
-    this.opts.onGenerate?.(this.getConfig());
   }
   destroy() {
     if (this.destroyed) return;
@@ -19163,8 +19095,6 @@ var LightingEditor = class _LightingEditor {
     this.scene.destroy();
     this.root.innerHTML = "";
     this.root.classList.remove("aicut-root", "aicut-lighting-editor");
-    this.root.removeAttribute("data-smart-enabled");
-    this.root.removeAttribute("data-smart-open");
   }
   // ---- Internal ------------------------------------------------------
   applyMutation(partial) {
@@ -19214,86 +19144,6 @@ var LightingEditor = class _LightingEditor {
       if (v === "front") btn.textContent = this.locale.lightingViewFront;
     }
   }
-  /**
-   * Build the smart slot column wrapper: × close button + the actual
-   * host slot. Wrapper handles the drawer animation; slot reference
-   * stays stable so portals don't have to relocate.
-   */
-  buildSmartWrapper() {
-    const wrap = document.createElement("div");
-    wrap.className = "aicut-lighting-smart-wrapper";
-    this.smartCloseBtn = document.createElement("button");
-    this.smartCloseBtn.type = "button";
-    this.smartCloseBtn.className = "aicut-lighting-smart-close";
-    this.smartCloseBtn.title = this.locale.lightingSmartClose;
-    this.smartCloseBtn.setAttribute("aria-label", this.locale.lightingSmartClose);
-    this.smartCloseBtn.setAttribute("data-testid", "aicut-lighting-smart-close");
-    this.smartCloseBtn.innerHTML = "×";
-    this.smartCloseBtn.addEventListener("click", () => this.setSmartOpen(false));
-    wrap.appendChild(this.smartCloseBtn);
-    wrap.appendChild(this.smartSlot);
-    return wrap;
-  }
-  /** Pill-style toggle that lives in the controls header. Re-opens
-   *  the smart drawer when the host has closed it via ×. */
-  buildSmartToggle() {
-    const row = document.createElement("div");
-    row.className = "aicut-lighting-smart-toggle-row";
-    const label = document.createElement("span");
-    label.className = "aicut-lighting-smart-toggle-label";
-    label.textContent = this.locale.lightingSmartToggle;
-    row.appendChild(label);
-    const toggle = document.createElement("div");
-    toggle.className = "aicut-lighting-toggle aicut-lighting-smart-toggle";
-    toggle.setAttribute("role", "switch");
-    toggle.setAttribute("tabindex", "0");
-    toggle.setAttribute("data-testid", "aicut-lighting-smart-toggle");
-    toggle.title = this.locale.lightingSmartToggle;
-    this.smartToggleThumb = document.createElement("div");
-    this.smartToggleThumb.className = "aicut-lighting-toggle-thumb";
-    toggle.appendChild(this.smartToggleThumb);
-    toggle.addEventListener("click", () => this.setSmartOpen(!this.smartOpen));
-    row.appendChild(toggle);
-    return row;
-  }
-  /** Re-translate smart-related labels after a locale swap. */
-  syncSmartLocale() {
-    if (this.smartCloseBtn) {
-      this.smartCloseBtn.title = this.locale.lightingSmartClose;
-      this.smartCloseBtn.setAttribute("aria-label", this.locale.lightingSmartClose);
-    }
-    if (this.smartToggleEl) {
-      const label = this.smartToggleEl.querySelector(
-        ".aicut-lighting-smart-toggle-label"
-      );
-      if (label) label.textContent = this.locale.lightingSmartToggle;
-      const toggle = this.smartToggleEl.querySelector(
-        ".aicut-lighting-smart-toggle"
-      );
-      if (toggle) toggle.title = this.locale.lightingSmartToggle;
-    }
-  }
-  /** Mirror smart state to data-* attrs + toggle thumb position.
-   *  Drives the CSS that collapses the column when closed. */
-  syncSmartState() {
-    this.root.setAttribute(
-      "data-smart-enabled",
-      this.smartEnabled ? "true" : "false"
-    );
-    this.root.setAttribute(
-      "data-smart-open",
-      this.smartOpen ? "true" : "false"
-    );
-    if (this.smartToggleEl) {
-      const toggle = this.smartToggleEl.querySelector(
-        ".aicut-lighting-smart-toggle"
-      );
-      if (toggle) {
-        toggle.classList.toggle("active", this.smartOpen);
-        toggle.setAttribute("aria-checked", this.smartOpen ? "true" : "false");
-      }
-    }
-  }
 };
 /*! Bundled license information: