#!/usr/bin/env python3
from __future__ import annotations

import argparse
import json
import os
import re
import shutil
import sys
from pathlib import Path


SDK_PACKAGES = {
    "@hana/plugin-protocol": "plugin-protocol",
    "@hana/plugin-runtime": "plugin-runtime",
    "@hana/plugin-sdk": "plugin-sdk",
    "@hana/plugin-components": "plugin-components",
}

SDK_TARBALLS = {
    "@hana/plugin-protocol": "hana-plugin-protocol-*.tgz",
    "@hana/plugin-runtime": "hana-plugin-runtime-*.tgz",
    "@hana/plugin-sdk": "hana-plugin-sdk-*.tgz",
    "@hana/plugin-components": "hana-plugin-components-*.tgz",
}

REACT_TEMPLATES = {"guided-react", "professional-react"}


def slugify(value: str) -> str:
    slug = re.sub(r"[^a-z0-9]+", "-", value.lower()).strip("-")
    return slug or "hana-plugin"


def titleize(value: str) -> str:
    parts = re.split(r"[\s_-]+", value.strip())
    return " ".join(part[:1].upper() + part[1:] for part in parts if part) or "Hana Plugin"


def js_string(value: str) -> str:
    return json.dumps(value, ensure_ascii=False)


def script_root() -> Path:
    return Path(__file__).resolve().parents[1]


def find_hana_root(*starts: Path) -> Path | None:
    seen: set[Path] = set()
    for start in starts:
        current = start.resolve()
        for candidate in [current, *current.parents]:
            if candidate in seen:
                continue
            seen.add(candidate)
            if (candidate / "PLUGIN_SDK.md").exists() and (candidate / "packages" / "plugin-runtime").exists():
                return candidate
    return None


def read_package_json(root: Path | None) -> dict:
    if not root:
        return {}
    package_path = root / "package.json"
    if not package_path.exists():
        return {}
    try:
        return json.loads(package_path.read_text(encoding="utf-8"))
    except Exception:
        return {}


def package_version(root_package: dict, name: str, fallback: str) -> str:
    for bucket in ("dependencies", "devDependencies", "peerDependencies"):
        value = root_package.get(bucket, {}).get(name)
        if isinstance(value, str) and value:
            return value
    return fallback


def relative_file_spec(from_dir: Path, target: Path) -> str:
    rel = os.path.relpath(target, from_dir)
    return "file:" + rel.replace(os.sep, "/")


def choose_template(template: str, audience: str) -> str:
    if template != "auto":
        return template
    if audience == "developer":
        return "professional-react"
    return "direct"


def choose_sdk_mode(sdk_mode: str, hana_root: Path | None, template: str) -> str:
    if template not in REACT_TEMPLATES:
        return "none"
    if sdk_mode != "auto":
        return sdk_mode
    if hana_root:
        return "workspace"
    return "bundled"


def write_text(path: Path, content: str) -> None:
    path.parent.mkdir(parents=True, exist_ok=True)
    path.write_text(content.rstrip() + "\n", encoding="utf-8")


