@nvidia-elements/core 2.22.4 → 2.23.0

package/CHANGELOG.md

@@ -1,3 +1,16 @@
+## [2.23.0](https://github.com/NVIDIA/elements/compare/@nvidia-elements/core-v2.22.5...@nvidia-elements/core-v2.23.0) (2026-11-07)
+
+### Features
+
+* **core:** add ghost and workspace ([c2bdec9](https://github.com/NVIDIA/elements/commit/c2bdec9701628add8dc364786023a6019660aee3))
+
+## [2.22.5](https://github.com/NVIDIA/elements/compare/@nvidia-elements/core-v2.22.4...@nvidia-elements/core-v2.22.5) (2026-11-06)
+
+### Bug Fixes
+
+* **core:** drop obsolete element internals polyfill ([bb0649c](https://github.com/NVIDIA/elements/commit/bb0649ced505ef4cfc0f050302046794a935441a))
+* **docs:** update 3d-force-graph to 1.80.2 ([86a69e9](https://github.com/NVIDIA/elements/commit/86a69e92a607dc254ca7df2e3e4428ae0d6126e5))
+
 ## [2.22.4](https://github.com/NVIDIA/elements/compare/@nvidia-elements/core-v2.22.3...@nvidia-elements/core-v2.22.4) (2026-11-06)
 
 ### Bug Fixes

package/dist/accordion/accordion2.js

@@ -31,7 +31,7 @@ var b = {
 	static {
 		this.metadata = {
 			tag: "nve-accordion-header",
-			version: "2.22.4"
+			version: "2.23.0"
 		};
 	}
 	render() {
@@ -49,7 +49,7 @@ var S = class extends h {
 	static {
 		this.metadata = {
 			tag: "nve-accordion-content",
-			version: "2.22.4"
+			version: "2.23.0"
 		};
 	}
 	render() {
@@ -65,7 +65,7 @@ var S = class extends h {
 	static {
 		this.metadata = {
 			tag: "nve-accordion",
-			version: "2.22.4",
+			version: "2.23.0",
 			children: [
 				x.metadata.tag,
 				S.metadata.tag,
@@ -123,7 +123,7 @@ var w = class extends h {
 	static {
 		this.metadata = {
 			tag: "nve-accordion-group",
-			version: "2.22.4",
+			version: "2.23.0",
 			children: [C.metadata.tag]
 		};
 	}

package/dist/alert/alert-group2.js

@@ -19,7 +19,7 @@ var f = class extends c {
 	static {
 		this.metadata = {
 			tag: "nve-alert-group",
-			version: "2.22.4",
+			version: "2.23.0",
 			children: [o.metadata.tag]
 		};
 	}

package/dist/alert/alert2.js

@@ -34,7 +34,7 @@ var v = {
 	static {
 		this.metadata = {
 			tag: "nve-alert",
-			version: "2.22.4"
+			version: "2.23.0"
 		};
 	}
 	static {

package/dist/avatar/avatar-group2.js

@@ -10,7 +10,7 @@ var a = class extends r {
 	static {
 		this.metadata = {
 			tag: "nve-avatar-group",
-			version: "2.22.4"
+			version: "2.23.0"
 		};
 	}
 	render() {

package/dist/avatar/avatar2.js

@@ -11,7 +11,7 @@ var s = class extends i {
 	static {
 		this.metadata = {
 			tag: "nve-avatar",
-			version: "2.22.4"
+			version: "2.23.0"
 		};
 	}
 	render() {

package/dist/badge/badge2.js

@@ -21,7 +21,7 @@ var h = class extends d {
 	static {
 		this.metadata = {
 			tag: "nve-badge",
-			version: "2.22.4"
+			version: "2.23.0"
 		};
 	}
 	static {

package/dist/breadcrumb/breadcrumb2.js

@@ -24,7 +24,7 @@ var m = class extends u {
 	static {
 		this.metadata = {
 			tag: "nve-breadcrumb",
-			version: "2.22.4"
+			version: "2.23.0"
 		};
 	}
 	static {

package/dist/bundle.d.ts

@@ -29,6 +29,7 @@ import '@nvidia-elements/core/format-relative-time/define.js';
 import '@nvidia-elements/core/format-truncate/define.js';
 import '@nvidia-elements/core/forms/define.js';
 import '@nvidia-elements/core/gauge/define.js';
+import '@nvidia-elements/core/ghost/define.js';
 import '@nvidia-elements/core/grid/define.js';
 import '@nvidia-elements/core/icon/define.js';
 import '@nvidia-elements/core/icon-button/define.js';
@@ -72,6 +73,7 @@ import '@nvidia-elements/core/toolbar/define.js';
 import '@nvidia-elements/core/tooltip/define.js';
 import '@nvidia-elements/core/tree/define.js';
 import '@nvidia-elements/core/week/define.js';
+import '@nvidia-elements/core/workspace/define.js';
 export * from '@nvidia-elements/core/accordion';
 export * from '@nvidia-elements/core/alert';
 export * from '@nvidia-elements/core/avatar';
@@ -103,6 +105,7 @@ export * from '@nvidia-elements/core/format-relative-time';
 export * from '@nvidia-elements/core/format-truncate';
 export * from '@nvidia-elements/core/forms';
 export * from '@nvidia-elements/core/gauge';
+export * from '@nvidia-elements/core/ghost';
 export * from '@nvidia-elements/core/grid';
 export * from '@nvidia-elements/core/icon';
 export * from '@nvidia-elements/core/icon-button';
@@ -146,3 +149,4 @@ export * from '@nvidia-elements/core/toolbar';
 export * from '@nvidia-elements/core/tooltip';
 export * from '@nvidia-elements/core/tree';
 export * from '@nvidia-elements/core/week';
+export * from '@nvidia-elements/core/workspace';

package/dist/bundles/index.d.ts

@@ -124,6 +124,7 @@ export interface I18nStrings {
 	reducedMotion: string;
 	colorScheme: string;
 	resize: string;
+	move: string;
 	or: string;
 	files: string;
 	dragAndDrop: string;
@@ -3403,6 +3404,32 @@ export declare class Gauge extends LitElement {
 	willUpdate(props: PropertyValues<this>): void;
 	updated(props: PropertyValues<this>): void;
 }
+/**
+ * @element nve-ghost
+ * @description An inert visual preview of content or its prospective placement. Applications control its geometry, movement, and accessible feedback.
+ * @documentation https://nvidia.github.io/elements/docs/elements/ghost/
+ * @since 0.0.0
+ * @stable false
+ * @entrypoint \@nvidia-elements/core/ghost
+ * @slot - Presentation content for the preview.
+ * @cssprop --background
+ * @cssprop --border
+ * @cssprop --border-radius
+ * @cssprop --color
+ * @cssprop --stack-offset-x - Nonnegative horizontal distance between layers. Defaults to 4px.
+ * @cssprop --stack-offset-y - Nonnegative vertical distance between layers. Defaults to 4px.
+ * @cssprop --padding
+ */
+export declare class Ghost extends LitElement {
+	static styles: CSSResult[];
+	static readonly metadata: {
+		tag: string;
+		version: string;
+	};
+	/** Number of visual surfaces. Rendering truncates fractions and clamps to one through three; nonfinite values use one. */
+	layers: number;
+	render(): TemplateResult<1>;
+}
 /**
  * @element nve-grid-column
  * @description Defines a column header within a grid, specifying the column's label, width, and alignment for all cells beneath it.
@@ -5906,6 +5933,315 @@ export declare class Week extends Control implements ContainerElement {
 	};
 	protected get suffixContent(): TemplateResult<1>;
 }
+export type WorkspaceNode = WorkspaceGroup | WorkspaceSplit;
+export interface WorkspaceGroup {
+	type: "group";
+	panels: string[];
+	active: string;
+}
+export interface WorkspaceSplit {
+	type: "split";
+	axis: "horizontal" | "vertical";
+	weights: number[];
+	children: WorkspaceNode[];
+}
+export interface WorkspaceLayout {
+	version: 1;
+	root: WorkspaceNode | null;
+	closed: string[];
+}
+export interface WorkspaceHeaderConfiguration {
+	selected: boolean;
+	offset: number;
+	animate: boolean;
+	tabWidth: number;
+	headerHeight: number;
+	suffixEnd: number;
+	clipLeft: number;
+	clipWidth: number;
+}
+/**
+ * @element nve-workspace-panel
+ * @description Stable application content and its workspace chrome.
+ * @documentation https://nvidia.github.io/elements/docs/elements/workspace/
+ * @since 0.0.0
+ * @stable false
+ * @entrypoint \@nvidia-elements/core/workspace
+ * @command --enter-fullscreen - Present this panel's group in native fullscreen.
+ * @command --exit-fullscreen - Exit native fullscreen.
+ * @command --toggle-fullscreen - Toggle native fullscreen for this panel's group.
+ * @command --open - Open and activate the targeted supplied panel. Repeated activation is silent.
+ * @command --close - Close the targeted panel when its workspace is closable.
+ * @command --select - Activate an open supplied panel without reopening a closed panel.
+ * @command --place - Apply the invoker's typed placement request when rearrangeable; membership changes also require groupable.
+ * @slot - Application content.
+ * @slot header - Title and controls.
+ * @slot footer - Status and actions.
+ * @cssprop --background
+ * @cssprop --border
+ * @cssprop --box-shadow
+ */
+export declare class WorkspacePanel extends LitElement {
+	static styles: CSSResult[];
+	static readonly metadata: {
+		tag: string;
+		version: string;
+		parents: string[];
+		children: string[];
+	};
+	/** Application minimum total panel width in pixels. */
+	minWidth: number;
+	/** Application minimum total panel height in pixels. */
+	minHeight: number;
+	private selected;
+	private headerHeight;
+	/** @internal */
+	_internals: ElementInternals;
+	connectedCallback(): void;
+	render(): TemplateResult<1>;
+	/** @internal */
+	_present(presented: boolean): void;
+	/** @internal */
+	_configure(configuration: WorkspaceHeaderConfiguration & {
+		scrollLeft: number;
+	}): void;
+}
+export type WorkspaceSide = "left" | "right" | "top" | "bottom";
+/** A placement supplied on the invoker's `placement` property for `--place`.
+ * Source defaults to one panel; `group` carries its entire current group, including closed members.
+ * An arrangement target identifies the enclosing split of the target panel, before source removal.
+ */
+export type WorkspacePlacement = {
+	source?: "panel" | "group";
+} & ({
+	operation: "split";
+	target: string;
+	position: WorkspaceSide;
+} | {
+	operation: "join";
+	target: string;
+	index?: number;
+} | {
+	operation: "reorder";
+	target: string;
+	position: "before" | "after";
+} | {
+	operation: "insert";
+	scope: "arrangement";
+	target: string;
+	position: WorkspaceSide;
+} | {
+	operation: "insert";
+	scope: "workspace";
+	position: WorkspaceSide;
+});
+/** Identifies a supplied panel and optional placement without requiring an invoker element. */
+export interface WorkspaceCommandContext {
+	value?: string | null;
+	placement?: WorkspacePlacement;
+}
+export interface WorkspaceCommandSource extends HTMLElement, WorkspaceCommandContext {
+	disabled?: boolean;
+	readOnly?: boolean;
+}
+export interface WorkspaceAnimationOptions {
+	readonly duration?: number;
+}
+/**
+ * @element nve-workspace
+ * @description A workspace provides a malleable arrangement of application panels in a restorable layout.
+ * @documentation https://nvidia.github.io/elements/docs/elements/workspace/
+ * @since 0.0.0
+ * @stable false
+ * @entrypoint \@nvidia-elements/core/workspace
+ * @command --enter-fullscreen - Present the invoking panel's group in native fullscreen.
+ * @command --exit-fullscreen - Exit native fullscreen.
+ * @command --toggle-fullscreen - Toggle native fullscreen for the invoking panel's group.
+ * @command --open - Open and activate the targeted supplied panel. Repeated activation is silent.
+ * @command --close - Close the targeted panel when its workspace is closable.
+ * @command --select - Activate an open supplied panel without reopening a closed panel.
+ * @command --place - Apply the invoker's typed placement request when rearrangeable; membership changes also require groupable.
+ * @slot - Workspace panels with durable IDs and application dropdown groups.
+ * @event change - Announces a committed arrangement value after interaction, commands, or reconciliation of newly supplied panels. Read value on the workspace.
+ * @event commandavailabilitychange - Command availability may have changed; query relevant commands again.
+ * @cssprop --gap - Space between groups as one nonnegative CSS length.
+ * @cssprop --border-radius - Corner radius of contained groups.
+ * @cssprop --tab-min-width - Smallest tab width before scrolling.
+ * @cssprop --tab-border - Border between tabs, after the drag handle, and before group controls without an authored suffix.
+ * @cssprop --header-control-size - Size of built-in header buttons and the base drag handle width.
+ * @cssprop --header-control-inset - Horizontal spacing around fullscreen and the drag handle.
+ * @cssprop --close-button-inset - Space after each panel close control.
+ * @cssprop --animation-duration - Duration of coordinated layout and placement transitions.
+ * @cssprop --animation-easing - Easing of coordinated layout and placement transitions.
+ * @cssprop --gutter-background - Idle separator fill.
+ * @cssprop --gutter-hover-background - Separator fill on hover.
+ * @csspart tabs - Tab strips.
+ * @csspart tabs-item - Panel selection controls.
+ * @csspart tab - Alias for panel selection controls.
+ * @csspart tabs-item-group - Tab and accessory layouts.
+ * @csspart icon-button - Built-in header icon controls.
+ * @csspart fullscreen-button - Group fullscreen control.
+ * @csspart close-button - Panel closing controls.
+ * @csspart resize-handle - Separator control.
+ * @csspart ghost - Destination and carried previews.
+ * @csspart destination-ghost - Animated insertion cue.
+ * @csspart carried-ghost - Pointer-following carried panel previews.
+ * @csspart icon - Placement status icons.
+ * @csspart blocked-icon - Unavailable placement indicator.
+ * @csspart drag-handle - Group movement control.
+ */
+export declare class Workspace extends LitElement {
+	#private;
+	static styles: CSSResult[];
+	static readonly metadata: {
+		tag: string;
+		version: string;
+		children: string[];
+	};
+	static elementDefinitions: {
+		[DragHandle.metadata.tag]: typeof DragHandle;
+		[Ghost.metadata.tag]: typeof Ghost;
+		[Icon.metadata.tag]: typeof Icon;
+		[IconButton.metadata.tag]: typeof IconButton;
+		[ResizeHandle.metadata.tag]: typeof ResizeHandle;
+		[Tabs.metadata.tag]: typeof Tabs;
+		[TabsItem.metadata.tag]: typeof TabsItem;
+		[TabsItemGroup.metadata.tag]: typeof TabsItemGroup;
+	};
+	/** Overrides localized workspace controls. */
+	i18n: Partial<I18nStrings & {
+		__set: boolean;
+	}>;
+	/** Enables separator resizing. */
+	resizable: boolean;
+	/** Enables moving groups and placement commands. Dragging individual tabs also requires groupable. */
+	rearrangeable: boolean;
+	/** Enables dragging individual tabs, joining panels, and extracting panels when rearrangeable. */
+	groupable: boolean;
+	/** Enables native fullscreen commands and one persistent control per group. Turning this off preserves an accepted session and its exit control. Fullscreen does not change the saved arrangement. */
+	fullscreenable: boolean;
+	/** Radial pointer distance in CSS pixels before a carried source detaches. Captured at gesture press. */
+	detachThreshold: number;
+	/** Enables closing supplied panels. */
+	closable: boolean;
+	/** Selects separator constraint behavior. */
+	resizePolicy: "stop" | "propagate";
+	/** Selects panel content framing. */
+	container?: "inset" | "flat" | "full";
+	/** Versioned JSON arrangement. Assignment restores without emitting change. */
+	get value(): string;
+	set value(value: string);
+	connectedCallback(): void;
+	disconnectedCallback(): void;
+	protected willUpdate(changed: PropertyValues): void;
+	protected updated(): void;
+	/** Restores an arrangement with animated geometry while retaining application content. */
+	animateTo(value: string, options?: WorkspaceAnimationOptions): void;
+	/** Reports whether a command can change the panel identified by `context.value` in the current arrangement. Native fullscreen admission remains subject to browser permission. */
+	isCommandAvailable(command: string, context?: WorkspaceCommandContext): boolean;
+	render(): TemplateResult<1>;
+}
+/**
+ * @element nve-workspace-panel-header
+ * @description Supplies a workspace panel title, decoration, and application controls.
+ * @documentation https://nvidia.github.io/elements/docs/elements/workspace/
+ * @since 0.0.0
+ * @stable false
+ * @entrypoint \@nvidia-elements/core/workspace
+ * @slot - Noninteractive panel title.
+ * @slot prefix - Noninteractive title decoration.
+ * @slot suffix - Application controls for the selected panel.
+ * @cssprop --min-height
+ * @cssprop --padding - Padding around the title.
+ * @cssprop --prefix-padding - Padding around title decoration.
+ * @cssprop --prefix-border - Border after title decoration.
+ * @cssprop --suffix-padding - Override the shared inset around header controls.
+ * @cssprop --suffix-border - Border before header controls.
+ * @cssprop --gap
+ * @cssprop --border-bottom
+ */
+export declare class WorkspacePanelHeader extends LitElement {
+	#private;
+	static styles: CSSResult[];
+	static readonly metadata: {
+		tag: string;
+		version: string;
+		parents: string[];
+	};
+	/** @private */
+	slot: string;
+	/** @private */
+	_internals: ElementInternals;
+	private configuration;
+	connectedCallback(): void;
+	disconnectedCallback(): void;
+	protected updated(): void;
+	render(): TemplateResult<1>;
+	/** @internal */
+	_getMeasurementTargets(): {
+		label: HTMLElement | null;
+		suffix: HTMLElement | null;
+	};
+	/** @internal */
+	_getTransitionTargets(): {
+		labelViewport: HTMLElement | null;
+		labelTrack: HTMLElement | null;
+		label: HTMLElement | null;
+		suffix: HTMLElement | null;
+	};
+	/** @internal */
+	_hover(hovered: boolean): void;
+	/** @internal */
+	_configure({ scrollLeft, ...configuration }: WorkspaceHeaderConfiguration & {
+		scrollLeft: number;
+	}): void;
+	/** @internal */
+	_scroll(scrollLeft: number): void;
+	/** @internal */
+	_bindScroll(source: HTMLElement | undefined, extent: number): void;
+}
+/**
+ * @element nve-workspace-panel-content
+ * @description Provides padding for workspace panel content.
+ * @documentation https://nvidia.github.io/elements/docs/elements/workspace/
+ * @since 0.0.0
+ * @stable false
+ * @entrypoint \@nvidia-elements/core/workspace
+ * @slot - Application content.
+ * @cssprop --padding
+ */
+export declare class WorkspacePanelContent extends LitElement {
+	static styles: CSSResult[];
+	static readonly metadata: {
+		tag: string;
+		version: string;
+		parents: string[];
+	};
+	render(): TemplateResult<1>;
+}
+/**
+ * @element nve-workspace-panel-footer
+ * @description Provides workspace panel status and actions outside the scrolling body.
+ * @documentation https://nvidia.github.io/elements/docs/elements/workspace/
+ * @since 0.0.0
+ * @stable false
+ * @entrypoint \@nvidia-elements/core/workspace
+ * @slot - Status and actions.
+ * @cssprop --padding
+ * @cssprop --border-top
+ * @cssprop --gap
+ */
+export declare class WorkspacePanelFooter extends LitElement {
+	static styles: CSSResult[];
+	static readonly metadata: {
+		tag: string;
+		version: string;
+		parents: string[];
+	};
+	/** @private */
+	slot: string;
+	render(): TemplateResult<1>;
+}
 
 export {
 	Color$1 as Color,