@riebeckite/plugin-share 0.0.21 → 0.0.23

package/README.md

@@ -1,19 +1,23 @@
 # @riebeckite/plugin-share
 
+<!-- Generated from docs/docs/plugins/share.md. Edit the canonical documentation in docs/docs/plugins and run `pnpm docs:sync`. -->
+
 Per-article share controls built at build time. For every published entry the
-plugin builds share URLs for the configured services and injects the controls
-into the rendered HTML. The links are ordinary anchors and work without
-JavaScript; only the copy-link action is a progressive enhancement.
+plugin builds share URLs for the configured services and provides the control
+data. The Site renders `<ShareControls />` itself, determining position in the
+layout. The links are ordinary anchors and work without JavaScript; only the
+copy-link action is a progressive enhancement.
 
 [日本語](./README_ja.md)
 
 ## Overview
 
 `share()` resolves each note's `permalink` to an absolute URL, composes the
-service URLs from the note title and URL, and inserts the controls near the
-article. The controls are inserted into the manifest entry's HTML, which Core
-synchronizes with the content the route renders, so they appear on generated
-pages and in feeds.
+service URLs from the note title and URL, and builds share link data. The data
+is available via `getShareLinks({ entry, site, options? })` and rendered by the
+Site using `<ShareControls links={...} />`. The controls are ordinary anchors
+and work without JavaScript; only the copy-link action is a progressive
+enhancement.
 
 Supported services:
 
@@ -27,7 +31,7 @@ Supported services:
 | `hatena` | `https://b.hatena.ne.jp/add?mode=confirm&url=…&title=…` |
 | `copy` | Copies the note URL (button, no JavaScript required for the links) |
 
-`mastodon` is opt-in: add `"mastodon"` to `services` and set
+Mastodon is opt-in: add `"mastodon"` to `services` and set
 `mastodonInstance`.
 
 ## Usage
