@agora-sdk/social-react-js 0.6.0

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2025 Replyke
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/dist/esm/components/CommunityWeather.d.ts

@@ -0,0 +1,24 @@
+import React from "react";
+/** Props for {@link CommunityWeather}. */
+export interface CommunityWeatherProps {
+    /** Optional class for the root element (for host-app layout/spacing). */
+    className?: string;
+}
+/**
+ * Render the Community Weather as an ambient climate chip.
+ *
+ * Self-contained: reads {@link useSocialWeather} internally and gates on the feature config. Shows a
+ * band-tinted glowing orb plus a soft trend arrow when history is available. The warmth `value` is
+ * never displayed.
+ *
+ * @param props - {@link CommunityWeatherProps}.
+ * @returns The weather chip, or `null` when the lens is disabled or still loading.
+ *
+ * @example
+ * ```tsx
+ * <SocialProvider projectId={id} accessToken={token}>
+ *   <CommunityWeather />
+ * </SocialProvider>
+ * ```
+ */
+export declare function CommunityWeather({ className }: CommunityWeatherProps): React.ReactElement | null;

package/dist/esm/components/CommunityWeather.js

@@ -0,0 +1,59 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useSocialWeather } from "@agora-sdk/social-core";
+import { bandColors } from "../palette.js";
+/** Human-readable, non-alarming captions per band. `stormy` stays gentle by design (SOCIAL.md §5). */
+const BAND_CAPTION = {
+    quiet: "Still forming",
+    stormy: "Could use more warmth",
+    overcast: "Settling in",
+    fine: "Warm",
+    sunny: "Glowing",
+};
+/**
+ * Render the Community Weather as an ambient climate chip.
+ *
+ * Self-contained: reads {@link useSocialWeather} internally and gates on the feature config. Shows a
+ * band-tinted glowing orb plus a soft trend arrow when history is available. The warmth `value` is
+ * never displayed.
+ *
+ * @param props - {@link CommunityWeatherProps}.
+ * @returns The weather chip, or `null` when the lens is disabled or still loading.
+ *
+ * @example
+ * ```tsx
+ * <SocialProvider projectId={id} accessToken={token}>
+ *   <CommunityWeather />
+ * </SocialProvider>
+ * ```
+ */
+export function CommunityWeather({ className }) {
+    const { weather } = useSocialWeather();
+    if (!weather)
+        return null;
+    const colors = bandColors(weather.band);
+    const caption = BAND_CAPTION[weather.band] ?? "Still forming";
+    const forming = weather.band === "quiet" || weather.value === null;
+    // Trend → a subtle directional cue, never alarming text. Tiny magnitudes are treated as steady.
+    const trendArrow = weather.trend === null || Math.abs(weather.trend) < 0.005
+        ? null
+        : weather.trend > 0
+            ? "↗"
+            : "↘";
+    return (_jsxs("div", { className: className, role: "img", "aria-label": `Community weather: ${caption.toLowerCase()}`, style: {
+            display: "inline-flex",
+            alignItems: "center",
+            gap: 10,
+            padding: "8px 14px",
+            borderRadius: 999,
+            background: "rgba(15, 15, 24, 0.04)",
+        }, children: [_jsx("span", { "aria-hidden": true, style: {
+                    width: 22,
+                    height: 22,
+                    borderRadius: "50%",
+                    background: `radial-gradient(circle at 35% 30%, ${colors.core}, ${colors.glow})`,
+                    boxShadow: `0 0 ${forming ? 10 : 18}px ${colors.glow}`,
+                    filter: forming ? "blur(0.5px)" : undefined,
+                    opacity: forming ? 0.8 : 1,
+                } }), _jsx("span", { style: { fontSize: 13, color: colors.core, fontWeight: 600 }, children: caption }), trendArrow && (_jsx("span", { "aria-hidden": true, title: weather.trend > 0 ? "warming" : "cooling", style: { fontSize: 13, color: colors.core, opacity: 0.7 }, children: trendArrow }))] }));
+}
+//# sourceMappingURL=CommunityWeather.js.map

