@molecule/app-forum-thread-row-angular 0.0.0-stage → 0.0.1-stage

package/dist/slot-dom.d.ts

@@ -0,0 +1,63 @@
+/**
+ * DOM helpers for the projected-slot wrappers of {@link ForumThreadRow}.
+ *
+ * React renders node props inside conditional wrappers (an
+ * `{expr && <div>…}` branch). Angular projection needs always-mounted
+ * `<ng-content>` capture points, so the wrappers live in the template
+ * unconditionally and these helpers reconcile them against React's DOM: an
+ * empty slot's wrapper is detached from its parent (an anchor comment keeps
+ * its position stable for a later re-attach).
+ *
+ * @module
+ */
+import type { ElementRef, Renderer2 } from '@angular/core';
+/**
+ * Whether a wrapper holds projected slot content. The wrapper's own text
+ * branch contributes exactly one leading text node — the interpolation, which
+ * Angular creates even when the string input is empty — and Angular strips
+ * whitespace-only template text between it and the `<ng-content>` capture
+ * point. So any ELEMENT child, any text node after that first one, or any
+ * non-empty text node at all, is projected slot content. (The adapter
+ * projects slots with `ngProjectAs`, which writes no real `slot` attribute
+ * into the DOM, so an attribute query cannot see the projection.)
+ *
+ * @param el - The wrapper element.
+ * @returns True when at least one projected node exists.
+ */
+export declare const hasProjectedSlot: (el: Element | undefined | null) => boolean;
+/**
+ * Reconciles one projected-slot wrapper against what React renders: attach
+ * or detach the wrapper, whose CONTENTS move with it. Idempotent, and anchored
+ * in the wrapper's current parent — for a detached wrapper, the parent of its
+ * anchor comment, so a NESTED wrapper (the meta spans live in the meta `<div>`)
+ * returns to its own position, never to the host.
+ */
+export declare class SlotGuard {
+    private readonly host;
+    private readonly renderer;
+    private readonly anchors;
+    /**
+     * Creates the guard.
+     *
+     * @param host - The component host element (last-resort anchor parent).
+     * @param renderer - The DOM renderer.
+     */
+    constructor(host: ElementRef<HTMLElement>, renderer: Renderer2);
+    /**
+     * Attaches or detaches the element (contents move with it).
+     *
+     * @param el - The wrapper element.
+     * @param shouldAttach - Whether it should be in the DOM.
+     */
+    toggle(el: Element | undefined | null, shouldAttach: boolean): void;
+    /**
+     * Returns the wrapper's anchor comment in `parent`, creating (or replacing
+     * a stale one) where the wrapper sits.
+     *
+     * @param parent - The anchor's parent.
+     * @param el - The wrapper the anchor stands for.
+     * @returns The connected anchor comment.
+     */
+    private anchorIn;
+}
+//# sourceMappingURL=slot-dom.d.ts.map

package/dist/slot-dom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slot-dom.d.ts","sourceRoot":"","sources":["../src/slot-dom.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE1D;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB,GAAI,IAAI,OAAO,GAAG,SAAS,GAAG,IAAI,KAAG,OASjE,CAAA;AAED;;;;;;GAMG;AACH,qBAAa,SAAS;IAUlB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAV3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;IAEtD;;;;;OAKG;gBAEgB,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC,EAC7B,QAAQ,EAAE,SAAS;IAGtC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI,EAAE,YAAY,EAAE,OAAO,GAAG,IAAI;IAoBnE;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ;CASjB"}

package/dist/slot-dom.js

@@ -0,0 +1,109 @@
+/**
+ * DOM helpers for the projected-slot wrappers of {@link ForumThreadRow}.
+ *
+ * React renders node props inside conditional wrappers (an
+ * `{expr && <div>…}` branch). Angular projection needs always-mounted
+ * `<ng-content>` capture points, so the wrappers live in the template
+ * unconditionally and these helpers reconcile them against React's DOM: an
+ * empty slot's wrapper is detached from its parent (an anchor comment keeps
+ * its position stable for a later re-attach).
+ *
+ * @module
+ */
+/**
+ * Whether a wrapper holds projected slot content. The wrapper's own text
+ * branch contributes exactly one leading text node — the interpolation, which
+ * Angular creates even when the string input is empty — and Angular strips
+ * whitespace-only template text between it and the `<ng-content>` capture
+ * point. So any ELEMENT child, any text node after that first one, or any
+ * non-empty text node at all, is projected slot content. (The adapter
+ * projects slots with `ngProjectAs`, which writes no real `slot` attribute
+ * into the DOM, so an attribute query cannot see the projection.)
+ *
+ * @param el - The wrapper element.
+ * @returns True when at least one projected node exists.
+ */
+export const hasProjectedSlot = (el) => {
+    if (!el)
+        return false;
+    const nodes = Array.from(el.childNodes);
+    for (const [index, node] of nodes.entries()) {
+        if (index === 0 && node.nodeType === 3)
+            continue;
+        if (node.nodeType === 1)
+            return true;
+        if (node.nodeType === 3 && (node.textContent ?? '').trim())
+            return true;
+    }
+    return false;
+};
+/**
+ * Reconciles one projected-slot wrapper against what React renders: attach
+ * or detach the wrapper, whose CONTENTS move with it. Idempotent, and anchored
+ * in the wrapper's current parent — for a detached wrapper, the parent of its
+ * anchor comment, so a NESTED wrapper (the meta spans live in the meta `<div>`)
+ * returns to its own position, never to the host.
+ */
+export class SlotGuard {
+    host;
+    renderer;
+    anchors = new Map();
+    /**
+     * Creates the guard.
+     *
+     * @param host - The component host element (last-resort anchor parent).
+     * @param renderer - The DOM renderer.
+     */
+    constructor(host, renderer) {
+        this.host = host;
+        this.renderer = renderer;
+    }
+    /**
+     * Attaches or detaches the element (contents move with it).
+     *
+     * @param el - The wrapper element.
+     * @param shouldAttach - Whether it should be in the DOM.
+     */
+    toggle(el, shouldAttach) {
+        if (!el)
+            return;
+        const anchor = this.anchors.get(el);
+        const parent = el.parentElement ?? anchor?.parentNode ?? this.host.nativeElement;
+        if (shouldAttach && !el.isConnected) {
+            if (anchor?.isConnected && anchor.parentNode === parent) {
+                parent.insertBefore(el, anchor);
+                this.renderer.removeChild(parent, anchor);
+                this.anchors.delete(el);
+            }
+            else {
+                parent.appendChild(el);
+            }
+        }
+        else if (!shouldAttach && el.isConnected) {
+            // A placeholder comment keeps the re-insertion position stable; the
+            // conformance normalizer strips comment nodes, so it never shows.
+            this.anchorIn(parent, el);
+            this.renderer.removeChild(parent, el);
+        }
+    }
+    /**
+     * Returns the wrapper's anchor comment in `parent`, creating (or replacing
+     * a stale one) where the wrapper sits.
+     *
+     * @param parent - The anchor's parent.
+     * @param el - The wrapper the anchor stands for.
+     * @returns The connected anchor comment.
+     */
+    anchorIn(parent, el) {
+        const existing = this.anchors.get(el);
+        if (existing?.isConnected && existing.parentNode === parent)
+            return existing;
+        if (existing)
+            this.anchors.delete(el);
+        const created = this.renderer.createComment('slot');
+        parent.insertBefore(created, el.isConnected ? el : null);
+        this.anchors.set(el, created);
+        return created;
+    }
+}
+//# sourceMappingURL=slot-dom.js.map