@@ -42,22 +46,11 @@ export default defineConfig({
 });
 ```
 
-Enable Mastodon and change placement:
-
-```ts
-share({
-  services: ["x", "bluesky", "mastodon", "copy"],
-  mastodonInstance: "mastodon.social",
-  placement: "top",
-});
-```
-
 ## Options
 
 | Option | Type | Default | Description |
 | ------ | ---- | ------- | ----------- |
 | `services` | `ShareService[]` | every service except `mastodon` | Services to render, in order |
-| `placement` | `"top" \| "bottom"` | `"bottom"` | Where the controls appear |
 | `mastodonInstance` | `string` | none | Mastodon host; required when `services` includes `"mastodon"` |
 | `className` | `string` | none | Extra root class alongside the stable `rr-share` hook |
 | `ariaLabel` | `string` | `"Share"` | Accessible name for the control group |
@@ -68,35 +61,22 @@ share({
 `share` throws a configuration error at `riebeckite check` time when
 `services` includes `"mastodon"` but `mastodonInstance` is missing.
 
-## Output
-
-```html
-<div class="rr-share" data-rr-share data-rr-share-placement="bottom"
-     role="group" aria-label="Share">
-  <ul class="rr-share__list">
-    <li class="rr-share__item">
-      <a class="rr-share__link rr-share__link--x"
-         href="https://twitter.com/intent/tweet?url=…&amp;text=…"
-         target="_blank" rel="noopener noreferrer" data-share-service="x">X</a>
-    </li>
-    <li class="rr-share__item">
-      <button type="button" class="rr-share__button rr-share__copy"
-              data-rr-share-copy data-share-url="https://example.com/posts/hello"
-              data-rr-share-copied="Copied" hidden>Copy link</button>
-    </li>
-  </ul>
-  <p class="rr-share__status" role="status" aria-live="polite"></p>
-</div>
-```
+## Display
+
+Share controls are rendered at the position determined by the Site, where
+`<ShareControls links={...} />` is placed in the layout. On this site they
+appear as live controls on the page, including the progressively enhanced
+copy-link action. The Site decides whether to render controls at the top or
+bottom of the article, or at some other position.
 
-## Progressive enhancement
+Progressive enhancement:
 
 The share links are plain anchors, so they work with JavaScript disabled. The
 copy-link button starts `hidden` and is revealed by `initShare()`, which the
 app calls during page initialization; a no-JS reader never sees a control that
 cannot work. Copying uses `navigator.clipboard.writeText` and falls back to a
-hidden textarea with `document.execCommand("copy")`. The result is announced in
-the `aria-live="polite"` status region.
+hidden textarea with `document.execCommand("copy")`. The result is announced
+in the `aria-live="polite"` status region.
 
 ## Style
 
@@ -108,8 +88,8 @@ import "@riebeckite/plugin-share/style.css";
 
 The stable classes are `rr-share` (root), `rr-share__list`, `rr-share__item`,
 `rr-share__link`, `rr-share__link--{service}`, `rr-share__button`,
-`rr-share__copy`, and `rr-share__status`. A theme can target these hooks; the
-optional `className` is added to the root without replacing them.
+`rr-share__copy`, and `rr-share__status`. A theme can target these hooks;
+the optional `className` is added to the root without replacing them.
 
 ## Exports
 
@@ -127,15 +107,13 @@ optional `className` is added to the root without replacing them.
 - Constants: `SHARE_SERVICES`, `SHARE_ATTRIBUTE`, `SHARE_ROOT_CLASS`,
   `DEFAULT_SHARE_SERVICES`, `DEFAULT_SHARE_LABELS`, `DEFAULT_SHARE_PLACEMENT`
 - Types: `ShareOptions`, `ResolvedShareOptions`, `ShareService`,
-  `SharePlacement`, `ShareLink`, `ShareTarget`
+  `ShareLink`, `ShareTarget`
 
 ## Limitations
 
 - Share URLs are fixed at build time. A full rebuild always recomputes them.
 - Mastodon cannot be enabled without a concrete instance.
-- The plugin contributes controls to `article.before-content` for `top` and
-  `article.footer` for `bottom`; a Site places those semantic slots in its layout.
 
 ## See also
 
-- [Plugin guide](../../../docs/docs/reference/plugin-api.md)
+- [Plugin guide](https://github.com/Rerurate514/riebeckite/blob/main/docs/docs/reference/plugin-api.md)

package/README_ja.md

@@ -1,8 +1,11 @@
 # @riebeckite/plugin-share
 
+<!-- Generated from docs/docs/plugins/share.ja.md. Edit the canonical documentation in docs/docs/plugins and run `pnpm docs:sync`. -->
+
 記事ごとの共有ボタンをビルド時に生成するプラグインです。公開対象の各エントリ
-について、設定したサービス向けの共有 URL を組み立て、本文の近くにコントロール
-を挿入します。共有リンクは通常の `<a>` なので JavaScript なしでも動作し、コピー
+について、設定したサービス向けの共有 URL を組み立て、Share controls のデータ
+を提供します。Site が `<ShareControls links={...} />` を描画する位置をlayout で
+決定します。共有リンクは通常の `<a>` なので JavaScript なしでも動作し、コピー
 操作だけをプログレッシブ・エンハンスメントとして追加します。
 
 [English](./README.md)
@@ -10,9 +13,11 @@
 ## 仕組み
 
 `share()` は各ノートの `permalink` を絶対 URL に解決し、ノートのタイトルと URL
-からサービスごとの共有 URL を組み立て、記事の近くにコントロールを挿入します。
-挿入先はマニフェストエントリの HTML で、Core がそれをコンテンツルートの描画
-HTML と同期するため、生成ページとフィードの両方に反映されます。
+からサービスごとの共有 URL を組み立て、Share control data を組み立てます。
+データは `getShareLinks({ entry, site, options? })` で利用可能で、Site が
+`<ShareControls links={...} />` で描画します。共有リンクは通常の `<a>` なので
+JavaScript なしでも動作し、コピー操作だけをプログレッシブ・エンハンスメント
+として追加します。
 
 対応サービスは次のとおりです。
 
@@ -26,7 +31,7 @@ HTML と同期するため、生成ページとフィードの両方に反映さ
 | `hatena` | `https://b.hatena.ne.jp/add?mode=confirm&url=…&title=…` |
 | `copy` | ノートの URL をコピーするボタン（リンクは JS 不要） |
 
