npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@molecule/app-progress-rings-angular

v1.1.0

Published

Apple-Health-style SVG progress rings (single + concentric triad) — health summaries, onboarding, OKR

Readme

@molecule/app-progress-rings-angular

Angular Apple-Health-style concentric SVG progress rings — single + triad.

Exports svg[mol-progress-rings] — the Angular counterpart of @molecule/app-progress-rings-react, with the same props (React names, bound as inputs) and the same DOM for the same input, so an app switches framework by changing only the package name in its imports.

Auto-generated, AI-first package reference for the molecule.dev ecosystem. It is written to be read by coding agents as much as by people, and is generated from this package's source — edit src/index.ts JSDoc, not this file.

Quick Start

import { Component } from '@angular/core'
import { ProgressRings } from '@molecule/app-progress-rings-angular'

@Component({
  selector: 'activity-ring',
  standalone: true,
  imports: [ProgressRings],
  template: `
    <svg
      mol-progress-rings
      [rings]="[
        { value: 8200, max: 10000, color: 'var(--color-success)', label: 'Steps' },
        { value: 7, max: 8, color: 'var(--color-info)', label: 'Sleep (hrs)' },
        { value: 35, max: 60, color: 'var(--color-warning)', label: 'Active (min)' },
      ]"
      [size]="160"
      [strokeWidth]="12"
    ></svg>
  `,
})
export class ActivityRing {}

Type

feature

Installation

npm install @molecule/app-progress-rings-angular @angular/common @angular/core @angular/platform-browser @molecule/app-angular @molecule/app-ui @molecule/app-ui-angular

API

Interfaces

ProgressRing

Single ring entry — value/max plus the colored accent and an optional label.

interface ProgressRing {
  /** Current progress value. Clamped against `max` at render time. */
  value: number
  /** Maximum / goal value. Must be > 0; values <= 0 fall back to 1. */
  max: number
  /**
   * SVG stroke color for this ring. Pass a CSS color (token-resolved by the
   * caller against the active theme) — the component never hardcodes color.
   */
  color: string
  /** Optional accessible label for this ring (e.g. "Steps", "Sleep"). */
  label?: string
}

ProgressRingsProps

Props accepted by {@link ProgressRings} — the same props the React package accepts, bound as inputs.

interface ProgressRingsProps {
  /** One or more rings. 1 ring = single circle; 2+ = concentric Apple-Health-style stack. */
  rings: ProgressRing[]
  /** Outer SVG diameter in px. Defaults to 160. */
  size?: number
  /** Stroke thickness for each ring in px. Defaults to 12. */
  strokeWidth?: number
  /** Gap between concentric rings in px (ignored when only one ring). Defaults to 4. */
  gap?: number
  /**
   * Stroke linecap rounding. `'round'` produces the iOS-Health pill caps;
   * `'butt'` is flat. Defaults to `'round'`.
   */
  cornerRadius?: 'round' | 'butt'
  /** Override the outer wrapper classes. */
  className?: string
  /** `data-mol-id` for AI-agent selectors. */
  dataMolId?: string
  /** Optional aria-label for the whole graphic. Falls back to translated summary. */
  ariaLabel?: string
}

Classes

ProgressRings

ProgressRings component.

Apple-Health-style concentric SVG progress rings — a single circular ring for one entry, or a nested stack (outermost first) for 2+. The host IS the <svg> (svg[mol-progress-rings]), matching React's root exactly — same attributes, same classes. Layout resolves via the wired ClassMap; ring colors come from the rings input. The stack renders with track $index, matching React's per-ring keys, so equal new data keeps the rendered nodes.

This is the Angular counterpart of @molecule/app-progress-rings-react.

@Component({
  selector: 'svg[mol-progress-rings]',
  standalone: true,
  inputs: [
    'rings',
    'size',
    'strokeWidth',
    'gap',
    'cornerRadius',
    'className',
    'dataMolId',
    'ariaLabel',
  ],
  host: {
    role: 'img',
    '[class]': 'classes()',
    '[attr.data-mol-id]': 'dataMolId ?? "progress-rings"',
    '[attr.aria-label]': 'summary()',
    '[attr.width]': 'svgSize()',
    '[attr.height]': 'svgSize()',
    '[attr.viewBox]': 'viewBox()',
  },
  // prettier-ignore
  template: `@for (ring of rings; track $index) {@if (radius($index) > 0) {<svg:g role="img" [attr.aria-label]="ringLabel($index, ring.label)"><svg:circle [attr.cx]="center()" [attr.cy]="center()" [attr.r]="radius($index)" fill="none" [attr.stroke]="ring.color" [attr.stroke-opacity]="0.18" [attr.stroke-width]="strokeWidthValue()" /><svg:circle [attr.cx]="center()" [attr.cy]="center()" [attr.r]="radius($index)" fill="none" [attr.stroke]="ring.color" [attr.stroke-width]="strokeWidthValue()" [attr.stroke-linecap]="cornerRadiusValue()" [attr.stroke-dasharray]="dasharray($index)" [attr.transform]="transform()" /></svg:g>}}`,
})
export class ProgressRings {
  /** One or more rings. 1 ring = single circle; 2+ = concentric stack. */
  rings: ProgressRing[] = []
  /** Outer SVG diameter in px (defaults to 160 at read time). */
  size?: number
  /** Stroke thickness for each ring in px (defaults to 12 at read time). */
  strokeWidth?: number
  /** Gap between concentric rings in px (defaults to 4 at read time). */
  gap?: number
  /** Stroke linecap rounding (defaults to `'round'` at read time). */
  cornerRadius?: ProgressRingsProps['cornerRadius']
  /** Override the outer wrapper classes. */
  className?: string
  /** `data-mol-id` for AI-agent selectors. */
  dataMolId?: string
  /** Optional aria-label for the whole graphic. */
  ariaLabel?: string

