@liquid-glass-forge/angular 0.0.0-stage → 0.1.0-rc.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nami Poursafargholi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE

@@ -0,0 +1,7 @@
+Liquid Glass Forge
+Copyright (c) 2026 Nami Poursafargholi. MIT licensed.
+
+Independent implementation inspired by Apple's Liquid Glass design.
+Not affiliated with, sponsored by or endorsed by Apple Inc.
+Apple and its design/assets remain subject to their respective rights.
+No Apple assets or upstream Liquid Glass/Sileo implementation is included.

package/README.md

@@ -1,3 +1,48 @@
-# Temporary Holding Version
+# <img src="https://raw.githubusercontent.com/namipsg/liquid-glass-forge/main/showcase/public/frameworks/angular.svg" width="20" height="20" alt=""> @liquid-glass-forge/angular
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Use standalone Angular glass surfaces and a shared scene directive.
+
+[Live showcase](https://namipsg.github.io/liquid-glass-forge/?framework=angular#developers) · [Examples](https://namipsg.github.io/liquid-glass-forge/examples.html) · [Documentation](https://github.com/namipsg/liquid-glass-forge/blob/main/docs/PHASE-9.md) · [Support](https://namipsg.github.io/liquid-glass-forge/support.html)
+
+## Install in Angular
+
+```sh
+npm install @liquid-glass-forge/angular@next @liquid-glass-forge/dom@next
+```
+
+The starter uses CSS glass and expects Angular core/common 22.2.4 and RxJS 7.8.2. Keep the Forge packages at matching versions.
+The [live installer](https://namipsg.github.io/liquid-glass-forge/?framework=angular#developers)
+shows verified exact versions and has a copy button.
+
+[Open the Angular starter](https://github.com/namipsg/liquid-glass-forge/blob/main/docs/QUICKSTART.md#angular) · [Add WebGL refraction](https://github.com/namipsg/liquid-glass-forge/blob/main/docs/QUICKSTART.md#add-webgl-refraction)
+
+[![A live glass lens bends the lettering beneath it](https://raw.githubusercontent.com/namipsg/liquid-glass-forge/main/docs/assets/glass-playground.gif)](https://namipsg.github.io/liquid-glass-forge/?framework=angular#developers)
+
+## Usage
+
+Experimental preview `0.1.0-rc.2`. Pinned peers: Angular core/common22.2.4
+and RxJS7.8.2. The ng-packagr output uses Angular Package Format, partial
+compilation, FESM2022 and bundled declarations. Angular/RxJS remain external.
+
+Import `GlassSceneDirective`, `GlassSurfaceComponent`, `GlassSurfaceDirective`
+from `@liquid-glass-forge/angular` in standalone component imports. Load
+`@liquid-glass-forge/dom/styles.css` through the application stylesheet pipeline.
+
+`lgf-surface` owns its decorative template canvas and projects normal content.
+`[lgfSurface]` binds a caller-template-owned direct canvas via required `lgfTarget`.
+Both expose `element`, `target` and `invalidate`; the component target is undefined
+before its view query resolves. Native controls remain Angular-owned.
+
+`[lgfScene]` shares an engine across descendants, accepting `lgfSource`,
+`lgfRenderer`, `lgfPaused` and `lgfTimeoutMs`, with errors emitted by `lgfError`.
+The caller owns reusable source/renderer objects. DestroyRef cleanup aborts work
+and disposes the scene/attachments without terminally disposing those objects.
+
+Browser activation requires local view readiness and application stability after
+a render callback. The callback alone is not treated as hydration completion.
+Only eager SSR hydration is qualified by current consumers; deferred/incremental
+hydration remains unqualified. Bitmap work runs outside Angular and does not
+write framework signals per frame. SSR import/render starts no engine.
+
+See the [integration guide](https://github.com/namipsg/liquid-glass-forge/blob/main/docs/PHASE-9.md) for the exact Angular/Node/TypeScript matrix,
+APF/linker evidence, ownership, and remaining qualification boundaries.

package/fesm2022/liquid-glass-forge-angular.mjs

@@ -0,0 +1,474 @@
+import { isPlatformBrowser } from "@angular/common";
+import * as i0 from "@angular/core";
+import { ApplicationRef, Component, DestroyRef, Directive, ElementRef, InjectionToken, NgZone, PLATFORM_ID, afterNextRender, effect, forwardRef, inject, input, output, signal, untracked, viewChild } from "@angular/core";
+import { takeUntilDestroyed } from "@angular/core/rxjs-interop";
+import { filter, take } from "rxjs";
+import { createGlassScene } from "@liquid-glass-forge/dom";
+const SCENE = new InjectionToken("LiquidGlassForgeScene");
+function afterStableView(action) {
+	const destroy = inject(DestroyRef), app = inject(ApplicationRef), zone = inject(NgZone);
+	if (!isPlatformBrowser(inject(PLATFORM_ID))) return;
+	const render = afterNextRender(() => zone.runOutsideAngular(() => {
+		app.isStable.pipe(filter(Boolean), take(1), takeUntilDestroyed(destroy)).subscribe(() => {
+			if (!destroy.destroyed) action();
+		});
+	}));
+	destroy.onDestroy(() => render.destroy());
+}
+var GlassSceneDirective = class GlassSceneDirective {
+	lgfSource = input(...ngDevMode ? [void 0, { debugName: "lgfSource" }] : /* istanbul ignore next */ []);
+	lgfRenderer = input(...ngDevMode ? [void 0, { debugName: "lgfRenderer" }] : /* istanbul ignore next */ []);
+	lgfTimeoutMs = input(...ngDevMode ? [void 0, { debugName: "lgfTimeoutMs" }] : /* istanbul ignore next */ []);
+	lgfPaused = input(false, ...ngDevMode ? [{ debugName: "lgfPaused" }] : /* istanbul ignore next */ []);
+	lgfError = output();
+	state = signal(null, ...ngDevMode ? [{ debugName: "state" }] : /* istanbul ignore next */ []);
+	scene = this.state.asReadonly();
+	zone = inject(NgZone);
+	destroy = inject(DestroyRef);
+	ready = false;
+	viewReady = false;
+	previous;
+	constructor() {
+		afterStableView(() => {
+			this.ready = true;
+			this.apply();
+		});
+		effect(() => {
+			this.lgfSource();
+			this.lgfRenderer();
+			this.lgfTimeoutMs();
+			this.lgfPaused();
+			untracked(() => this.apply());
+		});
+		this.destroy.onDestroy(() => {
+			this.ready = false;
+			this.state()?.dispose();
+			this.state.set(null);
+		});
+	}
+	ngAfterViewInit() {
+		this.viewReady = true;
+		this.apply();
+	}
+	apply() {
+		if (!this.ready || !this.viewReady || this.destroy.destroyed) return;
+		this.zone.runOutsideAngular(() => {
+			const source = this.lgfSource(), renderer = this.lgfRenderer(), timeout = this.lgfTimeoutMs();
+			if (!this.previous || source !== this.previous[0] || renderer !== this.previous[1] || timeout !== this.previous[2]) {
+				this.state()?.dispose();
+				const outside = source ? {
+					read: (options) => this.zone.runOutsideAngular(() => source.read(options)),
+					...source.subscribe ? { subscribe: (listener) => this.zone.runOutsideAngular(() => source.subscribe(() => this.zone.runOutsideAngular(listener))) } : {}
+				} : void 0;
+				const next = createGlassScene({
+					...outside ? { source: outside } : {},
+					...renderer ? { renderer } : {},
+					...timeout === void 0 ? {} : { timeoutMs: timeout },
+					onError: (cause) => {
+						if (!this.destroy.destroyed) this.zone.run(() => this.lgfError.emit(cause));
+					}
+				});
+				if (this.lgfPaused()) next.pause();
+				this.previous = [
+					source,
+					renderer,
+					timeout
+				];
+				this.state.set(next);
+			} else {
+				const current = this.state();
+				if (this.lgfPaused()) current?.pause();
+				else if (current?.state === "paused") current.resume();
+			}
+		});
+	}
+	static ɵfac = i0.ɵɵngDeclareFactory({
+		minVersion: "12.0.0",
+		version: "22.2.4",
+		ngImport: i0,
+		type: GlassSceneDirective,
+		deps: [],
+		target: i0.ɵɵFactoryTarget.Directive
+	});
+	static ɵdir = i0.ɵɵngDeclareDirective({
+		minVersion: "17.1.0",
+		version: "22.2.4",
+		type: GlassSceneDirective,
+		isStandalone: true,
+		selector: "[lgfScene]",
+		inputs: {
+			lgfSource: {
+				classPropertyName: "lgfSource",
+				publicName: "lgfSource",
+				isSignal: true,
+				isRequired: false,
+				transformFunction: null
+			},
+			lgfRenderer: {
+				classPropertyName: "lgfRenderer",
+				publicName: "lgfRenderer",
+				isSignal: true,
+				isRequired: false,
+				transformFunction: null
+			},
+			lgfTimeoutMs: {
+				classPropertyName: "lgfTimeoutMs",
+				publicName: "lgfTimeoutMs",
+				isSignal: true,
+				isRequired: false,
+				transformFunction: null
+			},
+			lgfPaused: {
+				classPropertyName: "lgfPaused",
+				publicName: "lgfPaused",
+				isSignal: true,
+				isRequired: false,
+				transformFunction: null
+			}
+		},
+		outputs: { lgfError: "lgfError" },
+		providers: [{
+			provide: SCENE,
+			useExisting: forwardRef(() => GlassSceneDirective)
+		}],
+		exportAs: ["lgfScene"],
+		ngImport: i0
+	});
+};
+i0.ɵɵngDeclareClassMetadata({
+	minVersion: "12.0.0",
+	version: "22.2.4",
+	ngImport: i0,
+	type: GlassSceneDirective,
+	decorators: [{
+		type: Directive,
+		args: [{
+			selector: "[lgfScene]",
+			standalone: true,
+			exportAs: "lgfScene",
+			providers: [{
+				provide: SCENE,
+				useExisting: forwardRef(() => GlassSceneDirective)
+			}]
+		}]
+	}],
+	ctorParameters: () => [],
+	propDecorators: {
+		lgfSource: [{
+			type: i0.Input,
+			args: [{
+				isSignal: true,
+				alias: "lgfSource",
+				required: false
+			}]
+		}],
+		lgfRenderer: [{
+			type: i0.Input,
+			args: [{
+				isSignal: true,
+				alias: "lgfRenderer",
+				required: false
+			}]
+		}],
+		lgfTimeoutMs: [{
+			type: i0.Input,
+			args: [{
+				isSignal: true,
+				alias: "lgfTimeoutMs",
+				required: false
+			}]
+		}],
+		lgfPaused: [{
+			type: i0.Input,
+			args: [{
+				isSignal: true,
+				alias: "lgfPaused",
+				required: false
+			}]
+		}],
+		lgfError: [{
+			type: i0.Output,
+			args: ["lgfError"]
+		}]
+	}
+});
+var SurfaceBinding = class {
+	element;
+	shared;
+	attachment;
+	owned;
+	lastScene;
+	lastTarget;
+	lastMaterial;
+	constructor(element, shared) {
+		this.element = element;
+		this.shared = shared;
+	}
+	update(target, scene, material) {
+		if (this.shared && !scene) {
+			this.detach();
+			return;
+		}
+		if (!this.shared) this.owned ??= createGlassScene();
+		const current = scene ?? this.owned;
+		if (current.state === "destroyed") {
+			this.detach();
+			return;
+		}
+		if (this.attachment && this.lastScene === current && this.lastTarget === target) {
+			if (this.lastMaterial !== material) this.attachment.update({ material });
+		} else {
+			this.detach();
+			this.attachment = current.attach(this.element, {
+				target,
+				material
+			});
+			this.lastScene = current;
+			this.lastTarget = target;
+		}
+		this.lastMaterial = material;
+	}
+	invalidate() {
+		this.attachment?.invalidate();
+	}
+	detach() {
+		this.attachment?.dispose();
+		this.attachment = void 0;
+		this.lastScene = void 0;
+		this.lastTarget = void 0;
+		this.lastMaterial = void 0;
+	}
+	destroy() {
+		this.detach();
+		this.owned?.dispose();
+		this.owned = void 0;
+	}
+};
+var GlassSurfaceComponent = class GlassSurfaceComponent {
+	material = input("glass", ...ngDevMode ? [{ debugName: "material" }] : /* istanbul ignore next */ []);
+	canvas = viewChild("glassTarget", ...ngDevMode ? [{ debugName: "canvas" }] : /* istanbul ignore next */ []);
+	host = inject(ElementRef);
+	parent = inject(SCENE, { optional: true });
+	zone = inject(NgZone);
+	destroy = inject(DestroyRef);
+	binding = new SurfaceBinding(this.host.nativeElement, !!this.parent);
+	ready = false;
+	viewReady = false;
+	constructor() {
+		afterStableView(() => {
+			this.ready = true;
+			this.refresh();
+		});
+		effect(() => {
+			this.material();
+			this.canvas();
+			this.parent?.scene();
+			untracked(() => this.refresh());
+		});
+		this.destroy.onDestroy(() => {
+			this.ready = false;
+			this.binding.destroy();
+		});
+	}
+	ngAfterViewInit() {
+		this.viewReady = true;
+		this.refresh();
+	}
+	get element() {
+		return this.host.nativeElement;
+	}
+	get target() {
+		return this.canvas()?.nativeElement;
+	}
+	invalidate() {
+		this.zone.runOutsideAngular(() => this.binding.invalidate());
+	}
+	refresh() {
+		if (!this.ready || !this.viewReady || this.destroy.destroyed) return;
+		const target = this.target;
+		if (!target) return;
+		this.zone.runOutsideAngular(() => this.binding.update(target, this.parent?.scene() ?? null, this.material()));
+	}
+	static ɵfac = i0.ɵɵngDeclareFactory({
+		minVersion: "12.0.0",
+		version: "22.2.4",
+		ngImport: i0,
+		type: GlassSurfaceComponent,
+		deps: [],
+		target: i0.ɵɵFactoryTarget.Component
+	});
+	static ɵcmp = i0.ɵɵngDeclareComponent({
+		minVersion: "17.2.0",
+		version: "22.2.4",
+		type: GlassSurfaceComponent,
+		isStandalone: true,
+		selector: "lgf-surface",
+		inputs: { material: {
+			classPropertyName: "material",
+			publicName: "material",
+			isSignal: true,
+			isRequired: false,
+			transformFunction: null
+		} },
+		host: { classAttribute: "lgf-host" },
+		viewQueries: [{
+			propertyName: "canvas",
+			first: true,
+			predicate: ["glassTarget"],
+			descendants: true,
+			isSignal: true
+		}],
+		exportAs: ["lgfSurface"],
+		ngImport: i0,
+		template: "<canvas #glassTarget class=\"lgf-surface\" [attr.data-lgf-material]=\"material()\" aria-hidden=\"true\" role=\"presentation\" tabindex=\"-1\"></canvas><ng-content />",
+		isInline: true,
+		styles: [":host{display:block}\n"]
+	});
+};
+i0.ɵɵngDeclareClassMetadata({
+	minVersion: "12.0.0",
+	version: "22.2.4",
+	ngImport: i0,
+	type: GlassSurfaceComponent,
+	decorators: [{
+		type: Component,
+		args: [{
+			selector: "lgf-surface",
+			standalone: true,
+			exportAs: "lgfSurface",
+			host: { class: "lgf-host" },
+			template: "<canvas #glassTarget class=\"lgf-surface\" [attr.data-lgf-material]=\"material()\" aria-hidden=\"true\" role=\"presentation\" tabindex=\"-1\"></canvas><ng-content />",
+			styles: [":host{display:block}\n"]
+		}]
+	}],
+	ctorParameters: () => [],
+	propDecorators: {
+		material: [{
+			type: i0.Input,
+			args: [{
+				isSignal: true,
+				alias: "material",
+				required: false
+			}]
+		}],
+		canvas: [{
+			type: i0.ViewChild,
+			args: ["glassTarget", { isSignal: true }]
+		}]
+	}
+});
+var GlassSurfaceDirective = class GlassSurfaceDirective {
+	lgfTarget = input.required(...ngDevMode ? [{ debugName: "lgfTarget" }] : /* istanbul ignore next */ []);
+	lgfMaterial = input("glass", ...ngDevMode ? [{ debugName: "lgfMaterial" }] : /* istanbul ignore next */ []);
+	host = inject(ElementRef);
+	parent = inject(SCENE, { optional: true });
+	zone = inject(NgZone);
+	destroy = inject(DestroyRef);
+	binding = new SurfaceBinding(this.host.nativeElement, !!this.parent);
+	ready = false;
+	viewReady = false;
+	constructor() {
+		afterStableView(() => {
+			this.ready = true;
+			this.refresh();
+		});
+		effect(() => {
+			this.lgfTarget();
+			this.lgfMaterial();
+			this.parent?.scene();
+			untracked(() => this.refresh());
+		});
+		this.destroy.onDestroy(() => {
+			this.ready = false;
+			this.binding.destroy();
+		});
+	}
+	ngAfterViewInit() {
+		this.viewReady = true;
+		this.refresh();
+	}
+	get element() {
+		return this.host.nativeElement;
+	}
+	get target() {
+		return this.lgfTarget();
+	}
+	invalidate() {
+		this.zone.runOutsideAngular(() => this.binding.invalidate());
+	}
+	refresh() {
+		if (!this.ready || !this.viewReady || this.destroy.destroyed) return;
+		this.zone.runOutsideAngular(() => this.binding.update(this.target, this.parent?.scene() ?? null, this.lgfMaterial()));
+	}
+	static ɵfac = i0.ɵɵngDeclareFactory({
+		minVersion: "12.0.0",
+		version: "22.2.4",
+		ngImport: i0,
+		type: GlassSurfaceDirective,
+		deps: [],
+		target: i0.ɵɵFactoryTarget.Directive
+	});
+	static ɵdir = i0.ɵɵngDeclareDirective({
+		minVersion: "17.1.0",
+		version: "22.2.4",
+		type: GlassSurfaceDirective,
+		isStandalone: true,
+		selector: "[lgfSurface]",
+		inputs: {
+			lgfTarget: {
+				classPropertyName: "lgfTarget",
+				publicName: "lgfTarget",
+				isSignal: true,
+				isRequired: true,
+				transformFunction: null
+			},
+			lgfMaterial: {
+				classPropertyName: "lgfMaterial",
+				publicName: "lgfMaterial",
+				isSignal: true,
+				isRequired: false,
+				transformFunction: null
+			}
+		},
+		host: { classAttribute: "lgf-host" },
+		exportAs: ["lgfSurface"],
+		ngImport: i0
+	});
+};
+i0.ɵɵngDeclareClassMetadata({
+	minVersion: "12.0.0",
+	version: "22.2.4",
+	ngImport: i0,
+	type: GlassSurfaceDirective,
+	decorators: [{
+		type: Directive,
+		args: [{
+			selector: "[lgfSurface]",
+			standalone: true,
+			exportAs: "lgfSurface",
+			host: { class: "lgf-host" }
+		}]
+	}],
+	ctorParameters: () => [],
+	propDecorators: {
+		lgfTarget: [{
+			type: i0.Input,
+			args: [{
+				isSignal: true,
+				alias: "lgfTarget",
+				required: true
+			}]
+		}],
+		lgfMaterial: [{
+			type: i0.Input,
+			args: [{
+				isSignal: true,
+				alias: "lgfMaterial",
+				required: false
+			}]
+		}]
+	}
+});
+export { GlassSceneDirective, GlassSurfaceComponent, GlassSurfaceDirective };
+
+//# sourceMappingURL=liquid-glass-forge-angular.mjs.map

package/fesm2022/liquid-glass-forge-angular.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"liquid-glass-forge-angular.mjs","names":[],"sources":["../../src/public-api.ts"],"sourcesContent":["import { isPlatformBrowser } from '@angular/common';\nimport { afterNextRender, ApplicationRef, Component, DestroyRef, Directive, effect, ElementRef, forwardRef, inject, InjectionToken, input, NgZone, output, PLATFORM_ID, signal, untracked, viewChild } from '@angular/core';\nimport { takeUntilDestroyed } from '@angular/core/rxjs-interop';\nimport { filter, take } from 'rxjs';\nimport { createGlassScene } from '@liquid-glass-forge/dom';\nimport type { GlassAttachment, GlassMaterial, GlassRenderer, GlassScene, SceneSource } from '@liquid-glass-forge/dom';\n\n/** Private per-provider context; scenes never become Angular application globals. */\nconst SCENE = new InjectionToken<GlassSceneDirective>('LiquidGlassForgeScene');\n\n/** Local view readiness plus application stability, not a global hydration claim.\n * Incremental/deferred hydration is outside this package's tested support matrix. */\nfunction afterStableView(action: () => void): void {\n  const destroy = inject(DestroyRef), app = inject(ApplicationRef), zone = inject(NgZone);\n  if (!isPlatformBrowser(inject(PLATFORM_ID))) return;\n  const render = afterNextRender(() => zone.runOutsideAngular(() => {\n    app.isStable.pipe(filter(Boolean), take(1), takeUntilDestroyed(destroy)).subscribe(() => {\n      if (!destroy.destroyed) action();\n    });\n  }));\n  destroy.onDestroy(() => render.destroy());\n}\n\n/** Borrowed inputs; this directive owns one cancellable scene lifetime. */\n@Directive({ selector: '[lgfScene]', standalone: true, exportAs: 'lgfScene', providers: [{ provide: SCENE, useExisting: forwardRef(() => GlassSceneDirective) }] })\nexport class GlassSceneDirective {\n  readonly lgfSource = input<SceneSource>();\n  readonly lgfRenderer = input<GlassRenderer>();\n  readonly lgfTimeoutMs = input<number>();\n  readonly lgfPaused = input(false);\n  readonly lgfError = output<unknown>();\n  private readonly state = signal<GlassScene | null>(null);\n  readonly scene = this.state.asReadonly();\n  private readonly zone = inject(NgZone);\n  private readonly destroy = inject(DestroyRef);\n  private ready = false;\n  private viewReady = false;\n  private previous: readonly [SceneSource | undefined, GlassRenderer | undefined, number | undefined] | undefined;\n  constructor() {\n    afterStableView(() => { this.ready = true; this.apply(); });\n    effect(() => {\n      this.lgfSource(); this.lgfRenderer(); this.lgfTimeoutMs(); this.lgfPaused();\n      untracked(() => this.apply());\n    });\n    this.destroy.onDestroy(() => { this.ready = false; this.state()?.dispose(); this.state.set(null); });\n  }\n  ngAfterViewInit(): void { this.viewReady = true; this.apply(); }\n  private apply(): void {\n    if (!this.ready || !this.viewReady || this.destroy.destroyed) return;\n    this.zone.runOutsideAngular(() => {\n      const source = this.lgfSource(), renderer = this.lgfRenderer(), timeout = this.lgfTimeoutMs();\n      if (!this.previous || source !== this.previous[0] || renderer !== this.previous[1] || timeout !== this.previous[2]) {\n        this.state()?.dispose();\n        // Source callbacks can be invoked from a zoned application event. Keep\n        // acquisition, invalidation and renderer work outside Angular scheduling.\n        const outside: SceneSource | undefined = source ? {\n          read: options => this.zone.runOutsideAngular(() => source.read(options)),\n          ...(source.subscribe ? { subscribe: (listener: () => void) => this.zone.runOutsideAngular(() => source.subscribe!(() => this.zone.runOutsideAngular(listener))) } : {}),\n        } : undefined;\n        const next = createGlassScene({ ...(outside ? { source: outside } : {}), ...(renderer ? { renderer } : {}),\n          ...(timeout === undefined ? {} : { timeoutMs: timeout }), onError: cause => { if (!this.destroy.destroyed) this.zone.run(() => this.lgfError.emit(cause)); } });\n        if (this.lgfPaused()) next.pause();\n        this.previous = [source, renderer, timeout]; this.state.set(next);\n      } else {\n        const current = this.state();\n        if (this.lgfPaused()) current?.pause(); else if (current?.state === 'paused') current.resume();\n      }\n    });\n  }\n}\n\n/** Engine state is ordinary data; bitmap completion never writes Angular signals. */\nclass SurfaceBinding {\n  private attachment: GlassAttachment | undefined;\n  private owned: GlassScene | undefined;\n  private lastScene: GlassScene | undefined;\n  private lastTarget: HTMLCanvasElement | undefined;\n  private lastMaterial: GlassMaterial | undefined;\n  constructor(private readonly element: HTMLElement, private readonly shared: boolean) {}\n  update(target: HTMLCanvasElement, scene: GlassScene | null, material: GlassMaterial): void {\n    if (this.shared && !scene) { this.detach(); return; }\n    if (!this.shared) this.owned ??= createGlassScene();\n    const current = scene ?? this.owned!;\n    if (current.state === 'destroyed') { this.detach(); return; }\n    if (this.attachment && this.lastScene === current && this.lastTarget === target) {\n      if (this.lastMaterial !== material) this.attachment.update({ material });\n    } else {\n      this.detach();\n      this.attachment = current.attach(this.element, { target, material });\n      this.lastScene = current; this.lastTarget = target;\n    }\n    this.lastMaterial = material;\n  }\n  invalidate(): void { this.attachment?.invalidate(); }\n  private detach(): void { this.attachment?.dispose(); this.attachment = undefined; this.lastScene = undefined; this.lastTarget = undefined; this.lastMaterial = undefined; }\n  destroy(): void { this.detach(); this.owned?.dispose(); this.owned = undefined; }\n}\n\n/** Angular owns the custom host, decorative canvas and projected semantic DOM. */\n@Component({\n  selector: 'lgf-surface', standalone: true, exportAs: 'lgfSurface',\n  host: { class: 'lgf-host' }, styles: [':host { display: block; }'],\n  template: '<canvas #glassTarget class=\"lgf-surface\" [attr.data-lgf-material]=\"material()\" aria-hidden=\"true\" role=\"presentation\" tabindex=\"-1\"></canvas><ng-content />',\n})\nexport class GlassSurfaceComponent {\n  readonly material = input<GlassMaterial>('glass');\n  private readonly canvas = viewChild<ElementRef<HTMLCanvasElement>>('glassTarget');\n  private readonly host = inject<ElementRef<HTMLElement>>(ElementRef);\n  private readonly parent = inject(SCENE, { optional: true });\n  private readonly zone = inject(NgZone);\n  private readonly destroy = inject(DestroyRef);\n  private readonly binding = new SurfaceBinding(this.host.nativeElement, !!this.parent);\n  private ready = false;\n  private viewReady = false;\n  constructor() {\n    afterStableView(() => { this.ready = true; this.refresh(); });\n    effect(() => { this.material(); this.canvas(); this.parent?.scene(); untracked(() => this.refresh()); });\n    this.destroy.onDestroy(() => { this.ready = false; this.binding.destroy(); });\n  }\n  ngAfterViewInit(): void { this.viewReady = true; this.refresh(); }\n  get element(): HTMLElement { return this.host.nativeElement; }\n  get target(): HTMLCanvasElement | undefined { return this.canvas()?.nativeElement; }\n  invalidate(): void { this.zone.runOutsideAngular(() => this.binding.invalidate()); }\n  private refresh(): void {\n    if (!this.ready || !this.viewReady || this.destroy.destroyed) return;\n    const target = this.target; if (!target) return;\n    this.zone.runOutsideAngular(() => this.binding.update(target, this.parent?.scene() ?? null, this.material()));\n  }\n}\n\n/** Bind a caller-template-owned direct canvas child; never create or move nodes. */\n@Directive({ selector: '[lgfSurface]', standalone: true, exportAs: 'lgfSurface', host: { class: 'lgf-host' } })\nexport class GlassSurfaceDirective {\n  readonly lgfTarget = input.required<HTMLCanvasElement>();\n  readonly lgfMaterial = input<GlassMaterial>('glass');\n  private readonly host = inject<ElementRef<HTMLElement>>(ElementRef);\n  private readonly parent = inject(SCENE, { optional: true });\n  private readonly zone = inject(NgZone);\n  private readonly destroy = inject(DestroyRef);\n  private readonly binding = new SurfaceBinding(this.host.nativeElement, !!this.parent);\n  private ready = false;\n  private viewReady = false;\n  constructor() {\n    afterStableView(() => { this.ready = true; this.refresh(); });\n    effect(() => { this.lgfTarget(); this.lgfMaterial(); this.parent?.scene(); untracked(() => this.refresh()); });\n    this.destroy.onDestroy(() => { this.ready = false; this.binding.destroy(); });\n  }\n  ngAfterViewInit(): void { this.viewReady = true; this.refresh(); }\n  get element(): HTMLElement { return this.host.nativeElement; }\n  get target(): HTMLCanvasElement { return this.lgfTarget(); }\n  invalidate(): void { this.zone.runOutsideAngular(() => this.binding.invalidate()); }\n  private refresh(): void {\n    if (!this.ready || !this.viewReady || this.destroy.destroyed) return;\n    this.zone.runOutsideAngular(() => this.binding.update(this.target, this.parent?.scene() ?? null, this.lgfMaterial()));\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,40 @@
 {
   "name": "@liquid-glass-forge/angular",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0-rc.2",
+  "private": false,
+  "type": "module",
+  "sideEffects": false,
+  "license": "MIT",
+  "engines": {
+    "node": "^22.22.3 || ^24.15.0 || >=26.0.0"
+  },
+  "peerDependencies": {
+    "@angular/core": "22.2.4",
+    "@angular/common": "22.2.4",
+    "rxjs": "7.8.2"
+  },
+  "dependencies": {
+    "@liquid-glass-forge/dom": "0.1.0-rc.2",
+    "tslib": "2.9.1"
+  },
+  "homepage": "https://namipsg.github.io/liquid-glass-forge/?framework=angular#developers",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/namipsg/liquid-glass-forge.git",
+    "directory": "packages/angular"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "module": "fesm2022/liquid-glass-forge-angular.mjs",
+  "typings": "types/liquid-glass-forge-angular.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./types/liquid-glass-forge-angular.d.ts",
+      "default": "./fesm2022/liquid-glass-forge-angular.mjs"
+    }
+  }
 }

package/types/liquid-glass-forge-angular.d.ts

@@ -0,0 +1,102 @@
+import { GlassMaterial, GlassRenderer, GlassScene, SceneSource } from "@liquid-glass-forge/dom";
+import * as i0 from "@angular/core";
+/** Borrowed inputs; this directive owns one cancellable scene lifetime. */
+export declare class GlassSceneDirective {
+  readonly lgfSource: import("@angular/core").InputSignal<SceneSource | undefined>;
+  readonly lgfRenderer: import("@angular/core").InputSignal<GlassRenderer | undefined>;
+  readonly lgfTimeoutMs: import("@angular/core").InputSignal<number | undefined>;
+  readonly lgfPaused: import("@angular/core").InputSignal<boolean>;
+  readonly lgfError: import("@angular/core").OutputEmitterRef<unknown>;
+  private readonly state;
+  readonly scene: import("@angular/core").Signal<GlassScene | null>;
+  private readonly zone;
+  private readonly destroy;
+  private ready;
+  private viewReady;
+  private previous;
+  constructor();
+  ngAfterViewInit(): void;
+  private apply;
+  static ɵfac: i0.ɵɵFactoryDeclaration<GlassSceneDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<GlassSceneDirective, "[lgfScene]", ["lgfScene"], {
+    "lgfSource": {
+      "alias": "lgfSource";
+      "required": false;
+      "isSignal": true;
+    };
+    "lgfRenderer": {
+      "alias": "lgfRenderer";
+      "required": false;
+      "isSignal": true;
+    };
+    "lgfTimeoutMs": {
+      "alias": "lgfTimeoutMs";
+      "required": false;
+      "isSignal": true;
+    };
+    "lgfPaused": {
+      "alias": "lgfPaused";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "lgfError": "lgfError";
+  }, never, never, true, never>;
+}
+/** Angular owns the custom host, decorative canvas and projected semantic DOM. */
+export declare class GlassSurfaceComponent {
+  readonly material: import("@angular/core").InputSignal<GlassMaterial>;
+  private readonly canvas;
+  private readonly host;
+  private readonly parent;
+  private readonly zone;
+  private readonly destroy;
+  private readonly binding;
+  private ready;
+  private viewReady;
+  constructor();
+  ngAfterViewInit(): void;
+  get element(): HTMLElement;
+  get target(): HTMLCanvasElement | undefined;
+  invalidate(): void;
+  private refresh;
+  static ɵfac: i0.ɵɵFactoryDeclaration<GlassSurfaceComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<GlassSurfaceComponent, "lgf-surface", ["lgfSurface"], {
+    "material": {
+      "alias": "material";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, ["*"], true, never>;
+}
+/** Bind a caller-template-owned direct canvas child; never create or move nodes. */
+export declare class GlassSurfaceDirective {
+  readonly lgfTarget: import("@angular/core").InputSignal<HTMLCanvasElement>;
+  readonly lgfMaterial: import("@angular/core").InputSignal<GlassMaterial>;
+  private readonly host;
+  private readonly parent;
+  private readonly zone;
+  private readonly destroy;
+  private readonly binding;
+  private ready;
+  private viewReady;
+  constructor();
+  ngAfterViewInit(): void;
+  get element(): HTMLElement;
+  get target(): HTMLCanvasElement;
+  invalidate(): void;
+  private refresh;
+  static ɵfac: i0.ɵɵFactoryDeclaration<GlassSurfaceDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<GlassSurfaceDirective, "[lgfSurface]", ["lgfSurface"], {
+    "lgfTarget": {
+      "alias": "lgfTarget";
+      "required": true;
+      "isSignal": true;
+    };
+    "lgfMaterial": {
+      "alias": "lgfMaterial";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}