@qr-city/angular 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dani Oliva
+
+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/README.md

@@ -1,3 +1,57 @@
-# Temporary Holding Version
+# @qr-city/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.
+Angular component for **qr-city**: a 3D city whose rooftops form a scannable QR code. Standalone, zoneless- and SSR-friendly. Angular ≥ 21, `three` as a *peerDependency*.
+
+```bash
+npm i @qr-city/angular three
+```
+
+```ts
+import { Component } from '@angular/core';
+import { QrCityComponent } from '@qr-city/angular';
+
+@Component({
+  selector: 'app-city',
+  imports: [QrCityComponent],
+  template: `
+    <qr-city-view #city data="https://your-site.dev" cityStyle="ciberpunk" style="width: 480px" (revealed)="ready()" />
+    <button (click)="city.reveal()">Reveal QR</button>
+  `,
+})
+export class CityComponent {
+  ready() { console.log('city ready'); }
+}
+```
+
+## Inputs and outputs
+
+The same options as [`createQrCity`](../core), as `input()`s: `data` (required), `cityStyle`, `intro`, `pauseAtThreshold`, `view`, `errorCorrection`, `quality`, `interactive`, `animate`, `maxPixelRatio`, `zoomable`, `maxZoom`, `wheelZoom`, `fallback`, `background`, `label` and `doorLabel`. **`cityStyle`** is the city's style (`'moderna' | 'costera' | 'ciberpunk' | 'nevada'` or a `QrCityStyle` object).
+
+| Output | Payload |
+| --- | --- |
+| `revealed` | — |
+| `introStageChange` | `'door' \| 'entering' \| 'threshold' \| 'flying' \| 'done'` |
+| `viewChange` | `'city' \| 'qr'` |
+| `zoomChange` | `number` |
+| `fallbackUsed` | `Error`: no WebGL, a flat scannable QR is shown |
+| `qrError` | `Error` |
+
+The selector is `qr-city-view` (so it does not clash with the `<qr-city>` Web Component). By default it is a square as wide as its container.
+
+## Behaviour
+
+- **Server (SSR):** WebGL starts in `afterNextRender`, which does not run on the server.
+- **Zone:** the animation loop runs outside `NgZone`, so it does not trigger change detection every frame. Outputs are emitted inside the zone.
+- **Input changes:** applied in place; the city only rebuilds when `data`, `cityStyle`, `errorCorrection` or `quality` change.
+- **`intro`** is fixed at creation: if it changes, the component restarts.
+- **Without WebGL** a flat, scannable QR is shown and `fallbackUsed` is emitted (`fallback="none"` to get a `qrError` instead). **Other errors** (invalid data…) reach `qrError`; in dev mode they are also written to the console.
+- **Printable QR:** `toQrSvg()` / `toQrPng()` on the component, or `qrToSvg(data)` / `qrToPng(data)` (exported).
+- **Component methods:** `reveal()`, `setView()`, `toggleView()`, `setZoom()`, `zoomBy()`, `resetZoom()`, `openDoor()`, `continueIntro()`, `skipIntro()`, `toPNG()`, `play()`, `pause()`, plus `controller`, `stage`, `currentView`, `zoom`.
+
+## Publishing
+
+ng-packagr builds the package into `packages/angular/dist`; publish from that folder.
+
+## License
+
+MIT. "QR Code" is a registered trademark of DENSO WAVE INCORPORATED.

package/fesm2022/qr-city-angular.mjs

