@memberjunction/ng-word-cloud 0.0.1 → 5.24.0

package/README.md

@@ -1,45 +1,136 @@
 # @memberjunction/ng-word-cloud
 
-## ⚠️ IMPORTANT NOTICE ⚠️
+A reusable, SVG-based word cloud component for Angular. Renders weighted text items in a spiral or rectangular layout with collision detection. Supports multiple color modes using MJ design tokens, optional entry animation, and click/hover interaction.
 
-**This package is created solely for the purpose of setting up OIDC (OpenID Connect) trusted publishing with npm.**
+## Installation
 
-This is **NOT** a functional package and contains **NO** code or functionality beyond the OIDC setup configuration.
+```bash
+npm install @memberjunction/ng-word-cloud
+```
 
-## Purpose
+## Usage
 
-This package exists to:
-1. Configure OIDC trusted publishing for the package name `@memberjunction/ng-word-cloud`
-2. Enable secure, token-less publishing from CI/CD workflows
-3. Establish provenance for packages published under this name
+The component is standalone and can be imported directly:
 
-## What is OIDC Trusted Publishing?
+```typescript
+import { MJWordCloudComponent } from '@memberjunction/ng-word-cloud';
 
-OIDC trusted publishing allows package maintainers to publish packages directly from their CI/CD workflows without needing to manage npm access tokens. Instead, it uses OpenID Connect to establish trust between the CI/CD provider (like GitHub Actions) and npm.
+@Component({
+    imports: [MJWordCloudComponent],
+    template: `
+        <mj-word-cloud
+            [Items]="Words"
+            [MaxFontSize]="56"
+            ColorMode="categorical"
+            (ItemClick)="OnWordClick($event)">
+        </mj-word-cloud>
+    `
+})
+export class MyComponent {
+    Words: WordCloudItem[] = [
+        { Text: 'Machine Learning', Weight: 1.0 },
+        { Text: 'Data Science', Weight: 0.8, Category: 'analytics' },
+        { Text: 'Neural Networks', Weight: 0.6, Category: 'ai' },
+    ];
 
-## Setup Instructions
+    OnWordClick(event: WordCloudItemEvent): void {
+        console.log('Clicked:', event.Item.Text);
+    }
+}
+```
 
-To properly configure OIDC trusted publishing for this package:
+## Component API
 