package/dist/esm/components/CommunityWeather.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommunityWeather.js","sourceRoot":"","sources":["../../../src/components/CommunityWeather.tsx"],"names":[],"mappings":";AASA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAQ3C,sGAAsG;AACtG,MAAM,YAAY,GAA2B;IAC3C,KAAK,EAAE,eAAe;IACtB,MAAM,EAAE,uBAAuB;IAC/B,QAAQ,EAAE,aAAa;IACvB,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,SAAS;CACjB,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAAE,SAAS,EAAyB;IACnE,MAAM,EAAE,OAAO,EAAE,GAAG,gBAAgB,EAAE,CAAC;IACvC,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,eAAe,CAAC;IAC9D,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,KAAK,OAAO,IAAI,OAAO,CAAC,KAAK,KAAK,IAAI,CAAC;IAEnE,gGAAgG;IAChG,MAAM,UAAU,GACd,OAAO,CAAC,KAAK,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK;QACvD,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,OAAO,CAAC,KAAK,GAAG,CAAC;YACjB,CAAC,CAAC,GAAG;YACL,CAAC,CAAC,GAAG,CAAC;IAEZ,OAAO,CACL,eACE,SAAS,EAAE,SAAS,EACpB,IAAI,EAAC,KAAK,gBACE,sBAAsB,OAAO,CAAC,WAAW,EAAE,EAAE,EACzD,KAAK,EAAE;YACL,OAAO,EAAE,aAAa;YACtB,UAAU,EAAE,QAAQ;YACpB,GAAG,EAAE,EAAE;YACP,OAAO,EAAE,UAAU;YACnB,YAAY,EAAE,GAAG;YACjB,UAAU,EAAE,wBAAwB;SACrC,aAED,oCAEE,KAAK,EAAE;oBACL,KAAK,EAAE,EAAE;oBACT,MAAM,EAAE,EAAE;oBACV,YAAY,EAAE,KAAK;oBACnB,UAAU,EAAE,sCAAsC,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,GAAG;oBAChF,SAAS,EAAE,OAAO,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,MAAM,CAAC,IAAI,EAAE;oBACtD,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS;oBAC3C,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;iBAC3B,GACD,EACF,eAAM,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,YAAG,OAAO,GAAQ,EACnF,UAAU,IAAI,CACb,oCAEE,KAAK,EAAE,OAAO,CAAC,KAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EACjD,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,YAExD,UAAU,GACN,CACR,IACG,CACP,CAAC;AACJ,CAAC"}

package/dist/esm/components/Constellation.d.ts

@@ -0,0 +1,26 @@
+import React from "react";
+/** Props for {@link Constellation}. */
+export interface ConstellationProps {
+    /** Canvas width in px. Defaults to 360. */
+    width?: number;
+    /** Canvas height in px. Defaults to 240. */
+    height?: number;
+    /** Optional class for the root SVG. */
+    className?: string;
+}
+/**
+ * Render the Constellation as a randomized field of warm blobs.
+ *
+ * Self-contained: reads {@link useSocialConstellation} and gates on the feature config. Returns `null`
+ * when disabled, a nebula when the snapshot is still forming (`asOf === null`), and otherwise a
+ * re-randomized SVG blob field. Blobs are sized by bucket and tinted by warmth only.
+ *
+ * @param props - {@link ConstellationProps}.
+ * @returns The blob canvas, a nebula, or `null`.
+ *
+ * @example
+ * ```tsx
+ * <Constellation width={420} height={280} />
+ * ```
+ */
+export declare function Constellation({ width, height, className, }: ConstellationProps): React.ReactElement | null;

package/dist/esm/components/Constellation.js