@@ -0,0 +1,171 @@
+import * as i0 from '@angular/core';
+import { input, output, inject, ElementRef, NgZone, signal, computed, afterNextRender, effect, untracked, DestroyRef, isDevMode, ChangeDetectionStrategy, Component } from '@angular/core';
+import { createQrCity } from '@qr-city/core';
+export { qrToPng, qrToSvg, styles } from '@qr-city/core';
+
+/**
+ * `<qr-city-view data="https://…" />`: a 3D city whose rooftops form a scannable QR code.
+ *
+ * Standalone and zoneless-friendly: it starts WebGL after the first render (so it is SSR-safe), runs
+ * the animation loop outside the Angular zone, and applies input changes in place.
+ * Size it with CSS (default: a square as wide as its container).
+ */
+class QrCityComponent {
+    /** Text or URL encoded in the QR (1–300 characters). */
+    data = input.required(...(ngDevMode ? [{ debugName: "data" }] : /* istanbul ignore next */ []));
+    /** Built-in style id or a custom style object. */
+    cityStyle = input(...(ngDevMode ? [undefined, { debugName: "cityStyle" }] : /* istanbul ignore next */ []));
+    /** Fixed at creation: changing it starts over. */
+    intro = input(...(ngDevMode ? [undefined, { debugName: "intro" }] : /* istanbul ignore next */ []));
+    pauseAtThreshold = input(...(ngDevMode ? [undefined, { debugName: "pauseAtThreshold" }] : /* istanbul ignore next */ []));
+    view = input(...(ngDevMode ? [undefined, { debugName: "view" }] : /* istanbul ignore next */ []));
+    errorCorrection = input(...(ngDevMode ? [undefined, { debugName: "errorCorrection" }] : /* istanbul ignore next */ []));
+    quality = input(...(ngDevMode ? [undefined, { debugName: "quality" }] : /* istanbul ignore next */ []));
+    interactive = input(...(ngDevMode ? [undefined, { debugName: "interactive" }] : /* istanbul ignore next */ []));
+    animate = input(...(ngDevMode ? [undefined, { debugName: "animate" }] : /* istanbul ignore next */ []));
+    maxPixelRatio = input(...(ngDevMode ? [undefined, { debugName: "maxPixelRatio" }] : /* istanbul ignore next */ []));
+    zoomable = input(...(ngDevMode ? [undefined, { debugName: "zoomable" }] : /* istanbul ignore next */ []));
+    maxZoom = input(...(ngDevMode ? [undefined, { debugName: "maxZoom" }] : /* istanbul ignore next */ []));
+    wheelZoom = input(...(ngDevMode ? [undefined, { debugName: "wheelZoom" }] : /* istanbul ignore next */ []));
+    /** `'qr'` (default) shows a plain QR when WebGL is missing; `'none'` reports an error instead. */
+    fallback = input(...(ngDevMode ? [undefined, { debugName: "fallback" }] : /* istanbul ignore next */ []));
+    background = input(...(ngDevMode ? [undefined, { debugName: "background" }] : /* istanbul ignore next */ []));
+    label = input(...(ngDevMode ? [undefined, { debugName: "label" }] : /* istanbul ignore next */ []));
+    doorLabel = input(...(ngDevMode ? [undefined, { debugName: "doorLabel" }] : /* istanbul ignore next */ []));
+    /** The city is on screen: it finished building (or the door intro finished). */
+    revealed = output();
+    introStageChange = output();
+    viewChange = output();
+    zoomChange = output();
+    /** WebGL is not available: a plain QR is shown instead of the city. */
+    fallbackUsed = output();
+    /** Failures: no WebGL, invalid data, a lost context… */
+    qrError = output();
+    host = inject(ElementRef);
+    zone = inject(NgZone);
+    mounted = signal(false, ...(ngDevMode ? [{ debugName: "mounted" }] : /* istanbul ignore next */ []));
+    instance = null;
+    /** Everything but `intro` and the callbacks, without `undefined` so the core applies its defaults. */
+    config = computed(() => {
+        const all = {
+            data: this.data(),
+            style: this.cityStyle(),
+            pauseAtThreshold: this.pauseAtThreshold(),
+            view: this.view(),
+            errorCorrection: this.errorCorrection(),
+            quality: this.quality(),
+            interactive: this.interactive(),
+            animate: this.animate(),
+            maxPixelRatio: this.maxPixelRatio(),
+            zoomable: this.zoomable(),
+            maxZoom: this.maxZoom(),
+            wheelZoom: this.wheelZoom(),
+            fallback: this.fallback(),
+            background: this.background(),
+            label: this.label(),
+            doorLabel: this.doorLabel(),
+        };
+        for (const k of Object.keys(all))
+            if (all[k] === undefined)
+                delete all[k];
+        return all;
+    }, ...(ngDevMode ? [{ debugName: "config" }] : /* istanbul ignore next */ []));
+    /** The controller (`null` until the first render, and on the server). */
+    get controller() { return this.instance; }
+    get stage() { return this.instance?.stage ?? 'done'; }
+    get currentView() { return this.instance?.view ?? 'city'; }
+    get zoom() { return this.instance?.zoom ?? 1; }
+    /** `true` while a plain QR is shown because WebGL is not available. */
+    get usingFallback() { return this.instance?.fallback ?? false; }
+    constructor() {
+        // Browser only: never runs during server-side rendering.
+        afterNextRender(() => this.mounted.set(true));
+        // `intro` is fixed when the city is created, so (re)create it when it changes.
+        effect((onCleanup) => {
+            if (!this.mounted())
+                return;
+            const intro = this.intro();
+            untracked(() => this.create(intro));
+            onCleanup(() => this.destroy());
+        });
+        // Everything else is applied in place; the city is rebuilt only when it has to be.
+        effect(() => {
+            const next = this.config();
+            untracked(() => {
+                try {
+                    this.instance?.update(next);
+                }
+                catch (error) {
+                    this.report(error);
+                }
+            });
+        });
+        inject(DestroyRef).onDestroy(() => this.destroy());
+    }
+    openDoor() { this.instance?.openDoor(); }
+    continueIntro() { this.instance?.continueIntro(); }
+    skipIntro() { this.instance?.skipIntro(); }
+    reveal() { this.instance?.reveal(); }
+    setView(view, opts) { this.instance?.setView(view, opts); }
+    toggleView() { this.instance?.toggleView(); }
+    setZoom(zoom, opts) { this.instance?.setZoom(zoom, opts); }
+    zoomBy(factor, opts) { this.instance?.zoomBy(factor, opts); }
+    resetZoom(opts) { this.instance?.resetZoom(opts); }
+    /** The current code as a plain, print-ready SVG. */
+    toQrSvg(opts) {
+        if (!this.instance)
+            throw new Error('[qr-city] The city is not mounted.');
+        return this.instance.toQrSvg(opts);
+    }
+    toQrPng(opts) {
+        return this.instance ? this.instance.toQrPng(opts) : Promise.reject(new Error('[qr-city] The city is not mounted.'));
+    }
+    play() { this.instance?.play(); }
+    pause() { this.instance?.pause(); }
+    toPNG(opts) {
+        return this.instance ? this.instance.toPNG(opts) : Promise.reject(new Error('[qr-city] The city is not mounted.'));
+    }
+    create(intro) {
+        this.destroy();
+        const inZone = (fn) => () => this.zone.run(fn);
+        try {
+            // The animation loop must not trigger change detection every frame.
+            this.instance = this.zone.runOutsideAngular(() => createQrCity(this.host.nativeElement, {
+                ...this.config(),
+                ...(intro ? { intro } : {}),
+                onReveal: inZone(() => this.revealed.emit()),
+                onIntroStage: (s) => inZone(() => this.introStageChange.emit(s))(),
+                onViewChange: (v) => inZone(() => this.viewChange.emit(v))(),
+                onZoomChange: (z) => inZone(() => this.zoomChange.emit(z))(),
+                onFallback: (r) => inZone(() => this.fallbackUsed.emit(r))(),
+                onError: (e) => this.report(e),
+            }));
+        }
+        catch (error) {
+            this.report(error);
+        }
+    }
+    destroy() {
+        this.instance?.dispose();
+        this.instance = null;
+    }
+    report(error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        if (isDevMode())
+            console.error(err);
+        this.zone.run(() => this.qrError.emit(err));
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.25", ngImport: i0, type: QrCityComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "21.2.25", type: QrCityComponent, isStandalone: true, selector: "qr-city-view", inputs: { data: { classPropertyName: "data", publicName: "data", isSignal: true, isRequired: true, transformFunction: null }, cityStyle: { classPropertyName: "cityStyle", publicName: "cityStyle", isSignal: true, isRequired: false, transformFunction: null }, intro: { classPropertyName: "intro", publicName: "intro", isSignal: true, isRequired: false, transformFunction: null }, pauseAtThreshold: { classPropertyName: "pauseAtThreshold", publicName: "pauseAtThreshold", isSignal: true, isRequired: false, transformFunction: null }, view: { classPropertyName: "view", publicName: "view", isSignal: true, isRequired: false, transformFunction: null }, errorCorrection: { classPropertyName: "errorCorrection", publicName: "errorCorrection", isSignal: true, isRequired: false, transformFunction: null }, quality: { classPropertyName: "quality", publicName: "quality", isSignal: true, isRequired: false, transformFunction: null }, interactive: { classPropertyName: "interactive", publicName: "interactive", isSignal: true, isRequired: false, transformFunction: null }, animate: { classPropertyName: "animate", publicName: "animate", isSignal: true, isRequired: false, transformFunction: null }, maxPixelRatio: { classPropertyName: "maxPixelRatio", publicName: "maxPixelRatio", isSignal: true, isRequired: false, transformFunction: null }, zoomable: { classPropertyName: "zoomable", publicName: "zoomable", isSignal: true, isRequired: false, transformFunction: null }, maxZoom: { classPropertyName: "maxZoom", publicName: "maxZoom", isSignal: true, isRequired: false, transformFunction: null }, wheelZoom: { classPropertyName: "wheelZoom", publicName: "wheelZoom", isSignal: true, isRequired: false, transformFunction: null }, fallback: { classPropertyName: "fallback", publicName: "fallback", isSignal: true, isRequired: false, transformFunction: null }, background: { classPropertyName: "background", publicName: "background", isSignal: true, isRequired: false, transformFunction: null }, label: { classPropertyName: "label", publicName: "label", isSignal: true, isRequired: false, transformFunction: null }, doorLabel: { classPropertyName: "doorLabel", publicName: "doorLabel", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { revealed: "revealed", introStageChange: "introStageChange", viewChange: "viewChange", zoomChange: "zoomChange", fallbackUsed: "fallbackUsed", qrError: "qrError" }, ngImport: i0, template: '', isInline: true, styles: [":host{display:block;position:relative;aspect-ratio:1 / 1}\n"], changeDetection: i0.ChangeDetectionStrategy.OnPush });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.25", ngImport: i0, type: QrCityComponent, decorators: [{
+            type: Component,
+            args: [{ selector: 'qr-city-view', template: '', changeDetection: ChangeDetectionStrategy.OnPush, styles: [":host{display:block;position:relative;aspect-ratio:1 / 1}\n"] }]
+        }], ctorParameters: () => [], propDecorators: { data: [{ type: i0.Input, args: [{ isSignal: true, alias: "data", required: true }] }], cityStyle: [{ type: i0.Input, args: [{ isSignal: true, alias: "cityStyle", required: false }] }], intro: [{ type: i0.Input, args: [{ isSignal: true, alias: "intro", required: false }] }], pauseAtThreshold: [{ type: i0.Input, args: [{ isSignal: true, alias: "pauseAtThreshold", required: false }] }], view: [{ type: i0.Input, args: [{ isSignal: true, alias: "view", required: false }] }], errorCorrection: [{ type: i0.Input, args: [{ isSignal: true, alias: "errorCorrection", required: false }] }], quality: [{ type: i0.Input, args: [{ isSignal: true, alias: "quality", required: false }] }], interactive: [{ type: i0.Input, args: [{ isSignal: true, alias: "interactive", required: false }] }], animate: [{ type: i0.Input, args: [{ isSignal: true, alias: "animate", required: false }] }], maxPixelRatio: [{ type: i0.Input, args: [{ isSignal: true, alias: "maxPixelRatio", required: false }] }], zoomable: [{ type: i0.Input, args: [{ isSignal: true, alias: "zoomable", required: false }] }], maxZoom: [{ type: i0.Input, args: [{ isSignal: true, alias: "maxZoom", required: false }] }], wheelZoom: [{ type: i0.Input, args: [{ isSignal: true, alias: "wheelZoom", required: false }] }], fallback: [{ type: i0.Input, args: [{ isSignal: true, alias: "fallback", required: false }] }], background: [{ type: i0.Input, args: [{ isSignal: true, alias: "background", required: false }] }], label: [{ type: i0.Input, args: [{ isSignal: true, alias: "label", required: false }] }], doorLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "doorLabel", required: false }] }], revealed: [{ type: i0.Output, args: ["revealed"] }], introStageChange: [{ type: i0.Output, args: ["introStageChange"] }], viewChange: [{ type: i0.Output, args: ["viewChange"] }], zoomChange: [{ type: i0.Output, args: ["zoomChange"] }], fallbackUsed: [{ type: i0.Output, args: ["fallbackUsed"] }], qrError: [{ type: i0.Output, args: ["qrError"] }] } });
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { QrCityComponent };
+//# sourceMappingURL=qr-city-angular.mjs.map

