@agora-sdk/social-react-native 0.6.0

package/dist/cjs/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/cjs/components/SocialTransparency.d.ts

@@ -0,0 +1,21 @@
+import React from "react";
+/** Props for {@link SocialTransparency}. */
+export interface SocialTransparencyProps {
+    /** Optional style for the root element. */
+    style?: object;
+}
+/**
+ * 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({ style, }: SocialTransparencyProps): React.ReactElement | null;

package/dist/cjs/components/SocialTransparency.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SocialTransparency = SocialTransparency;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_native_1 = require("react-native");
+const social_core_1 = require("@agora-sdk/social-core");
+/** One labeled row in the disclosure panel. */
+function Row({ label, value }) {
+    return ((0, jsx_runtime_1.jsxs)(react_native_1.View, { style: styles.row, children: [(0, jsx_runtime_1.jsx)(react_native_1.Text, { style: styles.rowLabel, children: label }), (0, jsx_runtime_1.jsx)(react_native_1.Text, { style: styles.rowValue, 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 />
+ * ```
+ */
+function SocialTransparency({ style, }) {
+    const { config } = (0, social_core_1.useSocialTransparency)();
+    if (!config)
+        return null;
+    const lenses = [
+        config.weatherEnabled && "Weather",
+        config.constellationEnabled && "Constellation",
+        config.neighborhoodEnabled && "Neighborhood",
+    ].filter(Boolean);
+    return ((0, jsx_runtime_1.jsxs)(react_native_1.View, { style: style, accessibilityLabel: "How the social graph works", children: [(0, jsx_runtime_1.jsx)(react_native_1.Text, { style: styles.heading, children: "How your community graph works" }), (0, jsx_runtime_1.jsx)(Row, { label: "Active lenses", value: lenses.length ? lenses.join(", ") : "None" }), (0, jsx_runtime_1.jsx)(Row, { label: "Warmth memory", value: `~${config.warmthHalfLifeDays}-day half-life` }), (0, jsx_runtime_1.jsx)(Row, { label: "Friction memory", value: `~${config.frictionHalfLifeDays}-day half-life` }), (0, jsx_runtime_1.jsx)(Row, { label: "Smallest visible cluster", value: `${config.constellationKFloor}+ members` }), (0, jsx_runtime_1.jsx)(Row, { label: "Neighborhood includes interactions", value: config.neighborhoodIncludeInteractions ? "By default" : "Only if you opt in" }), (0, jsx_runtime_1.jsx)(react_native_1.Text, { style: styles.footnote, 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." })] }));
+}
+const styles = react_native_1.StyleSheet.create({
+    heading: { fontSize: 14, fontWeight: "600", marginBottom: 8 },
+    row: { flexDirection: "row", justifyContent: "space-between", gap: 16, paddingVertical: 4 },
+    rowLabel: { fontSize: 13, color: "#9ca3af" },
+    rowValue: { fontSize: 13, fontWeight: "600" },
+    footnote: { fontSize: 12, color: "#9ca3af", marginTop: 10, lineHeight: 18 },
+});
+//# sourceMappingURL=SocialTransparency.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SocialTransparency.js","sourceRoot":"","sources":["../../../src/components/SocialTransparency.tsx"],"names":[],"mappings":";;AAyCA,gDA6BC;;AA9DD,+CAAsD;AACtD,wDAA+D;AAQ/D,+CAA+C;AAC/C,SAAS,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,EAAoC;IAC7D,OAAO,CACL,wBAAC,mBAAI,IAAC,KAAK,EAAE,MAAM,CAAC,GAAG,aACrB,uBAAC,mBAAI,IAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,YAAG,KAAK,GAAQ,EAC5C,uBAAC,mBAAI,IAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,YAAG,KAAK,GAAQ,IACvC,CACR,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAgB,kBAAkB,CAAC,EACjC,KAAK,GACmB;IACxB,MAAM,EAAE,MAAM,EAAE,GAAG,IAAA,mCAAqB,GAAE,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,wBAAC,mBAAI,IAAC,KAAK,EAAE,KAAK,EAAE,kBAAkB,EAAC,4BAA4B,aACjE,uBAAC,mBAAI,IAAC,KAAK,EAAE,MAAM,CAAC,OAAO,+CAAuC,EAClE,uBAAC,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,uBAAC,GAAG,IAAC,KAAK,EAAC,eAAe,EAAC,KAAK,EAAE,IAAI,MAAM,CAAC,kBAAkB,gBAAgB,GAAI,EACnF,uBAAC,GAAG,IAAC,KAAK,EAAC,iBAAiB,EAAC,KAAK,EAAE,IAAI,MAAM,CAAC,oBAAoB,gBAAgB,GAAI,EACvF,uBAAC,GAAG,IAAC,KAAK,EAAC,0BAA0B,EAAC,KAAK,EAAE,GAAG,MAAM,CAAC,mBAAmB,WAAW,GAAI,EACzF,uBAAC,GAAG,IACF,KAAK,EAAC,oCAAoC,EAC1C,KAAK,EAAE,MAAM,CAAC,+BAA+B,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,oBAAoB,GACnF,EACF,uBAAC,mBAAI,IAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,yMAGrB,IACF,CACR,CAAC;AACJ,CAAC;AAED,MAAM,MAAM,GAAG,yBAAU,CAAC,MAAM,CAAC;IAC/B,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,EAAE;IAC7D,GAAG,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,GAAG,EAAE,EAAE,EAAE,eAAe,EAAE,CAAC,EAAE;IAC3F,QAAQ,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;IAC5C,QAAQ,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE;IAC7C,QAAQ,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;CAC5E,CAAC,CAAC"}

package/dist/cjs/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/cjs/index.js

@@ -0,0 +1,40 @@
+"use strict";
+// @agora-sdk/social-react-native — bare React Native bindings for the Agora social graph.
+//
+// Re-exports the platform-agnostic core (provider + four feature-gated hooks + transport + wire types)
+// and adds the NATIVE visual components for the three lenses plus the transparency disclosure, drawn on
+// React Native primitives + react-native-svg. Use this package (not core directly) in a bare RN app 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. The data layer is pure REST — no platform crypto involved.
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.brightnessTreatment = exports.bandColors = exports.bandPalette = exports.SocialTransparency = exports.Neighborhood = exports.Constellation = exports.CommunityWeather = void 0;
+__exportStar(require("@agora-sdk/social-core"), exports);
+// ── components ────────────────────────────────────────────────────────────────
+var CommunityWeather_js_1 = require("./components/CommunityWeather.js");
+Object.defineProperty(exports, "CommunityWeather", { enumerable: true, get: function () { return CommunityWeather_js_1.CommunityWeather; } });
+var Constellation_js_1 = require("./components/Constellation.js");
+Object.defineProperty(exports, "Constellation", { enumerable: true, get: function () { return Constellation_js_1.Constellation; } });
+var Neighborhood_js_1 = require("./components/Neighborhood.js");
+Object.defineProperty(exports, "Neighborhood", { enumerable: true, get: function () { return Neighborhood_js_1.Neighborhood; } });
+var SocialTransparency_js_1 = require("./components/SocialTransparency.js");
+Object.defineProperty(exports, "SocialTransparency", { enumerable: true, get: function () { return SocialTransparency_js_1.SocialTransparency; } });
+// ── shared visual vocabulary (palette + brightness mapping) ───────────────────
+var palette_js_1 = require("./palette.js");
+Object.defineProperty(exports, "bandPalette", { enumerable: true, get: function () { return palette_js_1.bandPalette; } });
+Object.defineProperty(exports, "bandColors", { enumerable: true, get: function () { return palette_js_1.bandColors; } });
+Object.defineProperty(exports, "brightnessTreatment", { enumerable: true, get: function () { return palette_js_1.brightnessTreatment; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA,0FAA0F;AAC1F,EAAE;AACF,uGAAuG;AACvG,wGAAwG;AACxG,uGAAuG;AACvG,oGAAoG;AACpG,oGAAoG;;;;;;;;;;;;;;;;;AAEpG,yDAAuC;AAEvC,iFAAiF;AACjF,wEAAoE;AAA3D,uHAAA,gBAAgB,OAAA;AAEzB,kEAA8D;AAArD,iHAAA,aAAa,OAAA;AAEtB,gEAA4D;AAAnD,+GAAA,YAAY,OAAA;AAErB,4EAAwE;AAA/D,2HAAA,kBAAkB,OAAA;AAG3B,iFAAiF;AACjF,2CAA4E;AAAnE,yGAAA,WAAW,OAAA;AAAE,wGAAA,UAAU,OAAA;AAAE,iHAAA,mBAAmB,OAAA"}

package/dist/cjs/layout.d.ts

@@ -0,0 +1,25 @@
+import { type SimulationNodeDatum } from "d3-force";
+import type { BlobSizeBucket, ConstellationBlob, WeatherBand } from "@agora-sdk/social-core";
+/**
+ * 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).
+ */
+export declare const BUCKET_RADIUS: Record<BlobSizeBucket, number>;
+/** A blob with a force-resolved position. d3-force mutates `x`/`y` in place during simulation. */
+export interface BlobNode extends SimulationNodeDatum {
+    /** Blob radius in px (from {@link BUCKET_RADIUS}). */
+    r: number;
+    /** Warmth band that tints the blob. */
+    warmth: WeatherBand;
+}
+/**
+ * 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 it is called — never memoized to a stable
+ * layout. Uses `Math.random()` only for visual placement (no security relevance).
+ *
+ * @param blobs - The constellation blobs to place.
+ * @param width - Canvas width in px.
+ * @param height - Canvas height in px.
+ * @returns One {@link BlobNode} per blob, with settled, non-overlapping `x`/`y`.
+ */
+export declare function computePositions(blobs: ConstellationBlob[], width: number, height: number): BlobNode[];

package/dist/cjs/layout.js

@@ -0,0 +1,54 @@
+"use strict";
+// Constellation layout — the d3-force blob placement, shared verbatim with the web sibling.
+//
+// d3-force is pure JS (no DOM), so the exact same synchronous force pass the web `<Constellation />`
+// uses ports to native untouched. The SOCIAL.md §6 privacy rules are baked in here:
+//   • Size by BUCKET, never an exact count — radius comes from a fixed bucket→px map.
+//   • No stable layout — positions are seeded with a fresh `Math.random()` every call, so no cluster
+//     has a "home" a viewer could track across mounts. `Math.random()` is layout-only (no security
+//     relevance); the simulation then resolves overlaps with collision + center gravity.
+//
+// No `react-native` import here on purpose: this stays pure logic so it unit-tests under plain vitest.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BUCKET_RADIUS = void 0;
+exports.computePositions = computePositions;
+const d3_force_1 = require("d3-force");
+/**
+ * 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).
+ */
+exports.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 it is called — never memoized to a stable
+ * layout. Uses `Math.random()` only for visual placement (no security relevance).
+ *
+ * @param blobs - The constellation blobs to place.
+ * @param width - Canvas width in px.
+ * @param height - Canvas height in px.
+ * @returns One {@link BlobNode} per blob, with settled, non-overlapping `x`/`y`.
+ */
+function computePositions(blobs, width, height) {
+    const nodes = blobs.map((b) => ({
+        r: exports.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 = (0, d3_force_1.forceSimulation)(nodes)
+        .force("collide", (0, d3_force_1.forceCollide)((d) => d.r + 8))
+        .force("center", (0, d3_force_1.forceCenter)(width / 2, height / 2))
+        .stop();
+    simulation.tick(300);
+    return nodes;
+}
+//# sourceMappingURL=layout.js.map

package/dist/cjs/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../src/layout.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,EAAE;AACF,qGAAqG;AACrG,oFAAoF;AACpF,sFAAsF;AACtF,qGAAqG;AACrG,mGAAmG;AACnG,yFAAyF;AACzF,EAAE;AACF,uGAAuG;;;AAwCvG,4CAsBC;AA5DD,uCAKkB;AAGlB;;;GAGG;AACU,QAAA,aAAa,GAAmC;IAC3D,KAAK,EAAE,EAAE;IACT,OAAO,EAAE,EAAE;IACX,OAAO,EAAE,EAAE;IACX,OAAO,EAAE,EAAE;IACX,MAAM,EAAE,EAAE;CACX,CAAC;AAUF;;;;;;;;;GASG;AACH,SAAgB,gBAAgB,CAC9B,KAA0B,EAC1B,KAAa,EACb,MAAc;IAEd,MAAM,KAAK,GAAe,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC1C,CAAC,EAAE,qBAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE;QAC9B,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,sFAAsF;QACtF,CAAC,EAAE,KAAK,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,KAAK,GAAG,GAAG;QAClD,CAAC,EAAE,MAAM,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,MAAM,GAAG,GAAG;KACrD,CAAC,CAAC,CAAC;IAEJ,iGAAiG;IACjG,uFAAuF;IACvF,MAAM,UAAU,GAAG,IAAA,0BAAe,EAAC,KAAK,CAAC;SACtC,KAAK,CAAC,SAAS,EAAE,IAAA,uBAAY,EAAW,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;SACxD,KAAK,CAAC,QAAQ,EAAE,IAAA,sBAAW,EAAC,KAAK,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC;SACnD,IAAI,EAAE,CAAC;IACV,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAErB,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/cjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/dist/cjs/palette.d.ts

@@ -0,0 +1,58 @@
+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 shadows, 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). These are the
+ * exact same hex/rgba constants as the web palette, so a native and a web client tint warmth identically.
+ *
+ * - `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;
+/**
+ * A tie's brightness expressed as React Native visual WEIGHT — shadow glow, elevation, and scale —
+ * never as a number. The shadow *color* is chosen by the component (amber for sprouts, golden
+ * otherwise); this carries only the magnitude props plus the sprout flag.
+ */
+export interface BrightnessTreatment {
+    /** iOS `shadowRadius` in px (higher = warmer, closer). */
+    shadowRadius: number;
+    /** iOS `shadowOpacity` in `[0, 1]`. */
+    shadowOpacity: number;
+    /** Android `elevation` (a coarse glow proxy, since Android has no tunable shadow blur). */
+    elevation: 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 an RN visual treatment — shadow glow, elevation, scale,
+ * and the sprout flag. The brightness number itself is **never** returned for display; it is a rendering
+ * input only. The clamp floor and the `isSprout` threshold are identical to the web palette so the
+ * privacy semantics never diverge across platforms.
+ *
+ * @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/cjs/palette.js

@@ -0,0 +1,65 @@
+"use strict";
+// Climate palette + brightness mapping for native — the privacy-critical visual vocabulary.
+//
+// This is the React Native PORT of the web sibling (`@agora-sdk/social-react-js`'s `palette.ts`). It
+// keeps the SAME SOCIAL.md §5 band colors and the SAME §6 brightness thresholds (the `isSprout`
+// floor at 0.24, the `[0.15, 1.0]` clamp) — those are privacy-critical and must not drift between
+// platforms — but `brightnessTreatment` returns RN shadow/elevation props instead of values tuned for
+// a CSS `box-shadow` string. The rule still holds on every surface: a sky/climate register, **never
+// red** for low warmth, and the floor band rendered as a hopeful sprout glow, never a grey absence.
+//
+// No `react-native` import here on purpose: this module is pure logic so it unit-tests under plain
+// vitest (node env) without an RN renderer.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bandPalette = void 0;
+exports.bandColors = bandColors;
+exports.brightnessTreatment = brightnessTreatment;
+/**
+ * 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). These are the
+ * exact same hex/rgba constants as the web palette, so a native and a web client tint warmth identically.
+ *
+ * - `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)
+ */
+exports.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.
+ */
+function bandColors(band) {
+    return exports.bandPalette[band] ?? exports.bandPalette.quiet;
+}
+/**
+ * Map a dyadic `brightness` in `[0.15, 1.0]` to an RN visual treatment — shadow glow, elevation, scale,
+ * and the sprout flag. The brightness number itself is **never** returned for display; it is a rendering
+ * input only. The clamp floor and the `isSprout` threshold are identical to the web palette so the
+ * privacy semantics never diverge across platforms.
+ *
+ * @param brightness - Dyadic brightness in `[0.15, 1.0]` (values outside are clamped).
+ * @returns The {@link BrightnessTreatment} for that tie.
+ */
+function brightnessTreatment(brightness) {
+    const b = Math.min(1, Math.max(0.15, brightness));
+    // Same curve as the web sibling: a linear glow within the meaningful range, with the floor band
+    // special-cased as the sprout state. Mapped onto RN shadow/elevation props instead of a box-shadow.
+    const shadowRadius = 6 + Math.round(b * 22); // ~9px at floor → 28px at full glow
+    const shadowOpacity = 0.25 + b * 0.55; // ~0.33 at floor → 0.8 at full glow
+    const elevation = 2 + Math.round(b * 10); // Android proxy: ~4 at floor → 12 at full glow
+    const scale = 0.94 + b * 0.12; // subtle: brighter ties read slightly larger
+    const isSprout = b <= 0.24;
+    return { shadowRadius, shadowOpacity, elevation, scale, isSprout };
+}
+//# sourceMappingURL=palette.js.map

package/dist/cjs/palette.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"palette.js","sourceRoot":"","sources":["../../src/palette.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,EAAE;AACF,qGAAqG;AACrG,gGAAgG;AAChG,kGAAkG;AAClG,sGAAsG;AACtG,oGAAoG;AACpG,oGAAoG;AACpG,EAAE;AACF,mGAAmG;AACnG,4CAA4C;;;AAsC5C,gCAEC;AAgCD,kDAUC;AAtED;;;;;;;;;;GAUG;AACU,QAAA,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,SAAgB,UAAU,CAAC,IAAiB;IAC1C,OAAO,mBAAW,CAAC,IAAI,CAAC,IAAI,mBAAW,CAAC,KAAK,CAAC;AAChD,CAAC;AAuBD;;;;;;;;GAQG;AACH,SAAgB,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,oGAAoG;IACpG,MAAM,YAAY,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,oCAAoC;IACjF,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,oCAAoC;IAC3E,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,+CAA+C;IACzF,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,6CAA6C;IAC5E,MAAM,QAAQ,GAAG,CAAC,IAAI,IAAI,CAAC;IAC3B,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AACrE,CAAC"}

package/dist/esm/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/esm/components/CommunityWeather.js

@@ -0,0 +1,89 @@
+import { jsx as _jsx, jsxs as _jsxs } from "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.
+import React from "react";
+import { View, Text, StyleSheet } from "react-native";
+import Svg, { Defs, RadialGradient, Stop, Circle } from "react-native-svg";
+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",
+};
+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>
+ * ```
+ */
+export function CommunityWeather({ style }) {
+    const { weather } = useSocialWeather();
+    // react-native-svg references gradients by id; strip the colons React.useId emits so `url(#id)` is valid.
+    const gid = `cw-${React.useId().replace(/:/g, "")}`;
+    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(View, { style: [styles.chip, style], accessibilityRole: "image", accessibilityLabel: `Community weather: ${caption.toLowerCase()}`, children: [_jsx(View, { style: [
+                    styles.orbWrap,
+                    {
+                        shadowColor: colors.glow,
+                        shadowRadius: forming ? 10 : 18,
+                        elevation: forming ? 4 : 8,
+                        opacity: forming ? 0.8 : 1,
+                    },
+                ], children: _jsxs(Svg, { width: ORB, height: ORB, children: [_jsx(Defs, { children: _jsxs(RadialGradient, { id: gid, cx: "35%", cy: "30%", r: "70%", children: [_jsx(Stop, { offset: "0%", stopColor: colors.core, stopOpacity: 1 }), _jsx(Stop, { offset: "100%", stopColor: colors.core, stopOpacity: 0.2 })] }) }), _jsx(Circle, { cx: ORB / 2, cy: ORB / 2, r: ORB / 2, fill: `url(#${gid})` })] }) }), _jsx(Text, { style: [styles.caption, { color: colors.core }], children: caption }), trendArrow && (_jsx(Text, { style: [styles.trend, { color: colors.core }], accessibilityElementsHidden: true, children: trendArrow }))] }));
+}
+const styles = 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/esm/components/CommunityWeather.js.map

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

package/dist/esm/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/esm/components/Constellation.js

@@ -0,0 +1,61 @@
+import { jsx as _jsx, jsxs as _jsxs } from "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).
+import React, { useEffect, useMemo, useState } from "react";
+import Svg, { Defs, RadialGradient, Stop, Circle, Rect } from "react-native-svg";
+import { useSocialConstellation } from "@agora-sdk/social-core";
+import { bandColors } from "../palette.js";
+import { computePositions } from "../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} />
+ * ```
+ */
+export function Constellation({ width = 360, height = 240, }) {
+    const { constellation } = useSocialConstellation();
+    // react-native-svg references gradients by id; strip the colons React.useId emits so `url(#id)` is valid.
+    const gid = `cn-${React.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] = useState(() => blobs ? computePositions(blobs, width, height) : []);
+    useEffect(() => {
+        if (blobs)
+            setNodes(computePositions(blobs, width, height));
+    }, [blobs, width, height]);
+    // One gradient per band actually present — 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, { width: width, height: height, accessibilityRole: "image", accessibilityLabel: "Community constellation: still forming", children: [_jsx(Defs, { children: _jsxs(RadialGradient, { id: `${gid}-nebula`, cx: "50%", cy: "50%", r: "60%", children: [_jsx(Stop, { offset: "0%", stopColor: "#8a94a6", stopOpacity: 0.3 }), _jsx(Stop, { offset: "100%", stopColor: "#8a94a6", stopOpacity: 0 })] }) }), _jsx(Rect, { x: 0, y: 0, width: width, height: height, fill: `url(#${gid}-nebula)` })] }));
+    }
+    return (_jsxs(Svg, { width: width, height: height, accessibilityRole: "image", accessibilityLabel: "Community constellation", children: [_jsx(Defs, { children: bandsPresent.map((band) => {
+                    const colors = bandColors(band);
+                    return (_jsxs(RadialGradient, { id: `${gid}-${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));
+                }) }), nodes.map((n, i) => (_jsx(Circle, { cx: n.x, cy: n.y, r: n.r, fill: `url(#${gid}-${n.warmth})` }, 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":";AAAA,wGAAwG;AACxG,EAAE;AACF,qGAAqG;AACrG,iDAAiD;AACjD,qGAAqG;AACrG,8FAA8F;AAC9F,sFAAsF;AACtF,qGAAqG;AACrG,uGAAuG;AACvG,EAAE;AACF,qGAAqG;AACrG,+FAA+F;AAC/F,mDAAmD;AAEnD,OAAO,KAAK,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC5D,OAAO,GAAG,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAiB,MAAM,cAAc,CAAC;AAU/D;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,aAAa,CAAC,EAC5B,KAAK,GAAG,GAAG,EACX,MAAM,GAAG,GAAG,GACO;IACnB,MAAM,EAAE,aAAa,EAAE,GAAG,sBAAsB,EAAE,CAAC;IACnD,0GAA0G;IAC1G,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;IAEpD,MAAM,KAAK,GAAG,aAAa,EAAE,KAAK,IAAI,IAAI,CAAC;IAE3C,oGAAoG;IACpG,mGAAmG;IACnG,+FAA+F;IAC/F,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAa,GAAG,EAAE,CAClD,KAAK,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CACpD,CAAC;IACF,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,KAAK;YAAE,QAAQ,CAAC,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9D,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IAE3B,4EAA4E;IAC5E,MAAM,YAAY,GAAG,OAAO,CAC1B,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAC7D,CAAC,KAAK,CAAC,CACR,CAAC;IAEF,IAAI,CAAC,aAAa;QAAE,OAAO,IAAI,CAAC;IAEhC,iEAAiE;IACjE,IAAI,aAAa,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QAChC,OAAO,CACL,MAAC,GAAG,IAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAC,OAAO,EAAC,kBAAkB,EAAC,wCAAwC,aACtH,KAAC,IAAI,cACH,MAAC,cAAc,IAAC,EAAE,EAAE,GAAG,GAAG,SAAS,EAAE,EAAE,EAAC,KAAK,EAAC,EAAE,EAAC,KAAK,EAAC,CAAC,EAAC,KAAK,aAC5D,KAAC,IAAI,IAAC,MAAM,EAAC,IAAI,EAAC,SAAS,EAAC,SAAS,EAAC,WAAW,EAAE,GAAG,GAAI,EAC1D,KAAC,IAAI,IAAC,MAAM,EAAC,MAAM,EAAC,SAAS,EAAC,SAAS,EAAC,WAAW,EAAE,CAAC,GAAI,IAC3C,GACZ,EACP,KAAC,IAAI,IAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAI,IAC3E,CACP,CAAC;IACJ,CAAC;IAED,OAAO,CACL,MAAC,GAAG,IAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAC,OAAO,EAAC,kBAAkB,EAAC,yBAAyB,aACvG,KAAC,IAAI,cACF,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;oBACzB,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;oBAChC,OAAO,CACL,MAAC,cAAc,IAAY,EAAE,EAAE,GAAG,GAAG,IAAI,IAAI,EAAE,EAAE,EAAE,EAAC,KAAK,EAAC,EAAE,EAAC,KAAK,EAAC,CAAC,EAAC,KAAK,aACxE,KAAC,IAAI,IAAC,MAAM,EAAC,IAAI,EAAC,SAAS,EAAE,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,GAAI,EAC9D,KAAC,IAAI,IAAC,MAAM,EAAC,MAAM,EAAC,SAAS,EAAE,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC,GAAI,KAF3C,IAAI,CAGR,CAClB,CAAC;gBACJ,CAAC,CAAC,GACG,EACN,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CACnB,KAAC,MAAM,IAAS,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC,CAAC,MAAM,GAAG,IAA7D,CAAC,CAAgE,CAC/E,CAAC,IACE,CACP,CAAC;AACJ,CAAC"}

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 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;