@albi_scando/as-design-system-threejs-lib 1.1.6 → 1.1.7

package/dist/types/web-components/language-picker/component.d.ts

@@ -84,9 +84,13 @@ export declare class LanguagePickerComponent extends HTMLElement {
      */
     private setupHtmlElements;
     /**
-     * Set up Three.js elemnents.
+     * Set up Three.js elements.
      */
     private setupScene;
+    /**
+     * Cache references to UI elements like the BarMenu and menu container, and set initial styles.
+     */
+    private setupUI;
     /**
      * Create flag meshes, position them in a circle, and set up their wind parameters.
      */
@@ -96,15 +100,11 @@ export declare class LanguagePickerComponent extends HTMLElement {
      */
     private resizeHandler;
     private listenToBarMenuNavigation;
-    /**
-     * Cache references to UI elements like the BarMenu and menu container, and set initial styles.
-     */
-    private setupUI;
     private _computeIntroCameraEndPosition;
     /**
-     * Programmatically select a language by its locale key.
-     * Rotates the flags ring and syncs the BarMenu to show the correct autonym.
-     * Safe to call before init — queued and applied once the component is ready.
+     * Public method to select a language. Updates the selected language and rotates the flags and BarMenu accordingly.
+     * @param language Locale key of the language to select.
+     * @returns {void}
      */
     select(language: Locales): void;
     /**
@@ -120,6 +120,11 @@ export declare class LanguagePickerComponent extends HTMLElement {
     private _syncBarMenuToId;
     private setupConfirmationDialog;
     private barMenuButtonClickHandler;
+    /**
+     * Handler for when the user confirms their language selection in the confirmation dialog.
+     * Dispatches a custom event with the new selected language.
+     * @returns {void}
+     */
     private _handleConfirmation;
     private _animate;
     private _updateGroupRotation;

package/dist/types/web-components/theme-picker/component.d.ts

@@ -1,9 +1,8 @@
-import { Themes } from '@albi_scando/as-const-lib';
-export declare class ThemeCubeComponent extends HTMLElement {
+import { Themes } from '@albi_scando/as-const-themes-lib';
+export declare class ThemePickerComponent extends HTMLElement {
     private static readonly textureLoader;
     readonly shadowRoot: ShadowRoot;
     static get observedAttributes(): string[];
-    private static readonly FACE_VISUALS;
     private static readonly CUBE_SIDE_LENGTH;
     private options;
     /**
@@ -11,19 +10,20 @@ export declare class ThemeCubeComponent extends HTMLElement {
      * UI preview and confirmation derive from this value.
      */
     private selected;
+    private selectedTmp;
     private _renderer;
     private _scene;
     private _camera;
     private _root;
     private _canvas;
-    private _cube;
-    private _cubeGeometry;
-    private _cubeMaterials;
     private _resizeObserver;
     private _clock;
     private _lastTime;
+    private _cube;
+    private _cubeGeometry;
+    private _cubeMaterials;
     private _animationFrameId;
-    private _hintTop;
+    private previewDialog;
     private _previewTitle;
     private _previewSub;
     private _applyBtn;
@@ -37,6 +37,7 @@ export declare class ThemeCubeComponent extends HTMLElement {
     private _dragPointerId;
     private _rotX;
     private _rotY;
+    private _rotZ;
     private _idleSeconds;
     private _autoSpinEnabled;
     private _autoVelX;
@@ -47,16 +48,46 @@ export declare class ThemeCubeComponent extends HTMLElement {
     private readonly _tmpWorldNormal;
     constructor();
     attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
+    /**
+     * Called when the component is added to the DOM.
+     */
     connectedCallback(): void;
+    /**
+     * Called when the component is removed from the DOM.
+     */
     disconnectedCallback(): void;
+    /**
+     * Initialize the component with a set of options.
+     * @param options Set of keys representing the options to display.
+     */
     private init;
+    /**
+     * Cache references to important HTML elements.
+     */
     private setupHtmlElements;
+    /**
+     * Set up Three.js elements.
+     */
     private setupScene;
+    /**
+     * Cache references to important UI elements and set up initial states.
+     */
     private setupUI;
+    /**
+     * Set up the cube mesh with one face per theme option, applying textures or fallback visuals as needed.
+     */
     private setupCube;
+    /**
+     * Set up a ResizeObserver to handle canvas resizing and update the camera aspect ratio.
+     */
     private resizeHandler;
     private setupApplyButton;
     private setupConfirmationDialog;
+    /**
+     * Public method to select a theme. Updates the selected theme and rotates the cube accordingly.
+     * @param theme Theme key of the theme to select.
+     * @returns {void}
+     */
     select(theme: Themes): void;
     private _syncRotationToSelected;
     private _handleApplyClick;
@@ -70,17 +101,25 @@ export declare class ThemeCubeComponent extends HTMLElement {
     private _setMaterialTexture;
     private _createFallbackFaceTexture;
     private _getThemeIdForFace;
-    private _formatThemeName;
-    private _restoreThemePreview;
     private _stopAutoSpinFromInteraction;
     private _onPointerDown;
     private _onPointerMove;
     private _onPointerUp;
+    /**
+     * Bind event listeners. Separated from setupUI for clarity and
+     * to ensure all HTML elements are available before binding.
+     */
     private _bindEvents;
+    /**
+     * Unbind all event listeners to prevent memory leaks and
+     * unintended behavior when the component is removed from the DOM.
+     */
     private _unbindEvents;
-    private _parseThemesAttribute;
-    private _sanitizeThemes;
-    private _normalizeOptions;
+    /**
+     * Handler for when the user confirms their theme selection in the confirmation dialog.
+     * Dispatches a custom event with the new selection.
+     * @returns {void}
+     */
     private _handleConfirmation;
     private _handleConfirmationCancel;
     private _resolveThemeFaceVisual;

package/dist/types/web-components/theme-picker/default-values.const.d.ts

@@ -1,4 +1,4 @@
-import { Themes } from '@albi_scando/as-const-lib';
+import { Themes } from '@albi_scando/as-const-themes-lib';
 export declare const DEFAULT_VALUES: {
     readonly selected: "dark-purple";
     readonly options: Set<Themes>;

package/dist/types/web-components/theme-picker/main.d.ts

@@ -1,4 +1,4 @@
-export { ThemeCubeComponent } from './component';
+export { ThemePickerComponent } from './component';
 export { selector } from './selector';
 export { COMPONENT_CUSTOM_MESSAGES } from './custom-messages.const';
 export { OBSERVED_ATTRIBUTES } from './observed-attributes.const';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@albi_scando/as-design-system-threejs-lib",
-  "version": "1.1.6",
+  "version": "1.1.7",
   "description": "A library of reusable, strongly typed threejs Web Components built with TypeScript, designed for creating consistent and maintainable user interfaces.",
   "type": "module",
   "files": [
@@ -46,10 +46,6 @@
     "storybook-build": "storybook build"
   },
   "devDependencies": {
-    "@albi_scando/as-const-languages-lib": "^1.1.1",
-    "@albi_scando/as-const-lib": "^1.11.0",
-    "@albi_scando/as-design-system-lib": "^1.7.2",
-    "@albi_scando/as-threejs-flags-lib": "^2.3.2",
     "@commitlint/cli": "^20.4.1",
     "@commitlint/config-conventional": "^20.4.1",
     "@eslint/js": "^9.39.2",
@@ -93,7 +89,8 @@
   "peerDependencies": {
     "@albi_scando/as-const-languages-lib": "^1.1.0",
     "@albi_scando/as-const-lib": "^1.9.0",
-    "@albi_scando/as-design-system-lib": "^1.6.0",
+    "@albi_scando/as-const-themes-lib": "^1.0.0",
+    "@albi_scando/as-design-system-lib": "^1.7.2",
     "@albi_scando/as-threejs-flags-lib": "^2.3.2",
     "@fontsource/material-symbols-outlined": "^5.0.0",
     "@types/three": "^0.179.0",