def write_json(path: Path, data: dict) -> None:
    path.parent.mkdir(parents=True, exist_ok=True)
    path.write_text(json.dumps(data, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")


def required_sdk_packages(include_tool: bool, include_ui: bool, include_lifecycle: bool, template: str) -> list[str]:
    if template not in REACT_TEMPLATES:
        return []
    packages: list[str] = []
    if include_tool or include_lifecycle:
        packages.append("@hana/plugin-runtime")
    if include_ui:
        packages.extend([
            "@hana/plugin-protocol",
            "@hana/plugin-sdk",
            "@hana/plugin-components",
        ])
    return packages


def find_sdk_tarball(package_name: str) -> Path:
    sdk_dir = script_root() / "assets" / "sdk"
    pattern = SDK_TARBALLS[package_name]
    matches = sorted(sdk_dir.glob(pattern))
    if not matches:
        raise SystemExit(
            f"Bundled SDK tarball missing for {package_name}. "
            f"Expected {sdk_dir / pattern}. Run npm pack for SDK packages first."
        )
    return matches[-1]


def prepare_bundled_sdk(plugin_dir: Path, packages: list[str]) -> dict[str, Path]:
    vendor_dir = plugin_dir / "vendor" / "sdk"
    copied: dict[str, Path] = {}
    for package_name in packages:
        src = find_sdk_tarball(package_name)
        dst = vendor_dir / src.name
        dst.parent.mkdir(parents=True, exist_ok=True)
        shutil.copy2(src, dst)
        copied[package_name] = dst
    return copied


def sdk_dependency(
    plugin_dir: Path,
    hana_root: Path | None,
    package_name: str,
    sdk_mode: str,
    bundled: dict[str, Path],
) -> str:
    if sdk_mode == "workspace":
        if not hana_root:
            raise SystemExit("workspace SDK mode requires running from a Hana repo. Use --sdk-mode bundled.")
        package_dir = hana_root / "packages" / SDK_PACKAGES[package_name]
        if not package_dir.exists():
            raise SystemExit(f"Missing workspace SDK package: {package_dir}")
        return relative_file_spec(plugin_dir, package_dir)

    if sdk_mode == "bundled":
        tarball = bundled.get(package_name)
        if not tarball:
            raise SystemExit(f"Bundled SDK tarball was not prepared for {package_name}.")
        return relative_file_spec(plugin_dir, tarball)

    raise SystemExit(f"Unsupported SDK mode for {package_name}: {sdk_mode}")


def manifest_for(args: argparse.Namespace, plugin_id: str, display_name: str, include_ui: bool, include_lifecycle: bool) -> dict:
    manifest = {
        "manifestVersion": 1,
        "id": plugin_id,
        "name": display_name,
        "version": "0.1.0",
        "description": args.description or f"{display_name} plugin for Hana.",
        "minAppVersion": args.min_app_version,
    }
    if include_ui or include_lifecycle:
        manifest["trust"] = "full-access"
    if include_ui:
        manifest["ui"] = {
            "hostCapabilities": ["external.open", "clipboard.writeText"],
        }
        manifest["contributes"] = {
            "page": {
                "title": display_name,
                "route": "/page",
                "icon": "<svg viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.5\"><path d=\"M5 5h14v14H5z\"/><path d=\"M9 9h6M9 13h6\"/></svg>",
            },
            "widget": {
                "title": display_name,
                "route": "/widget",
                "icon": "<svg viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.5\"><path d=\"M8 7l-4 5 4 5\"/><path d=\"M16 7l4 5-4 5\"/></svg>",
            },
        }
    return manifest


def package_json_for(
    plugin_dir: Path,
    hana_root: Path | None,
    root_package: dict,
    plugin_id: str,
    include_tool: bool,
    include_ui: bool,
    include_lifecycle: bool,
    template: str,
    sdk_mode: str,
    bundled_sdk: dict[str, Path],
) -> dict:
    dependencies: dict[str, str] = {}
    for package_name in required_sdk_packages(include_tool, include_ui, include_lifecycle, template):
        dependencies[package_name] = sdk_dependency(plugin_dir, hana_root, package_name, sdk_mode, bundled_sdk)

    dev_dependencies: dict[str, str] = {}
    scripts: dict[str, str] = {}

    if include_ui and template in REACT_TEMPLATES:
        dependencies.update({
            "react": package_version(root_package, "react", "^19.0.0"),
            "react-dom": package_version(root_package, "react-dom", "^19.0.0"),
        })
        dev_dependencies.update({
            "@vitejs/plugin-react": package_version(root_package, "@vitejs/plugin-react", "^5.0.0"),
            "@types/react": package_version(root_package, "@types/react", "^19.0.0"),
            "@types/react-dom": package_version(root_package, "@types/react-dom", "^19.0.0"),
            "typescript": package_version(root_package, "typescript", "^5.0.0"),
            "vite": package_version(root_package, "vite", "^7.0.0"),
        })
        scripts.update({
            "build:ui": "vite build",
            "typecheck": "tsc --noEmit",
        })

    package = {
        "name": plugin_id,
        "version": "0.1.0",
        "private": True,
        "type": "module",
    }
    if dependencies:
        package["dependencies"] = dependencies
    if scripts:
        package["scripts"] = scripts
    if dev_dependencies:
        package["devDependencies"] = dev_dependencies
    return package


def create_direct_tool(plugin_id: str, display_name: str) -> str:
    return f"""
import fs from "node:fs";
import path from "node:path";

export const name = "create_note";
export const description = "Create a markdown note and return it as SessionFile media.";
export const parameters = {{
  type: "object",
  properties: {{
    title: {{ type: "string" }},
    body: {{ type: "string" }}
  }}
}};

export async function execute(input = {{}}, toolCtx) {{
  if (!toolCtx.sessionPath) {{
    throw new Error("{plugin_id}_create_note requires sessionPath");
  }}
  if (!toolCtx.stageFile) {{
    throw new Error("{plugin_id}_create_note requires stageFile");
  }}

  const title = typeof input.title === "string" && input.title.trim()
    ? input.title.trim()
    : {js_string(display_name + " Note")};
  const body = typeof input.body === "string" ? input.body : "Generated from a Hana plugin.";
  const safeName = title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "") || "note";
  const outputDir = path.join(toolCtx.dataDir, "notes");
  const filePath = path.join(outputDir, `${{safeName}}.md`);

  fs.mkdirSync(outputDir, {{ recursive: true }});
  fs.writeFileSync(filePath, `# ${{title}}\\n\\n${{body}}\\n`, "utf-8");

  const staged = toolCtx.stageFile({{
    sessionPath: toolCtx.sessionPath,
    filePath,
    label: `${{safeName}}.md`,
  }});

  return {{
    content: [{{ type: "text", text: `Created ${{safeName}}.md` }}],
    details: {{ media: {{ items: [staged.mediaItem] }} }},
  }};
}}
"""


def create_runtime_tool(plugin_id: str, display_name: str) -> str:
    return f"""
import fs from "node:fs";
import path from "node:path";
import {{ createMediaDetails, defineTool }} from "@hana/plugin-runtime";

const tool = defineTool({{
  name: "create_note",
  description: "Create a markdown note and return it as SessionFile media.",
  parameters: {{
    type: "object",
    properties: {{
      title: {{ type: "string" }},
      body: {{ type: "string" }}
    }}
  }},
  async execute(input = {{}}, toolCtx) {{
    if (!toolCtx.sessionPath) {{
      throw new Error("{plugin_id}_create_note requires sessionPath");
    }}
    if (!toolCtx.stageFile) {{
      throw new Error("{plugin_id}_create_note requires stageFile");
    }}

    const title = typeof input.title === "string" && input.title.trim()
      ? input.title.trim()
      : {js_string(display_name + " Note")};
    const body = typeof input.body === "string" ? input.body : "Generated from a Hana plugin.";
    const safeName = title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "") || "note";
    const outputDir = path.join(toolCtx.dataDir, "notes");
    const filePath = path.join(outputDir, `${{safeName}}.md`);

    fs.mkdirSync(outputDir, {{ recursive: true }});
    fs.writeFileSync(filePath, `# ${{title}}\\n\\n${{body}}\\n`, "utf-8");

    const staged = toolCtx.stageFile({{
      sessionPath: toolCtx.sessionPath,
      filePath,
      label: `${{safeName}}.md`,
    }});

    return {{
      content: [{{ type: "text", text: `Created ${{safeName}}.md` }}],
      details: createMediaDetails([staged]),
    }};
  }},
}});

export const {{ name, description, parameters, execute }} = tool;
"""


def create_direct_index(plugin_id: str, display_name: str) -> str:
    status_type = f"{plugin_id}:status"
    return f"""
const HANA_BUS_SKIP = Symbol.for("hana.event-bus.skip");

export default class Plugin {{
  async onload() {{
    const ctx = this.ctx;
    if (ctx.bus.handle) {{
      this.register(ctx.bus.handle({js_string(status_type)}, (payload) => {{
        if (payload?.pluginId && payload.pluginId !== ctx.pluginId) return HANA_BUS_SKIP;
        return {{
          ok: true,
          pluginId: ctx.pluginId,
          name: {js_string(display_name)},
        }};
      }}));
    }}
    ctx.log.info({js_string(display_name + " loaded")});
  }}

  async onunload() {{
    this.ctx.log.info({js_string(display_name + " unloaded")});
  }}
}}
"""


def create_runtime_index(plugin_id: str, display_name: str) -> str:
    status_type = f"{plugin_id}:status"
    return f"""
import {{
  defineBusHandler,
  definePlugin,
  HANA_BUS_SKIP,
}} from "@hana/plugin-runtime";

const statusHandler = defineBusHandler({{
  type: {js_string(status_type)},
  async handle(payload, ctx) {{
    if (payload?.pluginId && payload.pluginId !== ctx.pluginId) return HANA_BUS_SKIP;
    return {{
      ok: true,
      pluginId: ctx.pluginId,
      name: {js_string(display_name)},
    }};
  }},
}});

export default definePlugin({{
  async onload(ctx, {{ register }}) {{
    if (ctx.bus.handle) {{
      register(ctx.bus.handle(statusHandler.type, (payload) => statusHandler.handle(payload, ctx)));
    }}
    ctx.log.info({js_string(display_name + " loaded")});
  }},

  async onunload(ctx) {{
    ctx.log.info({js_string(display_name + " unloaded")});
  }},
}});
"""


def create_route(display_name: str) -> str:
    return f"""
import fs from "node:fs";
import path from "node:path";

export default function registerPluginUiRoutes(app, ctx) {{
  app.get("/page", (c) => c.html(renderShell(c, ctx, "page")));
  app.get("/widget", (c) => c.html(renderShell(c, ctx, "widget")));
  app.get("/assets/*", (c) => serveAsset(c, ctx));
}}

function renderShell(c, ctx, surface) {{
  const hanaCss = c.req.query("hana-css") || "";
  const theme = c.req.query("hana-theme") || "inherit";
  const base = `/api/plugins/${{ctx.pluginId}}`;
  const title = {js_string(display_name)};

  return `<!doctype html>
<html>
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>${{escapeHtml(title)}}</title>
  ${{hanaCss ? `<link rel="stylesheet" href="${{escapeAttr(hanaCss)}}">` : ""}}
  <link rel="stylesheet" href="${{base}}/assets/panel.css">
</head>
<body data-hana-theme="${{escapeAttr(theme)}}" data-surface="${{surface}}">
  <div id="root" data-surface="${{surface}}"></div>
  <script type="module" src="${{base}}/assets/panel.js"></script>
</body>
</html>`;
}}

function serveAsset(c, ctx) {{
  const rawName = c.req.path.split("/assets/")[1] || "";
  const fileName = path.basename(decodeURIComponent(rawName));
  if (!fileName) return c.text("Not found", 404);

  const assetsDir = path.join(ctx.pluginDir, "assets");
  const filePath = path.join(assetsDir, fileName);
  if (!filePath.startsWith(assetsDir + path.sep) || !fs.existsSync(filePath)) {{
    return c.text("Not found", 404);
  }}

  c.header("Content-Type", contentType(fileName));
  c.header("Cache-Control", "no-cache");
  return c.body(fs.readFileSync(filePath));
}}

function contentType(fileName) {{
  if (fileName.endsWith(".js")) return "text/javascript; charset=utf-8";
  if (fileName.endsWith(".css")) return "text/css; charset=utf-8";
  if (fileName.endsWith(".svg")) return "image/svg+xml";
  if (fileName.endsWith(".png")) return "image/png";
  if (fileName.endsWith(".jpg") || fileName.endsWith(".jpeg")) return "image/jpeg";
  return "application/octet-stream";
}}

function escapeAttr(value) {{
  return String(value)
    .replace(/&/g, "&amp;")
    .replace(/"/g, "&quot;")
    .replace(/</g, "&lt;");
}}

function escapeHtml(value) {{
  return escapeAttr(value).replace(/>/g, "&gt;");
}}
"""


def create_direct_panel_js(display_name: str) -> str:
    return f"""
const PROTOCOL = "hana.plugin.ui";
const VERSION = 1;
let seq = 0;

function targetOrigin() {{
  const params = new URLSearchParams(window.location.search);
  const explicit = params.get("hana-host-origin");
  if (explicit) return explicit;
  try {{
    return new URL(document.referrer).origin;
  }} catch {{
    return "*";
  }}
}}

function post(message) {{
  window.parent.postMessage(message, targetOrigin());
}}

function event(type, payload) {{
  post({{ protocol: PROTOCOL, version: VERSION, kind: "event", type, payload }});
}}

function request(type, payload, timeoutMs = 10000) {{
  const id = `hana-plugin-${{Date.now()}}-${{++seq}}`;
  const origin = targetOrigin();
  return new Promise((resolve, reject) => {{
    const timeout = window.setTimeout(() => {{
      window.removeEventListener("message", onMessage);
      reject(new Error(`Host request timed out: ${{type}}`));
    }}, timeoutMs);

    function onMessage(evt) {{
      if (evt.source !== window.parent) return;
      if (origin !== "*" && evt.origin !== origin) return;
      const msg = evt.data || {{}};
      if (msg.protocol !== PROTOCOL || msg.version !== VERSION || msg.id !== id || msg.type !== type) return;
      window.clearTimeout(timeout);
      window.removeEventListener("message", onMessage);
      if (msg.kind === "error") reject(new Error(msg.error?.message || `Host request failed: ${{type}}`));
      else resolve(msg.payload);
    }}

    window.addEventListener("message", onMessage);
    post({{ protocol: PROTOCOL, version: VERSION, id, kind: "request", type, payload }});
  }});
}}

const hana = {{
  ready: () => event("hana.ready"),
  ui: {{ resize: (size) => event("ui.resize", size) }},
  toast: {{ show: (input) => request("toast.show", input) }},
  external: {{ open: (url) => request("external.open", typeof url === "string" ? {{ url }} : url) }},
  clipboard: {{ writeText: (text) => request("clipboard.writeText", typeof text === "string" ? {{ text }} : text) }},
  theme: {{
    getSnapshot: () => {{
      const params = new URLSearchParams(window.location.search);
      return {{ theme: params.get("hana-theme") || undefined, cssUrl: params.get("hana-css") || undefined }};
    }},
  }},
}};

const root = document.getElementById("root");
const surface = root?.dataset.surface || "page";

function render() {{
  if (!root) return;
  root.innerHTML = `
    <main class="panel">
      <section class="card">
        <header class="card-header">
          <div>
            <h1 id="titleText"></h1>
            <p>A no-build Hana plugin panel.</p>
          </div>
          <button id="openBtn" class="button ghost" type="button">Open</button>
        </header>
        <label class="field">
          <span>Title</span>
          <input id="titleInput" type="text">
        </label>
        <div class="row">
          <div>
            <strong>Enabled</strong>
            <p>Local iframe state for this starter panel.</p>
          </div>
          <button id="toggleBtn" class="switch on" type="button" aria-pressed="true"><span></span></button>
        </div>
        <ul class="list">
          <li><span>Tool</span><em>Agent callable</em></li>
          <li><span>Page</span><em>Full iframe</em></li>
          <li><span>Widget</span><em>Sidebar iframe</em></li>
        </ul>
        <footer>
          <button id="copyBtn" class="button primary" type="button">Copy title</button>
        </footer>
      </section>
    </main>
  `;

  const titleInput = document.getElementById("titleInput");
  const titleText = document.getElementById("titleText");
  const toggleBtn = document.getElementById("toggleBtn");
  titleInput.value = {js_string(display_name)};
  titleText.textContent = titleInput.value;

  titleInput.addEventListener("input", () => {{
    titleText.textContent = titleInput.value || {js_string(display_name)};
  }});
  toggleBtn.addEventListener("click", () => {{
    const on = !toggleBtn.classList.contains("on");
    toggleBtn.classList.toggle("on", on);
    toggleBtn.setAttribute("aria-pressed", String(on));
  }});
  document.getElementById("copyBtn").addEventListener("click", async () => {{
    await hana.clipboard.writeText(titleInput.value);
    await hana.toast.show({{ message: "Copied title", type: "success" }});
  }});
  document.getElementById("openBtn").addEventListener("click", () => {{
    hana.external.open("https://example.com");
  }});
}}

render();
hana.ready();
hana.ui.resize({{ height: surface === "widget" ? 320 : 500 }});
"""


def create_direct_panel_css() -> str:
    return """
html,
body,
#root {
  min-height: 100%;
  margin: 0;
}

body {
  background: var(--bg, #f8f5ed);
  color: var(--text, #3b3d3f);
  font-family: var(--font-ui, Inter, -apple-system, BlinkMacSystemFont, "Helvetica Neue", sans-serif);
}

* {
  box-sizing: border-box;
}

.panel {
  min-height: 100vh;
  padding: 16px;
}

body[data-surface="widget"] .panel {
  padding: 12px;
}

.card {
  display: grid;
  gap: 14px;
  border: 1px solid var(--border, rgba(83, 125, 150, 0.22));
  border-radius: var(--radius-card, 4px);
  background: var(--bg-card, #fcfaf5);
  padding: 16px;
}

.card-header,
.row,
.list li,
footer {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 12px;
}

h1,
p {
  margin: 0;
}

h1 {
  font-size: 1.05rem;
  font-weight: 650;
}

p,
em {
  color: var(--text-muted, #8e9196);
  font-size: 0.78rem;
  font-style: normal;
}

.field {
  display: grid;
  gap: 6px;
  color: var(--text-light, #6b6f73);
  font-size: 0.78rem;
}

input {
  width: 100%;
  border: 1px solid var(--border, rgba(83, 125, 150, 0.22));
  border-radius: var(--radius-input, 3px);
  background: var(--bg, #f8f5ed);
  color: var(--text, #3b3d3f);
  padding: 8px 10px;
  font: inherit;
}

.button,
.switch {
  border: 1px solid transparent;
  border-radius: var(--radius-input, 3px);
  font: inherit;
  cursor: pointer;
}

.button {
  padding: 8px 12px;
}

.button.primary {
  background: var(--accent, #537d96);
  color: white;
}

.button.ghost {
  background: var(--accent-light, rgba(83, 125, 150, 0.08));
  color: var(--accent, #537d96);
}

.switch {
  width: 38px;
  height: 22px;
  padding: 2px;
  background: var(--border, rgba(83, 125, 150, 0.22));
}

.switch span {
  display: block;
  width: 16px;
  height: 16px;
  border-radius: 999px;
  background: var(--bg-card, #fcfaf5);
  transition: transform 0.15s ease;
}

.switch.on {
  background: var(--accent, #537d96);
}

.switch.on span {
  transform: translateX(16px);
}

.list {
  display: grid;
  gap: 8px;
  margin: 0;
  padding: 0;
  list-style: none;
}

.list li {
  border-top: 1px solid var(--border, rgba(83, 125, 150, 0.18));
  padding-top: 8px;
}
"""


def create_react_panel(display_name: str) -> str:
    return f"""
import {{ useEffect, useMemo, useState }} from 'react';
import {{ createRoot }} from 'react-dom/client';
import {{ hana }} from '@hana/plugin-sdk';
import {{
  Button,
  CardShell,
  EmptyState,
  HanaThemeProvider,
  List,
  Select,
  SettingRow,
  Switch,
  TextInput,
}} from '@hana/plugin-components';
import '@hana/plugin-components/styles.css';
import './panel.css';

type ThemeMode = 'inherit' | 'hana' | 'custom';

function Panel() {{
  const surface = document.getElementById('root')?.dataset.surface || 'page';
  const [themeMode, setThemeMode] = useState<ThemeMode>('inherit');
  const [title, setTitle] = useState({js_string(display_name)});
  const [enabled, setEnabled] = useState(true);

  useEffect(() => {{
    hana.ready();
    hana.ui.resize({{ height: surface === 'widget' ? 320 : 520 }});
  }}, [surface]);

  const customTheme = useMemo(() => (
    themeMode === 'custom'
      ? {{ bg: '#F7F4EF', bgCard: '#FFFDF8', accent: '#537D96' }}
      : undefined
  ), [themeMode]);

  async function copyTitle() {{
    await hana.clipboard.writeText(title);
    await hana.toast.show({{ message: 'Copied title', type: 'success' }});
  }}

  return (
    <HanaThemeProvider
      mode={{themeMode}}
      theme={{customTheme || (themeMode === 'hana' ? 'warm-paper' : undefined)}}
      className="plugin-panel"
    >
      <CardShell
        title={{title}}
        description="A Hana plugin panel using the SDK and shared components."
        actions={{<Button variant="ghost" onClick={{() => hana.external.open('https://example.com')}}>Open</Button>}}
        footer={{<Button variant="primary" onClick={{copyTitle}}>Copy title</Button>}}
      >
        <SettingRow
          label="Enabled"
          hint="Local iframe state; persist through plugin config when needed."
          control={{<Switch checked={{enabled}} onChange={{setEnabled}} label={{enabled ? 'On' : 'Off'}} />}}
        />
        <SettingRow
          label="Theme"
          control={{
            <Select
              value={{themeMode}}
              onChange={{(value) => setThemeMode(value as ThemeMode)}}
              options={{[
                {{ value: 'inherit', label: 'Follow Hana' }},
                {{ value: 'hana', label: 'Warm paper' }},
                {{ value: 'custom', label: 'Custom' }},
              ]}}
            />
          }}
        />
        <TextInput label="Title" value={{title}} onChange={{(event) => setTitle(event.currentTarget.value)}} />
        <List
          items={{[
            {{ id: 'runtime', title: '@hana/plugin-runtime', meta: 'Node' }},
            {{ id: 'sdk', title: '@hana/plugin-sdk', meta: 'iframe' }},
            {{ id: 'components', title: '@hana/plugin-components', meta: 'React' }},
          ]}}
        />
        {{!enabled && <EmptyState title="Paused" description="Turn the switch back on to resume actions." />}}
      </CardShell>
    </HanaThemeProvider>
  );
}}

const root = document.getElementById('root');
if (root) createRoot(root).render(<Panel />);
"""


def create_react_panel_css() -> str:
    return """
html,
body,
#root {
  min-height: 100%;
  margin: 0;
}

body {
  background: var(--hana-plugin-bg, #f8f5ed);
  color: var(--hana-plugin-text, #3b3d3f);
}

.plugin-panel {
  min-height: 100vh;
  box-sizing: border-box;
  padding: 16px;
}

body[data-surface="widget"] .plugin-panel {
  padding: 12px;
}
"""


def create_vite_config() -> str:
    return """
import path from 'node:path';
import { defineConfig } from 'vite';
import react from '@vitejs/plugin-react';

export default defineConfig({
  plugins: [react()],
  build: {
    outDir: 'assets',
    emptyOutDir: true,
    sourcemap: true,
    lib: {
      entry: path.resolve(__dirname, 'ui', 'Panel.tsx'),
      formats: ['es'],
      fileName: () => 'panel.js',
    },
    rollupOptions: {
      output: {
        assetFileNames: (assetInfo) => assetInfo.name === 'style.css' ? 'panel.css' : '[name][extname]',
      },
    },
  },
});
"""


def create_tsconfig() -> str:
    return """
{
  "compilerOptions": {
    "target": "ES2022",
    "useDefineForClassFields": true,
    "lib": ["DOM", "DOM.Iterable", "ES2022"],
    "allowJs": false,
    "skipLibCheck": true,
    "esModuleInterop": true,
    "allowSyntheticDefaultImports": true,
    "strict": true,
    "forceConsistentCasingInFileNames": true,
    "module": "ESNext",
    "moduleResolution": "Bundler",
    "resolveJsonModule": true,
    "isolatedModules": true,
    "noEmit": true,
    "jsx": "react-jsx"
  },
  "include": ["ui", "vite.config.ts"]
}
"""


def create_readme(plugin_id: str, display_name: str, include_ui: bool, include_lifecycle: bool, template: str, audience: str) -> str:
    lines = [
        f"# {display_name}",
        "",
        f"Hana plugin id: `{plugin_id}`.",
        "",
    ]
    if audience == "beginner" or template == "direct":
        lines.extend([
            "This is a small Hana plugin starter. Start by changing labels, button actions, and the sample tool.",
            "",
            "## What to edit first",
            "",
            "- `manifest.json`: the name, description, and permissions Hana sees.",
            "- `tools/create-note.js`: the sample action the Agent can call.",
        ])
        if include_ui:
            lines.extend([
                "- `assets/panel.js`: the iframe UI behavior.",
                "- `assets/panel.css`: the iframe UI style.",
            ])
    else:
        lines.extend([
            "## Contents",
            "",
            "- `manifest.json`: plugin metadata and capability declarations.",
            "- `tools/create-note.js`: sample SessionFile-aware tool.",
        ])
        if include_lifecycle:
            lines.append("- `index.js`: sample lifecycle entry and EventBus handler.")
        if include_ui:
            lines.extend([
                "- `routes/ui.js`: iframe shell and static asset route.",
                "- `ui/Panel.tsx`: React iframe UI built with Hana SDK components.",
                "- `vite.config.ts`: builds `assets/panel.js` and `assets/panel.css`.",
            ])

    lines.extend(["", "## Development", ""])
    if template in REACT_TEMPLATES:
        lines.extend([
            "```bash",
            "npm install",
            "npm run build:ui",
            "npm run typecheck",
            "```",
        ])
    else:
        lines.append("No build step is required for this direct template.")

    lines.extend([
        "",
        "Install by dragging this folder into Hana Settings > Plugins, or place it under the user plugin directory reported by `/api/plugins/settings`.",
    ])
    if include_ui:
        lines.append("This plugin requires full-access because Hana page and widget contributions are route-backed iframe UI.")
    return "\n".join(lines)


def scaffold(args: argparse.Namespace) -> Path:
    plugin_id = slugify(args.plugin_id or args.name)
    display_name = args.display_name or titleize(args.name)
    parent = Path(args.path).expanduser().resolve()
    plugin_dir = parent / plugin_id
    template = choose_template(args.template, args.audience)
    include_tool = args.kind in {"tool", "full"}
    include_ui = args.kind in {"ui", "full"}
    include_lifecycle = args.kind == "full"

    if plugin_dir.exists():
        if not args.force:
            raise SystemExit(f"{plugin_dir} already exists. Pass --force to replace it.")
        shutil.rmtree(plugin_dir)
    plugin_dir.mkdir(parents=True, exist_ok=True)

    hana_root = find_hana_root(Path.cwd(), parent)
    root_package = read_package_json(hana_root)
    sdk_mode = choose_sdk_mode(args.sdk_mode, hana_root, template)
    sdk_packages = required_sdk_packages(include_tool, include_ui, include_lifecycle, template)
    bundled_sdk = prepare_bundled_sdk(plugin_dir, sdk_packages) if sdk_mode == "bundled" else {}

    write_json(plugin_dir / "manifest.json", manifest_for(args, plugin_id, display_name, include_ui, include_lifecycle))
    if template in REACT_TEMPLATES:
        write_json(plugin_dir / "package.json", package_json_for(
            plugin_dir,
            hana_root,
            root_package,
            plugin_id,
            include_tool,
            include_ui,
            include_lifecycle,
            template,
            sdk_mode,
            bundled_sdk,
        ))
    write_text(plugin_dir / "README.md", create_readme(plugin_id, display_name, include_ui, include_lifecycle, template, args.audience))

    if include_tool:
        tool_source = create_runtime_tool(plugin_id, display_name) if template in REACT_TEMPLATES else create_direct_tool(plugin_id, display_name)
        write_text(plugin_dir / "tools" / "create-note.js", tool_source)
    if include_lifecycle:
        index_source = create_runtime_index(plugin_id, display_name) if template in REACT_TEMPLATES else create_direct_index(plugin_id, display_name)
        write_text(plugin_dir / "index.js", index_source)
    if include_ui:
        write_text(plugin_dir / "routes" / "ui.js", create_route(display_name))
        if template in REACT_TEMPLATES:
            write_text(plugin_dir / "ui" / "Panel.tsx", create_react_panel(display_name))
            write_text(plugin_dir / "ui" / "panel.css", create_react_panel_css())
            write_text(plugin_dir / "vite.config.ts", create_vite_config())
            write_text(plugin_dir / "tsconfig.json", create_tsconfig())
        else:
            write_text(plugin_dir / "assets" / "panel.js", create_direct_panel_js(display_name))
            write_text(plugin_dir / "assets" / "panel.css", create_direct_panel_css())

    return plugin_dir


def main() -> int:
    parser = argparse.ArgumentParser(description="Create a Hana plugin scaffold.")
    parser.add_argument("name", help="Human-facing plugin name, for example 'Finance Panel'.")
    parser.add_argument("--plugin-id", help="Stable plugin id. Defaults to a slugified name.")
    parser.add_argument("--display-name", help="Display name. Defaults to title-cased name.")
    parser.add_argument("--description", help="Manifest description.")
    parser.add_argument("--path", default="examples/plugins", help="Parent directory for the plugin. Defaults to examples/plugins.")
    parser.add_argument("--kind", choices=["tool", "ui", "full"], default="full", help="Scaffold shape.")
    parser.add_argument("--audience", choices=["auto", "beginner", "developer"], default="auto", help="Controls generated README tone and auto template choice.")
    parser.add_argument("--template", choices=["auto", "direct", "guided-react", "professional-react"], default="auto", help="UI/project template.")
    parser.add_argument("--sdk-mode", choices=["auto", "workspace", "bundled"], default="auto", help="SDK dependency source for React templates.")
    parser.add_argument("--min-app-version", default="0.159.0", help="Manifest minAppVersion.")
    parser.add_argument("--force", action="store_true", help="Replace an existing plugin directory.")
    args = parser.parse_args()

    plugin_dir = scaffold(args)
    template = choose_template(args.template, args.audience)
    print(f"Created Hana plugin scaffold: {plugin_dir}")
    print(f"Template: {template}")
    print("Next steps:")
    print("  1. Review manifest.json capabilities and trust.")
    if template in REACT_TEMPLATES:
        print("  2. Run npm install inside the plugin directory.")
        print("  3. Run npm run build:ui to produce assets/panel.js and assets/panel.css.")
    else:
        print("  2. Install or drag the plugin folder into Hana; no build step is required.")
    return 0


if __name__ == "__main__":
    sys.exit(main())
