snackng 0.1.0

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "snackng",
+  "version": "0.1.0",
+  "description": "The easiest way to show toasts and snackbars in Angular with a glass design, zero UI dependencies and CSS-variable theming. No Material, no CDK, no Tailwind required.",
+  "author": "xgreymx",
+  "keywords": [
+    "angular",
+    "toast",
+    "toastr",
+    "snackbar",
+    "notification",
+    "glassmorphism",
+    "a11y",
+    "angular-toast",
+    "angular-snackbar",
+    "angular-notification",
+    "css-variables",
+    "ssr",
+    "standalone"
+  ],
+  "license": "Apache-2.0",
+  "homepage": "https://github.com/xgreymx/snackng#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xgreymx/snackng.git",
+    "directory": "projects/snackng"
+  },
+  "bugs": {
+    "url": "https://github.com/xgreymx/snackng/issues"
+  },
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/xgreymx"
+  },
+  "sideEffects": false,
+  "peerDependencies": {
+    "@angular/common": ">=21",
+    "@angular/core": ">=21",
+    "@angular/platform-browser": ">=21"
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "exports": {
+    "./themes/daisy.css": {
+      "style": "./themes/daisy.css",
+      "default": "./themes/daisy.css"
+    },
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./types/snackng.d.ts",
+      "default": "./fesm2022/snackng.mjs"
+    }
+  },
+  "module": "fesm2022/snackng.mjs",
+  "typings": "types/snackng.d.ts",
+  "type": "module"
+}

package/themes/daisy.css

@@ -0,0 +1,35 @@
+/* snackng — daisyUI bridge (optional)
+   ===================================
+   Import this ONLY if your app uses daisyUI:
+
+     @import "snackng/themes/daisy.css";
+
+   snackng does not depend on daisyUI or Tailwind. Without this file it renders
+   with its own glass defaults. With it, the toast colours are re-pointed at
+   daisyUI's semantic theme variables, so they follow theme switching and dark
+   mode automatically — daisyUI redefines `--color-*` per theme.
+
+   Note this replaces the glass gradients with daisyUI's flat theme colours.
+   To keep the glass look and only borrow daisy's hues, override the individual
+   variables yourself instead of importing this file. */
+
+:root {
+  --snackng-success-bg: var(--color-success);
+  --snackng-success-ink: var(--color-success-content);
+  --snackng-success-solid: var(--color-success);
+
+  --snackng-warning-bg: var(--color-warning);
+  --snackng-warning-ink: var(--color-warning-content);
+  --snackng-warning-solid: var(--color-warning);
+
+  --snackng-danger-bg: var(--color-error);
+  --snackng-danger-ink: var(--color-error-content);
+  --snackng-danger-solid: var(--color-error);
+
+  --snackng-info-bg: var(--color-info);
+  --snackng-info-ink: var(--color-info-content);
+  --snackng-info-solid: var(--color-info);
+
+  --snackng-radius: var(--radius-box);
+  --snackng-font: inherit;
+}

package/types/snackng.d.ts

