@blotch/dolan 22.2.1 → 22.2.3

package/dist/ui/components/spinner/spinner.ts

@@ -9,13 +9,15 @@ import {
 } from '@angular/core';
 import { LYNX_ELEMENTS } from '@blotch/angular-lynx';
 
+import { cn } from '../../utils/cn';
+import { injectIconColor } from '../icon/icon-theme';
+
 const LOADER_SVG = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M12 2v4"/><path d="m16.2 7.8 2.9-2.9"/><path d="M18 12h4"/><path d="m16.2 16.2 2.9 2.9"/><path d="M12 18v4"/><path d="m4.9 19.1 2.9-2.9"/><path d="M2 12h4"/><path d="m4.9 4.9 2.9 2.9"/></svg>`;
 
 const SIZE_MAP = { xs: 16, sm: 20, md: 24, lg: 32 } as const;
 
 @Component({
   selector: 'ui-spinner',
-  standalone: true,
   imports: [LYNX_ELEMENTS],
   encapsulation: ViewEncapsulation.None,
   // SVG markup is passed via [attr.content] rather than as child elements.
@@ -24,14 +26,22 @@ const SIZE_MAP = { xs: 16, sm: 20, md: 24, lg: 32 } as const;
   // SVG markup string as the `content` attribute is the Lynx-native way to
   // embed vector graphics.
   template: `
-    <view #spinner [style]="sizeStyle()">
+    <view #spinner [class]="containerClass()" [style]="sizeStyle()">
       <svg [attr.content]="svgContent()" style="width: 100%; height: 100%;" />
     </view>
   `,
 })
 export class UiSpinner {
   readonly size = input<'xs' | 'sm' | 'md' | 'lg'>('md');
+  /**
+   * A literal color or a theme token (`var(--primary)`). Without one, the
+   * spinner takes the color its container sets (see `UI_ICON_COLOR`), then the
+   * theme's foreground.
+   */
   readonly color = input<string | undefined>(undefined);
+  readonly userClass = input<string>('', { alias: 'class' });
+
+  readonly #resolveColor = injectIconColor();
 
   readonly spinnerRef = viewChild<ElementRef>('spinner');
 
@@ -54,27 +64,27 @@ export class UiSpinner {
     });
   }
 