package/dist/slot-dom.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Types of `@molecule/app-forum-thread-row-angular` — the Angular counterpart
+ * of `@molecule/app-forum-thread-row-react`, same props and DOM.
+ *
+ * @module
+ */
+/**
+ * Props for {@link ForumThreadRow} — the same props
+ * `@molecule/app-forum-thread-row-react` accepts. Node-valued props (`title`,
+ * `excerpt`, `author`, `createdAt`, `tags`, `voteControls`) are projected
+ * content in Angular (an input cannot carry a node): pass a string value
+ * through the input, and element content in the host template as
+ * `[slot=<name>]` content.
+ */
+export interface ForumThreadRowProps {
+    /** Thread title; element content is projected as `[slot=title]` content. */
+    title?: unknown;
+    /** Optional snippet of the OP body; projected as `[slot=excerpt]` content. */
+    excerpt?: unknown;
+    /** Aggregate vote score / upvotes. */
+    voteScore?: number;
+    /** Reply count. */
+    replyCount?: number;
+    /** View count. */
+    viewCount?: number;
+    /** Optional pinned indicator. */
+    pinned?: boolean;
+    /** Optional locked indicator. */
+    locked?: boolean;
+    /** Author display; projected as `[slot=author]` content. */
+    author?: unknown;
+    /** Created-at display; projected as `[slot=createdAt]` content. */
+    createdAt?: unknown;
+    /** Tag chips; projected as `[slot=tags]` content. */
+    tags?: unknown;
+    /** Right-side voting controls; projected as `[slot=voteControls]` content. */
+    voteControls?: unknown;
+    /** Click handler; receives the DOM click event. */
+    onClick?: (event: Event) => void;
+    /** Extra classes. */
+    className?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAClC,4EAA4E;IAC5E,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,8EAA8E;IAC9E,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mBAAmB;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kBAAkB;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,iCAAiC;IACjC,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,iCAAiC;IACjC,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,mEAAmE;IACnE,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,qDAAqD;IACrD,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,8EAA8E;IAC9E,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,mDAAmD;IACnD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IAChC,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB"}

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * Types of `@molecule/app-forum-thread-row-angular` — the Angular counterpart
+ * of `@molecule/app-forum-thread-row-react`, same props and DOM.
+ *
+ * @module
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/package.json

@@ -1,6 +1,71 @@
 {
   "name": "@molecule/app-forum-thread-row-angular",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.1-stage",
+  "description": "Discussion / forum thread row with vote score, reply count, pin/lock badges, tags",
+  "homepage": "https://www.molecule.dev/packages/app-forum-thread-row-angular",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "ngc",
+    "dev": "ngc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "molecule",
+    "forum-thread-row",
+    "angular"
+  ],
+  "author": "Molecule Dev, Inc. (https://molecule.dev)",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/molecule-dev/molecule.git",
+    "directory": "packages/app/features/forum-thread-row-angular"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "bugs": "https://github.com/molecule-dev/molecule/issues",
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@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"
+  },
+  "devDependencies": {
+    "@angular/common": "22.2.3",
+    "@angular/compiler": "22.2.3",
+    "@angular/compiler-cli": "22.2.3",
+    "@angular/core": "22.2.3",
+    "@angular/platform-browser": "22.2.3",
+    "@molecule/app-angular": "3.6.0",
+    "@molecule/app-framework-conformance": "0.0.0",
+    "@molecule/app-i18n": "1.2.1",
+    "@molecule/app-icons": "1.0.4",
+    "@molecule/app-ui": "1.3.11",
+    "@molecule/app-ui-angular": "1.1.2",
+    "@types/node": "26.6.5",
+    "jsdom": "30.1.3",
+    "rxjs": "7.8.2",
+    "typescript": "6.0.3",
+    "vitest": "4.1.12",
+    "zone.js": "0.16.3"
+  }
+}