package/fesm2022/qr-city-angular.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"qr-city-angular.mjs","sources":["../../src/qr-city.component.ts","../../src/qr-city-angular.ts"],"sourcesContent":["import {\n  ChangeDetectionStrategy,\n  Component,\n  DestroyRef,\n  ElementRef,\n  NgZone,\n  afterNextRender,\n  computed,\n  effect,\n  inject,\n  input,\n  isDevMode,\n  output,\n  signal,\n  untracked,\n} from '@angular/core';\nimport { createQrCity } from '@qr-city/core';\nimport type {\n  QrCityController,\n  QrCityEcc,\n  QrCityIntro,\n  QrCityIntroStage,\n  QrCityOptions,\n  QrCityQuality,\n  QrCityStyle,\n  QrCityStyleId,\n  QrCityView,\n} from '@qr-city/core';\n\ntype ConfigOptions = Omit<QrCityOptions, 'onReveal' | 'onIntroStage' | 'onViewChange' | 'onZoomChange' | 'onError' | 'intro'>;\n\n/**\n * `<qr-city-view data=\"https://…\" />`: a 3D city whose rooftops form a scannable QR code.\n *\n * Standalone and zoneless-friendly: it starts WebGL after the first render (so it is SSR-safe), runs\n * the animation loop outside the Angular zone, and applies input changes in place.\n * Size it with CSS (default: a square as wide as its container).\n */\n@Component({\n  selector: 'qr-city-view',\n  template: '',\n  styles: [':host { display: block; position: relative; aspect-ratio: 1 / 1; }'],\n  changeDetection: ChangeDetectionStrategy.OnPush,\n})\nexport class QrCityComponent {\n  /** Text or URL encoded in the QR (1–300 characters). */\n  readonly data = input.required<string>();\n  /** Built-in style id or a custom style object. */\n  readonly cityStyle = input<QrCityStyleId | QrCityStyle>();\n  /** Fixed at creation: changing it starts over. */\n  readonly intro = input<QrCityIntro>();\n  readonly pauseAtThreshold = input<boolean>();\n  readonly view = input<QrCityView>();\n  readonly errorCorrection = input<QrCityEcc>();\n  readonly quality = input<QrCityQuality>();\n  readonly interactive = input<boolean>();\n  readonly animate = input<boolean | 'auto'>();\n  readonly maxPixelRatio = input<number>();\n  readonly zoomable = input<boolean>();\n  readonly maxZoom = input<number>();\n  readonly wheelZoom = input<'ctrl' | 'always' | 'off'>();\n  /** `'qr'` (default) shows a plain QR when WebGL is missing; `'none'` reports an error instead. */\n  readonly fallback = input<'qr' | 'none'>();\n  readonly background = input<string>();\n  readonly label = input<string>();\n  readonly doorLabel = input<string>();\n\n  /** The city is on screen: it finished building (or the door intro finished). */\n  readonly revealed = output<void>();\n  readonly introStageChange = output<QrCityIntroStage>();\n  readonly viewChange = output<QrCityView>();\n  readonly zoomChange = output<number>();\n  /** WebGL is not available: a plain QR is shown instead of the city. */\n  readonly fallbackUsed = output<Error>();\n  /** Failures: no WebGL, invalid data, a lost context… */\n  readonly qrError = output<Error>();\n\n  private readonly host = inject<ElementRef<HTMLElement>>(ElementRef);\n  private readonly zone = inject(NgZone);\n  private readonly mounted = signal(false);\n  private instance: QrCityController | null = null;\n\n  /** Everything but `intro` and the callbacks, without `undefined` so the core applies its defaults. */\n  private readonly config = computed<ConfigOptions>(() => {\n    const all: Record<string, unknown> = {\n      data: this.data(),\n      style: this.cityStyle(),\n      pauseAtThreshold: this.pauseAtThreshold(),\n      view: this.view(),\n      errorCorrection: this.errorCorrection(),\n      quality: this.quality(),\n      interactive: this.interactive(),\n      animate: this.animate(),\n      maxPixelRatio: this.maxPixelRatio(),\n      zoomable: this.zoomable(),\n      maxZoom: this.maxZoom(),\n      wheelZoom: this.wheelZoom(),\n      fallback: this.fallback(),\n      background: this.background(),\n      label: this.label(),\n      doorLabel: this.doorLabel(),\n    };\n    for (const k of Object.keys(all)) if (all[k] === undefined) delete all[k];\n    return all as unknown as ConfigOptions;\n  });\n\n  /** The controller (`null` until the first render, and on the server). */\n  get controller(): QrCityController | null { return this.instance; }\n  get stage(): QrCityIntroStage { return this.instance?.stage ?? 'done'; }\n  get currentView(): QrCityView { return this.instance?.view ?? 'city'; }\n  get zoom(): number { return this.instance?.zoom ?? 1; }\n  /** `true` while a plain QR is shown because WebGL is not available. */\n  get usingFallback(): boolean { return this.instance?.fallback ?? false; }\n\n  constructor() {\n    // Browser only: never runs during server-side rendering.\n    afterNextRender(() => this.mounted.set(true));\n\n    // `intro` is fixed when the city is created, so (re)create it when it changes.\n    effect((onCleanup) => {\n      if (!this.mounted()) return;\n      const intro = this.intro();\n      untracked(() => this.create(intro));\n      onCleanup(() => this.destroy());\n    });\n\n    // Everything else is applied in place; the city is rebuilt only when it has to be.\n    effect(() => {\n      const next = this.config();\n      untracked(() => {\n        try { this.instance?.update(next as QrCityOptions); } catch (error) { this.report(error); }\n      });\n    });\n\n    inject(DestroyRef).onDestroy(() => this.destroy());\n  }\n\n  openDoor(): void { this.instance?.openDoor(); }\n  continueIntro(): void { this.instance?.continueIntro(); }\n  skipIntro(): void { this.instance?.skipIntro(); }\n  reveal(): void { this.instance?.reveal(); }\n  setView(view: QrCityView, opts?: { immediate?: boolean }): void { this.instance?.setView(view, opts); }\n  toggleView(): void { this.instance?.toggleView(); }\n  setZoom(zoom: number, opts?: { immediate?: boolean; at?: { x: number; y: number } }): void { this.instance?.setZoom(zoom, opts); }\n  zoomBy(factor: number, opts?: { at?: { x: number; y: number } }): void { this.instance?.zoomBy(factor, opts); }\n  resetZoom(opts?: { immediate?: boolean }): void { this.instance?.resetZoom(opts); }\n  /** The current code as a plain, print-ready SVG. */\n  toQrSvg(opts?: Parameters<QrCityController['toQrSvg']>[0]): string {\n    if (!this.instance) throw new Error('[qr-city] The city is not mounted.');\n    return this.instance.toQrSvg(opts);\n  }\n  toQrPng(opts?: Parameters<QrCityController['toQrPng']>[0]): Promise<Blob> {\n    return this.instance ? this.instance.toQrPng(opts) : Promise.reject(new Error('[qr-city] The city is not mounted.'));\n  }\n  play(): void { this.instance?.play(); }\n  pause(): void { this.instance?.pause(); }\n  toPNG(opts?: { scale?: number }): Promise<Blob> {\n    return this.instance ? this.instance.toPNG(opts) : Promise.reject(new Error('[qr-city] The city is not mounted.'));\n  }\n\n  private create(intro: QrCityIntro | undefined): void {\n    this.destroy();\n    const inZone = <T>(fn: () => T) => () => this.zone.run(fn);\n    try {\n      // The animation loop must not trigger change detection every frame.\n      this.instance = this.zone.runOutsideAngular(() =>\n        createQrCity(this.host.nativeElement, {\n          ...this.config(),\n          ...(intro ? { intro } : {}),\n          onReveal: inZone(() => this.revealed.emit()),\n          onIntroStage: (s) => inZone(() => this.introStageChange.emit(s))(),\n          onViewChange: (v) => inZone(() => this.viewChange.emit(v))(),\n          onZoomChange: (z) => inZone(() => this.zoomChange.emit(z))(),\n          onFallback: (r) => inZone(() => this.fallbackUsed.emit(r))(),\n          onError: (e) => this.report(e),\n        } as QrCityOptions),\n      );\n    } catch (error) {\n      this.report(error);\n    }\n  }\n\n  private destroy(): void {\n    this.instance?.dispose();\n    this.instance = null;\n  }\n\n  private report(error: unknown): void {\n    const err = error instanceof Error ? error : new Error(String(error));\n    if (isDevMode()) console.error(err);\n    this.zone.run(() => this.qrError.emit(err));\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,41 @@
 {
   "name": "@qr-city/angular",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Angular component for qr-city: a 3D city whose rooftops form a scannable QR code.",
+  "keywords": [
+    "qr",
+    "qrcode",
+    "angular",
+    "three",
+    "3d",
+    "isometric"
+  ],
+  "license": "MIT",
+  "author": "Dani Oliva",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dolivag/qr-city.git",
+    "directory": "packages/angular"
+  },
+  "sideEffects": false,
+  "dependencies": {
+    "@qr-city/core": "0.1.0",
+    "tslib": "^2.3.0"
+  },
+  "peerDependencies": {
+    "@angular/core": ">=21.0.0",
+    "three": ">=0.160.0 <1"
+  },
+  "module": "fesm2022/qr-city-angular.mjs",
+  "typings": "types/qr-city-angular.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./types/qr-city-angular.d.ts",
+      "default": "./fesm2022/qr-city-angular.mjs"
+    }
+  },
+  "type": "module"
 }