@@ -0,0 +1,90 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// <Constellation /> — the anonymous community "shape" as a field of warm, glowing blobs.
+//
+// Renders the Constellation snapshot (cluster blobs) on an SVG canvas. The privacy rules from
+// SOCIAL.md §6 are enforced structurally here:
+//   • No stable layout — positions are re-randomized on every mount / whenever the blob data changes,
+//     so no cluster has a "home" a viewer could track across loads. We seed random (x, y) and resolve
+//     overlaps with a synchronous d3-force pass (collision + center gravity).
+//   • Size by BUCKET, never an exact count — radius comes from a fixed bucket→px map; no count is read
+//     or shown.
+//   • Warmth-only tint — blobs use the same calm climate palette as Weather; friction never renders.
+//   • `asOf === null` is the valid "still forming" state — a wispy nebula, not an error or empty list.
+import { useEffect, useId, useMemo, useState } from "react";
+import { forceCenter, forceCollide, forceSimulation, } from "d3-force";
+import { useSocialConstellation } from "@agora-sdk/social-core";
+import { bandColors } from "../palette.js";
+/**
+ * Fixed bucket → blob radius (px). Deliberately coarse: the bucket IS the privacy protection, so the
+ * visual never encodes more precision than the bucket itself (SOCIAL.md §6).
+ */
+const BUCKET_RADIUS = {
+    "5–9": 20,
+    "10–19": 28,
+    "20–49": 38,
+    "50–99": 50,
+    "100+": 65,
+};
+/**
+ * Lay out blobs with fresh random positions resolved by a synchronous force pass. Re-randomization is
+ * a privacy requirement, so this runs from scratch each time the blob set changes — never memoized to
+ * a stable layout. Uses `Math.random()` only for visual placement (no security relevance).
+ */
+function computePositions(blobs, width, height) {
+    const nodes = blobs.map((b) => ({
+        r: BUCKET_RADIUS[b.size] ?? 28,
+        warmth: b.warmth,
+        // Random seed placement near the center; the simulation spreads them without overlap.
+        x: width / 2 + (Math.random() - 0.5) * width * 0.6,
+        y: height / 2 + (Math.random() - 0.5) * height * 0.6,
+    }));
+    // Build a simulation, immediately stop its internal timer, and tick it synchronously so we get a
+    // settled, non-overlapping layout in one render with no animation loop or async state.
+    const simulation = forceSimulation(nodes)
+        .force("collide", forceCollide((d) => d.r + 8))
+        .force("center", forceCenter(width / 2, height / 2))
+        .stop();
+    simulation.tick(300);
+    return nodes;
+}
+/**
+ * Render the Constellation as a randomized field of warm blobs.
+ *
+ * Self-contained: reads {@link useSocialConstellation} and gates on the feature config. Returns `null`
+ * when disabled, a nebula when the snapshot is still forming (`asOf === null`), and otherwise a
+ * re-randomized SVG blob field. Blobs are sized by bucket and tinted by warmth only.
+ *
+ * @param props - {@link ConstellationProps}.
+ * @returns The blob canvas, a nebula, or `null`.
+ *
+ * @example
+ * ```tsx
+ * <Constellation width={420} height={280} />
+ * ```
+ */
+export function Constellation({ width = 360, height = 240, className, }) {
+    const { constellation } = useSocialConstellation();
+    const gradPrefix = useId();
+    const blobs = constellation?.blobs ?? null;
+    // Positions live in state, seeded once per blob-set and re-seeded whenever the blobs change (or the
+    // canvas resizes). NOT recomputed on every render — only when the data/size actually changes — but
+    // also never a *stable* layout across mounts, since each fresh mount re-runs computePositions.
+    const [nodes, setNodes] = useState(() => blobs ? computePositions(blobs, width, height) : []);
+    useEffect(() => {
+        if (blobs)
+            setNodes(computePositions(blobs, width, height));
+    }, [blobs, width, height]);
+    // One gradient per band actually present, plus a shared blur — referenced by the circles below.
+    const bandsPresent = useMemo(() => Array.from(new Set((blobs ?? []).map((b) => b.warmth))), [blobs]);
+    if (!constellation)
+        return null;
+    // Still-forming: a gentle nebula, never an error or empty state.
+    if (constellation.asOf === null) {
+        return (_jsxs("svg", { className: className, width: width, height: height, role: "img", "aria-label": "Community constellation: still forming", children: [_jsxs("defs", { children: [_jsxs("radialGradient", { id: `${gradPrefix}-nebula`, cx: "50%", cy: "50%", r: "60%", children: [_jsx("stop", { offset: "0%", stopColor: "rgba(138,148,166,0.30)" }), _jsx("stop", { offset: "100%", stopColor: "rgba(138,148,166,0)" })] }), _jsx("filter", { id: `${gradPrefix}-nblur`, children: _jsx("feGaussianBlur", { stdDeviation: "10" }) })] }), _jsx("rect", { x: 0, y: 0, width: width, height: height, fill: `url(#${gradPrefix}-nebula)`, filter: `url(#${gradPrefix}-nblur)` })] }));
+    }
+    return (_jsxs("svg", { className: className, width: width, height: height, role: "img", "aria-label": "Community constellation", children: [_jsxs("defs", { children: [bandsPresent.map((band) => {
+                        const colors = bandColors(band);
+                        return (_jsxs("radialGradient", { id: `${gradPrefix}-${band}`, cx: "50%", cy: "50%", r: "50%", children: [_jsx("stop", { offset: "0%", stopColor: colors.core, stopOpacity: 0.9 }), _jsx("stop", { offset: "100%", stopColor: colors.core, stopOpacity: 0 })] }, band));
+                    }), _jsx("filter", { id: `${gradPrefix}-glow`, children: _jsx("feGaussianBlur", { stdDeviation: "4" }) })] }), nodes.map((n, i) => (_jsx("circle", { cx: n.x, cy: n.y, r: n.r, fill: `url(#${gradPrefix}-${n.warmth})`, filter: `url(#${gradPrefix}-glow)` }, i)))] }));
+}
+//# sourceMappingURL=Constellation.js.map