-1. Go to [npmjs.com](https://www.npmjs.com/) and navigate to your package settings
-2. Configure the trusted publisher (e.g., GitHub Actions)
-3. Specify the repository and workflow that should be allowed to publish
-4. Use the configured workflow to publish your actual package
+### Selector
 
-## DO NOT USE THIS PACKAGE
+`mj-word-cloud`
 
-This package is a placeholder for OIDC configuration only. It:
-- Contains no executable code
-- Provides no functionality
-- Should not be installed as a dependency
-- Exists only for administrative purposes
+### Inputs
 
-## More Information
+| Input | Type | Default | Description |
+|-------|------|---------|-------------|
+| `Items` | `WordCloudItem[]` | `[]` | Data items to display in the cloud |
+| `MinFontSize` | `number` | `12` | Minimum font size in pixels for the lowest-weighted item |
+| `MaxFontSize` | `number` | `48` | Maximum font size in pixels for the highest-weighted item |
+| `Layout` | `'spiral' \| 'rectangular'` | `'spiral'` | Layout algorithm for word placement |
+| `ColorMode` | `'brand' \| 'categorical' \| 'weight-gradient'` | `'brand'` | How colors are assigned to words (see Color Modes below) |
+| `Interactive` | `boolean` | `true` | Whether words are clickable and hoverable |
+| `MaxItems` | `number` | `100` | Maximum number of items to display (heaviest items are kept) |
+| `Animate` | `boolean` | `true` | Whether to animate words in with a staggered fade |
 
-For more details about npm's trusted publishing feature, see:
-- [npm Trusted Publishing Documentation](https://docs.npmjs.com/generating-provenance-statements)
-- [GitHub Actions OIDC Documentation](https://docs.github.com/en/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)
+### Outputs
 
----
+| Output | Type | Description |
+|--------|------|-------------|
+| `ItemClick` | `EventEmitter<WordCloudItemEvent>` | Emitted when a word is clicked |
+| `ItemHover` | `EventEmitter<WordCloudItemEvent>` | Emitted when the pointer enters a word |
+| `ItemLeave` | `EventEmitter<WordCloudItemEvent>` | Emitted when the pointer leaves a word |
 
-**Maintained for OIDC setup purposes only**
+## Types
+
+### WordCloudItem
+
+```typescript
+interface WordCloudItem {
+    Text: string;                           // Display text
+    Weight: number;                         // Importance (0.0 - 1.0), determines font size
+    Category?: string;                      // Optional category for color grouping
+    Metadata?: Record<string, unknown>;     // Optional metadata passed through events
+}
+```
+
+### WordCloudItemEvent
+
+```typescript
+interface WordCloudItemEvent {
+    Item: WordCloudItem;    // The item that was interacted with
+    Event: MouseEvent;      // The original DOM event
+}
+```
+
+## Color Modes
+
+### `brand`
+
+All words use `--mj-brand-primary`. Opacity varies with weight (range 0.4--1.0), giving higher-weighted words more visual prominence.
+
+### `categorical`
+
+Words with the same `Category` share a color from a fixed palette of MJ design tokens: `--mj-brand-primary`, `--mj-status-success`, `--mj-status-warning`, `--mj-status-error`, `--mj-status-info`, and others. Words without a `Category` each get their own color.
+
+### `weight-gradient`
+
+Interpolates between `--mj-text-muted` (low weight) and `--mj-brand-primary` (high weight) using `color-mix()`. Provides a smooth gradient that adapts to both light and dark themes.
+
+## Rendering Approach
+
+The component renders entirely in SVG using an `<svg>` element with a computed `viewBox` and `preserveAspectRatio="xMidYMid meet"` so the cloud scales to fill its container.
+
+### Layout Algorithm
+
+1. Items are sorted by weight (heaviest first) and trimmed to `MaxItems`.
+2. For each item, the engine computes a font size by linear interpolation between `MinFontSize` and `MaxFontSize` based on weight.
+3. Roughly 20% of words are rotated 90 degrees for visual variety (deterministic based on index).
+4. The engine generates candidate positions using the selected algorithm:
+   - **Spiral** -- Archimedean spiral expanding from the center.
+   - **Rectangular** -- concentric rectangular rings expanding from the center.
+5. For each candidate position, an axis-aligned bounding box is computed (accounting for rotation) and tested against all previously placed items.
+6. The first non-colliding position is accepted. If no position is found after 500 attempts, the word is skipped.
+7. The overall SVG `viewBox` is computed to fit all placed items with 20px padding.
+
+Text width is estimated using an average character width ratio of 0.6x the font size (no DOM measurement required), making the layout engine fully deterministic and SSR-compatible.
+
+## Design Token Compliance
+
+All colors use MJ semantic design tokens exclusively. No hardcoded hex values are used in the component's styles or color logic. The component adapts automatically to light and dark themes via the `--mj-*` CSS custom properties.
+
+Tokens used:
+
+- `--mj-brand-primary`, `--mj-brand-primary-hover` -- brand color mode
+- `--mj-status-success`, `--mj-status-warning`, `--mj-status-error`, `--mj-status-info` -- categorical palette
+- `--mj-text-muted` -- weight-gradient low end
+- `--mj-font-family` -- inherited font family
+
+## Change Detection
+
+The component uses `ChangeDetectionStrategy.OnPush` for performance. The layout is recomputed whenever any `@Input` changes (via `ngOnChanges`).

package/dist/__tests__/word-cloud-layout.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=word-cloud-layout.test.d.ts.map

package/dist/__tests__/word-cloud-layout.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"word-cloud-layout.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/word-cloud-layout.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/word-cloud-layout.test.js

@@ -0,0 +1,198 @@
+import { describe, it, expect } from 'vitest';
+import { computeWordCloudLayout } from '../lib/word-cloud.layout';
+const defaultConfig = {
+    MinFontSize: 12,
+    MaxFontSize: 48,
+    Layout: 'spiral',
+    MaxItems: 100,
+};
+function makeItems(count, baseWeight = 1.0) {
+    return Array.from({ length: count }, (_, i) => ({
+        Text: `word${i}`,
+        Weight: baseWeight - (i * (baseWeight / count)),
+    }));
+}
+describe('computeWordCloudLayout', () => {
+    describe('empty and edge cases', () => {
+        it('should return empty layout for empty items array', () => {
+            const result = computeWordCloudLayout([], defaultConfig);
+            expect(result.Items).toHaveLength(0);
+            expect(result.ViewBox).toBe('0 0 100 100');
+        });
+        it('should return empty layout for null-ish items', () => {
+            const result = computeWordCloudLayout(null, defaultConfig);
+            expect(result.Items).toHaveLength(0);
+        });
+        it('should handle a single item', () => {
+            const items = [{ Text: 'hello', Weight: 1.0 }];
+            const result = computeWordCloudLayout(items, defaultConfig);
+            expect(result.Items).toHaveLength(1);
+            expect(result.Items[0].Text).toBe('hello');
+            expect(result.Items[0].FontSize).toBe(48); // max font for weight 1.0
+        });
+    });
+    describe('sorting and limiting', () => {
+        it('should sort items by weight descending (heaviest first)', () => {
+            const items = [
+                { Text: 'low', Weight: 0.2 },
+                { Text: 'high', Weight: 0.9 },
+                { Text: 'mid', Weight: 0.5 },
+            ];
+            const result = computeWordCloudLayout(items, defaultConfig);
+            expect(result.Items[0].Text).toBe('high');
+            expect(result.Items[1].Text).toBe('mid');
+            expect(result.Items[2].Text).toBe('low');
+        });
+        it('should limit items to MaxItems', () => {
+            const items = makeItems(50);
+            const config = { ...defaultConfig, MaxItems: 10 };
+            const result = computeWordCloudLayout(items, config);
+            expect(result.Items.length).toBeLessThanOrEqual(10);
+        });
+    });
+    describe('font size mapping', () => {
+        it('should map weight 1.0 to MaxFontSize', () => {
+            const items = [{ Text: 'max', Weight: 1.0 }];
+            const result = computeWordCloudLayout(items, defaultConfig);
+            expect(result.Items[0].FontSize).toBe(48);
+        });
+        it('should map weight 0.0 to MinFontSize', () => {
+            const items = [{ Text: 'min', Weight: 0.0 }];
+            const result = computeWordCloudLayout(items, defaultConfig);
+            expect(result.Items[0].FontSize).toBe(12);
+        });
+        it('should map weight 0.5 to midpoint font size', () => {
+            const items = [{ Text: 'mid', Weight: 0.5 }];
+            const result = computeWordCloudLayout(items, defaultConfig);
+            expect(result.Items[0].FontSize).toBe(30); // 12 + 0.5 * (48 - 12) = 30
+        });
+        it('should clamp weights above 1.0', () => {
+            const items = [{ Text: 'over', Weight: 1.5 }];
+            const result = computeWordCloudLayout(items, defaultConfig);
+            expect(result.Items[0].FontSize).toBe(48);
+        });
+        it('should clamp weights below 0.0', () => {
+            const items = [{ Text: 'under', Weight: -0.5 }];
+            const result = computeWordCloudLayout(items, defaultConfig);
+            expect(result.Items[0].FontSize).toBe(12);
+        });
+    });
+    describe('positioning', () => {
+        it('should place the first item near the center', () => {
+            const items = [{ Text: 'center', Weight: 1.0 }];
+            const result = computeWordCloudLayout(items, defaultConfig);
+            // First item should be at or very near (0, 0)
+            expect(Math.abs(result.Items[0].X)).toBeLessThan(10);
+            expect(Math.abs(result.Items[0].Y)).toBeLessThan(10);
+        });
+        it('should not have overlapping items', () => {
+            const items = makeItems(20);
+            const result = computeWordCloudLayout(items, defaultConfig);
+            // Verify no two items share the exact same position
+            for (let i = 0; i < result.Items.length; i++) {
+                for (let j = i + 1; j < result.Items.length; j++) {
+                    const samePos = result.Items[i].X === result.Items[j].X &&
+                        result.Items[i].Y === result.Items[j].Y;
+                    expect(samePos).toBe(false);
+                }
+            }
+        });
+        it('should place items progressively further from center', () => {
+            const items = makeItems(10, 1.0);
+            const result = computeWordCloudLayout(items, defaultConfig);
+            // The average distance from center should increase for later items
+            if (result.Items.length >= 2) {
+                const firstDist = Math.sqrt(result.Items[0].X ** 2 + result.Items[0].Y ** 2);
+                const lastDist = Math.sqrt(result.Items[result.Items.length - 1].X ** 2 +
+                    result.Items[result.Items.length - 1].Y ** 2);
+                expect(lastDist).toBeGreaterThanOrEqual(firstDist);
+            }
+        });
+    });
+    describe('rotation', () => {
+        it('should rotate approximately 20% of words (every 5th at index 3)', () => {
+            const items = makeItems(20);
+            const result = computeWordCloudLayout(items, defaultConfig);
+            const rotated = result.Items.filter(i => i.Rotation === 90);
+            const unrotated = result.Items.filter(i => i.Rotation === 0);
+            // Roughly 20% should be rotated (deterministic based on index % 5 === 3)
+            expect(rotated.length).toBeGreaterThan(0);
+            expect(unrotated.length).toBeGreaterThan(rotated.length);
+        });
+        it('should only use 0 or 90 degree rotation', () => {
+            const items = makeItems(30);
+            const result = computeWordCloudLayout(items, defaultConfig);
+            for (const item of result.Items) {
+                expect([0, 90]).toContain(item.Rotation);
+            }
+        });
+    });
+    describe('layout modes', () => {
+        it('should produce valid layout with spiral mode', () => {
+            const items = makeItems(15);
+            const result = computeWordCloudLayout(items, { ...defaultConfig, Layout: 'spiral' });
+            expect(result.Items.length).toBeGreaterThan(0);
+            expect(result.ViewBox).not.toBe('0 0 100 100'); // should have computed viewBox
+        });
+        it('should produce valid layout with rectangular mode', () => {
+            const items = makeItems(15);
+            const result = computeWordCloudLayout(items, { ...defaultConfig, Layout: 'rectangular' });
+            expect(result.Items.length).toBeGreaterThan(0);
+        });
+    });
+    describe('viewBox computation', () => {
+        it('should produce a viewBox that encompasses all items', () => {
+            const items = makeItems(10);
+            const result = computeWordCloudLayout(items, defaultConfig);
+            const [vx, vy, vw, vh] = result.ViewBox.split(' ').map(Number);
+            for (const item of result.Items) {
+                expect(item.X).toBeGreaterThanOrEqual(vx);
+                expect(item.X).toBeLessThanOrEqual(vx + vw);
+                expect(item.Y).toBeGreaterThanOrEqual(vy);
+                expect(item.Y).toBeLessThanOrEqual(vy + vh);
+            }
+        });
+    });
+    describe('index assignment', () => {
+        it('should assign sequential indices to layout items', () => {
+            const items = makeItems(5);
+            const result = computeWordCloudLayout(items, defaultConfig);
+            for (let i = 0; i < result.Items.length; i++) {
+                expect(result.Items[i].Index).toBe(i);
+            }
+        });
+    });
+    describe('metadata preservation', () => {
+        it('should preserve Category from input items', () => {
+            const items = [
+                { Text: 'test', Weight: 0.8, Category: 'tech' },
+            ];
+            const result = computeWordCloudLayout(items, defaultConfig);
+            expect(result.Items[0].Category).toBe('tech');
+        });
+        it('should preserve Metadata from input items', () => {
+            const meta = { id: '123', source: 'test' };
+            const items = [
+                { Text: 'test', Weight: 0.8, Metadata: meta },
+            ];
+            const result = computeWordCloudLayout(items, defaultConfig);
+            expect(result.Items[0].Metadata).toEqual(meta);
+        });
+    });
+    describe('large datasets', () => {
+        it('should handle 100 items without crashing', () => {
+            const items = makeItems(100);
+            const result = computeWordCloudLayout(items, defaultConfig);
+            expect(result.Items.length).toBeGreaterThan(0);
+            expect(result.Items.length).toBeLessThanOrEqual(100);
+        });
+        it('should complete layout within reasonable time', () => {
+            const items = makeItems(100);
+            const start = performance.now();
+            computeWordCloudLayout(items, defaultConfig);
+            const elapsed = performance.now() - start;
+            expect(elapsed).toBeLessThan(5000); // should complete in < 5 seconds
+        });
+    });
+});
+//# sourceMappingURL=word-cloud-layout.test.js.map

package/dist/__tests__/word-cloud-layout.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"word-cloud-layout.test.js","sourceRoot":"","sources":["../../src/__tests__/word-cloud-layout.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, it, expect } from 'vitest';\nimport { computeWordCloudLayout, WordCloudLayoutConfig } from '../lib/word-cloud.layout';\nimport { WordCloudItem } from '../lib/word-cloud.types';\n\nconst defaultConfig: WordCloudLayoutConfig = {\n    MinFontSize: 12,\n    MaxFontSize: 48,\n    Layout: 'spiral',\n    MaxItems: 100,\n};\n\nfunction makeItems(count: number, baseWeight = 1.0): WordCloudItem[] {\n    return Array.from({ length: count }, (_, i) => ({\n        Text: `word${i}`,\n        Weight: baseWeight - (i * (baseWeight / count)),\n    }));\n}\n\ndescribe('computeWordCloudLayout', () => {\n    describe('empty and edge cases', () => {\n        it('should return empty layout for empty items array', () => {\n            const result = computeWordCloudLayout([], defaultConfig);\n            expect(result.Items).toHaveLength(0);\n            expect(result.ViewBox).toBe('0 0 100 100');\n        });\n\n        it('should return empty layout for null-ish items', () => {\n            const result = computeWordCloudLayout(null as unknown as WordCloudItem[], defaultConfig);\n            expect(result.Items).toHaveLength(0);\n        });\n\n        it('should handle a single item', () => {\n            const items: WordCloudItem[] = [{ Text: 'hello', Weight: 1.0 }];\n            const result = computeWordCloudLayout(items, defaultConfig);\n            expect(result.Items).toHaveLength(1);\n            expect(result.Items[0].Text).toBe('hello');\n            expect(result.Items[0].FontSize).toBe(48); // max font for weight 1.0\n        });\n    });\n\n    describe('sorting and limiting', () => {\n        it('should sort items by weight descending (heaviest first)', () => {\n            const items: WordCloudItem[] = [\n                { Text: 'low', Weight: 0.2 },\n                { Text: 'high', Weight: 0.9 },\n                { Text: 'mid', Weight: 0.5 },\n            ];\n            const result = computeWordCloudLayout(items, defaultConfig);\n            expect(result.Items[0].Text).toBe('high');\n            expect(result.Items[1].Text).toBe('mid');\n            expect(result.Items[2].Text).toBe('low');\n        });\n\n        it('should limit items to MaxItems', () => {\n            const items = makeItems(50);\n            const config = { ...defaultConfig, MaxItems: 10 };\n            const result = computeWordCloudLayout(items, config);\n            expect(result.Items.length).toBeLessThanOrEqual(10);\n        });\n    });\n\n    describe('font size mapping', () => {\n        it('should map weight 1.0 to MaxFontSize', () => {\n            const items: WordCloudItem[] = [{ Text: 'max', Weight: 1.0 }];\n            const result = computeWordCloudLayout(items, defaultConfig);\n            expect(result.Items[0].FontSize).toBe(48);\n        });\n\n        it('should map weight 0.0 to MinFontSize', () => {\n            const items: WordCloudItem[] = [{ Text: 'min', Weight: 0.0 }];\n            const result = computeWordCloudLayout(items, defaultConfig);\n            expect(result.Items[0].FontSize).toBe(12);\n        });\n\n        it('should map weight 0.5 to midpoint font size', () => {\n            const items: WordCloudItem[] = [{ Text: 'mid', Weight: 0.5 }];\n            const result = computeWordCloudLayout(items, defaultConfig);\n            expect(result.Items[0].FontSize).toBe(30); // 12 + 0.5 * (48 - 12) = 30\n        });\n\n        it('should clamp weights above 1.0', () => {\n            const items: WordCloudItem[] = [{ Text: 'over', Weight: 1.5 }];\n            const result = computeWordCloudLayout(items, defaultConfig);\n            expect(result.Items[0].FontSize).toBe(48);\n        });\n\n        it('should clamp weights below 0.0', () => {\n            const items: WordCloudItem[] = [{ Text: 'under', Weight: -0.5 }];\n            const result = computeWordCloudLayout(items, defaultConfig);\n            expect(result.Items[0].FontSize).toBe(12);\n        });\n    });\n\n    describe('positioning', () => {\n        it('should place the first item near the center', () => {\n            const items: WordCloudItem[] = [{ Text: 'center', Weight: 1.0 }];\n            const result = computeWordCloudLayout(items, defaultConfig);\n            // First item should be at or very near (0, 0)\n            expect(Math.abs(result.Items[0].X)).toBeLessThan(10);\n            expect(Math.abs(result.Items[0].Y)).toBeLessThan(10);\n        });\n\n        it('should not have overlapping items', () => {\n            const items = makeItems(20);\n            const result = computeWordCloudLayout(items, defaultConfig);\n\n            // Verify no two items share the exact same position\n            for (let i = 0; i < result.Items.length; i++) {\n                for (let j = i + 1; j < result.Items.length; j++) {\n                    const samePos = result.Items[i].X === result.Items[j].X &&\n                                    result.Items[i].Y === result.Items[j].Y;\n                    expect(samePos).toBe(false);\n                }\n            }\n        });\n\n        it('should place items progressively further from center', () => {\n            const items = makeItems(10, 1.0);\n            const result = computeWordCloudLayout(items, defaultConfig);\n\n            // The average distance from center should increase for later items\n            if (result.Items.length >= 2) {\n                const firstDist = Math.sqrt(result.Items[0].X ** 2 + result.Items[0].Y ** 2);\n                const lastDist = Math.sqrt(\n                    result.Items[result.Items.length - 1].X ** 2 +\n                    result.Items[result.Items.length - 1].Y ** 2\n                );\n                expect(lastDist).toBeGreaterThanOrEqual(firstDist);\n            }\n        });\n    });\n\n    describe('rotation', () => {\n        it('should rotate approximately 20% of words (every 5th at index 3)', () => {\n            const items = makeItems(20);\n            const result = computeWordCloudLayout(items, defaultConfig);\n            const rotated = result.Items.filter(i => i.Rotation === 90);\n            const unrotated = result.Items.filter(i => i.Rotation === 0);\n            // Roughly 20% should be rotated (deterministic based on index % 5 === 3)\n            expect(rotated.length).toBeGreaterThan(0);\n            expect(unrotated.length).toBeGreaterThan(rotated.length);\n        });\n\n        it('should only use 0 or 90 degree rotation', () => {\n            const items = makeItems(30);\n            const result = computeWordCloudLayout(items, defaultConfig);\n            for (const item of result.Items) {\n                expect([0, 90]).toContain(item.Rotation);\n            }\n        });\n    });\n\n    describe('layout modes', () => {\n        it('should produce valid layout with spiral mode', () => {\n            const items = makeItems(15);\n            const result = computeWordCloudLayout(items, { ...defaultConfig, Layout: 'spiral' });\n            expect(result.Items.length).toBeGreaterThan(0);\n            expect(result.ViewBox).not.toBe('0 0 100 100'); // should have computed viewBox\n        });\n\n        it('should produce valid layout with rectangular mode', () => {\n            const items = makeItems(15);\n            const result = computeWordCloudLayout(items, { ...defaultConfig, Layout: 'rectangular' });\n            expect(result.Items.length).toBeGreaterThan(0);\n        });\n    });\n\n    describe('viewBox computation', () => {\n        it('should produce a viewBox that encompasses all items', () => {\n            const items = makeItems(10);\n            const result = computeWordCloudLayout(items, defaultConfig);\n            const [vx, vy, vw, vh] = result.ViewBox.split(' ').map(Number);\n\n            for (const item of result.Items) {\n                expect(item.X).toBeGreaterThanOrEqual(vx);\n                expect(item.X).toBeLessThanOrEqual(vx + vw);\n                expect(item.Y).toBeGreaterThanOrEqual(vy);\n                expect(item.Y).toBeLessThanOrEqual(vy + vh);\n            }\n        });\n    });\n\n    describe('index assignment', () => {\n        it('should assign sequential indices to layout items', () => {\n            const items = makeItems(5);\n            const result = computeWordCloudLayout(items, defaultConfig);\n            for (let i = 0; i < result.Items.length; i++) {\n                expect(result.Items[i].Index).toBe(i);\n            }\n        });\n    });\n\n    describe('metadata preservation', () => {\n        it('should preserve Category from input items', () => {\n            const items: WordCloudItem[] = [\n                { Text: 'test', Weight: 0.8, Category: 'tech' },\n            ];\n            const result = computeWordCloudLayout(items, defaultConfig);\n            expect(result.Items[0].Category).toBe('tech');\n        });\n\n        it('should preserve Metadata from input items', () => {\n            const meta = { id: '123', source: 'test' };\n            const items: WordCloudItem[] = [\n                { Text: 'test', Weight: 0.8, Metadata: meta },\n            ];\n            const result = computeWordCloudLayout(items, defaultConfig);\n            expect(result.Items[0].Metadata).toEqual(meta);\n        });\n    });\n\n    describe('large datasets', () => {\n        it('should handle 100 items without crashing', () => {\n            const items = makeItems(100);\n            const result = computeWordCloudLayout(items, defaultConfig);\n            expect(result.Items.length).toBeGreaterThan(0);\n            expect(result.Items.length).toBeLessThanOrEqual(100);\n        });\n\n        it('should complete layout within reasonable time', () => {\n            const items = makeItems(100);\n            const start = performance.now();\n            computeWordCloudLayout(items, defaultConfig);\n            const elapsed = performance.now() - start;\n            expect(elapsed).toBeLessThan(5000); // should complete in < 5 seconds\n        });\n    });\n});\n"]}

package/dist/lib/word-cloud.component.d.ts

@@ -0,0 +1,78 @@
+import { EventEmitter, OnChanges, SimpleChanges } from '@angular/core';
+import { WordCloudItem, WordCloudItemEvent, WordCloudLayoutItem } from './word-cloud.types';
+import * as i0 from "@angular/core";
+/**
+ * A reusable, SVG-based word cloud component.
+ *
+ * Renders weighted text items in a spiral or rectangular layout with
+ * collision detection. Supports multiple color modes using MJ design tokens,
+ * optional entry animation, and click/hover interaction.
+ *
+ * @example
+ * ```html
+ * <mj-word-cloud
+ *   [Items]="words"
+ *   [MaxFontSize]="56"
+ *   ColorMode="categorical"
+ *   (ItemClick)="onWordClick($event)">
+ * </mj-word-cloud>
+ * ```
+ */
+export declare class MJWordCloudComponent implements OnChanges {
+    /** Data items to display in the cloud. */
+    Items: WordCloudItem[];
+    /** Minimum font size in pixels for the lowest-weighted item. */
+    MinFontSize: number;
+    /** Maximum font size in pixels for the highest-weighted item. */
+    MaxFontSize: number;
+    /** Layout algorithm used for word placement. */
+    Layout: 'spiral' | 'rectangular';
+    /**
+     * How colors are assigned to words.
+     * - `brand`: all words use --mj-brand-primary with opacity based on weight.
+     * - `categorical`: distinct colors from a fixed palette, assigned by Category.
+     * - `weight-gradient`: interpolates from muted to brand-primary based on weight.
+     */
+    ColorMode: 'brand' | 'categorical' | 'weight-gradient';
+    /** Whether words are clickable / hoverable. */
+    Interactive: boolean;
+    /** Maximum number of items to display (heaviest are kept). */
+    MaxItems: number;
+    /** Whether to animate words in with a staggered fade. */
+    Animate: boolean;
+    /** Emitted when a word is clicked. */
+    ItemClick: EventEmitter<WordCloudItemEvent>;
+    /** Emitted when the pointer enters a word. */
+    ItemHover: EventEmitter<WordCloudItemEvent>;
+    /** Emitted when the pointer leaves a word. */
+    ItemLeave: EventEmitter<WordCloudItemEvent>;
+    /** Positioned items ready for rendering. */
+    LayoutItems: WordCloudLayoutItem[];
+    /** SVG viewBox attribute value. */
+    ViewBox: string;
+    ngOnChanges(_changes: SimpleChanges): void;
+    OnItemClick(item: WordCloudLayoutItem, event: MouseEvent): void;
+    OnItemHover(item: WordCloudLayoutItem, event: MouseEvent): void;
+    OnItemLeave(item: WordCloudLayoutItem, event: MouseEvent): void;
+    private recomputeLayout;
+    /**
+     * Applies color and opacity to each layout item based on the current ColorMode.
+     */
+    private applyColors;
+    /**
+     * Brand mode: all words use --mj-brand-primary; opacity varies with weight.
+     */
+    private applyBrandColors;
+    /**
+     * Categorical mode: words with the same Category share a color from the palette.
+     */
+    private applyCategoricalColors;
+    /**
+     * Weight-gradient mode: low-weight words use --mj-text-muted, high-weight
+     * words use --mj-brand-primary, interpolated via color-mix().
+     */
+    private applyWeightGradientColors;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MJWordCloudComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MJWordCloudComponent, "mj-word-cloud", never, { "Items": { "alias": "Items"; "required": false; }; "MinFontSize": { "alias": "MinFontSize"; "required": false; }; "MaxFontSize": { "alias": "MaxFontSize"; "required": false; }; "Layout": { "alias": "Layout"; "required": false; }; "ColorMode": { "alias": "ColorMode"; "required": false; }; "Interactive": { "alias": "Interactive"; "required": false; }; "MaxItems": { "alias": "MaxItems"; "required": false; }; "Animate": { "alias": "Animate"; "required": false; }; }, { "ItemClick": "ItemClick"; "ItemHover": "ItemHover"; "ItemLeave": "ItemLeave"; }, never, never, true, never>;
+}
+//# sourceMappingURL=word-cloud.component.d.ts.map

package/dist/lib/word-cloud.component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"word-cloud.component.d.ts","sourceRoot":"","sources":["../../src/lib/word-cloud.component.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,YAAY,EACZ,SAAS,EACT,aAAa,EAEd,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;;AAe5F;;;;;;;;;;;;;;;;GAgBG;AACH,qBAwEa,oBAAqB,YAAW,SAAS;IAGpD,0CAA0C;IACjC,KAAK,EAAE,aAAa,EAAE,CAAM;IAErC,gEAAgE;IACvD,WAAW,SAAM;IAE1B,iEAAiE;IACxD,WAAW,SAAM;IAE1B,gDAAgD;IACvC,MAAM,EAAE,QAAQ,GAAG,aAAa,CAAY;IAErD;;;;;OAKG;IACM,SAAS,EAAE,OAAO,GAAG,aAAa,GAAG,iBAAiB,CAAW;IAE1E,+CAA+C;IACtC,WAAW,UAAQ;IAE5B,8DAA8D;IACrD,QAAQ,SAAO;IAExB,yDAAyD;IAChD,OAAO,UAAQ;IAIxB,sCAAsC;IAC5B,SAAS,mCAA0C;IAE7D,8CAA8C;IACpC,SAAS,mCAA0C;IAE7D,8CAA8C;IACpC,SAAS,mCAA0C;IAI7D,4CAA4C;IAC5C,WAAW,EAAE,mBAAmB,EAAE,CAAM;IAExC,mCAAmC;IACnC,OAAO,SAAiB;IAIxB,WAAW,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAM1C,WAAW,CAAC,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI;IAM/D,WAAW,CAAC,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI;IAM/D,WAAW,CAAC,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI;IAQ/D,OAAO,CAAC,eAAe;IAavB;;OAEG;IACH,OAAO,CAAC,WAAW;IAanB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAmB9B;;;OAGG;IACH,OAAO,CAAC,yBAAyB;yCAjJtB,oBAAoB;2CAApB,oBAAoB;CA2JhC"}

package/dist/lib/word-cloud.component.js

@@ -0,0 +1,241 @@
+import { Component, Input, Output, EventEmitter, ChangeDetectionStrategy, } from '@angular/core';
+import { computeWordCloudLayout } from './word-cloud.layout';
+import * as i0 from "@angular/core";
+const _forTrack0 = ($index, $item) => $item.Text;
+function MJWordCloudComponent_For_2_Template(rf, ctx) { if (rf & 1) {
+    const _r1 = i0.ɵɵgetCurrentView();
+    i0.ɵɵnamespaceSVG();
+    i0.ɵɵdomElementStart(0, "text", 2);
+    i0.ɵɵdomListener("click", function MJWordCloudComponent_For_2_Template_text_click_0_listener($event) { const item_r2 = i0.ɵɵrestoreView(_r1).$implicit; const ctx_r2 = i0.ɵɵnextContext(); return i0.ɵɵresetView(ctx_r2.OnItemClick(item_r2, $event)); })("mouseenter", function MJWordCloudComponent_For_2_Template_text_mouseenter_0_listener($event) { const item_r2 = i0.ɵɵrestoreView(_r1).$implicit; const ctx_r2 = i0.ɵɵnextContext(); return i0.ɵɵresetView(ctx_r2.OnItemHover(item_r2, $event)); })("mouseleave", function MJWordCloudComponent_For_2_Template_text_mouseleave_0_listener($event) { const item_r2 = i0.ɵɵrestoreView(_r1).$implicit; const ctx_r2 = i0.ɵɵnextContext(); return i0.ɵɵresetView(ctx_r2.OnItemLeave(item_r2, $event)); });
+    i0.ɵɵtext(1);
+    i0.ɵɵdomElementEnd();
+} if (rf & 2) {
+    const item_r2 = ctx.$implicit;
+    const ctx_r2 = i0.ɵɵnextContext();
+    i0.ɵɵstyleProp("fill", item_r2.Color)("opacity", item_r2.Opacity)("animation-delay", ctx_r2.Animate ? item_r2.Index * 30 + "ms" : "0ms");
+    i0.ɵɵclassProp("mj-word-cloud-interactive", ctx_r2.Interactive);
+    i0.ɵɵattribute("x", item_r2.X)("y", item_r2.Y)("font-size", item_r2.FontSize + "px")("transform", "rotate(" + item_r2.Rotation + " " + item_r2.X + " " + item_r2.Y + ")");
+    i0.ɵɵadvance();
+    i0.ɵɵtextInterpolate1(" ", item_r2.Text, " ");
+} }
+/** Fixed palette for categorical color mode, using MJ design-token-friendly CSS values. */
+const CATEGORICAL_PALETTE = [
+    'var(--mj-brand-primary)',
+    'var(--mj-status-success)',
+    'var(--mj-status-warning)',
+    'var(--mj-status-error)',
+    'var(--mj-status-info)',
+    'var(--mj-brand-primary-hover)',
+    'var(--mj-status-success-text)',
+    'var(--mj-status-warning-text)',
+];
+/**
+ * A reusable, SVG-based word cloud component.
+ *
+ * Renders weighted text items in a spiral or rectangular layout with
+ * collision detection. Supports multiple color modes using MJ design tokens,
+ * optional entry animation, and click/hover interaction.
+ *
+ * @example
+ * ```html
+ * <mj-word-cloud
+ *   [Items]="words"
+ *   [MaxFontSize]="56"
+ *   ColorMode="categorical"
+ *   (ItemClick)="onWordClick($event)">
+ * </mj-word-cloud>
+ * ```
+ */
+export class MJWordCloudComponent {
+    // --------------- Inputs ---------------
+    /** Data items to display in the cloud. */
+    Items = [];
+    /** Minimum font size in pixels for the lowest-weighted item. */
+    MinFontSize = 12;
+    /** Maximum font size in pixels for the highest-weighted item. */
+    MaxFontSize = 48;
+    /** Layout algorithm used for word placement. */
+    Layout = 'spiral';
+    /**
+     * How colors are assigned to words.
+     * - `brand`: all words use --mj-brand-primary with opacity based on weight.
+     * - `categorical`: distinct colors from a fixed palette, assigned by Category.
+     * - `weight-gradient`: interpolates from muted to brand-primary based on weight.
+     */
+    ColorMode = 'brand';
+    /** Whether words are clickable / hoverable. */
+    Interactive = true;
+    /** Maximum number of items to display (heaviest are kept). */
+    MaxItems = 100;
+    /** Whether to animate words in with a staggered fade. */
+    Animate = true;
+    // --------------- Outputs ---------------
+    /** Emitted when a word is clicked. */
+    ItemClick = new EventEmitter();
+    /** Emitted when the pointer enters a word. */
+    ItemHover = new EventEmitter();
+    /** Emitted when the pointer leaves a word. */
+    ItemLeave = new EventEmitter();
+    // --------------- Public computed state ---------------
+    /** Positioned items ready for rendering. */
+    LayoutItems = [];
+    /** SVG viewBox attribute value. */
+    ViewBox = '0 0 100 100';
+    // --------------- Lifecycle ---------------
+    ngOnChanges(_changes) {
+        this.recomputeLayout();
+    }
+    // --------------- Event handlers ---------------
+    OnItemClick(item, event) {
+        if (this.Interactive) {
+            this.ItemClick.emit({ Item: item, Event: event });
+        }
+    }
+    OnItemHover(item, event) {
+        if (this.Interactive) {
+            this.ItemHover.emit({ Item: item, Event: event });
+        }
+    }
+    OnItemLeave(item, event) {
+        if (this.Interactive) {
+            this.ItemLeave.emit({ Item: item, Event: event });
+        }
+    }
+    // --------------- Private helpers ---------------
+    recomputeLayout() {
+        const config = {
+            MinFontSize: this.MinFontSize,
+            MaxFontSize: this.MaxFontSize,
+            Layout: this.Layout,
+            MaxItems: this.MaxItems,
+        };
+        const result = computeWordCloudLayout(this.Items, config);
+        this.ViewBox = result.ViewBox;
+        this.LayoutItems = this.applyColors(result.Items);
+    }
+    /**
+     * Applies color and opacity to each layout item based on the current ColorMode.
+     */
+    applyColors(items) {
+        switch (this.ColorMode) {
+            case 'brand':
+                return this.applyBrandColors(items);
+            case 'categorical':
+                return this.applyCategoricalColors(items);
+            case 'weight-gradient':
+                return this.applyWeightGradientColors(items);
+            default:
+                return items;
+        }
+    }
+    /**
+     * Brand mode: all words use --mj-brand-primary; opacity varies with weight.
+     */
+    applyBrandColors(items) {
+        return items.map(item => ({
+            ...item,
+            Color: 'var(--mj-brand-primary)',
+            Opacity: 0.4 + item.Weight * 0.6, // range 0.4 - 1.0
+        }));
+    }
+    /**
+     * Categorical mode: words with the same Category share a color from the palette.
+     */
+    applyCategoricalColors(items) {
+        const categoryIndex = new Map();
+        let nextIndex = 0;
+        return items.map(item => {
+            const key = item.Category ?? item.Text;
+            if (!categoryIndex.has(key)) {
+                categoryIndex.set(key, nextIndex);
+                nextIndex++;
+            }
+            const colorIdx = categoryIndex.get(key) % CATEGORICAL_PALETTE.length;
+            return {
+                ...item,
+                Color: CATEGORICAL_PALETTE[colorIdx],
+                Opacity: 1,
+            };
+        });
+    }
+    /**
+     * Weight-gradient mode: low-weight words use --mj-text-muted, high-weight
+     * words use --mj-brand-primary, interpolated via color-mix().
+     */
+    applyWeightGradientColors(items) {
+        return items.map(item => {
+            const pct = Math.round(item.Weight * 100);
+            return {
+                ...item,
+                Color: `color-mix(in srgb, var(--mj-brand-primary) ${pct}%, var(--mj-text-muted))`,
+                Opacity: 1,
+            };
+        });
+    }
+    static ɵfac = function MJWordCloudComponent_Factory(__ngFactoryType__) { return new (__ngFactoryType__ || MJWordCloudComponent)(); };
+    static ɵcmp = /*@__PURE__*/ i0.ɵɵdefineComponent({ type: MJWordCloudComponent, selectors: [["mj-word-cloud"]], inputs: { Items: "Items", MinFontSize: "MinFontSize", MaxFontSize: "MaxFontSize", Layout: "Layout", ColorMode: "ColorMode", Interactive: "Interactive", MaxItems: "MaxItems", Animate: "Animate" }, outputs: { ItemClick: "ItemClick", ItemHover: "ItemHover", ItemLeave: "ItemLeave" }, features: [i0.ɵɵNgOnChangesFeature], decls: 3, vars: 3, consts: [["preserveAspectRatio", "xMidYMid meet", 1, "mj-word-cloud"], ["text-anchor", "middle", "dominant-baseline", "central", 1, "mj-word-cloud-item", 3, "fill", "opacity", "animation-delay", "mj-word-cloud-interactive"], ["text-anchor", "middle", "dominant-baseline", "central", 1, "mj-word-cloud-item", 3, "click", "mouseenter", "mouseleave"]], template: function MJWordCloudComponent_Template(rf, ctx) { if (rf & 1) {
+            i0.ɵɵnamespaceSVG();
+            i0.ɵɵdomElementStart(0, "svg", 0);
+            i0.ɵɵrepeaterCreate(1, MJWordCloudComponent_For_2_Template, 2, 13, ":svg:text", 1, _forTrack0);
+            i0.ɵɵdomElementEnd();
+        } if (rf & 2) {
+            i0.ɵɵclassProp("mj-word-cloud-animated", ctx.Animate);
+            i0.ɵɵattribute("viewBox", ctx.ViewBox);
+            i0.ɵɵadvance();
+            i0.ɵɵrepeater(ctx.LayoutItems);
+        } }, styles: ["[_nghost-%COMP%] {\n      display: block;\n      width: 100%;\n      height: 100%;\n    }\n\n    .mj-word-cloud[_ngcontent-%COMP%] {\n      width: 100%;\n      height: 100%;\n    }\n\n    .mj-word-cloud-item[_ngcontent-%COMP%] {\n      font-family: var(--mj-font-family, inherit);\n      transition: opacity 0.2s ease, filter 0.2s ease;\n      user-select: none;\n    }\n\n    .mj-word-cloud-interactive[_ngcontent-%COMP%] {\n      cursor: pointer;\n    }\n\n    .mj-word-cloud-interactive[_ngcontent-%COMP%]:hover {\n      opacity: 0.8 !important;\n      filter: brightness(1.2);\n    }\n\n    .mj-word-cloud-animated[_ngcontent-%COMP%]   .mj-word-cloud-item[_ngcontent-%COMP%] {\n      animation: _ngcontent-%COMP%_mj-word-cloud-fade-in 0.4s ease-out both;\n    }\n\n    @keyframes _ngcontent-%COMP%_mj-word-cloud-fade-in {\n      from {\n        opacity: 0;\n      }\n      to {\n        opacity: 1;\n      }\n    }"], changeDetection: 0 });
+}
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassMetadata(MJWordCloudComponent, [{
+        type: Component,
+        args: [{ selector: 'mj-word-cloud', standalone: true, changeDetection: ChangeDetectionStrategy.OnPush, template: `
+    <svg
+      [attr.viewBox]="ViewBox"
+      class="mj-word-cloud"
+      [class.mj-word-cloud-animated]="Animate"
+      preserveAspectRatio="xMidYMid meet">
+      @for (item of LayoutItems; track item.Text) {
+        <text
+          [attr.x]="item.X"
+          [attr.y]="item.Y"
+          [attr.font-size]="item.FontSize + 'px'"
+          [attr.transform]="'rotate(' + item.Rotation + ' ' + item.X + ' ' + item.Y + ')'"
+          [style.fill]="item.Color"
+          [style.opacity]="item.Opacity"
+          [style.animation-delay]="Animate ? (item.Index * 30) + 'ms' : '0ms'"
+          class="mj-word-cloud-item"
+          [class.mj-word-cloud-interactive]="Interactive"
+          text-anchor="middle"
+          dominant-baseline="central"
+          (click)="OnItemClick(item, $event)"
+          (mouseenter)="OnItemHover(item, $event)"
+          (mouseleave)="OnItemLeave(item, $event)">
+          {{ item.Text }}
+        </text>
+      }
+    </svg>
+  `, styles: ["\n    :host {\n      display: block;\n      width: 100%;\n      height: 100%;\n    }\n\n    .mj-word-cloud {\n      width: 100%;\n      height: 100%;\n    }\n\n    .mj-word-cloud-item {\n      font-family: var(--mj-font-family, inherit);\n      transition: opacity 0.2s ease, filter 0.2s ease;\n      user-select: none;\n    }\n\n    .mj-word-cloud-interactive {\n      cursor: pointer;\n    }\n\n    .mj-word-cloud-interactive:hover {\n      opacity: 0.8 !important;\n      filter: brightness(1.2);\n    }\n\n    .mj-word-cloud-animated .mj-word-cloud-item {\n      animation: mj-word-cloud-fade-in 0.4s ease-out both;\n    }\n\n    @keyframes mj-word-cloud-fade-in {\n      from {\n        opacity: 0;\n      }\n      to {\n        opacity: 1;\n      }\n    }\n  "] }]
+    }], null, { Items: [{
+            type: Input
+        }], MinFontSize: [{
+            type: Input
+        }], MaxFontSize: [{
+            type: Input
+        }], Layout: [{
+            type: Input
+        }], ColorMode: [{
+            type: Input
+        }], Interactive: [{
+            type: Input
+        }], MaxItems: [{
+            type: Input
+        }], Animate: [{
+            type: Input
+        }], ItemClick: [{
+            type: Output
+        }], ItemHover: [{
+            type: Output
+        }], ItemLeave: [{
+            type: Output
+        }] }); })();
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassDebugInfo(MJWordCloudComponent, { className: "MJWordCloudComponent", filePath: "src/lib/word-cloud.component.ts", lineNumber: 114 }); })();
+//# sourceMappingURL=word-cloud.component.js.map

