@agora-sdk/social-react-native 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/cjs/components/CommunityWeather.d.ts

@@ -0,0 +1,24 @@
+import React from "react";
+/** Props for {@link CommunityWeather}. */
+export interface CommunityWeatherProps {
+    /** Optional style for the root chip (for host-app layout/spacing). */
+    style?: object;
+}
+/**
+ * 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({ style }: CommunityWeatherProps): React.ReactElement | null;

package/dist/cjs/components/CommunityWeather.js

@@ -0,0 +1,128 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommunityWeather = CommunityWeather;
+const jsx_runtime_1 = require("react/jsx-runtime");
+// <CommunityWeather /> — the Weather lens as an ambient climate indicator (React Native).
+//
+// Native port of the web component: the aggregate community warmth as a calm sky/climate chip
+// (SOCIAL.md §5) — a band-tinted orb with a soft glow, a subtle trend cue (warming/cooling, never
+// alarming text), and a "still forming" treatment for the `quiet` no-data sentinel. The raw `value`
+// number is NEVER shown — warmth is communicated only as color/glow. Returns `null` when the lens is
+// disabled or still loading, so a host can drop it in unconditionally and have it disappear when off.
+//
+// The orb's radial gradient is drawn with react-native-svg (the only cross-platform way to get a soft
+// gradient orb in RN); the ambient glow is an RN View shadow/elevation around it.
+const react_1 = __importDefault(require("react"));
+const react_native_1 = require("react-native");
+const react_native_svg_1 = __importStar(require("react-native-svg"));
+const social_core_1 = require("@agora-sdk/social-core");
+const palette_js_1 = require("../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",
+};
+const ORB = 22;
+/**
+ * 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>
+ * ```
+ */
+function CommunityWeather({ style }) {
+    const { weather } = (0, social_core_1.useSocialWeather)();
+    // react-native-svg references gradients by id; strip the colons React.useId emits so `url(#id)` is valid.
+    const gid = `cw-${react_1.default.useId().replace(/:/g, "")}`;
+    if (!weather)
+        return null;
+    const colors = (0, palette_js_1.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 ((0, jsx_runtime_1.jsxs)(react_native_1.View, { style: [styles.chip, style], accessibilityRole: "image", accessibilityLabel: `Community weather: ${caption.toLowerCase()}`, children: [(0, jsx_runtime_1.jsx)(react_native_1.View, { style: [
+                    styles.orbWrap,
+                    {
+                        shadowColor: colors.glow,
+                        shadowRadius: forming ? 10 : 18,
+                        elevation: forming ? 4 : 8,
+                        opacity: forming ? 0.8 : 1,
+                    },
+                ], children: (0, jsx_runtime_1.jsxs)(react_native_svg_1.default, { width: ORB, height: ORB, children: [(0, jsx_runtime_1.jsx)(react_native_svg_1.Defs, { children: (0, jsx_runtime_1.jsxs)(react_native_svg_1.RadialGradient, { id: gid, cx: "35%", cy: "30%", r: "70%", children: [(0, jsx_runtime_1.jsx)(react_native_svg_1.Stop, { offset: "0%", stopColor: colors.core, stopOpacity: 1 }), (0, jsx_runtime_1.jsx)(react_native_svg_1.Stop, { offset: "100%", stopColor: colors.core, stopOpacity: 0.2 })] }) }), (0, jsx_runtime_1.jsx)(react_native_svg_1.Circle, { cx: ORB / 2, cy: ORB / 2, r: ORB / 2, fill: `url(#${gid})` })] }) }), (0, jsx_runtime_1.jsx)(react_native_1.Text, { style: [styles.caption, { color: colors.core }], children: caption }), trendArrow && ((0, jsx_runtime_1.jsx)(react_native_1.Text, { style: [styles.trend, { color: colors.core }], accessibilityElementsHidden: true, children: trendArrow }))] }));
+}
+const styles = react_native_1.StyleSheet.create({
+    chip: {
+        flexDirection: "row",
+        alignItems: "center",
+        alignSelf: "flex-start",
+        gap: 10,
+        paddingVertical: 8,
+        paddingHorizontal: 14,
+        borderRadius: 999,
+        backgroundColor: "rgba(15, 15, 24, 0.04)",
+    },
+    // iOS shadow needs a non-transparent shadowOpacity; the color already carries its own alpha.
+    orbWrap: {
+        width: ORB,
+        height: ORB,
+        shadowOpacity: 1,
+        shadowOffset: { width: 0, height: 0 },
+    },
+    caption: { fontSize: 13, fontWeight: "600" },
+    trend: { fontSize: 13, opacity: 0.7 },
+});
+//# sourceMappingURL=CommunityWeather.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CommunityWeather.js","sourceRoot":"","sources":["../../../src/components/CommunityWeather.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmDA,4CAkDC;;AArGD,0FAA0F;AAC1F,EAAE;AACF,8FAA8F;AAC9F,kGAAkG;AAClG,oGAAoG;AACpG,qGAAqG;AACrG,sGAAsG;AACtG,EAAE;AACF,sGAAsG;AACtG,kFAAkF;AAElF,kDAA0B;AAC1B,+CAAsD;AACtD,qEAA2E;AAC3E,wDAA0D;AAC1D,8CAA2C;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,MAAM,GAAG,GAAG,EAAE,CAAC;AAEf;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,gBAAgB,CAAC,EAAE,KAAK,EAAyB;IAC/D,MAAM,EAAE,OAAO,EAAE,GAAG,IAAA,8BAAgB,GAAE,CAAC;IACvC,0GAA0G;IAC1G,MAAM,GAAG,GAAG,MAAM,eAAK,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;IACpD,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,MAAM,MAAM,GAAG,IAAA,uBAAU,EAAC,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,wBAAC,mBAAI,IAAC,KAAK,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,iBAAiB,EAAC,OAAO,EAAC,kBAAkB,EAAE,sBAAsB,OAAO,CAAC,WAAW,EAAE,EAAE,aAC5H,uBAAC,mBAAI,IACH,KAAK,EAAE;oBACL,MAAM,CAAC,OAAO;oBACd;wBACE,WAAW,EAAE,MAAM,CAAC,IAAI;wBACxB,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;wBAC/B,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;wBAC1B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;qBAC3B;iBACF,YAED,wBAAC,0BAAG,IAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,aAC1B,uBAAC,uBAAI,cAEH,wBAAC,iCAAc,IAAC,EAAE,EAAE,GAAG,EAAE,EAAE,EAAC,KAAK,EAAC,EAAE,EAAC,KAAK,EAAC,CAAC,EAAC,KAAK,aAChD,uBAAC,uBAAI,IAAC,MAAM,EAAC,IAAI,EAAC,SAAS,EAAE,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC,GAAI,EAC5D,uBAAC,uBAAI,IAAC,MAAM,EAAC,MAAM,EAAC,SAAS,EAAE,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,GAAI,IACjD,GACZ,EACP,uBAAC,yBAAM,IAAC,EAAE,EAAE,GAAG,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG,GAAG,CAAC,EAAE,CAAC,EAAE,GAAG,GAAG,CAAC,EAAE,IAAI,EAAE,QAAQ,GAAG,GAAG,GAAI,IAClE,GACD,EACP,uBAAC,mBAAI,IAAC,KAAK,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,YAAG,OAAO,GAAQ,EACtE,UAAU,IAAI,CACb,uBAAC,mBAAI,IAAC,KAAK,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,2BAA2B,kBAC7E,UAAU,GACN,CACR,IACI,CACR,CAAC;AACJ,CAAC;AAED,MAAM,MAAM,GAAG,yBAAU,CAAC,MAAM,CAAC;IAC/B,IAAI,EAAE;QACJ,aAAa,EAAE,KAAK;QACpB,UAAU,EAAE,QAAQ;QACpB,SAAS,EAAE,YAAY;QACvB,GAAG,EAAE,EAAE;QACP,eAAe,EAAE,CAAC;QAClB,iBAAiB,EAAE,EAAE;QACrB,YAAY,EAAE,GAAG;QACjB,eAAe,EAAE,wBAAwB;KAC1C;IACD,6FAA6F;IAC7F,OAAO,EAAE;QACP,KAAK,EAAE,GAAG;QACV,MAAM,EAAE,GAAG;QACX,aAAa,EAAE,CAAC;QAChB,YAAY,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;KACtC;IACD,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE;IAC5C,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE;CACtC,CAAC,CAAC"}

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

@@ -0,0 +1,24 @@
+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;
+}
+/**
+ * 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, }: ConstellationProps): React.ReactElement | null;

package/dist/cjs/components/Constellation.js

@@ -0,0 +1,97 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Constellation = Constellation;
+const jsx_runtime_1 = require("react/jsx-runtime");
+// <Constellation /> — the anonymous community "shape" as a field of warm, glowing blobs (React Native).
+//
+// Native port of the web component, drawn with react-native-svg. The privacy rules from SOCIAL.md §6
+// are enforced structurally, identically to web:
+//   • No stable layout — positions are re-randomized on every mount / whenever the blob data changes
+//     (see `computePositions` in ../layout), so no cluster has a "home" a viewer could track.
+//   • Size by BUCKET, never an exact count — radius comes from a fixed bucket→px map.
+//   • 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.
+//
+// Each blob is an SVG <Circle> filled by a per-band radial gradient that fades to transparent at the
+// edge, giving the soft "glow" look without an SVG blur filter (feGaussianBlur is not reliably
+// supported on react-native-svg across platforms).
+const react_1 = __importStar(require("react"));
+const react_native_svg_1 = __importStar(require("react-native-svg"));
+const social_core_1 = require("@agora-sdk/social-core");
+const palette_js_1 = require("../palette.js");
+const layout_js_1 = require("../layout.js");
+/**
+ * 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} />
+ * ```
+ */
+function Constellation({ width = 360, height = 240, }) {
+    const { constellation } = (0, social_core_1.useSocialConstellation)();
+    // react-native-svg references gradients by id; strip the colons React.useId emits so `url(#id)` is valid.
+    const gid = `cn-${react_1.default.useId().replace(/:/g, "")}`;
+    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] = (0, react_1.useState)(() => blobs ? (0, layout_js_1.computePositions)(blobs, width, height) : []);
+    (0, react_1.useEffect)(() => {
+        if (blobs)
+            setNodes((0, layout_js_1.computePositions)(blobs, width, height));
+    }, [blobs, width, height]);
+    // One gradient per band actually present — referenced by the circles below.
+    const bandsPresent = (0, react_1.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 ((0, jsx_runtime_1.jsxs)(react_native_svg_1.default, { width: width, height: height, accessibilityRole: "image", accessibilityLabel: "Community constellation: still forming", children: [(0, jsx_runtime_1.jsx)(react_native_svg_1.Defs, { children: (0, jsx_runtime_1.jsxs)(react_native_svg_1.RadialGradient, { id: `${gid}-nebula`, cx: "50%", cy: "50%", r: "60%", children: [(0, jsx_runtime_1.jsx)(react_native_svg_1.Stop, { offset: "0%", stopColor: "#8a94a6", stopOpacity: 0.3 }), (0, jsx_runtime_1.jsx)(react_native_svg_1.Stop, { offset: "100%", stopColor: "#8a94a6", stopOpacity: 0 })] }) }), (0, jsx_runtime_1.jsx)(react_native_svg_1.Rect, { x: 0, y: 0, width: width, height: height, fill: `url(#${gid}-nebula)` })] }));
+    }
+    return ((0, jsx_runtime_1.jsxs)(react_native_svg_1.default, { width: width, height: height, accessibilityRole: "image", accessibilityLabel: "Community constellation", children: [(0, jsx_runtime_1.jsx)(react_native_svg_1.Defs, { children: bandsPresent.map((band) => {
+                    const colors = (0, palette_js_1.bandColors)(band);
+                    return ((0, jsx_runtime_1.jsxs)(react_native_svg_1.RadialGradient, { id: `${gid}-${band}`, cx: "50%", cy: "50%", r: "50%", children: [(0, jsx_runtime_1.jsx)(react_native_svg_1.Stop, { offset: "0%", stopColor: colors.core, stopOpacity: 0.9 }), (0, jsx_runtime_1.jsx)(react_native_svg_1.Stop, { offset: "100%", stopColor: colors.core, stopOpacity: 0 })] }, band));
+                }) }), nodes.map((n, i) => ((0, jsx_runtime_1.jsx)(react_native_svg_1.Circle, { cx: n.x, cy: n.y, r: n.r, fill: `url(#${gid}-${n.warmth})` }, i)))] }));
+}
+//# sourceMappingURL=Constellation.js.map