package/dist/esm/components/Constellation.js.map

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

package/dist/esm/components/Neighborhood.d.ts

@@ -0,0 +1,24 @@
+import React from "react";
+/** Props for {@link Neighborhood}. */
+export interface NeighborhoodProps {
+    /** Render the "include interactions" toggle (wires to the hook's setter). Defaults to `false`. */
+    showInteractionsToggle?: boolean;
+    /** Optional class for the root element. */
+    className?: string;
+}
+/**
+ * Render the caller's Neighborhood — their named ties, lit by dyadic brightness.
+ *
+ * Self-contained: reads {@link useSocialNeighborhood} and gates on the feature config. Ties render in
+ * the server's brightest-first order; brightness becomes glow/scale, never a number. Optionally shows
+ * the interactions toggle.
+ *
+ * @param props - {@link NeighborhoodProps}.
+ * @returns The tie list, or `null` when the lens is disabled or still loading.
+ *
+ * @example
+ * ```tsx
+ * <Neighborhood showInteractionsToggle />
+ * ```
+ */
+export declare function Neighborhood({ showInteractionsToggle, className, }: NeighborhoodProps): React.ReactElement | null;

package/dist/esm/components/Neighborhood.js

@@ -0,0 +1,69 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useSocialNeighborhood } from "@agora-sdk/social-core";
+import { brightnessTreatment } from "../palette.js";
+/** Subtle glyphs for the tie-kind chips. Hints, not labels. */
+const TIE_KIND_GLYPH = {
+    follow: "→",
+    connection: "↔",
+    interaction: "·",
+};
+/** Best available display label for a tie, falling back gracefully when fields are null. */
+function displayName(tie) {
+    return tie.name ?? tie.username ?? "Someone";
+}
+/** First glyph for the avatar fallback. */
+function initial(tie) {
+    const label = displayName(tie);
+    return label.charAt(0).toUpperCase();
+}
+/** One tie card — avatar (or initial) + name + tie-kind chips, lit by brightness glow. */
+function TieCard({ tie }) {
+    const t = brightnessTreatment(tie.brightness);
+    // Sprout ties get a warm amber halo (hopeful/new); brighter ties get a golden glow. Never grey.
+    const glowColor = t.isSprout ? "rgba(224, 169, 85, " : "rgba(244, 198, 74, ";
+    const shadow = `0 0 ${t.glowRadius}px ${glowColor}${t.glowOpacity})`;
+    return (_jsxs("li", { style: {
+            display: "flex",
+            alignItems: "center",
+            gap: 12,
+            padding: "8px 4px",
+            listStyle: "none",
+        }, children: [_jsx("div", { "aria-hidden": true, style: {
+                    width: 40,
+                    height: 40,
+                    borderRadius: "50%",
+                    transform: `scale(${t.scale})`,
+                    boxShadow: shadow,
+                    background: tie.avatar
+                        ? `center / cover no-repeat url(${tie.avatar})`
+                        : "linear-gradient(135deg, #e0a955, #f4c64a)",
+                    display: "flex",
+                    alignItems: "center",
+                    justifyContent: "center",
+                    color: "#1b1b24",
+                    fontWeight: 700,
+                    fontSize: 16,
+                }, children: tie.avatar ? "" : initial(tie) }), _jsxs("div", { style: { display: "flex", flexDirection: "column", gap: 2 }, children: [_jsx("span", { style: { fontSize: 14, fontWeight: 600 }, children: displayName(tie) }), _jsx("span", { style: { display: "flex", gap: 6, fontSize: 11, color: "#9ca3af" }, children: tie.tieKinds.map((kind) => (_jsxs("span", { title: kind, "aria-label": kind, children: [TIE_KIND_GLYPH[kind], " ", kind] }, kind))) })] })] }));
+}
+/**
+ * Render the caller's Neighborhood — their named ties, lit by dyadic brightness.
+ *
+ * Self-contained: reads {@link useSocialNeighborhood} and gates on the feature config. Ties render in
+ * the server's brightest-first order; brightness becomes glow/scale, never a number. Optionally shows
+ * the interactions toggle.
+ *
+ * @param props - {@link NeighborhoodProps}.
+ * @returns The tie list, or `null` when the lens is disabled or still loading.
+ *
+ * @example
+ * ```tsx
+ * <Neighborhood showInteractionsToggle />
+ * ```
+ */
+export function Neighborhood({ showInteractionsToggle = false, className, }) {
+    const { neighborhood, includeInteractions, setIncludeInteractions } = useSocialNeighborhood();
+    if (!neighborhood)
+        return null;
+    return (_jsxs("div", { className: className, children: [showInteractionsToggle && (_jsxs("label", { style: { display: "flex", alignItems: "center", gap: 8, fontSize: 13, marginBottom: 8 }, children: [_jsx("input", { type: "checkbox", checked: includeInteractions, onChange: (e) => setIncludeInteractions(e.target.checked) }), "Include people I\u2019ve interacted with"] })), _jsx("ul", { style: { margin: 0, padding: 0 }, children: neighborhood.ties.map((tie) => (_jsx(TieCard, { tie: tie }, tie.userId))) })] }));
+}
+//# sourceMappingURL=Neighborhood.js.map