package/types/qr-city-angular.d.ts

@@ -0,0 +1,97 @@
+import * as _angular_core from '@angular/core';
+import { QrCityStyleId, QrCityStyle, QrCityIntro, QrCityView, QrCityEcc, QrCityQuality, QrCityIntroStage, QrCityController } from '@qr-city/core';
+export { QrCityController, QrCityDoorTheme, QrCityEcc, QrCityIntro, QrCityIntroStage, QrCityOptions, QrCityQuality, QrCityStyle, QrCityStyleId, QrCityView, QrImageOptions, QrPngOptions, qrToPng, qrToSvg, styles } from '@qr-city/core';
+
+/**
+ * `<qr-city-view data="https://…" />`: a 3D city whose rooftops form a scannable QR code.
+ *
+ * Standalone and zoneless-friendly: it starts WebGL after the first render (so it is SSR-safe), runs
+ * the animation loop outside the Angular zone, and applies input changes in place.
+ * Size it with CSS (default: a square as wide as its container).
+ */
+declare class QrCityComponent {
+    /** Text or URL encoded in the QR (1–300 characters). */
+    readonly data: _angular_core.InputSignal<string>;
+    /** Built-in style id or a custom style object. */
+    readonly cityStyle: _angular_core.InputSignal<QrCityStyleId | QrCityStyle | undefined>;
+    /** Fixed at creation: changing it starts over. */
+    readonly intro: _angular_core.InputSignal<QrCityIntro | undefined>;
+    readonly pauseAtThreshold: _angular_core.InputSignal<boolean | undefined>;
+    readonly view: _angular_core.InputSignal<QrCityView | undefined>;
+    readonly errorCorrection: _angular_core.InputSignal<QrCityEcc | undefined>;
+    readonly quality: _angular_core.InputSignal<QrCityQuality | undefined>;
+    readonly interactive: _angular_core.InputSignal<boolean | undefined>;
+    readonly animate: _angular_core.InputSignal<boolean | "auto" | undefined>;
+    readonly maxPixelRatio: _angular_core.InputSignal<number | undefined>;
+    readonly zoomable: _angular_core.InputSignal<boolean | undefined>;
+    readonly maxZoom: _angular_core.InputSignal<number | undefined>;
+    readonly wheelZoom: _angular_core.InputSignal<"ctrl" | "always" | "off" | undefined>;
+    /** `'qr'` (default) shows a plain QR when WebGL is missing; `'none'` reports an error instead. */
+    readonly fallback: _angular_core.InputSignal<"none" | "qr" | undefined>;
+    readonly background: _angular_core.InputSignal<string | undefined>;
+    readonly label: _angular_core.InputSignal<string | undefined>;
+    readonly doorLabel: _angular_core.InputSignal<string | undefined>;
+    /** The city is on screen: it finished building (or the door intro finished). */
+    readonly revealed: _angular_core.OutputEmitterRef<void>;
+    readonly introStageChange: _angular_core.OutputEmitterRef<QrCityIntroStage>;
+    readonly viewChange: _angular_core.OutputEmitterRef<QrCityView>;
+    readonly zoomChange: _angular_core.OutputEmitterRef<number>;
+    /** WebGL is not available: a plain QR is shown instead of the city. */
+    readonly fallbackUsed: _angular_core.OutputEmitterRef<Error>;
+    /** Failures: no WebGL, invalid data, a lost context… */
+    readonly qrError: _angular_core.OutputEmitterRef<Error>;
+    private readonly host;
+    private readonly zone;
+    private readonly mounted;
+    private instance;
+    /** Everything but `intro` and the callbacks, without `undefined` so the core applies its defaults. */
+    private readonly config;
+    /** The controller (`null` until the first render, and on the server). */
+    get controller(): QrCityController | null;
+    get stage(): QrCityIntroStage;
+    get currentView(): QrCityView;
+    get zoom(): number;
+    /** `true` while a plain QR is shown because WebGL is not available. */
+    get usingFallback(): boolean;
+    constructor();
+    openDoor(): void;
+    continueIntro(): void;
+    skipIntro(): void;
+    reveal(): void;
+    setView(view: QrCityView, opts?: {
+        immediate?: boolean;
+    }): void;
+    toggleView(): void;
+    setZoom(zoom: number, opts?: {
+        immediate?: boolean;
+        at?: {
+            x: number;
+            y: number;
+        };
+    }): void;
+    zoomBy(factor: number, opts?: {
+        at?: {
+            x: number;
+            y: number;
+        };
+    }): void;
+    resetZoom(opts?: {
+        immediate?: boolean;
+    }): void;
+    /** The current code as a plain, print-ready SVG. */
+    toQrSvg(opts?: Parameters<QrCityController['toQrSvg']>[0]): string;
+    toQrPng(opts?: Parameters<QrCityController['toQrPng']>[0]): Promise<Blob>;
+    play(): void;
+    pause(): void;
+    toPNG(opts?: {
+        scale?: number;
+    }): Promise<Blob>;
+    private create;
+    private destroy;
+    private report;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<QrCityComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<QrCityComponent, "qr-city-view", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "cityStyle": { "alias": "cityStyle"; "required": false; "isSignal": true; }; "intro": { "alias": "intro"; "required": false; "isSignal": true; }; "pauseAtThreshold": { "alias": "pauseAtThreshold"; "required": false; "isSignal": true; }; "view": { "alias": "view"; "required": false; "isSignal": true; }; "errorCorrection": { "alias": "errorCorrection"; "required": false; "isSignal": true; }; "quality": { "alias": "quality"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "animate": { "alias": "animate"; "required": false; "isSignal": true; }; "maxPixelRatio": { "alias": "maxPixelRatio"; "required": false; "isSignal": true; }; "zoomable": { "alias": "zoomable"; "required": false; "isSignal": true; }; "maxZoom": { "alias": "maxZoom"; "required": false; "isSignal": true; }; "wheelZoom": { "alias": "wheelZoom"; "required": false; "isSignal": true; }; "fallback": { "alias": "fallback"; "required": false; "isSignal": true; }; "background": { "alias": "background"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "doorLabel": { "alias": "doorLabel"; "required": false; "isSignal": true; }; }, { "revealed": "revealed"; "introStageChange": "introStageChange"; "viewChange": "viewChange"; "zoomChange": "zoomChange"; "fallbackUsed": "fallbackUsed"; "qrError": "qrError"; }, never, never, true, never>;
+}
+
+export { QrCityComponent };
+//# sourceMappingURL=qr-city-angular.d.ts.map

package/types/qr-city-angular.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qr-city-angular.d.ts","sources":["../../src/qr-city.component.ts"],"mappings":";;;;AA+BA;;;;;;AAMG;AACH,cAMa,eAAe;;mBAEb,aAAA,CAAA,WAAA;;wBAEK,aAAA,CAAA,WAAA,CAAA,aAAA,GAAA,WAAA;;oBAEJ,aAAA,CAAA,WAAA,CAAA,WAAA;+BACW,aAAA,CAAA,WAAA;mBACZ,aAAA,CAAA,WAAA,CAAA,UAAA;8BACW,aAAA,CAAA,WAAA,CAAA,SAAA;sBACR,aAAA,CAAA,WAAA,CAAA,aAAA;0BACI,aAAA,CAAA,WAAA;sBACJ,aAAA,CAAA,WAAA;4BACM,aAAA,CAAA,WAAA;uBACL,aAAA,CAAA,WAAA;sBACD,aAAA,CAAA,WAAA;wBACE,aAAA,CAAA,WAAA;;uBAED,aAAA,CAAA,WAAA;yBACE,aAAA,CAAA,WAAA;oBACL,aAAA,CAAA,WAAA;wBACI,aAAA,CAAA,WAAA;;uBAGD,aAAA,CAAA,gBAAA;+BACQ,aAAA,CAAA,gBAAA,CAAA,gBAAA;yBACN,aAAA,CAAA,gBAAA,CAAA,UAAA;yBACA,aAAA,CAAA,gBAAA;;2BAEE,aAAA,CAAA,gBAAA,CAAA,KAAA;;sBAEL,aAAA,CAAA,gBAAA,CAAA,KAAA;AAEhB;AACA;AACA;;;AAIA;;AAwBA,sBAAkB,gBAAgB;iBACrB,gBAAgB;uBACV,UAAU;;;;;AA4B7B;AACA;AACA;AACA;AACA,kBAAc,UAAU;;AAAgC;AACxD;AACA;;AAAoD;;;;AAA+B;AACnF;AAAgC;;;;AAA+B;;;AACvB;;AAExC,mBAAe,UAAU,CAAC,gBAAgB;AAI1C,mBAAe,UAAU,CAAC,gBAAgB,kBAAkB,OAAO,CAAC,IAAI;AAGxE;AACA;;;QACkC,OAAO,CAAC,IAAI;AAI9C;AAsBA;AAKA;oDA/IW,eAAe;sDAAf,eAAe;AAoJ3B;;","names":[]}