package/dist/cjs/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/cjs/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 style for the root element. */
+    style?: object;
+}
+/**
+ * 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, style, }: NeighborhoodProps): React.ReactElement | null;

package/dist/cjs/components/Neighborhood.js

@@ -0,0 +1,131 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Neighborhood = Neighborhood;
+const jsx_runtime_1 = require("react/jsx-runtime");
+// <Neighborhood /> — the caller's own named ties, lit by dyadic brightness (React Native).
+//
+// Native port of the web component. Renders the self-view tie list (brightest-first, as the server
+// sorts it). Brightness drives a glow treatment ONLY — the number is never shown, labeled, or compared
+// between ties (SOCIAL.md §6). Ties at the floor band render as a warm "sprout" (hopeful/new), not a
+// grey absence. An optional RN Switch wires the `includeInteractions` toggle. Returns `null` when the
+// lens is disabled or still loading.
+//
+// Privacy note: the underlying hook keeps ties in component state only and clears them on a user/project
+// switch — this component adds no cache of its own, so the self-view never lingers across sign-outs.
+const react_1 = __importDefault(require("react"));
+const react_native_1 = require("react-native");
+const react_native_svg_1 = __importStar(require("react-native-svg"));
+const social_core_1 = require("@agora-sdk/social-core");
+const palette_js_1 = require("../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) {
+    return displayName(tie).charAt(0).toUpperCase();
+}
+/** One tie card — avatar (or initial) + name + tie-kind chips, lit by brightness glow. */
+function TieCard({ tie, gradientId }) {
+    const t = (0, palette_js_1.brightnessTreatment)(tie.brightness);
+    // Sprout ties get a warm amber halo (hopeful/new); brighter ties get a golden glow. Never grey.
+    // The opacity rides on shadowOpacity, so the color itself is fully opaque.
+    const glowColor = t.isSprout ? "#e0a955" : "#f4c64a";
+    return ((0, jsx_runtime_1.jsxs)(react_native_1.View, { style: styles.card, children: [(0, jsx_runtime_1.jsx)(react_native_1.View, { style: [
+                    styles.avatar,
+                    {
+                        transform: [{ scale: t.scale }],
+                        shadowColor: glowColor,
+                        shadowRadius: t.shadowRadius,
+                        shadowOpacity: t.shadowOpacity,
+                        elevation: t.elevation,
+                    },
+                ], children: tie.avatar ? ((0, jsx_runtime_1.jsx)(react_native_1.Image, { source: { uri: tie.avatar }, style: styles.avatarImg })) : ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsxs)(react_native_svg_1.default, { width: 40, height: 40, style: react_native_1.StyleSheet.absoluteFill, children: [(0, jsx_runtime_1.jsx)(react_native_svg_1.Defs, { children: (0, jsx_runtime_1.jsxs)(react_native_svg_1.LinearGradient, { id: gradientId, x1: "0", y1: "0", x2: "1", y2: "1", children: [(0, jsx_runtime_1.jsx)(react_native_svg_1.Stop, { offset: "0", stopColor: "#e0a955" }), (0, jsx_runtime_1.jsx)(react_native_svg_1.Stop, { offset: "1", stopColor: "#f4c64a" })] }) }), (0, jsx_runtime_1.jsx)(react_native_svg_1.Rect, { width: 40, height: 40, rx: 20, fill: `url(#${gradientId})` })] }), (0, jsx_runtime_1.jsx)(react_native_1.Text, { style: styles.avatarInitial, children: initial(tie) })] })) }), (0, jsx_runtime_1.jsxs)(react_native_1.View, { style: styles.cardText, children: [(0, jsx_runtime_1.jsx)(react_native_1.Text, { style: styles.name, children: displayName(tie) }), (0, jsx_runtime_1.jsx)(react_native_1.View, { style: styles.kinds, children: tie.tieKinds.map((kind) => ((0, jsx_runtime_1.jsxs)(react_native_1.Text, { style: styles.kind, accessibilityLabel: 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 />
+ * ```
+ */
+function Neighborhood({ showInteractionsToggle = false, style, }) {
+    const { neighborhood, includeInteractions, setIncludeInteractions } = (0, social_core_1.useSocialNeighborhood)();
+    // Stable per-mount prefix so each tie's fallback gradient id is unique within this component instance.
+    const gid = `nb-${react_1.default.useId().replace(/:/g, "")}`;
+    if (!neighborhood)
+        return null;
+    return ((0, jsx_runtime_1.jsxs)(react_native_1.View, { style: style, children: [showInteractionsToggle && ((0, jsx_runtime_1.jsxs)(react_native_1.View, { style: styles.toggleRow, children: [(0, jsx_runtime_1.jsx)(react_native_1.Switch, { value: includeInteractions, onValueChange: setIncludeInteractions }), (0, jsx_runtime_1.jsx)(react_native_1.Text, { style: styles.toggleLabel, children: "Include people I\u2019ve interacted with" })] })), (0, jsx_runtime_1.jsx)(react_native_1.ScrollView, { children: neighborhood.ties.map((tie, i) => ((0, jsx_runtime_1.jsx)(TieCard, { tie: tie, gradientId: `${gid}-${i}` }, tie.userId))) })] }));
+}
+const styles = react_native_1.StyleSheet.create({
+    toggleRow: { flexDirection: "row", alignItems: "center", gap: 8, marginBottom: 8 },
+    toggleLabel: { fontSize: 13 },
+    card: { flexDirection: "row", alignItems: "center", gap: 12, paddingVertical: 8, paddingHorizontal: 4 },
+    avatar: {
+        width: 40,
+        height: 40,
+        borderRadius: 20,
+        overflow: "visible",
+        alignItems: "center",
+        justifyContent: "center",
+        shadowOffset: { width: 0, height: 0 },
+        backgroundColor: "#e0a955", // base tint behind the SVG/Image so the glow never reads grey
+    },
+    avatarImg: { width: 40, height: 40, borderRadius: 20 },
+    avatarInitial: { color: "#1b1b24", fontWeight: "700", fontSize: 16 },
+    cardText: { flexDirection: "column", gap: 2 },
+    name: { fontSize: 14, fontWeight: "600" },
+    kinds: { flexDirection: "row", gap: 6 },
+    kind: { fontSize: 11, color: "#9ca3af" },
+});
+//# sourceMappingURL=Neighborhood.js.map