@xpufx/paseo-helper-demo 0.2.0

package/client/suite-settings.tsx

@@ -0,0 +1,77 @@
+import React from "react";
+import { Text } from "react-native";
+import {
+  ActionBar,
+  Button,
+  Card,
+  FormRow,
+  KeyValue,
+  KeyValueGroup,
+  Toggle,
+  triggerHaptic,
+  usePluginTheme,
+  useSuiteSettings,
+} from "paseo-plugin-helper/client";
+
+export function SharedSuiteCard() {
+  const { colors, typography } = usePluginTheme();
+  const { settings, updateSettings, resetSettings, isUpdating } = useSuiteSettings({
+    pollIntervalMs: 2000,
+  });
+
+  return (
+    <Card variant="elevated">
+      <Card.Header
+        title="Shared Suite Settings"
+        subtitle="Architecture B: one file, every sibling plugin sees it"
+      />
+      <KeyValueGroup>
+        <KeyValue label="Suite" value={settings.suiteTitle} />
+        <KeyValue label="Accent" value={settings.accentColor} copyable />
+        <KeyValue label="Density" value={settings.density} />
+      </KeyValueGroup>
+      <FormRow
+        label="Show suite tabs"
+        description="Toggles the shared tab shell for all suite plugins"
+      >
+        <Toggle
+          value={settings.showSuiteTabs}
+          onValueChange={(val) => {
+            triggerHaptic("light");
+            updateSettings({ showSuiteTabs: val });
+          }}
+        />
+      </FormRow>
+      <FormRow label="Density" description={`Active density: "${settings.density}"`}>
+        <ActionBar align="flex-start" direction="row" style={{ marginTop: 0 }}>
+          {(["compact", "comfortable", "spacious"] as const).map((d) => (
+            <Button
+              key={d}
+              size="sm"
+              label={d}
+              variant={settings.density === d ? "primary" : "ghost"}
+              onPress={() => {
+                triggerHaptic("light");
+                updateSettings({ density: d });
+              }}
+            />
+          ))}
+        </ActionBar>
+      </FormRow>
+      <ActionBar align="space-between">
+        <Text style={{ color: colors.foregroundMuted, ...typography.caption }}>
+          {isUpdating ? "Syncing to suite file..." : "Writes land in xpufx-suite/settings.json"}
+        </Text>
+        <Button
+          label="Reset Suite"
+          variant="secondary"
+          size="sm"
+          onPress={async () => {
+            triggerHaptic("warning");
+            await resetSettings();
+          }}
+        />
+      </ActionBar>
+    </Card>
+  );
+}

package/client/vendor/paseo-plugin-helper/command-center.ts

@@ -0,0 +1,43 @@
+import type { PluginCleanup } from "./host";
+
+/**
+ * Structural registrar interface satisfied by both Paseo v0.7 PluginContext
+ * and Paseo v0.8 PluginClientContext.
+ */
+export interface CommandCenterItemRegistrar {
+  addCommandCenterItem(contribution: any): any;
+}
+
+export type CommandCenterContext = "global" | "workspace" | "agent";
+
+/**
+ * Capabilities the host passes to a command-center item's `onSelect`. Mirrors
+ * the subset of `PluginCommandCapabilities` the helper needs; the real host
+ * context carries additional fields (paseo, rpc, workspace, agent) that a
+ * handler may read off its own typed contribution.
+ */
+export interface CommandCenterCapabilities {
+  openSurface(id: string): void;
+  openSettings(id: string): void;
+}
+
+export interface CommandCenterItemContribution {
+  id: string;
+  title: string;
+  icon: string;
+  keywords?: readonly string[];
+  context: CommandCenterContext;
+  onSelect(context: CommandCenterCapabilities): void | Promise<void>;
+}
+
+/**
+ * Registers a command-center palette item — the entry the host Ctrl+K command
+ * center lists. Thin pass-through that keeps plugins on the helper seam and
+ * works with both Paseo v0.7 PluginContext and Paseo v0.8 PluginClientContext.
+ */
+export function registerCommandCenterItem(
+  plugin: CommandCenterItemRegistrar,
+  contribution: CommandCenterItemContribution,
+): PluginCleanup {
+  return plugin.addCommandCenterItem(contribution);
+}

package/client/vendor/paseo-plugin-helper/components/AboutSection.tsx

