@alfadocs/ui-kit 0.25.2 → 0.30.0

package/dist/components/public-footer/public-footer.d.ts

@@ -0,0 +1,51 @@
+import { type ReactNode } from 'react';
+import { type VariantProps } from 'class-variance-authority';
+import { type LegalUrlOverrides, type ResolvedLegalUrls } from './legal-urls';
+import { type SocialNetwork } from './socials';
+declare const rootVariants: (props?: ({
+    variant?: "compact" | "full" | "minimal" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export type PublicFooterVariant = NonNullable<VariantProps<typeof rootVariants>['variant']>;
+export interface PublicFooterLink {
+    href: string;
+    label: string;
+    /** When true, link opens in a new tab with the localised aria-label suffix. */
+    external?: boolean;
+}
+export interface PublicFooterLinkGroup {
+    /** Stable key — used to look up the column heading via `t('ui.footer.group.<key>')`. */
+    key: 'product' | 'resources' | 'company' | 'legal' | (string & {});
+    links: PublicFooterLink[];
+}
+export interface PublicFooterSocial {
+    network: SocialNetwork;
+    /** Override the kit's default URL. */
+    href?: string;
+}
+export interface PublicFooterProps {
+    variant: PublicFooterVariant;
+    /** Origin for legally-required URLs. Default: 'https://www.alfadocs.com'. */
+    marketingBaseUrl?: string;
+    /** Override individual legal-link slugs per locale. Rare. */
+    legalUrlOverrides?: LegalUrlOverrides;
+    /** `full` variant: consumer-supplied link columns. Legal column is always rendered. */
+    linkGroups?: PublicFooterLinkGroup[];
+    /** `full` variant: subset of social networks. Default: all four. Pass `[]` to hide the row. */
+    socials?: PublicFooterSocial[];
+    /** `full` variant: custom logo node. Default: kit's wordmark Logo. */
+    logoSlot?: ReactNode;
+    /** Extra surface-specific links — appended after the standard nav row in compact + full. Ignored by minimal. */
+    extraNavSlot?: ReactNode;
+    /** Trust badges (HIPAA, ISO). Rendered at the start of `minimal`'s row, or in the bottom strip of `full`. */
+    trustBadgesSlot?: ReactNode;
+    'aria-label'?: string;
+    id?: string;
+}
+export interface PublicFooterHandle {
+    getVariant: () => PublicFooterVariant;
+    /** Resolved legal URLs for the current locale + marketingBaseUrl + overrides. */
+    getLegalUrls: () => ResolvedLegalUrls;
+}
+export declare const PublicFooter: import("react").ForwardRefExoticComponent<PublicFooterProps & import("react").RefAttributes<PublicFooterHandle>>;
+export {};
+//# sourceMappingURL=public-footer.d.ts.map

package/dist/components/public-footer/socials.d.ts

@@ -0,0 +1,9 @@
+import type { ComponentType, SVGProps } from 'react';
+export declare const SOCIAL_NETWORKS: readonly ["linkedin", "youtube", "instagram", "facebook"];
+export type SocialNetwork = (typeof SOCIAL_NETWORKS)[number];
+export declare const DEFAULT_SOCIAL_URLS: Record<SocialNetwork, string>;
+type IconProps = SVGProps<SVGSVGElement>;
+type SocialIcon = ComponentType<IconProps>;
+export declare const SOCIAL_ICONS: Record<SocialNetwork, SocialIcon>;
+export {};
+//# sourceMappingURL=socials.d.ts.map

package/dist/components/reviews-panel/index.d.ts

@@ -0,0 +1,4 @@
+export { ReviewsPanel } from './reviews-panel';
+export type { ReviewsPanelProps, ReviewsPanelHandle, ReviewItem, ReviewsAggregate, ReviewFilter, } from './reviews-panel';
+export { reviewsPanelAgent } from './reviews-panel.agent';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/reviews-panel/index.js

@@ -0,0 +1,6 @@
+import { R as r, r as s } from "../../_chunks/reviews-panel-CFttsfuC.js";
+export {
+  r as ReviewsPanel,
+  s as reviewsPanelAgent
+};
+//# sourceMappingURL=index.js.map

package/dist/components/reviews-panel/reviews-panel.agent.d.ts

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { ReviewsPanelHandle } from './reviews-panel';
+export declare const reviewsPanelAgent: AgentAdapter<ReviewsPanelHandle>;
+//# sourceMappingURL=reviews-panel.agent.d.ts.map

package/dist/components/reviews-panel/reviews-panel.d.ts

@@ -0,0 +1,76 @@
+import { type ComponentPropsWithoutRef, type ReactNode } from 'react';
+export interface ReviewItem {
+    id: string;
+    /** When the review was authored (ISO 8601). */
+    authoredAt: string;
+    /** Anonymised author display ("Marco T.", "Anna_M"). Falls back to a localised "Anonymous". */
+    pseudonym?: string;
+    /** 0..max — drives the visible star summary on the compact card. */
+    overallScore: number;
+    /** Short free-text comment shown on the compact card. */
+    comment?: string;
+    /** Practice reply (revealed in the expanded panel only). */
+    reply?: string;
+    /** Optional per-axis breakdown — when present, the card grows an
+     *  "Expand" affordance that reveals these in a DescriptionList. */
+    breakdown?: {
+        appointmentScore?: number;
+        communicationScore?: number;
+        staffScore?: number;
+        overallScore?: number;
+    };
+    /** Optional categorical follow-ups, surfaced inside the breakdown. */
+    futureVisit?: 'yes' | 'no' | 'unsure';
+    recommendation?: 'yes' | 'no' | 'unsure';
+}
+export interface ReviewsAggregate {
+    /** Total review count across all star buckets (may exceed the loaded set when paginated). */
+    count: number;
+    /** Average score across the full population (drives the header `Rating`). */
+    averageScore: number;
+    /**
+     * Optional histogram — per-bucket count keyed by integer star value 1..5.
+     * When omitted, the panel derives buckets from the loaded `reviews` array
+     * (best-effort: paginated consumers SHOULD provide this explicitly).
+     */
+    histogram?: Record<1 | 2 | 3 | 4 | 5, number>;
+}
+export type ReviewFilter = 'all' | 1 | 2 | 3 | 4 | 5;
+export interface ReviewsPanelHandle {
+    getFilter: () => ReviewFilter;
+    setFilter: (next: ReviewFilter) => void;
+    /** Total visible after filter is applied. */
+    getVisibleCount: () => number;
+}
+export interface ReviewsPanelProps extends Omit<ComponentPropsWithoutRef<'section'>, 'aria-label' | 'children'> {
+    reviews: ReviewItem[];
+    aggregate: ReviewsAggregate;
+    /**
+     * Active star filter. Controlled — consumer owns it for shareability via
+     * URL query strings. Omit for uncontrolled (panel-managed) filtering.
+     */
+    filter?: ReviewFilter;
+    onFilterChange?: (next: ReviewFilter) => void;
+    /**
+     * Optional intro callout shown above the list (e.g. "Riepilogo delle
+     * opinioni — i pazienti raccontano…"). Render-prop slot so the consumer
+     * can drop in `<Alert>` / `<Callout>` / plain `<p>`.
+     */
+    introSlot?: ReactNode;
+    /** Optional header right-end action (e.g. a "Leave a review" button). */
+    headerActionSlot?: ReactNode;
+    /** Override the default region aria-label. */
+    'aria-label'?: string;
+    /** Agent-readiness id. */
+    id?: string;
+    className?: string;
+    /**
+     * Hide the filter sidebar — useful when the panel mounts under ~640px
+     * width or inside a narrow column. Defaults to false.
+     */
+    hideFilter?: boolean;
+    /** Render skeletons for the header and the list. */
+    loading?: boolean;
+}
+export declare const ReviewsPanel: import("react").ForwardRefExoticComponent<ReviewsPanelProps & import("react").RefAttributes<HTMLElement>>;
+//# sourceMappingURL=reviews-panel.d.ts.map

package/dist/components/slot-grid/index.js

@@ -1,4 +1,4 @@
-import { S as s, f as e, i as r } from "../../_chunks/slot-grid-DoodeQGZ.js";
+import { S as s, f as e, i as r } from "../../_chunks/slot-grid-B2zprPcv.js";
 export {
   s as SlotGrid,
   e as findFirstAvailable,