package/dist/esm/components/Neighborhood.js.map

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

package/dist/esm/components/SocialTransparency.d.ts

@@ -0,0 +1,21 @@
+import React from "react";
+/** Props for {@link SocialTransparency}. */
+export interface SocialTransparencyProps {
+    /** Optional class for the root element. */
+    className?: string;
+}
+/**
+ * Render the social-graph transparency panel.
+ *
+ * Self-contained: reads {@link useSocialTransparency} from the provider. Lists the enabled lenses and
+ * the tuning that shapes them, in member-safe terms.
+ *
+ * @param props - {@link SocialTransparencyProps}.
+ * @returns The disclosure panel, or `null` until the config has resolved.
+ *
+ * @example
+ * ```tsx
+ * <SocialTransparency />
+ * ```
+ */
+export declare function SocialTransparency({ className, }: SocialTransparencyProps): React.ReactElement | null;

package/dist/esm/components/SocialTransparency.js

@@ -0,0 +1,32 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useSocialTransparency } from "@agora-sdk/social-core";
+/** One labeled row in the disclosure panel. */
+function Row({ label, value }) {
+    return (_jsxs("div", { style: { display: "flex", justifyContent: "space-between", gap: 16, fontSize: 13, padding: "4px 0" }, children: [_jsx("span", { style: { color: "#9ca3af" }, children: label }), _jsx("span", { style: { fontWeight: 600 }, children: value })] }));
+}
+/**
+ * Render the social-graph transparency panel.
+ *
+ * Self-contained: reads {@link useSocialTransparency} from the provider. Lists the enabled lenses and
+ * the tuning that shapes them, in member-safe terms.
+ *
+ * @param props - {@link SocialTransparencyProps}.
+ * @returns The disclosure panel, or `null` until the config has resolved.
+ *
+ * @example
+ * ```tsx
+ * <SocialTransparency />
+ * ```
+ */
+export function SocialTransparency({ className, }) {
+    const { config } = useSocialTransparency();
+    if (!config)
+        return null;
+    const lenses = [
+        config.weatherEnabled && "Weather",
+        config.constellationEnabled && "Constellation",
+        config.neighborhoodEnabled && "Neighborhood",
+    ].filter(Boolean);
+    return (_jsxs("section", { className: className, "aria-label": "How the social graph works", children: [_jsx("h3", { style: { fontSize: 14, margin: "0 0 8px" }, children: "How your community graph works" }), _jsx(Row, { label: "Active lenses", value: lenses.length ? lenses.join(", ") : "None" }), _jsx(Row, { label: "Warmth memory", value: `~${config.warmthHalfLifeDays}-day half-life` }), _jsx(Row, { label: "Friction memory", value: `~${config.frictionHalfLifeDays}-day half-life` }), _jsx(Row, { label: "Smallest visible cluster", value: `${config.constellationKFloor}+ members` }), _jsx(Row, { label: "Neighborhood includes interactions", value: config.neighborhoodIncludeInteractions ? "By default" : "Only if you opt in" }), _jsx("p", { style: { fontSize: 12, color: "#9ca3af", marginTop: 10, lineHeight: 1.5 }, children: "Warmth fades gently over time, so the graph reflects how things are now \u2014 not a permanent score. Clusters smaller than the floor are never shown. Your Neighborhood is yours alone." })] }));
+}
+//# sourceMappingURL=SocialTransparency.js.map

