@stealthscale/sdk-host 0.1.0

package/dist/page-7ScZC_LI.js

@@ -0,0 +1,62 @@
+import { t as pluginWordsOf } from "./words-yI-WdYM3.js";
+import { targetKeyOf } from "@stealthscale/sdk-core";
+import { Slot, useResolvedProduct } from "@stealthscale/sdk-plugin";
+import { EmptyState } from "@stealthscale/component-feedback";
+import { Outlet, useChildMatches } from "@stealthscale/provider-router";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useTranslation } from "@stealthscale/provider-i18n";
+import { Stack } from "@stealthscale/component-layout";
+import { Heading } from "@stealthscale/component-typography";
+//#region src/standalone/page.tsx
+/**
+* The props a slot without a sample renders with.
+*/
+const NONE = {};
+/**
+* Returns the values a slot renders with: each value the extensions placed in a keyed slot match,
+* and no value for a slot that is not keyed.
+*/
+function matchesOf(slot, extensions) {
+	if (slot.keyed !== true) return [void 0];
+	const target = targetKeyOf(slot);
+	return [...new Set(extensions.filter((one) => one.target === target).map(({ match }) => match))];
+}
+/**
+* Returns the component of the placeholder page of one route.
+*
+* @remarks
+*   The page names the route and states that its plugin is installed from its contract alone. Where
+*   the address matches a child route, the child's page renders in the route's outlet.
+*   Otherwise each slot of the contract renders under a heading that names the slot, with the
+*   slot's sample props, and a keyed slot renders once per value the extensions placed in it match.
+* @param routeId - Qualified id of the route.
+* @param contract - The contract of the route's plugin.
+*/
+function placeholderPageOf(routeId, contract) {
+	const slots = Object.values(contract.slots);
+	/**
+	* Renders the page in its plugin's scope.
+	*/
+	return function PlaceholderPage() {
+		const { i18n, t } = useTranslation("host");
+		const { extensions } = useResolvedProduct();
+		const nested = useChildMatches().length > 0;
+		const plugin = pluginWordsOf(i18n).t(contract.pluginId, "plugin.name");
+		return /* @__PURE__ */ jsxs(Stack, { children: [/* @__PURE__ */ jsx(EmptyState.Root, { children: /* @__PURE__ */ jsxs(EmptyState.Content, { children: [/* @__PURE__ */ jsx(EmptyState.Title, {
+			as: "h1",
+			children: routeId
+		}), /* @__PURE__ */ jsx(EmptyState.Description, { children: t("standalone.page", { plugin }) })] }) }), nested ? /* @__PURE__ */ jsx(Outlet, {}) : slots.map((slot) => /* @__PURE__ */ jsxs(Stack, {
+			as: "section",
+			children: [/* @__PURE__ */ jsx(Heading, {
+				as: "h2",
+				children: slot.id
+			}), matchesOf(slot, extensions).map((match) => /* @__PURE__ */ jsx(Slot, {
+				match,
+				props: slot.sample ?? NONE,
+				slot
+			}, match ?? ""))]
+		}, slot.id))] });
+	};
+}
+//#endregion
+export { placeholderPageOf };

package/dist/section-CtcVFcBK.js

@@ -0,0 +1,41 @@
+import { t as pluginWordsOf } from "./words-yI-WdYM3.js";
+import { pluginOf } from "@stealthscale/sdk-core";
+import { c } from "react/compiler-runtime";
+import { jsx } from "react/jsx-runtime";
+import { useTranslation } from "@stealthscale/provider-i18n";
+import { Text } from "@stealthscale/component-typography";
+//#region src/standalone/section.tsx
+/**
+* Renders a sentence that names the section's plugin and states that it is installed from its
+* contract alone.
+*/
+function PlaceholderSection(t0) {
+	const $ = c(8);
+	const { sectionId } = t0;
+	const { i18n, t } = useTranslation("host");
+	let T0;
+	let t1;
+	if ($[0] !== i18n || $[1] !== sectionId || $[2] !== t) {
+		const plugin = pluginWordsOf(i18n).t(pluginOf(sectionId), "plugin.name");
+		T0 = Text;
+		t1 = t("standalone.section", { plugin });
+		$[0] = i18n;
+		$[1] = sectionId;
+		$[2] = t;
+		$[3] = T0;
+		$[4] = t1;
+	} else {
+		T0 = $[3];
+		t1 = $[4];
+	}
+	let t2;
+	if ($[5] !== T0 || $[6] !== t1) {
+		t2 = /* @__PURE__ */ jsx(T0, { children: t1 });
+		$[5] = T0;
+		$[6] = t1;
+		$[7] = t2;
+	} else t2 = $[7];
+	return t2;
+}
+//#endregion
+export { PlaceholderSection };

package/dist/standalone/app.d.ts

@@ -0,0 +1,65 @@
+import "../standalone-XfUZYt9b.js";
+import "@stealthscale/provider-data";
+import { Product, ResolvedProduct } from "@stealthscale/sdk-core";
+import { RouteMap } from "@stealthscale/provider-router";
+import { ReactNode } from "react";
+import { Catalogues } from "@stealthscale/provider-i18n";
+import { FormGlyphs } from "@stealthscale/component-forms/form";
+import { Root } from "react-dom/client";
+//#region src/standalone/context.d.ts
+/**
+ * Lists the glyphs of the standalone page: the settings forms' glyphs, and those of the panel's
+ * stage triggers. A trigger without its glyph is left out.
+ */
+interface StandaloneGlyphs extends FormGlyphs {
+  /**
+   * Glyph of the trigger that minimizes the panel to its header.
+   */
+  readonly minimize?: ReactNode;
+  /**
+   * Glyph of the trigger that restores a minimized panel.
+   */
+  readonly restore?: ReactNode;
+}
+//#endregion
+//#region src/standalone/app.d.ts
+/**
+ * Lists what the standalone page renders with.
+ */
+export interface StandalonePageOptions {
+  /**
+   * The catalogues, from `virtual:i18n`. Every key renders as itself where left out.
+   */
+  readonly catalogues?: Catalogues | undefined;
+  /**
+   * The element the page renders into. The element with the id `root` where left out.
+   */
+  readonly element?: Element | null | undefined;
+  /**
+   * The glyphs of the settings forms and of the panel's stage triggers. None where left out.
+   */
+  readonly glyphs?: StandaloneGlyphs | undefined;
+  /**
+   * The locales the page offers, the first its fallback. American English alone where left out.
+   */
+  readonly locales?: readonly [string, ...string[]] | undefined;
+  /**
+   * The standalone product, from `virtual:product`.
+   */
+  readonly product: Product;
+  /**
+   * The themes the page offers. The page renders the first until a person picks another. The
+   * application's one theme where left out.
+   */
+  readonly themes?: readonly string[] | undefined;
+}
+/**
+ * Renders the standalone page once the host is ready.
+ *
+ * @param options - The product, the catalogues, the glyphs, the locales, the themes and the
+ *   element.
+ * @returns The React root the page renders in, which `unmount` takes down.
+ * @throws {@link Error} Where no element is given and the document has none with the id `root`.
+ */
+export declare function renderStandalone({ catalogues, element, glyphs, locales, product, themes }: StandalonePageOptions): Promise<Root>;
+//#endregion