  /** The i18n handle (locale-reactive), read in an injection context. */
  private readonly i18n = useTranslation()

  /**
   * The current class map.
   * @returns The UIClassMap.
   */
  cm(): UIClassMap {
    return getClassMap()
  }

  /**
   * Computes the SVG's class list.
   * @returns The class string.
   */
  classes(): string {
    return this.cm().cn(this.className)
  }

  /**
   * The SVG diameter (React's default parameter: a later-bound write of
   * `undefined` must not erase the `160` default).
   * @returns The size in px.
   */
  svgSize(): number {
    return this.size ?? 160
  }

  /**
   * The stroke thickness (React's default parameter).
   * @returns The stroke width in px.
   */
  strokeWidthValue(): number {
    return this.strokeWidth ?? 12
  }

  /**
   * The gap between rings (React's default parameter).
   * @returns The gap in px.
   */
  gapValue(): number {
    return this.gap ?? 4
  }

  /**
   * The stroke linecap (React's default parameter).
   * @returns `'round'` or `'butt'`.
   */
  cornerRadiusValue(): 'round' | 'butt' {
    return this.cornerRadius ?? 'round'
  }

  /**
   * The centre of the viewBox (also the circle centre on both axes).
   * @returns The centre in px.
   */
  center(): number {
    return this.svgSize() / 2
  }

  /**
   * The viewBox of the SVG.
   * @returns The `min-x min-y width height` string.
   */
  viewBox(): string {
    return `0 0 ${this.svgSize()} ${this.svgSize()}`
  }

  /**
   * The accessible summary (an explicit `ariaLabel` wins over the translated one).
   * @returns The aria label text.
   */
  summary(): string {
    return (
      this.ariaLabel ??
      this.i18n.t(
        'progressRings.summary',
        { count: this.rings.length },
        {
          defaultValue: 'Progress rings ({{count}} rings)',
        },
      )
    )
  }

  /**
   * The ring's accessible label (an explicit per-ring `label` wins).
   * @param i - Ring index (0 = outermost).
   * @param label - The ring's own label, when it has one.
   * @returns The label text.
   */
  ringLabel(i: number, label: string | undefined): string {
    return (
      label ??
      this.i18n.t('progressRings.ring', { index: i + 1 }, { defaultValue: 'Ring {{index}}' })
    )
  }

  /**
   * The ring's radius — rings nest inside-out, each one (strokeWidth + gap)
   * inward of the previous. React renders nothing for a radius <= 0.
   * @param i - Ring index (0 = outermost).
   * @returns The radius in px.
   */
  radius(i: number): number {
    return (
      this.svgSize() / 2 -
      this.strokeWidthValue() / 2 -
      i * (this.strokeWidthValue() + this.gapValue())
    )
  }

  /**
   * The ring's circumference (0 when the radius is not positive).
   * @param i - Ring index (0 = outermost).
   * @returns The circumference in px.
   */
  circumference(i: number): number {
    return 2 * Math.PI * Math.max(this.radius(i), 0)
  }

  /**
   * The filled arc length: the circumference times the clamped value ratio.
   * @param i - Ring index (0 = outermost).
   * @returns The filled length in px.
   */
  filledLength(i: number): number {
    const ring = this.rings[i]
    if (!ring) return 0
    const safeMax = ring.max > 0 ? ring.max : 1
    const ratio = Math.max(0, Math.min(1, ring.value / safeMax))
    return this.circumference(i) * ratio
  }

  /**
   * The arc's `stroke-dasharray` (filled length, then the whole circumference).
   * @param i - Ring index (0 = outermost).
   * @returns The dasharray value.
   */
  dasharray(i: number): string {
    return `${this.filledLength(i)} ${this.circumference(i)}`
  }

  /**
   * The arc's rotation, so it starts at the top of the circle.
   * @returns The transform value.
   */
  transform(): string {
    return `rotate(-90 ${this.center()} ${this.center()})`
  }
}

Injection Notes

Requirements

Peer dependencies:

  • @angular/common ^22.0.0
  • @angular/core ^22.0.0
  • @angular/platform-browser ^22.0.0
  • @molecule/app-angular ^3.5.0
  • @molecule/app-ui ^1.0.1
  • @molecule/app-ui-angular ^1.1.0

Runtime Dependencies

  • @angular/common
  • @angular/core
  • @angular/platform-browser
  • @molecule/app-angular
  • @molecule/app-ui
  • @molecule/app-ui-angular

Companion locale bond: @molecule/app-locales-progress-rings (aria summary

  • per-ring labels). Ring color is any CSS color — pass theme tokens like var(--color-success) so rings follow the active theme. Requires a wired ClassMap bond; the labels are read through useTranslation() so they follow a locale switch. Rings nest outside-in: rings[0] is the outermost.

Translations

Translation strings are provided by @molecule/app-locales-progress-rings.