package/dist/esm/components/SocialTransparency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SocialTransparency.js","sourceRoot":"","sources":["../../../src/components/SocialTransparency.tsx"],"names":[],"mappings":";AAQA,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAQ/D,+CAA+C;AAC/C,SAAS,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,EAAoC;IAC7D,OAAO,CACL,eAAK,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,eAAe,EAAE,GAAG,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,aACvG,eAAM,KAAK,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,YAAG,KAAK,GAAQ,EACjD,eAAM,KAAK,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,YAAG,KAAK,GAAQ,IAC5C,CACP,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kBAAkB,CAAC,EACjC,SAAS,GACe;IACxB,MAAM,EAAE,MAAM,EAAE,GAAG,qBAAqB,EAAE,CAAC;IAC3C,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAEzB,MAAM,MAAM,GAAG;QACb,MAAM,CAAC,cAAc,IAAI,SAAS;QAClC,MAAM,CAAC,oBAAoB,IAAI,eAAe;QAC9C,MAAM,CAAC,mBAAmB,IAAI,cAAc;KAC7C,CAAC,MAAM,CAAC,OAAO,CAAa,CAAC;IAE9B,OAAO,CACL,mBAAS,SAAS,EAAE,SAAS,gBAAa,4BAA4B,aACpE,aAAI,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,+CAAqC,EACnF,KAAC,GAAG,IAAC,KAAK,EAAC,eAAe,EAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,GAAI,EAChF,KAAC,GAAG,IAAC,KAAK,EAAC,eAAe,EAAC,KAAK,EAAE,IAAI,MAAM,CAAC,kBAAkB,gBAAgB,GAAI,EACnF,KAAC,GAAG,IAAC,KAAK,EAAC,iBAAiB,EAAC,KAAK,EAAE,IAAI,MAAM,CAAC,oBAAoB,gBAAgB,GAAI,EACvF,KAAC,GAAG,IAAC,KAAK,EAAC,0BAA0B,EAAC,KAAK,EAAE,GAAG,MAAM,CAAC,mBAAmB,WAAW,GAAI,EACzF,KAAC,GAAG,IACF,KAAK,EAAC,oCAAoC,EAC1C,KAAK,EAAE,MAAM,CAAC,+BAA+B,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,oBAAoB,GACnF,EACF,YAAG,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,yMAGxE,IACI,CACX,CAAC;AACJ,CAAC"}

package/dist/esm/index.d.ts

@@ -0,0 +1,11 @@
+export * from "@agora-sdk/social-core";
+export { CommunityWeather } from "./components/CommunityWeather.js";
+export type { CommunityWeatherProps } from "./components/CommunityWeather.js";
+export { Constellation } from "./components/Constellation.js";
+export type { ConstellationProps } from "./components/Constellation.js";
+export { Neighborhood } from "./components/Neighborhood.js";
+export type { NeighborhoodProps } from "./components/Neighborhood.js";
+export { SocialTransparency } from "./components/SocialTransparency.js";
+export type { SocialTransparencyProps } from "./components/SocialTransparency.js";
+export { bandPalette, bandColors, brightnessTreatment } from "./palette.js";
+export type { BandColors, BrightnessTreatment } from "./palette.js";

package/dist/esm/index.js

@@ -0,0 +1,15 @@
+// @agora-sdk/social-react-js — web (browser) bindings for the Agora social graph.
+//
+// Re-exports the platform-agnostic core (provider + hooks + transport + types) and adds the web visual
+// components for the three lenses plus the transparency disclosure. Use this package (not core
+// directly) in browser apps so the components ship. The shared climate palette is exported too, so host
+// apps can match the SDK's warmth vocabulary in their own chrome.
+export * from "@agora-sdk/social-core";
+// ── components ────────────────────────────────────────────────────────────────
+export { CommunityWeather } from "./components/CommunityWeather.js";
+export { Constellation } from "./components/Constellation.js";
+export { Neighborhood } from "./components/Neighborhood.js";
+export { SocialTransparency } from "./components/SocialTransparency.js";
+// ── shared visual vocabulary (palette + brightness mapping) ───────────────────
+export { bandPalette, bandColors, brightnessTreatment } from "./palette.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,EAAE;AACF,uGAAuG;AACvG,+FAA+F;AAC/F,wGAAwG;AACxG,kEAAkE;AAElE,cAAc,wBAAwB,CAAC;AAEvC,iFAAiF;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAE9D,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAGxE,iFAAiF;AACjF,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}