-`mastodon` はオプトインです。`services` に `"mastodon"` を追加し、
+Mastodon はオプトインです。`services` に `"mastodon"` を追加し、
 `mastodonInstance` を設定してください。
 
 ## 使い方
@@ -41,22 +46,11 @@ export default defineConfig({
 });
 ```
 
-Mastodon を有効にし、表示位置を変える例です。
-
-```ts
-share({
-  services: ["x", "bluesky", "mastodon", "copy"],
-  mastodonInstance: "mastodon.social",
-  placement: "top",
-});
-```
-
 ## オプション
 
 | オプション | 型 | 既定値 | 説明 |
 | ---------- | -- | ------ | ---- |
 | `services` | `ShareService[]` | `mastodon` 以外のすべて | 表示するサービス（順序どおり） |
-| `placement` | `"top" \| "bottom"` | `"bottom"` | コントロールの表示位置 |
 | `mastodonInstance` | `string` | なし | Mastodon のホスト。`services` に `"mastodon"` を含めると必須 |
 | `className` | `string` | なし | 安定した `rr-share` フックに追加するルートクラス |
 | `ariaLabel` | `string` | `"Share"` | コントロールグループのアクセシブル名 |
@@ -67,26 +61,13 @@ share({
 `services` に `"mastodon"` を含めたのに `mastodonInstance` が未設定の場合、
 `riebeckite check` の時点で設定エラーになります。
 
-## 出力
-
-```html
-<div class="rr-share" data-rr-share data-rr-share-placement="bottom"
-     role="group" aria-label="Share">
-  <ul class="rr-share__list">
-    <li class="rr-share__item">
-      <a class="rr-share__link rr-share__link--x"
-         href="https://twitter.com/intent/tweet?url=…&amp;text=…"
-         target="_blank" rel="noopener noreferrer" data-share-service="x">X</a>
-    </li>
-    <li class="rr-share__item">
-      <button type="button" class="rr-share__button rr-share__copy"
-              data-rr-share-copy data-share-url="https://example.com/posts/hello"
-              data-rr-share-copied="Copied" hidden>Copy link</button>
-    </li>
-  </ul>
-  <p class="rr-share__status" role="status" aria-live="polite"></p>
-</div>
-```
+## 表示
+
+共有コントロールは、Site が layout で `<ShareControls links={...} />` を
+描画する位置に実際に描画されます。このサイトでは、プログレッシブ・エンハンス
+メントされたリンクコピー操作を含むコントロールとして表示します。Site は
+コントロールを記事のトップやボトム、またはその他の位置に描画するかどうかを
+決定します。
 
 ## プログレッシブ・エンハンスメント
 
@@ -127,15 +108,13 @@ import "@riebeckite/plugin-share/style.css";
 - 定数: `SHARE_SERVICES`, `SHARE_ATTRIBUTE`, `SHARE_ROOT_CLASS`,
   `DEFAULT_SHARE_SERVICES`, `DEFAULT_SHARE_LABELS`, `DEFAULT_SHARE_PLACEMENT`
 - 型: `ShareOptions`, `ResolvedShareOptions`, `ShareService`,
-  `SharePlacement`, `ShareLink`, `ShareTarget`
+  `ShareLink`, `ShareTarget`
 
 ## 制約
 
 - 共有 URL はビルド時に確定します。再ビルドすれば常に正しく再計算されます。
 - Mastodon は具体的なインスタンスなしには有効化できません。
-- `top` は `article.before-content`、`bottom` は `article.footer` にコントロールを
-  提供します。Site は layout でその semantic slot を配置します。
 
 ## 関連
 
-- [プラグインガイド](../../../docs/docs/reference/plugin-api.ja.md)
+- [プラグインガイド](https://github.com/Rerurate514/riebeckite/blob/main/docs/docs/reference/plugin-api.ja.md)

package/dist/components/share-controls.d.ts

@@ -0,0 +1,12 @@
+import type { ShareLink } from "../src/types.js";
+export type ShareControlsProps = {
+    readonly links: readonly ShareLink[];
+    readonly copyUrl?: string;
+    readonly ariaLabel?: string;
+    readonly className?: string;
+    readonly copyLabel?: string;
+    readonly copiedLabel?: string;
+    readonly copyFailedLabel?: string;
+};
+declare const ShareControls: ({ links, copyUrl, ariaLabel, className, copyLabel, copiedLabel, copyFailedLabel, }: Readonly<ShareControlsProps>) => import("hono/jsx/jsx-dev-runtime").JSX.Element;
+export default ShareControls;

package/dist/components/share-controls.js

@@ -0,0 +1,47 @@
+// components/share-controls.tsx
+import { jsx, jsxs } from "hono/jsx/jsx-runtime";
+var ShareControls = (({
+  links,
+  copyUrl,
+  ariaLabel = "Share",
+  className = "rr-share",
+  copyLabel = "Copy link",
+  copiedLabel = "Copied",
+  copyFailedLabel = "Copy failed"
+}) => {
+  if (links.length === 0 && !copyUrl) return null;
+  const rootClass = className === "rr-share" ? className : `rr-share ${className}`;
+  return /* @__PURE__ */ jsxs("nav", { class: rootClass, "data-rr-share": true, "aria-label": ariaLabel, children: [
+    /* @__PURE__ */ jsxs("ul", { class: "rr-share__list", children: [
+      links.map((link) => /* @__PURE__ */ jsx("li", { class: "rr-share__item", children: /* @__PURE__ */ jsx(
+        "a",
+        {
+          class: `rr-share__link rr-share__link--${link.service}`,
+          href: link.url,
+          target: "_blank",
+          rel: "noopener noreferrer",
+          "data-share-service": link.service,
+          children: link.label
+        }
+      ) }, link.service)),
+      copyUrl ? /* @__PURE__ */ jsx("li", { class: "rr-share__item", children: /* @__PURE__ */ jsx(
+        "button",
+        {
+          type: "button",
+          class: "rr-share__button rr-share__copy",
+          "data-rr-share-copy": true,
+          "data-share-url": copyUrl,
+          "data-rr-share-copied": copiedLabel,
+          "data-rr-share-copy-failed": copyFailedLabel,
+          hidden: true,
+          children: copyLabel
+        }
+      ) }) : null
+    ] }),
+    /* @__PURE__ */ jsx("p", { class: "rr-share__status", role: "status", "aria-live": "polite" })
+  ] });
+});
+var share_controls_default = ShareControls;
+export {
+  share_controls_default as default
+};

package/dist/index.d.ts

@@ -1,10 +1,27 @@
+import { type PluginDataHelper, type PublicContentEntry, type ResolvedRiebeckiteConfig } from "@riebeckite/core";
 import type { ShareOptions } from "./src/types.js";
+export type { ShareControlsProps } from "./components/share-controls.js";
+export { default as ShareControls } from "./components/share-controls.js";
 export { initShare } from "./src/client.js";
-export { DEFAULT_SHARE_ARIA_LABEL, DEFAULT_SHARE_COPIED_LABEL, DEFAULT_SHARE_COPY_FAILED_LABEL, DEFAULT_SHARE_LABELS, DEFAULT_SHARE_PLACEMENT, DEFAULT_SHARE_SERVICES, resolveShareOptions, validateShareOptions, } from "./src/options.js";
+export { DEFAULT_SHARE_ARIA_LABEL, DEFAULT_SHARE_COPIED_LABEL, DEFAULT_SHARE_COPY_FAILED_LABEL, DEFAULT_SHARE_LABELS, DEFAULT_SHARE_SERVICES, resolveShareOptions, validateShareOptions, } from "./src/options.js";
 export { renderShareControls, SHARE_ATTRIBUTE, SHARE_ROOT_CLASS, } from "./src/render.js";
 export { buildAbsoluteUrl, buildShareLinks, buildShareUrl, normalizeMastodonInstance, type ShareTarget, } from "./src/services.js";
-export type { ResolvedShareOptions, ShareLink, ShareOptions, SharePlacement, ShareService, } from "./src/types.js";
+export type { ResolvedShareOptions, ShareLink, ShareOptions, ShareService, } from "./src/types.js";
 export { SHARE_SERVICES } from "./src/types.js";
+export type ShareLinksData = {
+    readonly links: readonly import("./src/types.js").ShareLink[];
+    readonly copyUrl?: string;
+    readonly ariaLabel: string;
+    readonly className: string;
+    readonly copyLabel: string;
+    readonly copiedLabel: string;
+    readonly copyFailedLabel: string;
+};
+export declare const getShareLinks: PluginDataHelper<{
+    entry: PublicContentEntry;
+    site: Pick<ResolvedRiebeckiteConfig, "site">;
+    options?: ShareOptions;
+}, ShareLinksData>;
 export declare const SHARE_PLUGIN_NAME = "share";
 /**
  * Per-article share controls.

package/dist/index.js

@@ -1,6 +1,5 @@
 // index.ts
 import {
-  appendContentBodySlot,
   createClientEntry,
   createStyleAsset,
   definePlugin
@@ -89,14 +88,12 @@ var DEFAULT_SHARE_LABELS = {
   hatena: "Hatena Bookmark",
   copy: "Copy link"
 };
-var DEFAULT_SHARE_PLACEMENT = "bottom";
 var DEFAULT_SHARE_ARIA_LABEL = "Share";
 var DEFAULT_SHARE_COPIED_LABEL = "Copied";
 var DEFAULT_SHARE_COPY_FAILED_LABEL = "Copy failed";
 function resolveShareOptions(options = {}) {
   return {
     services: normalizeServices(options.services),
-    placement: options.placement === "top" ? "top" : DEFAULT_SHARE_PLACEMENT,
     mastodonInstance: normalizeMastodonInstance(options.mastodonInstance),
     className: normalizeNonEmpty(options.className, ""),
     ariaLabel: normalizeNonEmpty(options.ariaLabel, DEFAULT_SHARE_ARIA_LABEL),
@@ -145,12 +142,6 @@ function validateShareOptions(options) {
       message: "Expected a non-empty string."
     });
   }
-  if (options.placement !== void 0 && options.placement !== "top" && options.placement !== "bottom") {
-    issues.push({
-      path: "placement",
-      message: 'Expected "top" or "bottom".'
-    });
-  }
   for (const key of [
     "className",
     "ariaLabel",
@@ -227,7 +218,7 @@ function renderShareControls(options, target) {
   const items = links.map(renderLinkItem).join("");
   const copyItem = wantsCopy ? renderCopyItem(options, target) : "";
   const ariaLabel = escapeHtmlAttribute(options.ariaLabel);
-  return `<div class="${escapeHtmlAttribute(rootClass)}" ${SHARE_ATTRIBUTE} data-rr-share-placement="${escapeHtmlAttribute(options.placement)}" role="group" aria-label="${ariaLabel}"><ul class="${SHARE_ROOT_CLASS}__list">${items}${copyItem}</ul><p class="${SHARE_ROOT_CLASS}__status" role="status" aria-live="polite"></p></div>`;
+  return `<div class="${escapeHtmlAttribute(rootClass)}" ${SHARE_ATTRIBUTE} role="group" aria-label="${ariaLabel}"><ul class="${SHARE_ROOT_CLASS}__list">${items}${copyItem}</ul><p class="${SHARE_ROOT_CLASS}__status" role="status" aria-live="polite"></p></div>`;
 }
 function renderLinkItem(link) {
   const modifier = `${SHARE_ROOT_CLASS}__link--${link.service}`;
@@ -237,6 +228,51 @@ function renderCopyItem(options, target) {
   return `<li class="${SHARE_ROOT_CLASS}__item"><button type="button" class="${SHARE_ROOT_CLASS}__button ${SHARE_ROOT_CLASS}__copy" data-rr-share-copy data-share-url="${escapeHtmlAttribute(target.url)}" data-rr-share-copied="${escapeHtmlAttribute(options.copiedLabel)}" data-rr-share-copy-failed="${escapeHtmlAttribute(options.copyFailedLabel)}" hidden>${escapeHtml(options.labels.copy)}</button></li>`;
 }
 
+// components/share-controls.tsx
+import { jsx, jsxs } from "hono/jsx/jsx-runtime";
+var ShareControls = (({
+  links,
+  copyUrl,
+  ariaLabel = "Share",
+  className = "rr-share",
+  copyLabel = "Copy link",
+  copiedLabel = "Copied",
+  copyFailedLabel = "Copy failed"
+}) => {
+  if (links.length === 0 && !copyUrl) return null;
+  const rootClass = className === "rr-share" ? className : `rr-share ${className}`;
+  return /* @__PURE__ */ jsxs("nav", { class: rootClass, "data-rr-share": true, "aria-label": ariaLabel, children: [
+    /* @__PURE__ */ jsxs("ul", { class: "rr-share__list", children: [
+      links.map((link) => /* @__PURE__ */ jsx("li", { class: "rr-share__item", children: /* @__PURE__ */ jsx(
+        "a",
+        {
+          class: `rr-share__link rr-share__link--${link.service}`,
+          href: link.url,
+          target: "_blank",
+          rel: "noopener noreferrer",
+          "data-share-service": link.service,
+          children: link.label
+        }
+      ) }, link.service)),
+      copyUrl ? /* @__PURE__ */ jsx("li", { class: "rr-share__item", children: /* @__PURE__ */ jsx(
+        "button",
+        {
+          type: "button",
+          class: "rr-share__button rr-share__copy",
+          "data-rr-share-copy": true,
+          "data-share-url": copyUrl,
+          "data-rr-share-copied": copiedLabel,
+          "data-rr-share-copy-failed": copyFailedLabel,
+          hidden: true,
+          children: copyLabel
+        }
+      ) }) : null
+    ] }),
+    /* @__PURE__ */ jsx("p", { class: "rr-share__status", role: "status", "aria-live": "polite" })
+  ] });
+});
+var share_controls_default = ShareControls;
+
 // src/client.ts
 var COPY_SELECTOR = "[data-rr-share-copy]";
 var STATUS_SELECTOR = ".rr-share__status";
@@ -302,9 +338,22 @@ function copyWithExecCommand(value) {
 }
 
 // index.ts
+var getShareLinks = ({ entry, site, options }) => {
+  const resolved = resolveShareOptions(options);
+  const url = buildAbsoluteUrl(site, entry.permalink);
+  return {
+    links: buildShareLinks(resolved, { url, title: entry.title }),
+    ...resolved.services.includes("copy") ? { copyUrl: url } : {},
+    ariaLabel: resolved.ariaLabel,
+    className: resolved.className || SHARE_ROOT_CLASS,
+    copyLabel: resolved.labels.copy,
+    copiedLabel: resolved.copiedLabel,
+    copyFailedLabel: resolved.copyFailedLabel
+  };
+};
 var SHARE_PLUGIN_NAME = "share";
 function share(options = {}) {
-  const resolved = resolveShareOptions(options);
+  const _resolved = resolveShareOptions(options);
   return definePlugin({
     name: SHARE_PLUGIN_NAME,
     processedContentCache: {
@@ -313,47 +362,34 @@ function share(options = {}) {
     },
     options,
     validateOptions: validateShareOptions,
-    onManifestCreated: (context) => {
-      const { manifest, config } = context;
-      if (!config) return;
-      for (const entry of manifest.entries) {
-        const block = renderShareControls(resolved, {
-          url: buildAbsoluteUrl(config, entry.permalink),
-          title: entry.title
-        });
-        if (block === "") continue;
-        const slot = resolved.placement === "top" ? "article.before-content" : "article.footer";
-        if (!hasSlotFragment(entry.bodySlots?.[slot], block)) {
-          appendContentBodySlot(entry, slot, block);
-        }
-      }
-    },
-    assets: [createStyleAsset(SHARE_PLUGIN_NAME)],
-    clientEntries: [createClientEntry(SHARE_PLUGIN_NAME, "initShare")]
+    assets: [
+      createStyleAsset(SHARE_PLUGIN_NAME, "@riebeckite/plugin-share/style.css")
+    ],
+    clientEntries: [
+      createClientEntry(
+        SHARE_PLUGIN_NAME,
+        "@riebeckite/plugin-share/client",
+        "initShare"
+      )
+    ]
   });
 }
 var sharePlugin = share;
-function hasSlotFragment(slot, fragment) {
-  return slot === fragment || slot?.startsWith(`${fragment}
-`) || slot?.endsWith(`
-${fragment}`) || slot?.includes(`
-${fragment}
-`) || false;
-}
 export {
   DEFAULT_SHARE_ARIA_LABEL,
   DEFAULT_SHARE_COPIED_LABEL,
   DEFAULT_SHARE_COPY_FAILED_LABEL,
   DEFAULT_SHARE_LABELS,
-  DEFAULT_SHARE_PLACEMENT,
   DEFAULT_SHARE_SERVICES,
   SHARE_ATTRIBUTE,
   SHARE_PLUGIN_NAME,
   SHARE_ROOT_CLASS,
   SHARE_SERVICES,
+  share_controls_default as ShareControls,
   buildAbsoluteUrl,
   buildShareLinks,
   buildShareUrl,
+  getShareLinks,
   initShare,
   normalizeMastodonInstance,
   renderShareControls,

package/dist/src/options.d.ts

@@ -1,9 +1,8 @@
 import type { ConfigValidationIssue } from "@riebeckite/core";
-import { type ResolvedShareOptions, type ShareOptions, type SharePlacement, type ShareService } from "./types.js";
+import { type ResolvedShareOptions, type ShareOptions, type ShareService } from "./types.js";
 /** Services rendered when `services` is omitted. Mastodon is opt-in. */
 export declare const DEFAULT_SHARE_SERVICES: readonly ShareService[];
 export declare const DEFAULT_SHARE_LABELS: Readonly<Record<ShareService, string>>;
-export declare const DEFAULT_SHARE_PLACEMENT: SharePlacement;
 export declare const DEFAULT_SHARE_ARIA_LABEL = "Share";
 export declare const DEFAULT_SHARE_COPIED_LABEL = "Copied";
 export declare const DEFAULT_SHARE_COPY_FAILED_LABEL = "Copy failed";

package/dist/src/services.d.ts

@@ -11,7 +11,7 @@ export type ShareTarget = {
  * Resolves a note's `permalink` to an absolute URL against the site base URL.
  * Already-absolute URLs are returned unchanged.
  */
-export declare function buildAbsoluteUrl(config: ResolvedRiebeckiteConfig, pathOrUrl: string): string;
+export declare function buildAbsoluteUrl(config: Pick<ResolvedRiebeckiteConfig, "site">, pathOrUrl: string): string;
 /**
  * Normalizes a Mastodon instance to a bare host. Accepts `"mastodon.social"`,
  * `"https://mastodon.social/"`, and `"https://mastodon.social/@user"` (the

package/dist/src/types.d.ts

@@ -1,8 +1,6 @@
 /** Services a note can be shared to. `copy` is the copy-link action. */
 export declare const SHARE_SERVICES: readonly ["x", "bluesky", "mastodon", "facebook", "linkedin", "hatena", "copy"];
 export type ShareService = (typeof SHARE_SERVICES)[number];
-/** Where the controls sit relative to the note body. */
-export type SharePlacement = "top" | "bottom";
 /** Options accepted by `share()`. */
 export type ShareOptions = {
     /**
@@ -11,8 +9,6 @@ export type ShareOptions = {
      * to enable it.
      */
     services?: readonly ShareService[];
-    /** Where the controls appear. Defaults to `"bottom"`. */
-    placement?: SharePlacement;
     /**
      * Instance host used by the `mastodon` service, for example
      * `"mastodon.social"`. Accepts a bare host or a full URL; the scheme and
@@ -37,7 +33,6 @@ export type ShareOptions = {
 /** `ShareOptions` with every default applied. */
 export type ResolvedShareOptions = {
     services: readonly ShareService[];
-    placement: SharePlacement;
     mastodonInstance: string;
     className: string;
     ariaLabel: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riebeckite/plugin-share",
-  "version": "0.0.21",
+  "version": "0.0.23",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./dist/index.js",
@@ -18,10 +18,17 @@
       "source": "./client.ts",
       "default": "./dist/client.js"
     },
+    "./components": {
+      "types": "./dist/components/share-controls.d.ts",
+      "import": "./dist/components/share-controls.js",
+      "source": "./components/share-controls.tsx",
+      "default": "./dist/components/share-controls.js"
+    },
     "./style.css": "./style.css"
   },
   "dependencies": {
-    "@riebeckite/core": "0.0.21"
+    "hono": "^4.12.25",
+    "@riebeckite/core": "0.0.23"
   },
   "devDependencies": {
     "tsx": "^4.22.4"