@flamingo-stack/openframe-frontend-core 0.0.720 → 0.0.722

package/dist/components/help-center-pages/download-apps-page.d.ts

@@ -0,0 +1,68 @@
+/**
+ * `<DownloadAppsPage>`: every way to install OpenFrame, on one page.
+ *
+ *   - The desktop app: every system at once, one card each (a download page
+ *     lists its platforms; it does not hide them behind tabs, so nothing moves
+ *     when a visitor looks for another system). In a card the installer is THE
+ *     action (the other architecture is a quieter button) and each package
+ *     manager is one line under it, with its copy button.
+ *   - The mobile app: the store badges, and the install QR code beside them. The
+ *     code and the address it encodes are the server's (`mobile.install`): the
+ *     website's install link, which the server answers with a redirect to the
+ *     phone's store. This page redirects nobody, and with no install link from
+ *     the server it draws no code.
+ *   - `web`: the way in for someone who installs nothing (the website's trial
+ *     signup). The host names the words and the button; the page draws the card,
+ *     in the frame of every other card on it.
+ *
+ * DATA: all of it is the server's answer (`DownloadsPublic`), read by
+ * `useDownloads` against `endpoint` (default `DOWNLOADS_API_PATH`; embedders
+ * pass their `/content` proxy path), the one request every download button on
+ * the page shares. `initialData` (hub SSR) is the answer, with no fetch. The
+ * lib holds no link of its own and no fallback: the page ADAPTS, so a system
+ * with no installer and no command has no card, a store with no listing has no
+ * badge, and a section with nothing to offer is not drawn.
+ *
+ * A HOST DECIDES `showDesktop`: the website shows the desktop app only to a
+ * visitor whose main action is the download; the desktop shell hides it (it is
+ * the app already running).
+ *
+ * The chrome is the canonical `PageShell` + frozen `PageLayout`.
+ */
+import type { ReactNode } from 'react';
+import { type DownloadActionEvent, type DownloadsPublic } from '../../types/downloads';
+export interface DownloadAppsPageProps {
+    /** GET endpoint for the public projection. Default `DOWNLOADS_API_PATH`. */
+    endpoint?: string;
+    /** Optional SSR hydrate (hub server-read): skips the initial client fetch. */
+    initialData?: DownloadsPublic;
+    /** Render the standalone `<PageShell>`. Default true. Pass false when the host
+     *  layout already provides the page container (e.g. openframe-frontend). */
+    shell?: boolean;
+    /** Back-button config. Default: none. */
+    backButton?: {
+        label?: string;
+        href?: string;
+    } | false;
+    /** Page title. Default by what is offered (`DOWNLOADS_TITLE` / `DOWNLOADS_MOBILE_TITLE`). */
+    title?: string;
+    /** Page subtitle. Default by what is offered. */
+    subtitle?: string;
+    /** Offer the desktop app. Default true. False: the mobile app only. */
+    showDesktop?: boolean;
+    /** Open the store listings in a new tab. Default true. */
+    openStoresInNewTab?: boolean;
+    /** Called when a visitor downloads an installer or copies an install command (the host's analytics). */
+    onDownloadAction?: (event: DownloadActionEvent) => void;
+    /** The closing card, under the mobile app: using OpenFrame without installing anything. Default: none. */
+    web?: DownloadAppsWebOption;
+}
+/** The "no install" card: the host's words and its own button (the page holds no signup link). */
+export interface DownloadAppsWebOption {
+    title: string;
+    description: string;
+    /** The host's button (the website's trial signup). */
+    action: ReactNode;
+}
+export declare function DownloadAppsPage({ endpoint, initialData, shell, backButton, title, subtitle, showDesktop, openStoresInNewTab, onDownloadAction, web, }: DownloadAppsPageProps): import("react").JSX.Element;
+//# sourceMappingURL=download-apps-page.d.ts.map

package/dist/components/help-center-pages/download-apps-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download-apps-page.d.ts","sourceRoot":"","sources":["../../../src/components/help-center-pages/download-apps-page.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EAAiB,SAAS,EAAE,MAAM,OAAO,CAAC;AAItD,OAAO,EASL,KAAK,mBAAmB,EACxB,KAAK,eAAe,EAErB,MAAM,uBAAuB,CAAC;AAgB/B,MAAM,WAAW,qBAAqB;IACpC,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B;gFAC4E;IAC5E,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,yCAAyC;IACzC,UAAU,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,KAAK,CAAC;IACvD,6FAA6F;IAC7F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,0DAA0D;IAC1D,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,wGAAwG;IACxG,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACxD,0GAA0G;IAC1G,GAAG,CAAC,EAAE,qBAAqB,CAAC;CAC7B;AAED,kGAAkG;AAClG,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,MAAM,EAAE,SAAS,CAAC;CACnB;AAgLD,wBAAgB,gBAAgB,CAAC,EAC/B,QAA6B,EAC7B,WAAW,EACX,KAAY,EACZ,UAAkB,EAClB,KAAK,EACL,QAAQ,EACR,WAAkB,EAClB,kBAAyB,EACzB,gBAAgB,EAChB,GAAG,GACJ,EAAE,qBAAqB,+BAmFvB"}