package/dist/esm/palette.d.ts

@@ -0,0 +1,49 @@
+import type { WeatherBand } from "@agora-sdk/social-core";
+/** A band's rendering colors: a `core` fill/ink and a softer `glow` for shadows/auras. */
+export interface BandColors {
+    /** The primary fill or text color for this band. */
+    core: string;
+    /** A translucent glow/aura color (for box-shadow, radial-gradient edges). */
+    glow: string;
+}
+/**
+ * Maps each {@link WeatherBand} to its calm climate colors. Kept deliberately in the amber/slate/grey
+ * register — **no red anywhere** — so low warmth never reads as an alarm (SOCIAL.md §5).
+ *
+ * - `quiet` — soft grey-blue, "still forming" (the no-data sentinel)
+ * - `stormy` — muted slate-blue (low warmth, NOT danger)
+ * - `overcast` — cool grey (below average)
+ * - `fine` — warm amber-gold (above average)
+ * - `sunny` — bright golden-yellow (high warmth)
+ */
+export declare const bandPalette: Record<WeatherBand, BandColors>;
+/**
+ * Resolve the climate colors for a band, defaulting to `quiet` for any unexpected value (fail-soft to
+ * the neutral "forming" look rather than throwing on malformed server data).
+ *
+ * @param band - The weather/warmth band to color.
+ * @returns The {@link BandColors} for that band.
+ */
+export declare function bandColors(band: WeatherBand): BandColors;
+/** The four brightness bands from SOCIAL.md §5, as visual treatment (never exposed as a number). */
+export interface BrightnessTreatment {
+    /** Glow radius in px for a box-shadow / drop-shadow (higher = warmer, closer). */
+    glowRadius: number;
+    /** Glow opacity in `[0, 1]`. */
+    glowOpacity: number;
+    /** Node scale multiplier (brighter ties read slightly larger). */
+    scale: number;
+    /**
+     * True for ties at the floor band (`[0.15, 0.24]`): render the warm, hopeful "sprout" treatment, not
+     * a grey absence. New ≠ lonely ≠ deficient (SOCIAL.md §6).
+     */
+    isSprout: boolean;
+}
+/**
+ * Map a dyadic `brightness` in `[0.15, 1.0]` to a visual treatment — glow, scale, and the sprout flag.
+ * The brightness number itself is **never** returned for display; it is a rendering input only.
+ *
+ * @param brightness - Dyadic brightness in `[0.15, 1.0]` (values outside are clamped).
+ * @returns The {@link BrightnessTreatment} for that tie.
+ */
+export declare function brightnessTreatment(brightness: number): BrightnessTreatment;

package/dist/esm/palette.js