@@ -0,0 +1,108 @@
+import * as i0 from '@angular/core';
+import { OnDestroy, InjectionToken, EnvironmentProviders } from '@angular/core';
+
+/** Built-in severities. Any other string is a custom type registered via `provideSnackng`. */
+type SnackngBuiltInType = 'success' | 'warning' | 'danger' | 'info';
+type SnackngType = SnackngBuiltInType | (string & {});
+type SnackngPosition = 'top-start' | 'top-center' | 'top-end' | 'bottom-start' | 'bottom-center' | 'bottom-end';
+type SnackngPoliteness = 'polite' | 'assertive' | 'off';
+type SnackngOverflow = 'queue' | 'dismiss-oldest';
+/** `'replaced'` means the toast was evicted under `overflow: 'dismiss-oldest'`. */
+type SnackngDismissReason = 'timeout' | 'action' | 'manual' | 'replaced';
+interface SnackngAction {
+    label: string;
+    handler?: () => void;
+    /** Dismiss the toast when the action is clicked. Defaults to true. */
+    dismissOnClick?: boolean;
+}
+/**
+ * Definition for a custom type. Built-in types already have icon and colors;
+ * a custom type inherits the neutral surface and is styled through
+ * `--snackng-<type>-bg` / `--snackng-<type>-ink`.
+ */
+interface SnackngTypeDef {
+    /**
+     * Raw SVG markup for the icon. Trusted as-is (bypasses Angular's sanitizer),
+     * so it must come from your code, never from user input. Falls back to the
+     * `info` glyph when omitted.
+     */
+    icon?: string;
+    politeness?: SnackngPoliteness;
+}
+interface SnackngOptions {
+    title?: string;
+    /** Milliseconds before auto-dismiss. `0` keeps the toast until dismissed. */
+    duration?: number;
+    action?: SnackngAction;
+    position?: SnackngPosition;
+    /** Show the close button. */
+    dismissible?: boolean;
+    /** Overrides the politeness derived from the type. */
+    politeness?: SnackngPoliteness;
+    panelClass?: string | string[];
+}
+interface SnackngRef {
+    readonly id: string;
+    dismiss(): void;
+    readonly afterDismissed: Promise<SnackngDismissReason>;
+}
+
+declare class SnackngService implements OnDestroy {
+    private readonly store;
+    private readonly config;
+    private readonly liveRegion;
+    private readonly appRef;
+    private readonly injector;
+    private readonly document;
+    private readonly isBrowser;
+    private host?;
+    /**
+     * Toasts accepted but still waiting for a free slot under `overflow: 'queue'`.
+     * Useful for a "3 more" affordance.
+     */
+    readonly pending: i0.Signal<number>;
+    success(message: string, options?: SnackngOptions): SnackngRef;
+    warning(message: string, options?: SnackngOptions): SnackngRef;
+    danger(message: string, options?: SnackngOptions): SnackngRef;
+    info(message: string, options?: SnackngOptions): SnackngRef;
+    show(type: SnackngType, message: string, options?: SnackngOptions): SnackngRef;
+    dismissAll(): void;
+    private resolvePoliteness;
+    private ensureHost;
+    ngOnDestroy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SnackngService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SnackngService>;
+}
+
+interface SnackngConfig {
+    duration: number;
+    position: SnackngPosition;
+    /** Maximum toasts on screen at once. Extras are handled per `overflow`. */
+    max: number;
+    /**
+     * What happens when a toast arrives while `max` are already visible.
+     * `'queue'` waits for a free slot — nothing is ever lost, but a flood becomes
+     * a long parade. `'dismiss-oldest'` evicts the oldest to make room, so the
+     * newest always wins; useful when an interceptor can emit toasts in bursts.
+     */
+    overflow: SnackngOverflow;
+    /**
+     * Milliseconds between releasing consecutive queued toasts. Staggering keeps
+     * a burst from firing every enter animation at the same instant. `0` releases
+     * as many as fit at once.
+     */
+    stagger: number;
+    pauseOnHover: boolean;
+    dismissible: boolean;
+    types: Record<string, SnackngTypeDef>;
+}
+declare const SNACKNG_DEFAULTS: SnackngConfig;
+declare const SNACKNG_CONFIG: InjectionToken<SnackngConfig>;
+/**
+ * Optional. Without it the defaults above apply, so `npm i snackng` and calling
+ * the service is enough to get working toasts.
+ */
+declare function provideSnackng(config?: Partial<SnackngConfig>): EnvironmentProviders;
+
+export { SNACKNG_CONFIG, SNACKNG_DEFAULTS, SnackngService, provideSnackng };
+export type { SnackngAction, SnackngBuiltInType, SnackngConfig, SnackngDismissReason, SnackngOptions, SnackngPoliteness, SnackngPosition, SnackngRef, SnackngType, SnackngTypeDef };