-  protected readonly svgContent = computed(() => {
-    const c = this.color();
-    if (c) {
-      // Lynx SVG elements don't inherit the CSS `color` property into their
-      // stroke attributes, so we substitute the literal `currentColor` in the
-      // SVG string rather than relying on `currentColor` propagation via CSS.
-      //
-      // Uses split().join() instead of String.prototype.replaceAll(). replaceAll
-      // is ES2021, but Lynx's main thread runs on PrimJS at an ES2019 target;
-      // because it's a runtime method (not syntax) the build's down-leveling does
-      // not polyfill it, so it simply doesn't exist there. Calling it throws
-      // "main-thread.js exception: not a function" from inside Angular change
-      // detection, which aborts the whole tick before Lynx flushes the element
-      // tree — so the spinner never paints, and the error count climbs on every
-      // render as each tick re-runs and re-throws. split/join is ES2019-safe and
-      // is preferred over `replace(/.../g)` here because the search term is a
-      // plain literal and needs no regex escaping.
-      return LOADER_SVG.split('currentColor').join(c);
-    }
-    return LOADER_SVG;
-  });
+  // Lynx SVG elements don't inherit the CSS `color` property into their stroke
+  // attributes, so we substitute the literal `currentColor` in the SVG string
+  // rather than relying on `currentColor` propagation via CSS. The color is
+  // resolved first: the SVG parser can't read `var(--x)` either (see
+  // icon-theme.ts).
+  //
+  // Uses split().join() instead of String.prototype.replaceAll(). replaceAll is
+  // ES2021, but Lynx's main thread runs on PrimJS at an ES2019 target; because
+  // it's a runtime method (not syntax) the build's down-leveling does not
+  // polyfill it, so it simply doesn't exist there. Calling it throws
+  // "main-thread.js exception: not a function" from inside Angular change
+  // detection, which aborts the whole tick before Lynx flushes the element tree
+  // — so the spinner never paints, and the error count climbs on every render
+  // as each tick re-runs and re-throws. split/join is ES2019-safe and is
+  // preferred over `replace(/.../g)` here because the search term is a plain
+  // literal and needs no regex escaping.
+  protected readonly svgContent = computed(() =>
+    LOADER_SVG.split('currentColor').join(this.#resolveColor(this.color())),
+  );
+
+  protected readonly containerClass = computed(() => cn(this.userClass()));
 
   protected readonly sizeStyle = computed(() => {
     const px = SIZE_MAP[this.size()];

package/dist/ui/components/toast/toast.test.ts

@@ -154,6 +154,43 @@ describe('UiToastItem', () => {
     expect(dismissed).toHaveBeenCalled();
   });
 
+  it('stops its auto-dismiss timer when it is destroyed first', async () => {
+    // dismissToast(id) removes the toast at once. Its timer used to fire on
+    // the destroyed component anyway, and emit from a destroyed output.
+    const dismissed = vi.fn();
+    const warn = vi.spyOn(console, 'warn');
+    const { componentRef } = await render(UiToastItem);
+    const inst = componentRef.instance as UiToastItem;
+    inst.dismissed.subscribe(dismissed);
+    setInputSignal(inst.data, baseData({ duration: 30 }));
+    setInputSignal(inst.depth, 0);
+    await waitForUpdate();
+    inst.ngOnInit();
+    componentRef.destroy();
+    await new Promise((r) => setTimeout(r, 400));
+    expect(dismissed).not.toHaveBeenCalled();
+    expect(warn).not.toHaveBeenCalledWith(expect.stringContaining('NG0953'));
+    warn.mockRestore();
+  });
+
+  it('stops its exit timer when it is destroyed mid-exit', async () => {
+    // A destroyed output drops the emit, so the warning is what shows it.
+    const dismissed = vi.fn();
+    const warn = vi.spyOn(console, 'warn');
+    const { componentRef } = await render(UiToastItem);
+    const inst = componentRef.instance as UiToastItem;
+    inst.dismissed.subscribe(dismissed);
+    setInputSignal(inst.data, baseData());
+    setInputSignal(inst.depth, 0);
+    await waitForUpdate();
+    inst.dismiss();
+    componentRef.destroy();
+    await new Promise((r) => setTimeout(r, 400));
+    expect(dismissed).not.toHaveBeenCalled();
+    expect(warn).not.toHaveBeenCalledWith(expect.stringContaining('NG0953'));
+    warn.mockRestore();
+  });
+
   it('touch drag beyond threshold dismisses; below threshold snaps back', async () => {
     const { componentRef } = await render(UiToastItem);
     const inst = componentRef.instance as UiToastItem;

package/dist/ui/components/toast/toast.ts

@@ -1,4 +1,5 @@
 import {
+  type OnDestroy,
   type OnInit,
   Component,
   ElementRef,
@@ -53,7 +54,6 @@ const stackTransform = (depth: number): string =>
  */
 @Component({
   selector: 'ui-toast-item',
-  standalone: true,
   imports: [LYNX_ELEMENTS],
   encapsulation: ViewEncapsulation.None,
   // Styling + interaction live on the HOST element (a plain `view`, since the
@@ -86,7 +86,7 @@ const stackTransform = (depth: number): string =>
     }
   `,
 })
-export class UiToastItem implements OnInit {
+export class UiToastItem implements OnInit, OnDestroy {
   readonly data = input.required<ToastData>();
   // 0 = front (newest, interactive); higher = further back in the stack.
   readonly depth = input.required<number>();
@@ -96,6 +96,8 @@ export class UiToastItem implements OnInit {
   readonly #host = inject(ElementRef);
   #anim?: AnimationHandle;
   #dismissTimer: ReturnType<typeof setTimeout> | null = null;
+  // The one that emits `dismissed` once the exit animation has played.
+  #exitTimer: ReturnType<typeof setTimeout> | null = null;
 
   // Hidden until the entrance animation runs, so the toast doesn't flash at its
   // resting position for a frame before sliding/fading in.
@@ -295,7 +297,22 @@ export class UiToastItem implements OnInit {
       this.#dismissTimer = null;
     }
     this.#animateOut();
-    setTimeout(() => this.dismissed.emit(), DURATION.fast + 20);
+    this.#exitTimer = setTimeout(
+      () => this.dismissed.emit(),
+      DURATION.fast + 20,
+    );
+  }
+
+  /**
+   * A toast can be destroyed before its timers fire: `dismissToast(id)` drops
+   * it from the queue straight away, and the toaster itself can be removed.
+   * Without this, the auto-dismiss timer later ran `dismiss()` on the destroyed
+   * component: it animated a detached element and emitted `dismissed` from a
+   * destroyed output, which Angular warns about in dev builds (NG0953).
+   */
+  ngOnDestroy(): void {
+    if (this.#dismissTimer) clearTimeout(this.#dismissTimer);
+    if (this.#exitTimer) clearTimeout(this.#exitTimer);
   }
 
   #animateIn(): void {
@@ -447,7 +464,6 @@ export class UiToastItem implements OnInit {
  */
 @Component({
   selector: 'ui-toaster',
-  standalone: true,
   imports: [LYNX_ELEMENTS, UiToastItem],
   encapsulation: ViewEncapsulation.None,
   template: `

package/dist/ui/theme/chart-colors.test.ts

@@ -0,0 +1,30 @@
+import { readFileSync } from 'node:fs';
+import { describe, expect, it } from 'vitest';
+import {
+  CHART_DARK_COLORS,
+  CHART_LIGHT_COLORS,
+} from '../components/chart/chart-theme';
+
+/**
+ * `<ui-chart>` draws through native SVG, which can't read CSS variables, so the
+ * chart component keeps a TypeScript copy of the theme's colors. This keeps the
+ * copy in step with default.css and dark.css.
+ */
+const tokens = (file: string): Record<string, string> => {
+  const css = readFileSync(new URL(file, import.meta.url), 'utf8');
+  const values: Record<string, string> = {};
+  for (const match of css.matchAll(/--([\w-]+):\s*(rgba\([^)]*\))/g)) {
+    values[match[1]!] = match[2]!;
+  }
+  return values;
+};
+
+describe('chart color tables', () => {
+  it('match default.css', () => {
+    expect(CHART_LIGHT_COLORS).toEqual(tokens('./default.css'));
+  });
+
+  it('match dark.css', () => {
+    expect(CHART_DARK_COLORS).toEqual(tokens('./dark.css'));
+  });
+});

package/dist/ui/theme/dark.css

@@ -37,5 +37,13 @@ page.dark {
   /* Translucent variant of --ring for a softer focus outline (see default.css). */
   --ring-subtle: rgba(212, 212, 216, 0.4);
 
+  /* Series palette for charts (bg-chart-1, and chart-theme.ts in the chart
+     component, which mirrors these values for SVG). */
+  --chart-1: rgba(38, 98, 217, 1);
+  --chart-2: rgba(46, 184, 138, 1);
+  --chart-3: rgba(232, 140, 48, 1);
+  --chart-4: rgba(175, 87, 219, 1);
+  --chart-5: rgba(226, 54, 112, 1);
+
   --radius: 8px;
 }

package/dist/ui/theme/default.css

@@ -52,5 +52,13 @@ page {
      apply to the opaque --ring, and Lynx can't inject alpha into it either. */
   --ring-subtle: rgba(24, 24, 27, 0.4);
 
+  /* Series palette for charts (bg-chart-1, and chart-theme.ts in the chart
+     component, which mirrors these values for SVG). */
+  --chart-1: rgba(231, 110, 80, 1);
+  --chart-2: rgba(42, 157, 144, 1);
+  --chart-3: rgba(39, 71, 84, 1);
+  --chart-4: rgba(232, 196, 104, 1);
+  --chart-5: rgba(244, 164, 98, 1);
+
   --radius: 8px;
 }

package/dist/ui/theme/icon-colors.test.ts

@@ -0,0 +1,30 @@
+import { readFileSync } from 'node:fs';
+import { describe, expect, it } from 'vitest';
+import {
+  ICON_DARK_COLORS,
+  ICON_LIGHT_COLORS,
+} from '../components/icon/icon-theme';
+
+/**
+ * `<ui-icon>`, `<ui-spinner>` and pagination draw through native SVG, which
+ * can't read CSS variables, so icon-theme.ts keeps a TypeScript copy of the
+ * theme's colors. This keeps the copy in step with default.css and dark.css.
+ */
+const tokens = (file: string): Record<string, string> => {
+  const css = readFileSync(new URL(file, import.meta.url), 'utf8');
+  const values: Record<string, string> = {};
+  for (const match of css.matchAll(/--([\w-]+):\s*(rgba\([^)]*\))/g)) {
+    values[match[1]!] = match[2]!;
+  }
+  return values;
+};
+
+describe('icon color tables', () => {
+  it('match default.css', () => {
+    expect(ICON_LIGHT_COLORS).toEqual(tokens('./default.css'));
+  });
+
+  it('match dark.css', () => {
+    expect(ICON_DARK_COLORS).toEqual(tokens('./dark.css'));
+  });
+});

package/dist/ui/theme/tailwind-plugin.ts

@@ -16,7 +16,7 @@ const SAFE_AREA_SIDES = {
  * Registers safe-area-aware padding utilities driven by CSS `env(safe-area-inset-*)`.
  *
  * Why `env()` works on Lynx: the native CSS engine parses `env(safe-area-inset-*)`
- * as a length (see references/lynx .../css_style_utils.cc `GetEnvValue`), and its
+ * as a length (see lynx-family/lynx's css_style_utils.cc `GetEnvValue`), and its
  * calc parser accepts `env()` *inside* `calc()` too — so `calc(1rem + env(...))`
  * is valid on device. The inset values default to `0` until the native host app
  * populates them, so every utility here degrades gracefully to plain padding
@@ -139,6 +139,15 @@ export const blotchPlugin = plugin(
             DEFAULT: 'var(--card)',
             foreground: 'var(--card-foreground)',
           },
+          // Chart series colors, e.g. bg-chart-1 for a legend swatch that
+          // matches the first series.
+          chart: {
+            1: 'var(--chart-1)',
+            2: 'var(--chart-2)',
+            3: 'var(--chart-3)',
+            4: 'var(--chart-4)',
+            5: 'var(--chart-5)',
+          },
         },
         borderRadius: {
           lg: 'var(--radius)',

package/dist/utils/installed.d.ts

@@ -0,0 +1,17 @@
+import type { Lockfile } from '../lockfile.js';
+/**
+ * The registry components with a folder in the components directory. Other
+ * folders (the app's own code next to the components) aren't dolan's.
+ */
+export declare const componentsOnDisk: (componentsDir: string) => string[];
+/**
+ * The installed components dolan tracks: on disk and in the lockfile. `add`
+ * records every component it copies, and `eject` removes the record to hand
+ * the component over to the app, so a folder without one is the app's own
+ * code. `update`, `list`, `diff` and `outdated` leave it alone: before, they
+ * scanned the folders, so an ejected component showed as a conflict,
+ * `update --force` overwrote it and `update` tracked it again.
+ */
+export declare const trackedComponents: (componentsDir: string, lockfile: Lockfile) => string[];
+/** The components on disk that dolan doesn't track (see trackedComponents). */
+export declare const untrackedComponents: (componentsDir: string, lockfile: Lockfile) => string[];

package/dist/utils/installed.js

@@ -0,0 +1,27 @@
+import { existsSync, readdirSync } from 'node:fs';
+import { getComponentNames } from '../registry.js';
+/**
+ * The registry components with a folder in the components directory. Other
+ * folders (the app's own code next to the components) aren't dolan's.
+ */
+export const componentsOnDisk = (componentsDir) => {
+    if (!existsSync(componentsDir))
+        return [];
+    const known = new Set(getComponentNames());
+    return readdirSync(componentsDir, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory() && known.has(entry.name))
+        .map((entry) => entry.name)
+        .sort();
+};
+/**
+ * The installed components dolan tracks: on disk and in the lockfile. `add`
+ * records every component it copies, and `eject` removes the record to hand
+ * the component over to the app, so a folder without one is the app's own
+ * code. `update`, `list`, `diff` and `outdated` leave it alone: before, they
+ * scanned the folders, so an ejected component showed as a conflict,
+ * `update --force` overwrote it and `update` tracked it again.
+ */
+export const trackedComponents = (componentsDir, lockfile) => componentsOnDisk(componentsDir).filter((name) => lockfile.components[name]);
+/** The components on disk that dolan doesn't track (see trackedComponents). */
+export const untrackedComponents = (componentsDir, lockfile) => componentsOnDisk(componentsDir).filter((name) => !lockfile.components[name]);
+//# sourceMappingURL=installed.js.map

package/dist/utils/installed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installed.js","sourceRoot":"","sources":["../../src/utils/installed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGnD;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,aAAqB,EAAY,EAAE;IAClE,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC;QAAE,OAAO,EAAE,CAAC;IAC1C,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAC3C,OAAO,WAAW,CAAC,aAAa,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SACvD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;SAC/D,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;SAC1B,IAAI,EAAE,CAAC;AACZ,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,aAAqB,EACrB,QAAkB,EACR,EAAE,CACZ,gBAAgB,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;AAE9E,+EAA+E;AAC/E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,aAAqB,EACrB,QAAkB,EACR,EAAE,CACZ,gBAAgB,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC"}

package/dist/utils/installed.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/utils/installed.test.js

@@ -0,0 +1,41 @@
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, describe, expect, it } from 'vitest';
+import { createEmptyLockfile } from '../lockfile';
+import { componentsOnDisk, trackedComponents, untrackedComponents, } from './installed';
+let root;
+const componentsDir = (...folders) => {
+    root = mkdtempSync(join(tmpdir(), 'dolan-installed-'));
+    for (const folder of folders)
+        mkdirSync(join(root, folder));
+    // A file isn't a component, whatever its name.
+    writeFileSync(join(root, 'badge'), '');
+    return root;
+};
+afterEach(() => {
+    if (root)
+        rmSync(root, { recursive: true, force: true });
+});
+describe('componentsOnDisk', () => {
+    it('lists the registry components with a folder, sorted', () => {
+        const dir = componentsDir('spinner', 'card', 'my-own-thing');
+        expect(componentsOnDisk(dir)).toEqual(['card', 'spinner']);
+    });
+    it('is empty when the directory is missing', () => {
+        expect(componentsOnDisk(join(tmpdir(), 'dolan-missing-dir'))).toEqual([]);
+    });
+});
+describe('trackedComponents / untrackedComponents', () => {
+    it('splits the components on disk by their lockfile entry', () => {
+        const dir = componentsDir('card', 'spinner', 'button');
+        const lockfile = createEmptyLockfile();
+        lockfile.components['card'] = {};
+        lockfile.components['button'] = {};
+        // In the lockfile but not on disk: removed by hand, so neither.
+        lockfile.components['dialog'] = {};
+        expect(trackedComponents(dir, lockfile)).toEqual(['button', 'card']);
+        expect(untrackedComponents(dir, lockfile)).toEqual(['spinner']);
+    });
+});
+//# sourceMappingURL=installed.test.js.map

package/dist/utils/installed.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installed.test.js","sourceRoot":"","sources":["../../src/utils/installed.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAErB,IAAI,IAAY,CAAC;AACjB,MAAM,aAAa,GAAG,CAAC,GAAG,OAAiB,EAAE,EAAE;IAC7C,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC;IACvD,KAAK,MAAM,MAAM,IAAI,OAAO;QAAE,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5D,+CAA+C;IAC/C,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;IACvC,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,SAAS,CAAC,GAAG,EAAE;IACb,IAAI,IAAI;QAAE,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAC3D,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,GAAG,GAAG,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC;QAC7D,MAAM,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,yCAAyC,EAAE,GAAG,EAAE;IACvD,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QACvD,MAAM,QAAQ,GAAG,mBAAmB,EAAE,CAAC;QACvC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;QACjC,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;QACnC,gEAAgE;QAChE,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;QAEnC,MAAM,CAAC,iBAAiB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;QACrE,MAAM,CAAC,mBAAmB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/utils/interactive.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Whether anyone can answer a question: stdin is a terminal. In CI, a script
+ * or an AI agent it isn't, and clack's prompts wait for input that never
+ * comes. The commands used to hang there until stdin closed, then exit 0
+ * having done nothing. Without a terminal, each command asks nothing and takes
+ * each question's default instead, or exits 1 and names the option to pass
+ * when that default would cancel the run.
+ */
+export declare const isInteractive: () => boolean;

package/dist/utils/interactive.js

@@ -0,0 +1,10 @@
+/**
+ * Whether anyone can answer a question: stdin is a terminal. In CI, a script
+ * or an AI agent it isn't, and clack's prompts wait for input that never
+ * comes. The commands used to hang there until stdin closed, then exit 0
+ * having done nothing. Without a terminal, each command asks nothing and takes
+ * each question's default instead, or exits 1 and names the option to pass
+ * when that default would cancel the run.
+ */
+export const isInteractive = () => process.stdin.isTTY === true;
+//# sourceMappingURL=interactive.js.map

package/dist/utils/interactive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive.js","sourceRoot":"","sources":["../../src/utils/interactive.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,GAAY,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC"}

package/dist/utils/interactive.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/utils/interactive.test.js

@@ -0,0 +1,24 @@
+import { afterEach, describe, expect, it } from 'vitest';
+import { isInteractive } from './interactive';
+const isTTY = Object.getOwnPropertyDescriptor(process.stdin, 'isTTY');
+const setIsTTY = (value) => Object.defineProperty(process.stdin, 'isTTY', { value, configurable: true });
+afterEach(() => {
+    if (isTTY)
+        Object.defineProperty(process.stdin, 'isTTY', isTTY);
+    else
+        delete process.stdin.isTTY;
+});
+describe('isInteractive', () => {
+    it('is true when stdin is a terminal', () => {
+        setIsTTY(true);
+        expect(isInteractive()).toBe(true);
+    });
+    it('is false when stdin is a pipe or a file', () => {
+        // Node leaves `isTTY` undefined on anything but a terminal.
+        setIsTTY(undefined);
+        expect(isInteractive()).toBe(false);
+        setIsTTY(false);
+        expect(isInteractive()).toBe(false);
+    });
+});
+//# sourceMappingURL=interactive.test.js.map

package/dist/utils/interactive.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive.test.js","sourceRoot":"","sources":["../../src/utils/interactive.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,KAAK,GAAG,MAAM,CAAC,wBAAwB,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AACtE,MAAM,QAAQ,GAAG,CAAC,KAA0B,EAAE,EAAE,CAC9C,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;AAE/E,SAAS,CAAC,GAAG,EAAE;IACb,IAAI,KAAK;QAAE,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;;QAC3D,OAAQ,OAAO,CAAC,KAA6B,CAAC,KAAK,CAAC;AAC3D,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,4DAA4D;QAC5D,QAAQ,CAAC,SAAS,CAAC,CAAC;QACpB,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAChB,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/utils/packages.d.ts

@@ -0,0 +1,36 @@
+import { spawnSync } from 'node:child_process';
+/**
+ * npm packages a component imports. Components are copied, not installed, but
+ * some build on a library (the charts on `@tanstack/charts`), and their copied
+ * code can't compile until the project depends on it too. `dolan add` and
+ * `dolan update` install what's missing with the project's own package manager.
+ */
+export type PackageManager = 'npm' | 'pnpm' | 'yarn' | 'bun';
+/**
+ * The package manager whose lockfile is nearest `cwd`, looking up the tree
+ * because in a workspace the lockfile sits at the root. npm when there's none.
+ */
+export declare const detectPackageManager: (cwd: string) => PackageManager;
+/** `@scope/name@^1.0.0` → `@scope/name`; `name` stays `name`. */
+export declare const packageName: (spec: string) => string;
+/** The specs whose package the project's package.json doesn't list yet. */
+export declare const missingPackages: (cwd: string, specs: readonly string[]) => string[];
+/** The command that adds `specs` as dependencies, e.g. `npm install a b`. */
+export declare const installCommand: (manager: PackageManager, specs: readonly string[]) => string[];
+/**
+ * Installs `specs` in `cwd`. Returns false when the package manager couldn't
+ * run or failed, so the caller can show the command to run by hand.
+ */
+export declare const installPackages: (cwd: string, specs: readonly string[], run?: typeof spawnSync) => boolean;
+/**
+ * The library the components' tests render with. Apps get it from
+ * `ng generate @blotch/angular-lynx:add-testing`.
+ */
+export declare const TESTING_LIBRARY = "@blotch/angular-lynx-testing-library";
+/**
+ * Whether dolan copies components' tests into the project: only when it
+ * depends on the testing library, since the tests import it and `ng test`
+ * fails to compile them otherwise. Every command asks the same question, so
+ * a project without the library never sees the tests as missing or new.
+ */
+export declare const copiesTests: (cwd: string) => boolean;

package/dist/utils/packages.js

@@ -0,0 +1,70 @@
+import { spawnSync } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+const LOCK_FILES = [
+    ['pnpm-lock.yaml', 'pnpm'],
+    ['yarn.lock', 'yarn'],
+    ['bun.lock', 'bun'],
+    ['bun.lockb', 'bun'],
+    ['package-lock.json', 'npm'],
+];
+/**
+ * The package manager whose lockfile is nearest `cwd`, looking up the tree
+ * because in a workspace the lockfile sits at the root. npm when there's none.
+ */
+export const detectPackageManager = (cwd) => {
+    let dir = cwd;
+    for (;;) {
+        for (const [file, manager] of LOCK_FILES) {
+            if (existsSync(join(dir, file)))
+                return manager;
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            return 'npm';
+        dir = parent;
+    }
+};
+/** `@scope/name@^1.0.0` → `@scope/name`; `name` stays `name`. */
+export const packageName = (spec) => {
+    const at = spec.indexOf('@', 1);
+    return at === -1 ? spec : spec.slice(0, at);
+};
+/** The specs whose package the project's package.json doesn't list yet. */
+export const missingPackages = (cwd, specs) => {
+    const manifestPath = join(cwd, 'package.json');
+    const manifest = existsSync(manifestPath)
+        ? JSON.parse(readFileSync(manifestPath, 'utf-8'))
+        : {};
+    const listed = new Set(['dependencies', 'devDependencies', 'peerDependencies'].flatMap((key) => Object.keys(manifest[key] ?? {})));
+    return specs.filter((spec) => !listed.has(packageName(spec)));
+};
+/** The command that adds `specs` as dependencies, e.g. `npm install a b`. */
+export const installCommand = (manager, specs) => [manager, manager === 'npm' ? 'install' : 'add', ...specs];
+/**
+ * Installs `specs` in `cwd`. Returns false when the package manager couldn't
+ * run or failed, so the caller can show the command to run by hand.
+ */
+export const installPackages = (cwd, specs, run = spawnSync) => {
+    const [command, ...args] = installCommand(detectPackageManager(cwd), specs);
+    const result = run(command, args, {
+        cwd,
+        stdio: 'inherit',
+        // Package managers are .cmd shims on Windows, which only a shell runs.
+        shell: process.platform === 'win32',
+    });
+    return result.status === 0;
+};
+/**
+ * The library the components' tests render with. Apps get it from
+ * `ng generate @blotch/angular-lynx:add-testing`.
+ */
+export const TESTING_LIBRARY = '@blotch/angular-lynx-testing-library';
+/**
+ * Whether dolan copies components' tests into the project: only when it
+ * depends on the testing library, since the tests import it and `ng test`
+ * fails to compile them otherwise. Every command asks the same question, so
+ * a project without the library never sees the tests as missing or new.
+ */
+export const copiesTests = (cwd) => missingPackages(cwd, [TESTING_LIBRARY]).length === 0;
+//# sourceMappingURL=packages.js.map

package/dist/utils/packages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packages.js","sourceRoot":"","sources":["../../src/utils/packages.ts"],"names":[],"mappings":"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"}

package/dist/utils/packages.test.d.ts

@@ -0,0 +1 @@
+export {};