@@ -0,0 +1,52 @@
+// Climate palette + brightness mapping — the privacy-critical visual vocabulary, in one place.
+//
+// Every social surface that renders warmth (Weather band, Constellation blob tint) maps through
+// `bandPalette` so the rules from SOCIAL.md §5/§6 hold uniformly: a sky/climate register, and
+// **never red** for low-warmth bands (red reads as danger; low warmth means "could use more
+// connection", not "something is wrong"). Brightness (Neighborhood) maps to visual WEIGHT only —
+// never a number — via `brightnessTreatment`, with the floor band rendered as a hopeful sprout glow
+// rather than a grey absence.
+/**
+ * Maps each {@link WeatherBand} to its calm climate colors. Kept deliberately in the amber/slate/grey
+ * register — **no red anywhere** — so low warmth never reads as an alarm (SOCIAL.md §5).
+ *
+ * - `quiet` — soft grey-blue, "still forming" (the no-data sentinel)
+ * - `stormy` — muted slate-blue (low warmth, NOT danger)
+ * - `overcast` — cool grey (below average)
+ * - `fine` — warm amber-gold (above average)
+ * - `sunny` — bright golden-yellow (high warmth)
+ */
+export const bandPalette = {
+    quiet: { core: "#8a94a6", glow: "rgba(138, 148, 166, 0.35)" },
+    stormy: { core: "#5b6b86", glow: "rgba(91, 107, 134, 0.40)" },
+    overcast: { core: "#8d96a3", glow: "rgba(141, 150, 163, 0.40)" },
+    fine: { core: "#e0a955", glow: "rgba(224, 169, 85, 0.55)" },
+    sunny: { core: "#f4c64a", glow: "rgba(244, 198, 74, 0.70)" },
+};
+/**
+ * Resolve the climate colors for a band, defaulting to `quiet` for any unexpected value (fail-soft to
+ * the neutral "forming" look rather than throwing on malformed server data).
+ *
+ * @param band - The weather/warmth band to color.
+ * @returns The {@link BandColors} for that band.
+ */
+export function bandColors(band) {
+    return bandPalette[band] ?? bandPalette.quiet;
+}
+/**
+ * Map a dyadic `brightness` in `[0.15, 1.0]` to a visual treatment — glow, scale, and the sprout flag.
+ * The brightness number itself is **never** returned for display; it is a rendering input only.
+ *
+ * @param brightness - Dyadic brightness in `[0.15, 1.0]` (values outside are clamped).
+ * @returns The {@link BrightnessTreatment} for that tie.
+ */
+export function brightnessTreatment(brightness) {
+    const b = Math.min(1, Math.max(0.15, brightness));
+    // Linear glow within the meaningful range; the floor band is special-cased as the sprout state.
+    const glowRadius = 6 + Math.round(b * 22); // ~9px at floor → 28px at full glow
+    const glowOpacity = 0.25 + b * 0.55; // ~0.33 at floor → 0.8 at full glow
+    const scale = 0.94 + b * 0.12; // subtle: brighter ties read slightly larger
+    const isSprout = b <= 0.24;
+    return { glowRadius, glowOpacity, scale, isSprout };
+}
+//# sourceMappingURL=palette.js.map

package/dist/esm/palette.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"palette.js","sourceRoot":"","sources":["../../src/palette.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,EAAE;AACF,gGAAgG;AAChG,8FAA8F;AAC9F,4FAA4F;AAC5F,iGAAiG;AACjG,oGAAoG;AACpG,8BAA8B;AAY9B;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,WAAW,GAAoC;IAC1D,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,2BAA2B,EAAE;IAC7D,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,0BAA0B,EAAE;IAC7D,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,2BAA2B,EAAE;IAChE,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,0BAA0B,EAAE;IAC3D,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,0BAA0B,EAAE;CAC7D,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,IAAiB;IAC1C,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC;AAChD,CAAC;AAiBD;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAkB;IACpD,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;IAClD,gGAAgG;IAChG,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,oCAAoC;IAC/E,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,oCAAoC;IACzE,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,6CAA6C;IAC5E,MAAM,QAAQ,GAAG,CAAC,IAAI,IAAI,CAAC;IAC3B,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AACtD,CAAC"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@agora-sdk/social-react-js",
+  "version": "0.6.0",
+  "private": false,
+  "license": "Apache-2.0",
+  "author": "Agora SDK Plus, maintained by Jenova Marie",
+  "description": "Web (browser) components for the Agora social graph: CommunityWeather, Constellation (d3-force), Neighborhood, SocialTransparency. Re-exports @agora-sdk/social-core.",
+  "keywords": [
+    "agora",
+    "social-graph",
+    "community",
+    "constellation",
+    "react",
+    "web",
+    "typescript"
+  ],
+  "bugs": {
+    "url": "https://github.com/jenova-marie/agora-sdk-plus/issues"
+  },
+  "homepage": "https://github.com/jenova-marie/agora-sdk-plus",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jenova-marie/agora-sdk-plus.git",
+    "directory": "packages/social/react-js"
+  },
+  "main": "dist/esm/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/esm/index.d.ts",
+  "type": "module",
+  "comment:esm-only": "ESM-only to match the secure-chat web binding: web/React consumers always bundle (Vite/webpack/Metro), and @agora-sdk/core is bundler-only, so a CJS build would never load at runtime.",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "d3-force": "^3.0.0",
+    "@agora-sdk/social-core": "0.6.0"
+  },
+  "peerDependencies": {
+    "@agora-sdk/core": "^1.2.2",
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@types/d3-force": "^3.0.10"
+  },
+  "scripts": {
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build": "rimraf dist && pnpm run build:esm",
+    "prepublish": "pnpm run build"
+  }
+}