@rivinia/toast 0.1.0 → 0.2.0

package/README.md

@@ -8,13 +8,14 @@ dedupe, overflow policies — zero DOM, zero styles, zero router dependency.
 A future `@rivinia/toast/ui` entry point will render this state; Core never
 imports UI.
 
-- Version: **0.1.0**
+- Version: **0.2.0**
 - Requires: **Angular `^22.0.0`**, `tslib`
 
 ## Install
 
 ```bash
 npm install @rivinia/toast
+ng add @rivinia/toast   # wires provideRiviniaToast() into app.config.ts
 ```
 
 ```ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rivinia/toast",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Headless toast queue for Angular with optional UI outlet: signals, pause-on-hover timers, actions.",
   "keywords": [
     "angular",
@@ -17,6 +17,7 @@
     "tslib": "^2.3.0"
   },
   "sideEffects": false,
+  "schematics": "./schematics/collection.json",
   "module": "fesm2022/rivinia-toast.mjs",
   "typings": "types/rivinia-toast.d.ts",
   "exports": {

package/schematics/collection.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "../../../node_modules/@angular-devkit/schematics/collection-schema.json",
+  "schematics": {
+    "ng-add": {
+      "description": "Add provideRiviniaToast() to the application config.",
+      "factory": "./ng-add/index.cjs#ngAdd",
+      "schema": "./ng-add/schema.json"
+    }
+  }
+}

package/schematics/ng-add/index.cjs

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ngAdd = ngAdd;
+const schematics_1 = require("@angular-devkit/schematics");
+const PROVIDE_IMPORT = `import { provideRiviniaToast } from '@rivinia/toast';`;
+/**
+ * `ng add @rivinia/toast` — wires the library into a standalone app config.
+ *
+ * - Never overwrites user files; only inserts one import + one provider.
+ * - Idempotent: safe to run twice (existing entries are detected and skipped).
+ * - No prompts by design: duration/maxVisible are one-line edits, and every
+ *   extra question is a papercut. Pass `--duration` / `--max-visible` flags
+ *   or edit the emitted call afterwards.
+ */
+function ngAdd(options) {
+    return (tree, context) => {
+        let configPath;
+        try {
+            configPath = findAppConfig(tree, options.project);
+        }
+        catch (error) {
+            context.logger.warn(`[rivinia/toast] workspace lookup failed (${error instanceof Error ? error.message : error}) — skipping. ` +
+                `Add provideRiviniaToast() manually (see README).`);
+            return tree;
+        }
+        if (!configPath || !tree.exists(configPath)) {
+            context.logger.warn(`[rivinia/toast] app.config.ts not found — skipping. ` +
+                `Add provideRiviniaToast() manually (see README).`);
+            return tree;
+        }
+        let content = tree.read(configPath)?.toString('utf-8') ?? '';
+        if (!content) {
+            throw new schematics_1.SchematicsException(`[rivinia/toast] ${configPath} is empty.`);
+        }
+        const parts = [];
+        if (options.duration !== undefined)
+            parts.push(`duration: ${options.duration}`);
+        if (options.maxVisible !== undefined)
+            parts.push(`maxVisible: ${options.maxVisible}`);
+        const provideCall = `provideRiviniaToast(${parts.length > 0 ? `{ ${parts.join(', ')} }` : ''})`;
+        let changed = false;
+        if (!content.includes(PROVIDE_IMPORT)) {
+            content = insertAfterLastImport(content, PROVIDE_IMPORT);
+            changed = true;
+        }
+        if (!content.includes('provideRiviniaToast(')) {
+            content = insertProvider(content, provideCall);
+            changed = true;
+        }
+        else {
+            context.logger.info('[rivinia/toast] provideRiviniaToast() already present — skipped.');
+        }
+        if (changed) {
+            tree.overwrite(configPath, content);
+            context.logger.info(`[rivinia/toast] wired into ${configPath}.`);
+        }
+        return tree;
+    };
+}
+function defaultProjectName(tree, requested) {
+    if (requested)
+        return requested;
+    const angularJson = tree.read('/angular.json')?.toString('utf-8');
+    if (!angularJson) {
+        throw new schematics_1.SchematicsException('[rivinia/toast] angular.json not found.');
+    }
+    const workspace = JSON.parse(angularJson);
+    if (workspace.defaultProject && typeof workspace.defaultProject === 'string') {
+        return workspace.defaultProject;
+    }
+    const names = Object.keys(workspace.projects ?? {});
+    if (names.length === 0) {
+        throw new schematics_1.SchematicsException('[rivinia/toast] no projects in angular.json.');
+    }
+    return names[0];
+}
+function findAppConfig(tree, requestedProject) {
+    const angularJson = tree.read('/angular.json')?.toString('utf-8');
+    if (!angularJson)
+        return null;
+    const workspace = JSON.parse(angularJson);
+    const name = defaultProjectName(tree, requestedProject);
+    const project = workspace.projects?.[name];
+    if (!project)
+        return null;
+    const sourceRoot = project.sourceRoot ?? (project.root ? `${project.root}/src` : 'src');
+    return `/${sourceRoot}/app/app.config.ts`;
+}
+function insertAfterLastImport(content, line) {
+    const lines = content.split('\n');
+    let idx = -1;
+    for (let i = 0; i < lines.length; i++) {
+        if (/^\s*import\s/.test(lines[i]))
+            idx = i;
+    }
+    lines.splice(idx + 1, 0, line);
+    return lines.join('\n');
+}
+function insertProvider(content, call) {
+    const match = /providers\s*:\s*\[/.exec(content);
+    if (!match) {
+        throw new schematics_1.SchematicsException('[rivinia/toast] no `providers: [` array found in app.config.ts — add providers manually.');
+    }
+    const at = match.index + match[0].length;
+    return `${content.slice(0, at)}\n    ${call},${content.slice(at)}`;
+}

package/schematics/ng-add/schema.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "rivinia-toast-ng-add",
+  "title": "Rivinia Toast ng-add options",
+  "type": "object",
+  "properties": {
+    "duration": {
+      "type": "number",
+      "description": "Global default auto-dismiss delay in milliseconds for provideRiviniaToast({ duration }). Omit to keep the 5000 default."
+    },
+    "maxVisible": {
+      "type": "number",
+      "description": "Maximum simultaneously visible toasts for provideRiviniaToast({ maxVisible }). Omit to keep the 5 default."
+    },
+    "project": {
+      "type": "string",
+      "description": "Angular CLI project name — only for multi-app workspaces. Defaults to the workspace default project.",
+      "default": ""
+    }
+  },
+  "required": []
+}