package/dist/lib/word-cloud.component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"word-cloud.component.js","sourceRoot":"","sources":["../../src/lib/word-cloud.component.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Component,\n  Input,\n  Output,\n  EventEmitter,\n  OnChanges,\n  SimpleChanges,\n  ChangeDetectionStrategy,\n} from '@angular/core';\nimport { WordCloudItem, WordCloudItemEvent, WordCloudLayoutItem } from './word-cloud.types';\nimport { computeWordCloudLayout, WordCloudLayoutConfig } from './word-cloud.layout';\n\n/** Fixed palette for categorical color mode, using MJ design-token-friendly CSS values. */\nconst CATEGORICAL_PALETTE: string[] = [\n  'var(--mj-brand-primary)',\n  'var(--mj-status-success)',\n  'var(--mj-status-warning)',\n  'var(--mj-status-error)',\n  'var(--mj-status-info)',\n  'var(--mj-brand-primary-hover)',\n  'var(--mj-status-success-text)',\n  'var(--mj-status-warning-text)',\n];\n\n/**\n * A reusable, SVG-based word cloud component.\n *\n * Renders weighted text items in a spiral or rectangular layout with\n * collision detection. Supports multiple color modes using MJ design tokens,\n * optional entry animation, and click/hover interaction.\n *\n * @example\n * ```html\n * <mj-word-cloud\n *   [Items]=\"words\"\n *   [MaxFontSize]=\"56\"\n *   ColorMode=\"categorical\"\n *   (ItemClick)=\"onWordClick($event)\">\n * </mj-word-cloud>\n * ```\n */\n@Component({\n  selector: 'mj-word-cloud',\n  standalone: true,\n  changeDetection: ChangeDetectionStrategy.OnPush,\n  template: `\n    <svg\n      [attr.viewBox]=\"ViewBox\"\n      class=\"mj-word-cloud\"\n      [class.mj-word-cloud-animated]=\"Animate\"\n      preserveAspectRatio=\"xMidYMid meet\">\n      @for (item of LayoutItems; track item.Text) {\n        <text\n          [attr.x]=\"item.X\"\n          [attr.y]=\"item.Y\"\n          [attr.font-size]=\"item.FontSize + 'px'\"\n          [attr.transform]=\"'rotate(' + item.Rotation + ' ' + item.X + ' ' + item.Y + ')'\"\n          [style.fill]=\"item.Color\"\n          [style.opacity]=\"item.Opacity\"\n          [style.animation-delay]=\"Animate ? (item.Index * 30) + 'ms' : '0ms'\"\n          class=\"mj-word-cloud-item\"\n          [class.mj-word-cloud-interactive]=\"Interactive\"\n          text-anchor=\"middle\"\n          dominant-baseline=\"central\"\n          (click)=\"OnItemClick(item, $event)\"\n          (mouseenter)=\"OnItemHover(item, $event)\"\n          (mouseleave)=\"OnItemLeave(item, $event)\">\n          {{ item.Text }}\n        </text>\n      }\n    </svg>\n  `,\n  styles: [`\n    :host {\n      display: block;\n      width: 100%;\n      height: 100%;\n    }\n\n    .mj-word-cloud {\n      width: 100%;\n      height: 100%;\n    }\n\n    .mj-word-cloud-item {\n      font-family: var(--mj-font-family, inherit);\n      transition: opacity 0.2s ease, filter 0.2s ease;\n      user-select: none;\n    }\n\n    .mj-word-cloud-interactive {\n      cursor: pointer;\n    }\n\n    .mj-word-cloud-interactive:hover {\n      opacity: 0.8 !important;\n      filter: brightness(1.2);\n    }\n\n    .mj-word-cloud-animated .mj-word-cloud-item {\n      animation: mj-word-cloud-fade-in 0.4s ease-out both;\n    }\n\n    @keyframes mj-word-cloud-fade-in {\n      from {\n        opacity: 0;\n      }\n      to {\n        opacity: 1;\n      }\n    }\n  `],\n})\nexport class MJWordCloudComponent implements OnChanges {\n  // --------------- Inputs ---------------\n\n  /** Data items to display in the cloud. */\n  @Input() Items: WordCloudItem[] = [];\n\n  /** Minimum font size in pixels for the lowest-weighted item. */\n  @Input() MinFontSize = 12;\n\n  /** Maximum font size in pixels for the highest-weighted item. */\n  @Input() MaxFontSize = 48;\n\n  /** Layout algorithm used for word placement. */\n  @Input() Layout: 'spiral' | 'rectangular' = 'spiral';\n\n  /**\n   * How colors are assigned to words.\n   * - `brand`: all words use --mj-brand-primary with opacity based on weight.\n   * - `categorical`: distinct colors from a fixed palette, assigned by Category.\n   * - `weight-gradient`: interpolates from muted to brand-primary based on weight.\n   */\n  @Input() ColorMode: 'brand' | 'categorical' | 'weight-gradient' = 'brand';\n\n  /** Whether words are clickable / hoverable. */\n  @Input() Interactive = true;\n\n  /** Maximum number of items to display (heaviest are kept). */\n  @Input() MaxItems = 100;\n\n  /** Whether to animate words in with a staggered fade. */\n  @Input() Animate = true;\n\n  // --------------- Outputs ---------------\n\n  /** Emitted when a word is clicked. */\n  @Output() ItemClick = new EventEmitter<WordCloudItemEvent>();\n\n  /** Emitted when the pointer enters a word. */\n  @Output() ItemHover = new EventEmitter<WordCloudItemEvent>();\n\n  /** Emitted when the pointer leaves a word. */\n  @Output() ItemLeave = new EventEmitter<WordCloudItemEvent>();\n\n  // --------------- Public computed state ---------------\n\n  /** Positioned items ready for rendering. */\n  LayoutItems: WordCloudLayoutItem[] = [];\n\n  /** SVG viewBox attribute value. */\n  ViewBox = '0 0 100 100';\n\n  // --------------- Lifecycle ---------------\n\n  ngOnChanges(_changes: SimpleChanges): void {\n    this.recomputeLayout();\n  }\n\n  // --------------- Event handlers ---------------\n\n  OnItemClick(item: WordCloudLayoutItem, event: MouseEvent): void {\n    if (this.Interactive) {\n      this.ItemClick.emit({ Item: item, Event: event });\n    }\n  }\n\n  OnItemHover(item: WordCloudLayoutItem, event: MouseEvent): void {\n    if (this.Interactive) {\n      this.ItemHover.emit({ Item: item, Event: event });\n    }\n  }\n\n  OnItemLeave(item: WordCloudLayoutItem, event: MouseEvent): void {\n    if (this.Interactive) {\n      this.ItemLeave.emit({ Item: item, Event: event });\n    }\n  }\n\n  // --------------- Private helpers ---------------\n\n  private recomputeLayout(): void {\n    const config: WordCloudLayoutConfig = {\n      MinFontSize: this.MinFontSize,\n      MaxFontSize: this.MaxFontSize,\n      Layout: this.Layout,\n      MaxItems: this.MaxItems,\n    };\n\n    const result = computeWordCloudLayout(this.Items, config);\n    this.ViewBox = result.ViewBox;\n    this.LayoutItems = this.applyColors(result.Items);\n  }\n\n  /**\n   * Applies color and opacity to each layout item based on the current ColorMode.\n   */\n  private applyColors(items: WordCloudLayoutItem[]): WordCloudLayoutItem[] {\n    switch (this.ColorMode) {\n      case 'brand':\n        return this.applyBrandColors(items);\n      case 'categorical':\n        return this.applyCategoricalColors(items);\n      case 'weight-gradient':\n        return this.applyWeightGradientColors(items);\n      default:\n        return items;\n    }\n  }\n\n  /**\n   * Brand mode: all words use --mj-brand-primary; opacity varies with weight.\n   */\n  private applyBrandColors(items: WordCloudLayoutItem[]): WordCloudLayoutItem[] {\n    return items.map(item => ({\n      ...item,\n      Color: 'var(--mj-brand-primary)',\n      Opacity: 0.4 + item.Weight * 0.6, // range 0.4 - 1.0\n    }));\n  }\n\n  /**\n   * Categorical mode: words with the same Category share a color from the palette.\n   */\n  private applyCategoricalColors(items: WordCloudLayoutItem[]): WordCloudLayoutItem[] {\n    const categoryIndex = new Map<string, number>();\n    let nextIndex = 0;\n\n    return items.map(item => {\n      const key = item.Category ?? item.Text;\n      if (!categoryIndex.has(key)) {\n        categoryIndex.set(key, nextIndex);\n        nextIndex++;\n      }\n      const colorIdx = categoryIndex.get(key)! % CATEGORICAL_PALETTE.length;\n      return {\n        ...item,\n        Color: CATEGORICAL_PALETTE[colorIdx],\n        Opacity: 1,\n      };\n    });\n  }\n\n  /**\n   * Weight-gradient mode: low-weight words use --mj-text-muted, high-weight\n   * words use --mj-brand-primary, interpolated via color-mix().\n   */\n  private applyWeightGradientColors(items: WordCloudLayoutItem[]): WordCloudLayoutItem[] {\n    return items.map(item => {\n      const pct = Math.round(item.Weight * 100);\n      return {\n        ...item,\n        Color: `color-mix(in srgb, var(--mj-brand-primary) ${pct}%, var(--mj-text-muted))`,\n        Opacity: 1,\n      };\n    });\n  }\n}\n"]}