@@ -0,0 +1,493 @@
+import React, { useState, type ReactNode } from "react";
+import {
+  Image,
+  Linking,
+  StyleSheet,
+  Text,
+  View,
+  type ImageSourcePropType,
+  type StyleProp,
+  type ViewStyle,
+} from "react-native";
+import { getClientHost } from "../host";
+import { usePluginTheme } from "../theme/provider";
+import { useResponsive } from "../theme/useResponsive";
+import { Card } from "./Card";
+import { Badge } from "./Badge";
+import { Button } from "./Button";
+import { KeyValue, KeyValueGroup } from "./KeyValue";
+import { copyToClipboard } from "../utils/clipboard";
+import { triggerHaptic } from "../utils/haptics";
+
+export interface AboutLink {
+  label: string;
+  url: string;
+  icon?: string;
+}
+
+export interface AboutSectionProps {
+  /**
+   * Name of the plugin.
+   */
+  name: string;
+
+  /**
+   * Short description or tagline.
+   */
+  description?: string;
+
+  /**
+   * Semantic version string (e.g. from `PLUGIN_VERSION` or package.json).
+   */
+  version: string;
+
+  /**
+   * Author or organization name.
+   */
+  author?: string;
+
+  /**
+   * Logo or icon to display.
+   * - A React Native image source object: `{ uri: "https://..." }` or `require("./assets/logo.png")`
+   * - A string starting with "http" (e.g. avatar/logo URL)
+   * - A Paseo Lucide icon name (e.g. "Cpu", "Layers", "Sparkles")
+   * - If omitted and `repository` or `author` is a GitHub link/username, defaults to the GitHub avatar!
+   */
+  logo?: ImageSourcePropType | string;
+
+  /**
+   * Repository URL (e.g. "https://github.com/xpufx/paseo-top").
+   */
+  repository?: string;
+
+  /**
+   * Issue tracker URL (e.g. "https://github.com/xpufx/paseo-top/issues").
+   */
+  issues?: string;
+
+  /**
+   * Documentation website or wiki URL.
+   */
+  homepage?: string;
+
+  /**
+   * License identifier (e.g. "MIT", "Apache-2.0").
+   */
+  license?: string;
+
+  /**
+   * Custom additional links.
+   */
+  links?: AboutLink[];
+
+  /**
+   * Extra diagnostic or environmental items to display in the details section.
+   */
+  extraItems?: Array<{
+    label: string;
+    value: string;
+    subValue?: string;
+    copyable?: boolean;
+  }>;
+
+  /**
+   * Whether to display the "Copy Diagnostics" button. Default: true.
+   */
+  showDiagnosticsCopy?: boolean;
+
+  /**
+   * Optional custom container style.
+   */
+  style?: StyleProp<ViewStyle>;
+
+  /**
+   * Visual density. `"tiny"` scales all fonts to the smallest readable
+   * size for dense About pages. Default: `"default"`.
+   */
+  density?: "default" | "compact" | "tiny";
+}
+
+/**
+ * Extracts a GitHub owner/organization from a repository URL or author name.
+ */
+function resolveGitHubAvatarUrl(repo?: string, author?: string): string | null {
+  if (repo) {
+    const match = repo.match(/github\.com[/:]([a-zA-Z0-9_-]+)/);
+    if (match?.[1]) {
+      return `https://github.com/${match[1]}.png?size=128`;
+    }
+  }
+  if (author && !author.includes(" ") && !author.includes("@")) {
+    return `https://github.com/${author}.png?size=128`;
+  }
+  return null;
+}
+
+/**
+ * `<AboutSection>` provides a standardized, responsive plugin information and diagnostics view.
+ * 
+ * Features:
+ * - Displays plugin branding, author, description, version, and license badges.
+ * - Supports custom logo images, local asset requires, Lucide icons, or auto-resolved GitHub avatars.
+ * - One-click "Copy Diagnostics" button formatting system info for GitHub issue triage.
+ * - Pre-styled external links with native browser launch via React Native `Linking`.
+ */
+export function AboutSection({
+  name,
+  description,
+  version,
+  author,
+  logo,
+  repository,
+  issues,
+  homepage,
+  license = "MIT",
+  links = [],
+  extraItems = [],
+  showDiagnosticsCopy = true,
+  style,
+  density = "default",
+}: AboutSectionProps) {
+  const { Icon } = getClientHost();
+  const { colors, resolveRadius, typography } = usePluginTheme();
+  const { isCompact, platform } = useResponsive();
+  const [copied, setCopied] = useState(false);
+  const isTiny = density === "tiny";
+
+  // 1. Resolve Logo / Avatar
+  let resolvedLogoNode: ReactNode = null;
+  const radius = resolveRadius("md");
+
+  if (logo) {
+    if (typeof logo === "string") {
+      if (logo.startsWith("http://") || logo.startsWith("https://")) {
+        resolvedLogoNode = (
+          <Image
+            source={{ uri: logo }}
+            style={[styles.logoImage, { borderRadius: radius }]}
+          />
+        );
+      } else {
+        resolvedLogoNode = (
+          <View
+            style={[
+              styles.logoIconFallback,
+              {
+                backgroundColor: colors.surface2,
+                borderRadius: radius,
+                borderColor: colors.border,
+              },
+            ]}
+          >
+            <Icon name={logo} size={26} color={colors.accent} />
+          </View>
+        );
+      }
+    } else {
+      resolvedLogoNode = (
+        <Image
+          source={logo}
+          style={[styles.logoImage, { borderRadius: radius }]}
+        />
+      );
+    }
+  } else {
+    // Attempt automatic GitHub avatar resolution
+    const githubAvatar = resolveGitHubAvatarUrl(repository, author);
+    if (githubAvatar) {
+      resolvedLogoNode = (
+        <Image
+          source={{ uri: githubAvatar }}
+          style={[styles.logoImage, { borderRadius: radius }]}
+        />
+      );
+    } else {
+      resolvedLogoNode = (
+        <View
+          style={[
+            styles.logoIconFallback,
+            {
+              backgroundColor: colors.surface2,
+              borderRadius: radius,
+              borderColor: colors.border,
+            },
+          ]}
+        >
+          <Icon name="Layers" size={26} color={colors.accent} />
+        </View>
+      );
+    }
+  }
+
+  // 2. Open URL helper
+  const handleOpenUrl = async (url: string) => {
+    try {
+      triggerHaptic("light");
+      const canOpen = await Linking.canOpenURL(url);
+      if (canOpen) {
+        await Linking.openURL(url);
+      }
+    } catch {
+      // Ignore linking errors
+    }
+  };
+
+  // 3. Diagnostics copy helper
+  const handleCopyDiagnostics = async () => {
+    triggerHaptic("success");
+    const lines = [
+      `Plugin: ${name} v${version}`,
+      author ? `Author: ${author}` : null,
+      `License: ${license}`,
+      `Platform: ${platform} (${isCompact ? "compact" : "regular"})`,
+      repository ? `Repository: ${repository}` : null,
+      ...extraItems.map((item) => `${item.label}: ${item.value}`),
+    ].filter(Boolean);
+
+    await copyToClipboard(lines.join("\n"));
+    setCopied(true);
+    setTimeout(() => setCopied(false), 2500);
+  };
+
+  // 4. Assemble external links
+  const allLinks: AboutLink[] = [
+    ...(repository ? [{ label: "Repository", url: repository, icon: "ExternalLink" }] : []),
+    ...(issues ? [{ label: "Report Issue", url: issues, icon: "Bug" }] : []),
+    ...(homepage ? [{ label: "Documentation", url: homepage, icon: "BookOpen" }] : []),
+    ...links,
+  ];
+
+  return (
+    <View style={[styles.container, isTiny && tinyStyles.container, style]}>
+      {/* Header Banner Card */}
+      <Card variant="elevated" style={isTiny ? tinyStyles.card : undefined}>
+        <View style={[styles.headerRow, isTiny && tinyStyles.headerRow]}>
+          {resolvedLogoNode}
+
+          <View style={[styles.metaColumn, isTiny && tinyStyles.metaColumn]}>
+            <View style={styles.identityTitleRow}>
+              <Text
+                numberOfLines={2}
+                style={[
+                  styles.identityTitle,
+                  {
+                    color: colors.foreground,
+                    ...typography.heading,
+                  },
+                  isTiny && tinyStyles.title,
+                ]}
+              >
+                {name}
+              </Text>
+              <Badge
+                variant="accent"
+                label={`v${version}`}
+                textStyle={isTiny ? tinyStyles.text9 : undefined}
+              />
+            </View>
+
+            {description ? (
+              <Text
+                numberOfLines={3}
+                style={[
+                  styles.identityDescription,
+                  { color: colors.foregroundMuted, ...typography.body },
+                  isTiny && tinyStyles.text9,
+                ]}
+              >
+                {description}
+              </Text>
+            ) : null}
+
+            {author ? (
+              <Text
+                style={[
+                  styles.authorText,
+                  { color: colors.foregroundMuted, ...typography.caption },
+                  isTiny && tinyStyles.text9,
+                ]}
+              >
+                by {author}
+              </Text>
+            ) : null}
+
+            {license ? (
+              <View style={styles.titleRow}>
+                <Badge
+                  variant="neutral"
+                  label={license}
+                  textStyle={isTiny ? tinyStyles.text9 : undefined}
+                />
+              </View>
+            ) : null}
+          </View>
+        </View>
+
+        {/* Action Buttons: External Links & Diagnostics */}
+        <View style={[styles.actionsRow, isTiny && tinyStyles.actionsRow]}>
+          {allLinks.map((link) => (
+            <Button
+              key={link.url}
+              size="sm"
+              variant="secondary"
+              icon={link.icon ?? "ExternalLink"}
+              label={link.label}
+              onPress={() => handleOpenUrl(link.url)}
+              textStyle={isTiny ? tinyStyles.text9 : undefined}
+            />
+          ))}
+
+          {showDiagnosticsCopy && (
+            <Button
+              size="sm"
+              variant={copied ? "primary" : "ghost"}
+              icon={copied ? "Check" : "Copy"}
+              label={copied ? "Diagnostics Copied!" : "Copy Diagnostics"}
+              onPress={handleCopyDiagnostics}
+              textStyle={isTiny ? tinyStyles.text9 : undefined}
+            />
+          )}
+        </View>
+      </Card>
+
+      {/* Environment & Extra Diagnostics Details */}
+      <Card variant="elevated" style={isTiny ? tinyStyles.card : undefined}>
+        <Card.Header
+          title="Runtime Environment"
+          subtitle="Diagnostics for issue reports and system verification"
+          titleStyle={isTiny ? tinyStyles.title : undefined}
+          subtitleStyle={isTiny ? tinyStyles.text9 : undefined}
+        />
+        <KeyValueGroup columns={isCompact ? 1 : 2} gap={isTiny ? 6 : undefined}>
+          <KeyValue
+            label="Plugin Version"
+            value={`v${version}`}
+            copyable
+            labelStyle={isTiny ? tinyStyles.text9 : undefined}
+            valueStyle={isTiny ? tinyStyles.text9 : undefined}
+          />
+          <KeyValue
+            label="Client Platform"
+            value={platform}
+            labelStyle={isTiny ? tinyStyles.text9 : undefined}
+            valueStyle={isTiny ? tinyStyles.text9 : undefined}
+          />
+          {author ? (
+            <KeyValue
+              label="Author"
+              value={author}
+              labelStyle={isTiny ? tinyStyles.text9 : undefined}
+              valueStyle={isTiny ? tinyStyles.text9 : undefined}
+            />
+          ) : null}
+          {license ? (
+            <KeyValue
+              label="License"
+              value={license}
+              labelStyle={isTiny ? tinyStyles.text9 : undefined}
+              valueStyle={isTiny ? tinyStyles.text9 : undefined}
+            />
+          ) : null}
+          {extraItems.map((item, idx) => (
+            <KeyValue
+              key={idx}
+              label={item.label}
+              value={item.value}
+              subValue={item.subValue}
+              copyable={item.copyable}
+              labelStyle={isTiny ? tinyStyles.text9 : undefined}
+              valueStyle={isTiny ? tinyStyles.text9 : undefined}
+            />
+          ))}
+        </KeyValueGroup>
+      </Card>
+    </View>
+  );
+}
+
+const styles = StyleSheet.create({
+  container: {
+    gap: 12,
+  },
+  headerRow: {
+    flexDirection: "row",
+    alignItems: "center",
+    gap: 14,
+  },
+  logoImage: {
+    width: 48,
+    height: 48,
+    resizeMode: "cover",
+  },
+  logoIconFallback: {
+    width: 48,
+    height: 48,
+    alignItems: "center",
+    justifyContent: "center",
+    borderWidth: 1,
+  },
+  metaColumn: {
+    flex: 1,
+    gap: 5,
+    minWidth: 0,
+  },
+  identityTitleRow: {
+    flexDirection: "row",
+    alignItems: "center",
+    flexWrap: "wrap",
+    gap: 6,
+  },
+  identityTitle: {
+    flexShrink: 1,
+  },
+  identityDescription: {
+    flexShrink: 1,
+  },
+  titleRow: {
+    flexDirection: "row",
+    alignItems: "center",
+    flexWrap: "wrap",
+    gap: 6,
+  },
+  authorText: {
+    flexShrink: 1,
+  },
+  actionsRow: {
+    flexDirection: "row",
+    alignItems: "center",
+    flexWrap: "wrap",
+    gap: 8,
+    marginTop: 12,
+    paddingTop: 10,
+    borderTopWidth: StyleSheet.hairlineWidth,
+    borderTopColor: "rgba(128, 128, 128, 0.2)",
+  },
+});
+
+const tinyStyles = StyleSheet.create({
+  container: {
+    gap: 6,
+  },
+  card: {
+    paddingHorizontal: 8,
+    paddingVertical: 8,
+    gap: 6,
+  },
+  title: {
+    fontSize: 11,
+  },
+  text9: {
+    fontSize: 9,
+  },
+  headerRow: {
+    gap: 8,
+  },
+  metaColumn: {
+    gap: 4,
+  },
+  actionsRow: {
+    gap: 6,
+    marginTop: 8,
+    paddingTop: 6,
+  },
+});