@fairmint/ui 0.2.31 → 0.2.33

package/dist/components/specific/EquityRibbonChart/EquityRibbonChart.d.ts

@@ -0,0 +1,41 @@
+import { CSSProperties } from 'react';
+import { RibbonLayout } from './ribbonGeometry';
+import { RibbonBackground, RibbonGradientStop } from './ribbonTheme';
+export type { RibbonBackground, RibbonGradientStop };
+export interface EquityRibbonChartProps {
+    /** Band labels, bottom to top visually (Cap Table → Liquidity). */
+    labels?: readonly string[];
+    /** How many stacked ribbons to draw (1 = bottom band only, 5 = full stack). @default 5 */
+    bandCount?: number;
+    /** Per-band gradient stops (`start` / `end` hex). Defaults to brand purple stack. */
+    gradients?: readonly RibbonGradientStop[];
+    /** Play left-to-right reveal + label fade-in. @default true */
+    animated?: boolean;
+    /** Hide labels. @default false */
+    hideLabels?: boolean;
+    /** Canvas behind ribbons. @default 'transparent' */
+    background?: RibbonBackground;
+    /**
+     * Color of the 2px seam between ribbons (SVG stroke).
+     * Defaults to the `background` surface; when `background` is `transparent`, defaults to `ribbonChartSurface.black`.
+     */
+    gapColor?: string;
+    /** `hero` = wide marketing chart; `mark` = tight fill for square icon. @default 'hero' */
+    layout?: RibbonLayout;
+    /** Label text color (CSS color). @default ribbonChartLabelDefault */
+    labelColor?: string;
+    /** Root element class. */
+    className?: string;
+    /** Override chart height (CSS length). */
+    height?: string;
+    /**
+     * Chart width in pixels (sets root `width`, same idea as `height`).
+     * Clamped up to the rendered height when needed; wider charts increase right-edge stagger between ribbons.
+     * Omit to fill the parent (`width: 100%`).
+     */
+    chartWidth?: number;
+    /** Passed to root for layout wrappers. */
+    style?: CSSProperties;
+}
+export declare function EquityRibbonChart({ labels, bandCount: bandCountProp, gradients, animated, hideLabels, background, gapColor, layout, labelColor, className, height, chartWidth, style, }: EquityRibbonChartProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=EquityRibbonChart.d.ts.map

package/dist/components/specific/EquityRibbonChart/EquityRibbonChart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EquityRibbonChart.d.ts","sourceRoot":"","sources":["../../../../src/components/specific/EquityRibbonChart/EquityRibbonChart.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAOnB,MAAM,OAAO,CAAC;AACf,OAAO,yBAAyB,CAAC;AACjC,OAAO,EAWL,KAAK,YAAY,EAGlB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EAGxB,MAAM,eAAe,CAAC;AAUvB,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,CAAC;AAErD,MAAM,WAAW,sBAAsB;IACrC,mEAAmE;IACnE,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,0FAA0F;IAC1F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qFAAqF;IACrF,SAAS,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC1C,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kCAAkC;IAClC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oDAAoD;IACpD,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0FAA0F;IAC1F,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AA8BD,wBAAgB,iBAAiB,CAAC,EAChC,MAA8B,EAC9B,SAAS,EAAE,aAAiB,EAC5B,SAAS,EACT,QAAe,EACf,UAAkB,EAClB,UAA0B,EAC1B,QAAQ,EACR,MAAe,EACf,UAAoC,EACpC,SAAS,EACT,MAAM,EACN,UAAU,EACV,KAAK,GACN,EAAE,sBAAsB,2CA0RxB"}

package/dist/components/specific/EquityRibbonChart/FairmintRibbonMark.d.ts

@@ -0,0 +1,25 @@
+import { CSSProperties } from 'react';
+import { EquityRibbonChartProps } from './EquityRibbonChart';
+import { RibbonBackground } from './ribbonTheme';
+export interface FairmintRibbonMarkProps {
+    /** Square size in pixels. @default 64 */
+    size?: number;
+    /** Ribbons to include (1–5). @default 5 */
+    bandCount?: EquityRibbonChartProps["bandCount"];
+    /** Custom gradient stops per band. */
+    gradients?: EquityRibbonChartProps["gradients"];
+    /** Canvas behind ribbons. @default 'black' */
+    background?: RibbonBackground;
+    /** Seam color between ribbons; use `transparent` to hide strokes on transparent backgrounds. */
+    gapColor?: EquityRibbonChartProps["gapColor"];
+    /** Label text color when labels are shown. @default ribbonChartLabelDefault */
+    labelColor?: EquityRibbonChartProps["labelColor"];
+    /** Additional class name. */
+    className?: string;
+    style?: CSSProperties;
+}
+/**
+ * Square brand mark — stacked ribbons without labels (favicon / app icon source).
+ */
+export declare function FairmintRibbonMark({ size, bandCount, gradients, background, gapColor, labelColor, className, style, }: FairmintRibbonMarkProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=FairmintRibbonMark.d.ts.map

package/dist/components/specific/EquityRibbonChart/FairmintRibbonMark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FairmintRibbonMark.d.ts","sourceRoot":"","sources":["../../../../src/components/specific/EquityRibbonChart/FairmintRibbonMark.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,EAAqB,KAAK,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,MAAM,WAAW,uBAAuB;IACtC,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,SAAS,CAAC,EAAE,sBAAsB,CAAC,WAAW,CAAC,CAAC;IAChD,sCAAsC;IACtC,SAAS,CAAC,EAAE,sBAAsB,CAAC,WAAW,CAAC,CAAC;IAChD,8CAA8C;IAC9C,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,gGAAgG;IAChG,QAAQ,CAAC,EAAE,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAC9C,+EAA+E;IAC/E,UAAU,CAAC,EAAE,sBAAsB,CAAC,YAAY,CAAC,CAAC;IAClD,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,IAAS,EACT,SAAa,EACb,SAAS,EACT,UAAoB,EACpB,QAAQ,EACR,UAAU,EACV,SAAS,EACT,KAAK,GACN,EAAE,uBAAuB,2CAkBzB"}

package/dist/components/specific/EquityRibbonChart/index.d.ts

@@ -0,0 +1,9 @@
+export type { EquityRibbonChartProps, RibbonGradientStop } from './EquityRibbonChart';
+export { EquityRibbonChart } from './EquityRibbonChart';
+export type { FairmintRibbonMarkProps } from './FairmintRibbonMark';
+export { FairmintRibbonMark } from './FairmintRibbonMark';
+export type { RibbonLayout } from './ribbonGeometry';
+export { clampBandCount, DEFAULT_RIBBON_CONFIG, MARK_RIBBON_CONFIG, MARK_RIBBON_RIGHT_EDGE, transformPathD, } from './ribbonGeometry';
+export type { RibbonBackground } from './ribbonTheme';
+export { DEFAULT_RIBBON_LABELS, RIBBON_BACKGROUND_CLASS, RIBBON_BAND_GRADIENTS, } from './ribbonTheme';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/specific/EquityRibbonChart/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/specific/EquityRibbonChart/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACtF,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,eAAe,CAAC"}

package/dist/components/specific/EquityRibbonChart/ribbonGeometry.d.ts

@@ -0,0 +1,73 @@
+/** Stacked exponential ribbon chart — geometry ported from preview-journey prototype. */
+export interface RibbonGeometryConfig {
+    baseline: number;
+    xEndStagger: number;
+    xEndDraw: readonly number[];
+    xEndCurve: number;
+    xStart: readonly number[];
+    kArr: readonly number[];
+    V: readonly number[];
+    vMin: readonly number[];
+    xStem: readonly number[];
+    labelX: readonly number[];
+    labelAboveGap: readonly number[];
+    labelLeftGap: number;
+    labelLiquidityGap: number;
+    labelNudge: readonly [number, number][];
+    samples: number;
+}
+export declare const DEFAULT_RIBBON_CONFIG: RibbonGeometryConfig;
+/** Right edge for mark / square charts: all ribbons align on this vertical line. */
+export declare const MARK_RIBBON_RIGHT_EDGE = 0.936;
+/**
+ * Stagger scale: `int_px = (chartWidth - height) * RIBBON_END_STAGGER_X` when chartWidth > height.
+ * Calibrated at W=1000, H=500: int_px = 0.009 × 1000 ⇒ X = 9 / 500 = 0.018.
+ */
+export declare const RIBBON_END_STAGGER_X: number;
+/**
+ * Horizontal scale factor for mark fit (mark layout only).
+ * < 1 compresses width so the stack reads square in a 1:1 viewport.
+ */
+export declare const MARK_FIT_HORIZONTAL_COMPRESS = 0.78;
+/** Tighter geometry so the mark fills a square icon. */
+export declare const MARK_RIBBON_CONFIG: RibbonGeometryConfig;
+export type RibbonLayout = "hero" | "mark";
+export type RibbonLabelPlacement = "start";
+/** Scale and translate path `d` (M/L commands only, as produced by buildBandPath). */
+export declare function transformPathD(d: string, scaleX: number, scaleY: number, tx: number, ty: number): string;
+export interface BuiltRibbonLabel {
+    index: number;
+    text: string;
+    leftPct: number;
+    topPct: number;
+    placement: RibbonLabelPlacement;
+}
+export interface RibbonGeometryResult {
+    paths: string[];
+    clipWidthPx: number[];
+    labels: BuiltRibbonLabel[];
+    width: number;
+    height: number;
+    bandCount: number;
+}
+export declare function clampBandCount(count: number, max?: number): number;
+/**
+ * Geometry width for paths/viewBox.
+ * With `chartWidth`: at least rendered height, then respect a narrower measured width (e.g. `max-width: 100%`).
+ * Without `chartWidth`: use measured container width only.
+ */
+export declare function resolveChartGeometryWidth(containerWidth: number, containerHeight: number, chartWidth?: number): number;
+/** CSS cap for explicit `chartWidth` (never below rendered height). */
+export declare function nominalChartWidthPx(chartWidth: number, renderedHeightPx: number): number;
+/** Normalized gap between adjacent ribbon right edges (0 when square). */
+export declare function ribbonEndStaggerNorm(chartWidth: number, height: number): number;
+/** Per-band clip right edge (bottom band leftmost, top band at `rightAnchor`). */
+export declare function buildStaggeredEndDraw(bandCount: number, chartWidth: number, height: number): readonly number[];
+export declare function configWithChartDimensions(base: RibbonGeometryConfig, chartWidth: number, height: number): RibbonGeometryConfig;
+export declare function buildRibbonGeometry(width: number, height: number, labels: readonly string[], config?: RibbonGeometryConfig, bandCount?: number, layout?: RibbonLayout): RibbonGeometryResult | null;
+/** Quadratic ease-in-out (GSAP `power2.inOut` equivalent) for reveal motion. */
+export declare function easePower1InOut(t: number): number;
+export declare function easePower2Out(t: number): number;
+/** Label reveal start time (seconds) along a timeline of `duration` seconds. */
+export declare function ribbonLabelRevealTime(labelIndex: number, duration: number, config?: RibbonGeometryConfig): number;
+//# sourceMappingURL=ribbonGeometry.d.ts.map

package/dist/components/specific/EquityRibbonChart/ribbonGeometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ribbonGeometry.d.ts","sourceRoot":"","sources":["../../../../src/components/specific/EquityRibbonChart/ribbonGeometry.ts"],"names":[],"mappings":"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"}

package/dist/components/specific/EquityRibbonChart/ribbonTheme.d.ts

@@ -0,0 +1,13 @@
+import { ribbonChartLabelDefault, ribbonChartSurface } from '../../../theme/ribbonChartColors';
+export type RibbonGradientStop = {
+    start: string;
+    end: string;
+};
+export type RibbonBackground = keyof typeof ribbonChartSurface | "transparent";
+export declare const RIBBON_BACKGROUND_CLASS: Record<RibbonBackground, string>;
+export declare const DEFAULT_RIBBON_LABELS: readonly ["Cap Table", "Fundraising", "Grants", "Secondaries", "Liquidity"];
+export declare const RIBBON_BAND_GRADIENTS: readonly (RibbonGradientStop & {
+    idSuffix: string;
+})[];
+export { ribbonChartLabelDefault, ribbonChartSurface };
+//# sourceMappingURL=ribbonTheme.d.ts.map

package/dist/components/specific/EquityRibbonChart/ribbonTheme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ribbonTheme.d.ts","sourceRoot":"","sources":["../../../../src/components/specific/EquityRibbonChart/ribbonTheme.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,uBAAuB,EACvB,kBAAkB,EACnB,MAAM,kCAAkC,CAAC;AAE1C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,kBAAkB,GAAG,aAAa,CAAC;AAE/E,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAIpE,CAAC;AAEF,eAAO,MAAM,qBAAqB,6EAMxB,CAAC;AAEX,eAAO,MAAM,qBAAqB,EAAE,SAAS,CAAC,kBAAkB,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,EAC/D,CAAC;AAE1B,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,CAAC"}