package/dist/lib/word-cloud.layout.d.ts

@@ -0,0 +1,19 @@
+import { WordCloudItem, WordCloudLayoutItem } from './word-cloud.types';
+/**
+ * Configuration for the layout engine.
+ */
+export interface WordCloudLayoutConfig {
+    MinFontSize: number;
+    MaxFontSize: number;
+    Layout: 'spiral' | 'rectangular';
+    MaxItems: number;
+}
+/**
+ * Computes the layout for all word cloud items, returning positioned items
+ * and the overall bounding viewBox.
+ */
+export declare function computeWordCloudLayout(items: WordCloudItem[], config: WordCloudLayoutConfig): {
+    Items: WordCloudLayoutItem[];
+    ViewBox: string;
+};
+//# sourceMappingURL=word-cloud.layout.d.ts.map

package/dist/lib/word-cloud.layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"word-cloud.layout.d.ts","sourceRoot":"","sources":["../../src/lib/word-cloud.layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,QAAQ,GAAG,aAAa,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAkID;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,aAAa,EAAE,EACtB,MAAM,EAAE,qBAAqB,GAC5B;IAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA2DnD"}

package/dist/lib/word-cloud.layout.js

@@ -0,0 +1,182 @@
+/**
+ * Estimates the width of a text string at a given font size.
+ * Uses an average character width ratio since we cannot measure DOM elements
+ * in a pure layout function.
+ */
+function estimateTextWidth(text, fontSize) {
+    // Average character width is roughly 0.6x the font size for sans-serif fonts
+    const avgCharWidthRatio = 0.6;
+    return text.length * fontSize * avgCharWidthRatio;
+}
+/**
+ * Creates a bounding box for a word at a given position and font size,
+ * accounting for rotation.
+ */
+function createBoundingBox(x, y, text, fontSize, rotation) {
+    const textWidth = estimateTextWidth(text, fontSize);
+    const textHeight = fontSize * 1.2; // line-height factor
+    const padding = fontSize * 0.15; // small padding between words
+    // For 90-degree rotation, width and height swap
+    const effectiveWidth = rotation === 90 ? textHeight : textWidth;
+    const effectiveHeight = rotation === 90 ? textWidth : textHeight;
+    return {
+        Left: x - effectiveWidth / 2 - padding,
+        Top: y - effectiveHeight / 2 - padding,
+        Right: x + effectiveWidth / 2 + padding,
+        Bottom: y + effectiveHeight / 2 + padding,
+    };
+}
+/**
+ * Checks whether two bounding boxes overlap.
+ */
+function boxesOverlap(a, b) {
+    return a.Left < b.Right && a.Right > b.Left && a.Top < b.Bottom && a.Bottom > b.Top;
+}
+/**
+ * Checks whether a candidate bounding box collides with any of the placed boxes.
+ */
+function hasCollision(candidate, placed) {
+    for (const box of placed) {
+        if (boxesOverlap(candidate, box)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Generates (x, y) positions along an Archimedean spiral from the center.
+ */
+function* spiralPositions(centerX, centerY, maxAttempts) {
+    const spiralStep = 1; // angular step in radians
+    const radiusGrowth = 2; // pixels per radian
+    for (let i = 0; i < maxAttempts; i++) {
+        const angle = spiralStep * i * 0.1;
+        const radius = radiusGrowth * angle;
+        yield {
+            X: centerX + radius * Math.cos(angle),
+            Y: centerY + radius * Math.sin(angle),
+        };
+    }
+}
+/**
+ * Generates positions in a rectangular grid expanding from the center.
+ */
+function* rectangularPositions(centerX, centerY, maxAttempts) {
+    const step = 8;
+    yield { X: centerX, Y: centerY };
+    let attempt = 1;
+    for (let ring = 1; attempt < maxAttempts; ring++) {
+        const offset = ring * step;
+        // Top and bottom edges
+        for (let dx = -offset; dx <= offset && attempt < maxAttempts; dx += step) {
+            yield { X: centerX + dx, Y: centerY - offset };
+            attempt++;
+            yield { X: centerX + dx, Y: centerY + offset };
+            attempt++;
+        }
+        // Left and right edges (excluding corners)
+        for (let dy = -offset + step; dy < offset && attempt < maxAttempts; dy += step) {
+            yield { X: centerX - offset, Y: centerY + dy };
+            attempt++;
+            yield { X: centerX + offset, Y: centerY + dy };
+            attempt++;
+        }
+    }
+}
+/**
+ * Maps a weight (0-1) to a font size between min and max.
+ */
+function weightToFontSize(weight, minFont, maxFont) {
+    const clamped = Math.max(0, Math.min(1, weight));
+    return minFont + clamped * (maxFont - minFont);
+}
+/**
+ * Decides whether a word should be rotated (90 degrees) based on its index.
+ * Roughly 20% of words are rotated for visual variety.
+ */
+function shouldRotate(index) {
+    // Deterministic pseudo-random based on index
+    return index % 5 === 3;
+}
+/**
+ * Computes the layout for all word cloud items, returning positioned items
+ * and the overall bounding viewBox.
+ */
+export function computeWordCloudLayout(items, config) {
+    if (!items || items.length === 0) {
+        return { Items: [], ViewBox: '0 0 100 100' };
+    }
+    // Take top N items by weight
+    const sorted = [...items]
+        .sort((a, b) => b.Weight - a.Weight)
+        .slice(0, config.MaxItems);
+    const placedBoxes = [];
+    const layoutItems = [];
+    const maxAttempts = 500;
+    const centerX = 0;
+    const centerY = 0;
+    for (let i = 0; i < sorted.length; i++) {
+        const item = sorted[i];
+        const fontSize = weightToFontSize(item.Weight, config.MinFontSize, config.MaxFontSize);
+        const rotation = shouldRotate(i) ? 90 : 0;
+        const positionGenerator = config.Layout === 'rectangular'
+            ? rectangularPositions(centerX, centerY, maxAttempts)
+            : spiralPositions(centerX, centerY, maxAttempts);
+        let placed = false;
+        for (const pos of positionGenerator) {
+            const box = createBoundingBox(pos.X, pos.Y, item.Text, fontSize, rotation);
+            if (!hasCollision(box, placedBoxes)) {
+                placedBoxes.push(box);
+                layoutItems.push({
+                    ...item,
+                    FontSize: fontSize,
+                    X: pos.X,
+                    Y: pos.Y,
+                    Rotation: rotation,
+                    Color: '', // assigned by the component based on ColorMode
+                    Opacity: 1,
+                    Index: layoutItems.length,
+                });
+                placed = true;
+                break;
+            }
+        }
+        // If no position found after maxAttempts, skip the word
+        if (!placed) {
+            continue;
+        }
+    }
+    // Compute the overall bounding box for the viewBox
+    const viewBox = computeViewBox(placedBoxes);
+    return { Items: layoutItems, ViewBox: viewBox };
+}
+/**
+ * Computes an SVG viewBox string that fits all placed bounding boxes
+ * with a small amount of padding.
+ */
+function computeViewBox(boxes) {
+    if (boxes.length === 0) {
+        return '0 0 100 100';
+    }
+    let minX = Infinity;
+    let minY = Infinity;
+    let maxX = -Infinity;
+    let maxY = -Infinity;
+    for (const box of boxes) {
+        if (box.Left < minX)
+            minX = box.Left;
+        if (box.Top < minY)
+            minY = box.Top;
+        if (box.Right > maxX)
+            maxX = box.Right;
+        if (box.Bottom > maxY)
+            maxY = box.Bottom;
+    }
+    const padding = 20;
+    const x = minX - padding;
+    const y = minY - padding;
+    const width = maxX - minX + padding * 2;
+    const height = maxY - minY + padding * 2;
+    return `${x} ${y} ${width} ${height}`;
+}
+//# sourceMappingURL=word-cloud.layout.js.map

package/dist/lib/word-cloud.layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"word-cloud.layout.js","sourceRoot":"","sources":["../../src/lib/word-cloud.layout.ts"],"names":[],"mappings":"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","sourcesContent":["import { WordCloudItem, WordCloudLayoutItem } from './word-cloud.types';\n\n/**\n * Configuration for the layout engine.\n */\nexport interface WordCloudLayoutConfig {\n  MinFontSize: number;\n  MaxFontSize: number;\n  Layout: 'spiral' | 'rectangular';\n  MaxItems: number;\n}\n\n/**\n * Axis-aligned bounding box for collision detection.\n */\ninterface BoundingBox {\n  Left: number;\n  Top: number;\n  Right: number;\n  Bottom: number;\n}\n\n/**\n * Estimates the width of a text string at a given font size.\n * Uses an average character width ratio since we cannot measure DOM elements\n * in a pure layout function.\n */\nfunction estimateTextWidth(text: string, fontSize: number): number {\n  // Average character width is roughly 0.6x the font size for sans-serif fonts\n  const avgCharWidthRatio = 0.6;\n  return text.length * fontSize * avgCharWidthRatio;\n}\n\n/**\n * Creates a bounding box for a word at a given position and font size,\n * accounting for rotation.\n */\nfunction createBoundingBox(\n  x: number,\n  y: number,\n  text: string,\n  fontSize: number,\n  rotation: number\n): BoundingBox {\n  const textWidth = estimateTextWidth(text, fontSize);\n  const textHeight = fontSize * 1.2; // line-height factor\n  const padding = fontSize * 0.15; // small padding between words\n\n  // For 90-degree rotation, width and height swap\n  const effectiveWidth = rotation === 90 ? textHeight : textWidth;\n  const effectiveHeight = rotation === 90 ? textWidth : textHeight;\n\n  return {\n    Left: x - effectiveWidth / 2 - padding,\n    Top: y - effectiveHeight / 2 - padding,\n    Right: x + effectiveWidth / 2 + padding,\n    Bottom: y + effectiveHeight / 2 + padding,\n  };\n}\n\n/**\n * Checks whether two bounding boxes overlap.\n */\nfunction boxesOverlap(a: BoundingBox, b: BoundingBox): boolean {\n  return a.Left < b.Right && a.Right > b.Left && a.Top < b.Bottom && a.Bottom > b.Top;\n}\n\n/**\n * Checks whether a candidate bounding box collides with any of the placed boxes.\n */\nfunction hasCollision(candidate: BoundingBox, placed: BoundingBox[]): boolean {\n  for (const box of placed) {\n    if (boxesOverlap(candidate, box)) {\n      return true;\n    }\n  }\n  return false;\n}\n\n/**\n * Generates (x, y) positions along an Archimedean spiral from the center.\n */\nfunction* spiralPositions(centerX: number, centerY: number, maxAttempts: number): Generator<{ X: number; Y: number }> {\n  const spiralStep = 1; // angular step in radians\n  const radiusGrowth = 2; // pixels per radian\n\n  for (let i = 0; i < maxAttempts; i++) {\n    const angle = spiralStep * i * 0.1;\n    const radius = radiusGrowth * angle;\n    yield {\n      X: centerX + radius * Math.cos(angle),\n      Y: centerY + radius * Math.sin(angle),\n    };\n  }\n}\n\n/**\n * Generates positions in a rectangular grid expanding from the center.\n */\nfunction* rectangularPositions(centerX: number, centerY: number, maxAttempts: number): Generator<{ X: number; Y: number }> {\n  const step = 8;\n  yield { X: centerX, Y: centerY };\n  let attempt = 1;\n\n  for (let ring = 1; attempt < maxAttempts; ring++) {\n    const offset = ring * step;\n    // Top and bottom edges\n    for (let dx = -offset; dx <= offset && attempt < maxAttempts; dx += step) {\n      yield { X: centerX + dx, Y: centerY - offset };\n      attempt++;\n      yield { X: centerX + dx, Y: centerY + offset };\n      attempt++;\n    }\n    // Left and right edges (excluding corners)\n    for (let dy = -offset + step; dy < offset && attempt < maxAttempts; dy += step) {\n      yield { X: centerX - offset, Y: centerY + dy };\n      attempt++;\n      yield { X: centerX + offset, Y: centerY + dy };\n      attempt++;\n    }\n  }\n}\n\n/**\n * Maps a weight (0-1) to a font size between min and max.\n */\nfunction weightToFontSize(weight: number, minFont: number, maxFont: number): number {\n  const clamped = Math.max(0, Math.min(1, weight));\n  return minFont + clamped * (maxFont - minFont);\n}\n\n/**\n * Decides whether a word should be rotated (90 degrees) based on its index.\n * Roughly 20% of words are rotated for visual variety.\n */\nfunction shouldRotate(index: number): boolean {\n  // Deterministic pseudo-random based on index\n  return index % 5 === 3;\n}\n\n/**\n * Computes the layout for all word cloud items, returning positioned items\n * and the overall bounding viewBox.\n */\nexport function computeWordCloudLayout(\n  items: WordCloudItem[],\n  config: WordCloudLayoutConfig\n): { Items: WordCloudLayoutItem[]; ViewBox: string } {\n  if (!items || items.length === 0) {\n    return { Items: [], ViewBox: '0 0 100 100' };\n  }\n\n  // Take top N items by weight\n  const sorted = [...items]\n    .sort((a, b) => b.Weight - a.Weight)\n    .slice(0, config.MaxItems);\n\n  const placedBoxes: BoundingBox[] = [];\n  const layoutItems: WordCloudLayoutItem[] = [];\n  const maxAttempts = 500;\n\n  const centerX = 0;\n  const centerY = 0;\n\n  for (let i = 0; i < sorted.length; i++) {\n    const item = sorted[i];\n    const fontSize = weightToFontSize(item.Weight, config.MinFontSize, config.MaxFontSize);\n    const rotation = shouldRotate(i) ? 90 : 0;\n\n    const positionGenerator =\n      config.Layout === 'rectangular'\n        ? rectangularPositions(centerX, centerY, maxAttempts)\n        : spiralPositions(centerX, centerY, maxAttempts);\n\n    let placed = false;\n\n    for (const pos of positionGenerator) {\n      const box = createBoundingBox(pos.X, pos.Y, item.Text, fontSize, rotation);\n\n      if (!hasCollision(box, placedBoxes)) {\n        placedBoxes.push(box);\n        layoutItems.push({\n          ...item,\n          FontSize: fontSize,\n          X: pos.X,\n          Y: pos.Y,\n          Rotation: rotation,\n          Color: '', // assigned by the component based on ColorMode\n          Opacity: 1,\n          Index: layoutItems.length,\n        });\n        placed = true;\n        break;\n      }\n    }\n\n    // If no position found after maxAttempts, skip the word\n    if (!placed) {\n      continue;\n    }\n  }\n\n  // Compute the overall bounding box for the viewBox\n  const viewBox = computeViewBox(placedBoxes);\n\n  return { Items: layoutItems, ViewBox: viewBox };\n}\n\n/**\n * Computes an SVG viewBox string that fits all placed bounding boxes\n * with a small amount of padding.\n */\nfunction computeViewBox(boxes: BoundingBox[]): string {\n  if (boxes.length === 0) {\n    return '0 0 100 100';\n  }\n\n  let minX = Infinity;\n  let minY = Infinity;\n  let maxX = -Infinity;\n  let maxY = -Infinity;\n\n  for (const box of boxes) {\n    if (box.Left < minX) minX = box.Left;\n    if (box.Top < minY) minY = box.Top;\n    if (box.Right > maxX) maxX = box.Right;\n    if (box.Bottom > maxY) maxY = box.Bottom;\n  }\n\n  const padding = 20;\n  const x = minX - padding;\n  const y = minY - padding;\n  const width = maxX - minX + padding * 2;\n  const height = maxY - minY + padding * 2;\n\n  return `${x} ${y} ${width} ${height}`;\n}\n"]}

package/dist/lib/word-cloud.types.d.ts

@@ -0,0 +1,42 @@
+/**
+ * A single item to display in the word cloud.
+ */
+export interface WordCloudItem {
+    /** Display text */
+    Text: string;
+    /** Weight / importance (0.0 - 1.0) - determines font size */
+    Weight: number;
+    /** Optional category for color grouping in 'categorical' color mode */
+    Category?: string;
+    /** Optional arbitrary metadata passed through click/hover events */
+    Metadata?: Record<string, unknown>;
+}
+/**
+ * Event payload emitted when the user interacts with a word cloud item.
+ */
+export interface WordCloudItemEvent {
+    /** The item that was interacted with */
+    Item: WordCloudItem;
+    /** The original DOM event */
+    Event: MouseEvent;
+}
+/**
+ * Internal representation of a word cloud item after layout computation.
+ */
+export interface WordCloudLayoutItem extends WordCloudItem {
+    /** Computed font size in pixels */
+    FontSize: number;
+    /** Computed X position (center of the text) */
+    X: number;
+    /** Computed Y position (center of the text) */
+    Y: number;
+    /** Rotation in degrees (0 or 90) */
+    Rotation: number;
+    /** Computed CSS color string */
+    Color: string;
+    /** Computed opacity (used in weight-gradient mode) */
+    Opacity: number;
+    /** Index for animation staggering */
+    Index: number;
+}
+//# sourceMappingURL=word-cloud.types.d.ts.map

package/dist/lib/word-cloud.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"word-cloud.types.d.ts","sourceRoot":"","sources":["../../src/lib/word-cloud.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,IAAI,EAAE,aAAa,CAAC;IACpB,6BAA6B;IAC7B,KAAK,EAAE,UAAU,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACxD,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,CAAC,EAAE,MAAM,CAAC;IACV,+CAA+C;IAC/C,CAAC,EAAE,MAAM,CAAC;IACV,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/lib/word-cloud.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=word-cloud.types.js.map

package/dist/lib/word-cloud.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"word-cloud.types.js","sourceRoot":"","sources":["../../src/lib/word-cloud.types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * A single item to display in the word cloud.\n */\nexport interface WordCloudItem {\n  /** Display text */\n  Text: string;\n  /** Weight / importance (0.0 - 1.0) - determines font size */\n  Weight: number;\n  /** Optional category for color grouping in 'categorical' color mode */\n  Category?: string;\n  /** Optional arbitrary metadata passed through click/hover events */\n  Metadata?: Record<string, unknown>;\n}\n\n/**\n * Event payload emitted when the user interacts with a word cloud item.\n */\nexport interface WordCloudItemEvent {\n  /** The item that was interacted with */\n  Item: WordCloudItem;\n  /** The original DOM event */\n  Event: MouseEvent;\n}\n\n/**\n * Internal representation of a word cloud item after layout computation.\n */\nexport interface WordCloudLayoutItem extends WordCloudItem {\n  /** Computed font size in pixels */\n  FontSize: number;\n  /** Computed X position (center of the text) */\n  X: number;\n  /** Computed Y position (center of the text) */\n  Y: number;\n  /** Rotation in degrees (0 or 90) */\n  Rotation: number;\n  /** Computed CSS color string */\n  Color: string;\n  /** Computed opacity (used in weight-gradient mode) */\n  Opacity: number;\n  /** Index for animation staggering */\n  Index: number;\n}\n"]}

package/dist/public-api.d.ts

@@ -0,0 +1,9 @@
+export * from './lib/word-cloud.types';
+export * from './lib/word-cloud.layout';
+export * from './lib/word-cloud.component';
+/**
+ * Tree-shaking prevention function. Call this from consuming modules
+ * to ensure the component registration is not removed by bundlers.
+ */
+export declare function LoadWordCloud(): void;
+//# sourceMappingURL=public-api.d.ts.map

package/dist/public-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-api.d.ts","sourceRoot":"","sources":["../src/public-api.ts"],"names":[],"mappings":"AAIA,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAE3C;;;GAGG;AACH,wBAAgB,aAAa,SAE5B"}

package/dist/public-api.js

@@ -0,0 +1,14 @@
+/*
+ * Public API Surface for @memberjunction/ng-word-cloud
+ */
+export * from './lib/word-cloud.types';
+export * from './lib/word-cloud.layout';
+export * from './lib/word-cloud.component';
+/**
+ * Tree-shaking prevention function. Call this from consuming modules
+ * to ensure the component registration is not removed by bundlers.
+ */
+export function LoadWordCloud() {
+    /* prevent tree-shaking */
+}
+//# sourceMappingURL=public-api.js.map

package/dist/public-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-api.js","sourceRoot":"","sources":["../src/public-api.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAE3C;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,0BAA0B;AAC5B,CAAC","sourcesContent":["/*\n * Public API Surface for @memberjunction/ng-word-cloud\n */\n\nexport * from './lib/word-cloud.types';\nexport * from './lib/word-cloud.layout';\nexport * from './lib/word-cloud.component';\n\n/**\n * Tree-shaking prevention function. Call this from consuming modules\n * to ensure the component registration is not removed by bundlers.\n */\nexport function LoadWordCloud() {\n  /* prevent tree-shaking */\n}\n"]}

package/package.json

@@ -1,10 +1,40 @@
 {
   "name": "@memberjunction/ng-word-cloud",
-  "version": "0.0.1",
-  "description": "OIDC trusted publishing setup package for @memberjunction/ng-word-cloud",
+  "version": "5.24.0",
+  "description": "MemberJunction: Reusable SVG-based word cloud component for Angular.",
+  "main": "./dist/public-api.js",
+  "typings": "./dist/public-api.d.ts",
+  "files": [
+    "/dist"
+  ],
+  "scripts": {
+    "build": "npm run clean && ngc",
+    "clean": "rimraf dist",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
   "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
+    "MemberJunction",
+    "Angular",
+    "word-cloud"
+  ],
+  "author": "",
+  "license": "ISC",
+  "devDependencies": {
+    "@angular/compiler": "21.1.3",
+    "@angular/compiler-cli": "21.1.3",
+    "vitest": "^4.0.18"
+  },
+  "peerDependencies": {
+    "@angular/common": "21.1.3",
+    "@angular/core": "21.1.3"
+  },
+  "dependencies": {
+    "tslib": "^2.8.1"
+  },
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MemberJunction/MJ"
+  }
 }