@kosdev-code/kos-ui-plugin 2.1.1 → 2.1.3

package/documentation-generator-B8FuhDjB.js

@@ -1,1271 +0,0 @@
-var T = Object.defineProperty;
-var _ = (s, e, t) => e in s ? T(s, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : s[e] = t;
-var E = (s, e, t) => (_(s, typeof e != "symbol" ? e + "" : e, t), t);
-import { z as P } from "zod";
-function A(s, e) {
-  for (var t = 0; t < e.length; t++) {
-    const n = e[t];
-    if (typeof n != "string" && !Array.isArray(n)) {
-      for (const r in n)
-        if (r !== "default" && !(r in s)) {
-          const i = Object.getOwnPropertyDescriptor(n, r);
-          i && Object.defineProperty(s, r, i.get ? i : {
-            enumerable: !0,
-            get: () => n[r]
-          });
-        }
-    }
-  }
-  return Object.freeze(Object.defineProperty(s, Symbol.toStringTag, { value: "Module" }));
-}
-var C = {}, x = {};
-Object.defineProperty(x, "__esModule", { value: !0 });
-x.loadRemoteModule = x.setRemoteDefinitions = x.setRemoteUrlResolver = void 0;
-let w, R;
-const k = /* @__PURE__ */ new Map(), S = /* @__PURE__ */ new Map();
-let D = !1;
-function K(s) {
-  R = s;
-}
-x.setRemoteUrlResolver = K;
-function F(s) {
-  w = s;
-}
-x.setRemoteDefinitions = F;
-async function M(s, e) {
-  const t = `${s}:${e}`;
-  if (k.has(t))
-    return k.get(t);
-  const i = (await (S.has(s) ? S.get(s) : await V(s)).get(e))();
-  return k.set(t, i), i;
-}
-x.loadRemoteModule = M;
-const N = (s, e) => new Promise((t, n) => {
-  const r = document.createElement("script");
-  r.src = s, r.type = "text/javascript", r.async = !0, r.onload = () => {
-    t({
-      get: (a) => window[e].get(a),
-      init: (a) => {
-        try {
-          window[e].init(a);
-        } catch (o) {
-          console.error(`Failed to initialize remote ${e}`, o), n(o);
-        }
-      }
-    });
-  }, r.onerror = () => n(new Error(`Remote ${e} not found`)), document.head.appendChild(r);
-});
-async function V(s) {
-  if (!R && !w)
-    throw new Error("Call setRemoteDefinitions or setRemoteUrlResolver to allow Dynamic Federation to find the remote apps correctly.");
-  D || (D = !0, await __webpack_init_sharing__("default"));
-  const e = w ? w[s] : await R(s);
-  let t = e;
-  !e.endsWith(".mjs") && !e.endsWith(".js") && (t = `${e}${e.endsWith("/") ? "" : "/"}remoteEntry.js`);
-  const n = await N(t, s);
-  return await n.init(__webpack_share_scopes__.default), S.set(s, n), n;
-}
-(function(s) {
-  Object.defineProperty(s, "__esModule", { value: !0 }), s.setRemoteUrlResolver = s.setRemoteDefinitions = s.loadRemoteModule = void 0;
-  var e = x;
-  Object.defineProperty(s, "loadRemoteModule", { enumerable: !0, get: function() {
-    return e.loadRemoteModule;
-  } }), Object.defineProperty(s, "setRemoteDefinitions", { enumerable: !0, get: function() {
-    return e.setRemoteDefinitions;
-  } }), Object.defineProperty(s, "setRemoteUrlResolver", { enumerable: !0, get: function() {
-    return e.setRemoteUrlResolver;
-  } });
-})(C);
-const oe = /* @__PURE__ */ A({
-  __proto__: null
-}, [C]);
-function B(s) {
-  var e;
-  try {
-    if ("shape" in s) {
-      const t = s, n = [];
-      for (const [r, i] of Object.entries(
-        t.shape
-      )) {
-        const a = i, o = {
-          name: r,
-          required: !a.isOptional()
-        };
-        if (a._def && a._def.description && (o.description = a._def.description), a._def) {
-          let c = a._def.typeName || "unknown";
-          c === "ZodOptional" && a._def.innerType && (c = ((e = a._def.innerType._def) == null ? void 0 : e.typeName) || "unknown"), o.type = c.replace("Zod", "").toLowerCase();
-        }
-        n.push(o);
-      }
-      return n;
-    }
-    return [];
-  } catch (t) {
-    return console.warn("Failed to extract schema field info:", t), [];
-  }
-}
-class L {
-  constructor() {
-    E(this, "issues", []);
-  }
-  addError(e) {
-    this.issues.push({ type: "error", message: e });
-  }
-  addWarning(e) {
-    this.issues.push({ type: "warning", message: e });
-  }
-  addInfo(e) {
-    this.issues.push({ type: "info", message: e });
-  }
-  hasErrors() {
-    return this.issues.some((e) => e.type === "error");
-  }
-  hasIssues() {
-    return this.issues.length > 0;
-  }
-  getIssues() {
-    return [...this.issues];
-  }
-}
-class q {
-  constructor() {
-    E(this, "cache", /* @__PURE__ */ new Map());
-  }
-  set(e, t) {
-    this.cache.set(e, t);
-  }
-  get(e) {
-    return this.cache.get(e) || [];
-  }
-  clear() {
-    this.cache.clear();
-  }
-}
-const v = new q();
-function re(s) {
-  return v.get(s);
-}
-const U = [];
-function H(s) {
-  U.push(s);
-}
-function z(s, e, t) {
-  return U.reduce(
-    (n, r) => r(n, e, t),
-    s
-  );
-}
-class G {
-  constructor() {
-    E(this, "extensionPoints", /* @__PURE__ */ new Map());
-  }
-  define(e) {
-    if (this.extensionPoints.has(e.id))
-      return console.warn(`Extension point ${e.id} is already defined`), this.extensionPoints.get(e.id);
-    const t = {
-      config: e,
-      id: e.id,
-      isRegistered: !1,
-      getExtensions: (n) => n[e.id] || {},
-      register: () => {
-        if (t.isRegistered) {
-          console.warn(`Extension point ${e.id} is already registered`);
-          return;
-        }
-        const n = this.createReducer(e);
-        H(n), t.isRegistered = !0;
-      }
-    };
-    return e.schema && (t.getSchemaFieldInfo = () => B(e.schema)), this.extensionPoints.set(e.id, t), t;
-  }
-  createReducer(e) {
-    return (t, n, r) => {
-      const i = n[e.contributionKey];
-      return !i || typeof i != "object" || Object.entries(i).forEach(
-        ([a, o]) => {
-          var g, h;
-          if (!o)
-            return;
-          const c = {
-            remote: o.remote || "",
-            sectionId: o.sectionId || a,
-            experiences: r,
-            contributions: n
-          };
-          if (e.validate) {
-            const d = new L();
-            if (e.validate(
-              o,
-              d
-            ) === "skip") {
-              v.set(a, [
-                {
-                  type: "warning",
-                  message: "Plugin marked to skip processing"
-                }
-              ]);
-              return;
-            }
-            if (d.hasIssues()) {
-              const b = d.getIssues().map((m) => ({
-                ...m,
-                message: `Extension point validation: ${m.message}`
-              }));
-              if (v.set(a, b), d.hasErrors()) {
-                console.error(
-                  `Validation failed for ${e.id} contribution "${a}":`,
-                  b.filter((m) => m.type === "error").map((m) => m.message).join(", ")
-                );
-                return;
-              }
-            } else
-              v.set(a, []);
-          }
-          const u = e.transform ? e.transform(o, c) : o;
-          t[e.id] || (t[e.id] = {});
-          const l = {
-            id: a,
-            type: e.contributionKey,
-            data: u,
-            remote: c.remote,
-            sectionId: c.sectionId
-          };
-          if (e.isRankable && typeof o.rank == "number" && (l.rank = o.rank), u && typeof u == "object" && ("component" in u && (l.component = u.component), "view" in u && (l.view = u.view), "location" in u && (l.location = u.location)), t[e.id][a] = l, e.hasView && ((g = e.relatedPoints) != null && g.view)) {
-            const d = o.experienceId, p = r == null ? void 0 : r[d];
-            p && (t[e.relatedPoints.view] || (t[e.relatedPoints.view] = {}), t[e.relatedPoints.view][a] = {
-              id: a,
-              type: `${e.contributionKey}.view`,
-              data: p,
-              remote: c.remote,
-              sectionId: c.sectionId
-            });
-          }
-          (h = e.relatedPoints) != null && h.definition && (t[e.relatedPoints.definition] || (t[e.relatedPoints.definition] = {}), t[e.relatedPoints.definition][a] = {
-            id: a,
-            type: `${e.contributionKey}.definition`,
-            data: u,
-            remote: c.remote,
-            sectionId: c.sectionId
-          });
-        }
-      ), t;
-    };
-  }
-  /**
-   * Get all registered extension points (for discovery/documentation)
-   */
-  getAllExtensionPoints() {
-    return Array.from(this.extensionPoints.values()).filter(
-      (e) => e.isRegistered
-    );
-  }
-  /**
-   * Get all defined extension points (registered and unregistered)
-   */
-  getAllDefinedExtensionPoints() {
-    return Array.from(this.extensionPoints.values());
-  }
-  /**
-   * Get a specific extension point definition
-   */
-  getExtensionPoint(e) {
-    return this.extensionPoints.get(e);
-  }
-  /**
-   * Check if an extension point is registered
-   */
-  hasExtensionPoint(e) {
-    return this.extensionPoints.has(e);
-  }
-}
-const W = new G();
-function y() {
-  return W;
-}
-const Y = (s) => (e, t) => {
-  var c;
-  const n = s[t].remote, r = t, i = (c = s[t].contributes) == null ? void 0 : c.experiences;
-  return Object.keys(i).forEach((u) => {
-    const l = i[u];
-    e.experiences[u] = {
-      ...l,
-      remote: n,
-      sectionId: r
-    };
-  }), y().getAllExtensionPoints().forEach((u) => {
-    var h;
-    const { contributionKey: l } = u.config, g = (h = s[t].contributes) == null ? void 0 : h[l];
-    g && (e[l] || (e[l] = {}), Array.isArray(g) ? g.forEach((d) => {
-      d && d.id && (e[l][d.id] = {
-        ...d,
-        remote: n,
-        sectionId: r
-      });
-    }) : typeof g == "object" && Object.entries(g).forEach(([d, p]) => {
-      e[l][d] = {
-        ...p,
-        id: d,
-        remote: n,
-        sectionId: r
-      };
-    }));
-  }), e;
-};
-async function Z(s) {
-  const e = s ?? window.KosPlugins.__dynamicRemotes;
-  if (window.KosPlugins.extensions) {
-    const i = window.KosPlugins.extensions;
-    return {
-      extensionPoints: i,
-      getExtensions: (a) => i[a] || [],
-      remotes: e,
-      extensions: window.KosPlugins.__extensions
-    };
-  }
-  const t = window.KosPlugins.__extensions ?? await J(e), n = {};
-  if (t)
-    for (const i of Object.keys(t))
-      n[i] = Object.values(
-        t[i] || {}
-      );
-  return window.KosPlugins.extensions = n, { extensionPoints: n, getExtensions: (i) => n[i] || [], remotes: e, extensions: t };
-}
-const j = {
-  controlPourDefinitions: {},
-  experiences: {}
-};
-function Q(s) {
-  return s ? Object.keys(s).reduce(Y(s), {
-    ...j
-  }) : j;
-}
-async function J(s) {
-  if (!s)
-    return window.KosPlugins = window.KosPlugins || {}, {};
-  for (const a of Object.values(s))
-    if (a.init)
-      try {
-        const o = await C.loadRemoteModule(
-          a.remote,
-          "./InitPlugin"
-        );
-        if (o.default) {
-          const c = new o.default();
-          c == null || c.register();
-        }
-      } catch (o) {
-        console.warn(`Failed to load InitPlugin from ${a.remote}:`, o);
-      }
-  const e = Q(s), t = e.experiences, r = z(
-    {},
-    e,
-    t
-  ), i = Object.keys(s).reduce((a, o) => {
-    const c = s[o].extensions ?? [];
-    for (const u of c)
-      a[u.extensionPointId] = a[u.extensionPointId] || {}, a[u.extensionPointId][u.id] = {
-        id: u.id,
-        type: u.type,
-        component: u.component,
-        remote: s[o].remote,
-        sectionId: o,
-        data: u
-      };
-    return a;
-  }, r);
-  return window.KosPlugins = window.KosPlugins || {}, window.KosPlugins.__extensions = i, i;
-}
-async function ae(s) {
-  const { getExtensions: e } = await Z();
-  return e(s);
-}
-const X = (s = null) => (s || window.location.search.replace("?", "")).split("&").map((e) => {
-  const [t, n] = e.split("=");
-  return [t, decodeURIComponent(n || "")];
-}).reduce((e, [t, n]) => (e[t] = n, e), {}), ee = () => {
-  const s = window.location.origin, e = X();
-  return (e == null ? void 0 : e.host) || s;
-}, ce = async (s) => {
-  var p, b;
-  const e = ee(), t = s ?? {}, {
-    pluginBaseUrl: n = e,
-    pluginApiPath: r = "/api/app/kosdev.ddk/ncui/plugins",
-    overrides: i = {},
-    pluginContext: a
-  } = t, o = !!a, c = o ? `${n}/api/kos/ui/plugins/context/${a.context}` : `${n}${r}`;
-  console.log(
-    `initialize-plugins: Using Plugin Framework: ${o}:  Fetching plugins from ${c}`
-  );
-  const l = await (await fetch(c)).json(), g = o ? ((b = (p = l.data) == null ? void 0 : p.groups) == null ? void 0 : b[a.group]) ?? [] : l.data ?? [], h = g == null ? void 0 : g.reduce((m, f) => {
-    const $ = (i == null ? void 0 : i[f.id]) ?? o ? `${n}${f.path}` : `${n}${f.baseUrl}`;
-    return f.descriptor ? m[f.id] = {
-      basePath: `${$}remoteEntry.js`,
-      extensions: f.descriptor.extensions,
-      contributes: f.descriptor.contributes,
-      remote: f.descriptor.id,
-      init: !!f.descriptor.init
-    } : console.error(
-      `initialize-plugins: Plugin ${f.id} does not have a descriptor`
-    ), m;
-  }, {});
-  window.KosPlugins = window.KosPlugins || {}, window.KosPlugins.__dynamicRemotes = h;
-  const d = Object.keys(h).reduce((m, f) => {
-    const $ = h[f].remote;
-    return m[$] = h[f].basePath, m;
-  }, {});
-  return C.setRemoteDefinitions(d), d;
-};
-function ue(s, e, t = !1) {
-  return !s || Object.keys(s).length === 0 ? null : t ? e && s[e] ? s[e] : null : e && s[e] ? s[e] : Object.values(s).filter((r) => typeof r.id == "string").sort((r, i) => {
-    const a = typeof r.rank == "number" ? r.rank : 1 / 0, o = typeof i.rank == "number" ? i.rank : 1 / 0;
-    if (a === o) {
-      const c = r.id ?? "", u = i.id ?? "";
-      return c.localeCompare(u);
-    }
-    return a - o;
-  })[0] ?? null;
-}
-const O = P.object({
-  id: P.string().min(1, "ID is required").describe("Unique identifier for this extension"),
-  title: P.string().min(1, "Title is required").describe("Display title shown in the interface"),
-  namespace: P.string().min(1, "Namespace is required").describe("Namespace for organizing related extensions"),
-  experienceId: P.string().min(1, "Experience ID is required").describe("Reference to the UI component experience for rendering")
-}), te = O.extend({
-  rank: P.number().int().min(0).optional().describe("Optional ranking for ordering (higher = preferred)")
-});
-function le(s, e, t) {
-  const n = s.safeParse(e);
-  return n.success ? !0 : (n.error.errors.forEach((r) => {
-    t.addError(`${r.path.join(".")}: ${r.message}`);
-  }), !1);
-}
-function de(s, e, t) {
-  e && !e.includes(".") && t.addWarning(
-    `${s} '${e}' should typically include dot notation (e.g., 'category.item')`
-  );
-}
-function ne(s, e, t = 1e3) {
-  s !== void 0 && s > t && e.addWarning(
-    `Rank ${s} seems unusually high - consider using lower values for better ordering`
-  );
-}
-function pe(s, e = {}) {
-  return (e.rankable ? te : O).extend(s);
-}
-function ge(s, e, t = 1e3) {
-  typeof s == "object" && s !== null && "rank" in s && ne(s.rank, e, t);
-}
-class I {
-  /**
-   * Get all extension points with their plugin information
-   */
-  static getExtensionPoints(e, t = {}) {
-    const {
-      includeLegacyExtensions: n = !0,
-      includeEmptyExtensionPoints: r = !0
-    } = t, a = y().getAllExtensionPoints(), o = [];
-    return a.forEach((c) => {
-      const u = Object.values((e == null ? void 0 : e[c.id]) || {});
-      !r && u.length === 0 || o.push({
-        id: c.id,
-        displayName: c.config.displayName,
-        description: c.config.description,
-        source: "simplified",
-        metadata: c.config.metadata,
-        pluginCount: u.length,
-        plugins: u
-      });
-    }), n && e && Object.entries(e).forEach(([c, u]) => {
-      if (o.some((g) => g.id === c))
-        return;
-      const l = Object.values(u || {});
-      !r && l.length === 0 || o.push({
-        id: c,
-        source: "legacy",
-        pluginCount: l.length,
-        plugins: l
-      });
-    }), o.sort((c, u) => c.id.localeCompare(u.id));
-  }
-  /**
-   * Filter extension points based on search criteria
-   */
-  static filterExtensionPoints(e, t) {
-    if (!t.trim())
-      return e;
-    const n = t.toLowerCase();
-    return e.filter(
-      (r) => {
-        var i, a, o, c, u, l;
-        return r.id.toLowerCase().includes(n) || ((i = r.displayName) == null ? void 0 : i.toLowerCase().includes(n)) || ((a = r.description) == null ? void 0 : a.toLowerCase().includes(n)) || ((c = (o = r.metadata) == null ? void 0 : o.category) == null ? void 0 : c.toLowerCase().includes(n)) || ((l = (u = r.metadata) == null ? void 0 : u.tags) == null ? void 0 : l.some((g) => g.toLowerCase().includes(n)));
-      }
-    );
-  }
-  /**
-   * Calculate health statistics for the plugin system
-   */
-  static calculateHealthStats(e) {
-    const t = e.length, n = e.filter(
-      (c) => c.pluginCount > 0
-    ).length, r = e.reduce(
-      (c, u) => c + u.pluginCount,
-      0
-    ), i = e.filter(
-      (c) => c.source === "simplified"
-    ).length, a = e.filter(
-      (c) => c.source === "legacy"
-    ).length, o = e.filter(
-      (c) => {
-        var u;
-        return (u = c.metadata) == null ? void 0 : u.deprecated;
-      }
-    ).length;
-    return {
-      totalExtensionPoints: t,
-      extensionPointsWithPlugins: n,
-      totalPlugins: r,
-      simplifiedExtensionPoints: i,
-      legacyExtensionPoints: a,
-      deprecatedExtensionPoints: o
-    };
-  }
-  /**
-   * Analyze a specific plugin for health and capabilities
-   */
-  static analyzePlugin(e) {
-    const t = !!e.component, n = typeof e.rank == "number", r = e.rank || 0, i = [];
-    if (t ? i.push("UI Component") : i.push("Background Service"), n && i.push(`Rank: ${r}`), e.namespace) {
-      const o = e.namespace;
-      o.includes("kos") || o.includes("ddk") ? i.push("First-party") : i.push("Third-party");
-    }
-    e.modalMode && i.push(`Modal: ${e.modalMode}`);
-    let a = "healthy";
-    return e.remote || (a = "warning"), {
-      hasComponent: t,
-      hasRank: n,
-      healthStatus: a,
-      capabilities: i
-    };
-  }
-  /**
-   * Get extension point by ID with detailed information
-   */
-  static getExtensionPointById(e, t) {
-    return e.find((n) => n.id === t);
-  }
-  /**
-   * Validate if an extension point ID follows conventions
-   */
-  static validateExtensionPointId(e) {
-    const t = [], n = [];
-    e.includes(".") || (t.push(
-      "Extension point ID should contain at least one dot (namespace.feature)"
-    ), n.push('Use format like "ddk.myFeature" or "app.myFeature"'));
-    const r = e.split(".");
-    r.length < 2 && t.push(
-      "Extension point ID should have at least 2 parts (namespace.feature)"
-    );
-    const i = r[0];
-    return i && !["ddk", "cui", "app"].includes(i) && !i.endsWith("app") && n.push(
-      "Consider using standard namespaces: ddk, cui, or [appname]app"
-    ), r.some((o) => /[A-Z]/.test(o)) && (t.push("Extension point ID parts should be lowercase"), n.push(
-      'Use kebab-case or dot notation: "my.feature" not "my.myFeature"'
-    )), {
-      isValid: t.length === 0,
-      issues: t,
-      suggestions: n
-    };
-  }
-  /**
-   * Validate a plugin descriptor structure and content
-   */
-  static validatePluginDescriptor(e) {
-    const t = [], n = [], r = [], i = [];
-    if (e.id ? e.id.match(/^[a-z0-9-]+$/) || i.push(
-      "Plugin ID convention: use lowercase letters, numbers, and hyphens (e.g., 'my-awesome-plugin')"
-    ) : (r.push("id"), t.push("Plugin descriptor must have an 'id' field")), !e.contributes)
-      n.push(
-        "Plugin has no contributions - it won't extend any functionality"
-      ), i.push("Add a 'contributes' section with plugin contributions");
-    else {
-      const a = Object.keys(e.contributes);
-      a.length === 0 && n.push("Plugin contributes section is empty"), a.forEach((o) => {
-        const c = e.contributes[o];
-        if (!Array.isArray(c)) {
-          t.push(`Contribution '${o}' must be an array`);
-          return;
-        }
-        c.forEach((u, l) => {
-          u.id || t.push(
-            `Contribution ${o}[${l}] missing required 'id' field`
-          ), o === "experiences" && u.component && !u.location && (t.push(
-            `Experience '${u.id}' has component but no location`
-          ), i.push(
-            "Add 'location' field pointing to the component file"
-          )), ["cui", "utilities", "settings", "setup"].includes(o) && (u.title || n.push(
-            `${o} contribution '${u.id}' missing 'title' field`
-          ), u.namespace || n.push(
-            `${o} contribution '${u.id}' missing 'namespace' field`
-          ), u.experienceId || t.push(
-            `${o} contribution '${u.id}' missing required 'experienceId' field`
-          ));
-        });
-      });
-    }
-    return e.init !== void 0 && typeof e.init != "boolean" && t.push("'init' field must be a boolean value"), {
-      isValid: t.length === 0 && r.length === 0,
-      errors: t,
-      warnings: n,
-      missingRequired: r,
-      suggestions: i
-    };
-  }
-  /**
-   * Check compatibility between plugin contributions and available extension points
-   */
-  static checkPluginCompatibility(e, t) {
-    const n = [], r = [], i = [], a = [];
-    if (!e.contributes)
-      return {
-        isCompatible: !0,
-        issues: ["Plugin has no contributions to check"],
-        missingExtensionPoints: [],
-        incompatibleTypes: [],
-        suggestions: []
-      };
-    const o = y(), c = new Set(
-      t.map((u) => u.id)
-    );
-    return Object.entries(e.contributes).forEach(
-      ([u, l]) => {
-        this.getExpectedExtensionPoints(u).forEach((p) => {
-          c.has(p) || (r.push(p), n.push(
-            `Extension point '${p}' not available for '${u}' contributions`
-          ), a.push(
-            `Ensure the extension point '${p}' is registered`
-          ));
-        });
-        const d = o.getAllExtensionPoints().find(
-          (p) => p.config.contributionKey === u
-        );
-        d && l.length > 0 && l.forEach((p, b) => {
-          d.config.isRankable && typeof p.rank != "number" && (n.push(
-            `${u}[${b}]: Extension point '${d.id}' expects 'rank' property`
-          ), a.push(
-            "Add 'rank' property with numeric value for ordering"
-          )), d.config.hasView && !p.experienceId && (n.push(
-            `${u}[${b}]: Extension point '${d.id}' expects 'experienceId' for view-based contributions`
-          ), a.push(
-            "Add 'experienceId' property linking to an experience definition"
-          ));
-        });
-      }
-    ), {
-      isCompatible: n.length === 0,
-      issues: n,
-      missingExtensionPoints: r,
-      incompatibleTypes: i,
-      suggestions: a
-    };
-  }
-  /**
-   * Map contribution keys to their expected extension point IDs
-   */
-  static getExpectedExtensionPoints(e) {
-    return {
-      cui: ["ddk.cui", "ddk.cui.view", "ddk.cui.settings.config"],
-      utilities: ["ddk.utility", "ddk.utility.view", "ddk.utilities"],
-      setup: ["ddk.setup", "ddk.setup.view"],
-      settings: ["ddk.settings", "ddk.settings.view"],
-      troubleActions: ["ddk.troubleAction", "ddk.troubleAction.view"],
-      navViews: ["ddk.nav", "ddk.nav.view"],
-      controlPour: ["ddk.controlPour", "ddk.controlPour.view"],
-      experiences: [],
-      // Experiences don't directly map to extension points
-      views: []
-      // Views are mapped by their extension point ID keys
-    }[e] || [];
-  }
-  /**
-   * Get comprehensive plugin analysis including validation and compatibility
-   */
-  static analyzePluginDescriptor(e, t) {
-    const n = this.validatePluginDescriptor(e), r = this.checkPluginCompatibility(
-      e,
-      t
-    ), i = [];
-    return n.warnings.length > 0 && i.push(
-      "Address validation warnings to improve plugin quality"
-    ), r.isCompatible || i.push(
-      "Resolve compatibility issues before deploying plugin"
-    ), e.contributes && Object.keys(e.contributes).length === 1 && i.push(
-      "Consider adding more contribution types to increase plugin value"
-    ), {
-      validation: n,
-      compatibility: r,
-      recommendations: i
-    };
-  }
-}
-class fe {
-  /**
-   * Generate complete documentation for all extension points
-   */
-  static generateFullDocumentation(e, t = {}) {
-    const {
-      includeUsageExamples: n = !0,
-      includeTypeDefinitions: r = !0,
-      includeLegacyExtensions: i = !0,
-      includePluginHealth: a = !0
-    } = t, o = I.getExtensionPoints(
-      e,
-      {
-        includeLegacyExtensions: i,
-        includeEmptyExtensionPoints: !0
-      }
-    ), c = I.calculateHealthStats(o);
-    let u = this.generateHeader(c);
-    return u += this.generateTableOfContents(o), u += this.generateOverviewSection(o, c), o.forEach((l) => {
-      u += this.generateExtensionPointSection(l, {
-        includeUsageExamples: n,
-        includePluginHealth: a
-      });
-    }), r && (u += this.generateTypeDefinitionsSection(o)), u += this.generateContributionGuide(), u += this.generateTroubleshootingSection(), {
-      content: u,
-      metadata: {
-        generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
-        totalExtensionPoints: c.totalExtensionPoints,
-        totalPlugins: c.totalPlugins,
-        simplifiedExtensionPoints: c.simplifiedExtensionPoints,
-        legacyExtensionPoints: c.legacyExtensionPoints
-      }
-    };
-  }
-  /**
-   * Generate documentation header with metadata
-   */
-  static generateHeader(e) {
-    return `# KOS Plugin Extension Points Reference
-
-**Generated**: ${(/* @__PURE__ */ new Date()).toLocaleString()}
-
-## System Overview
-
-- **Total Extension Points**: ${e.totalExtensionPoints}
-- **Extension Points with Plugins**: ${e.extensionPointsWithPlugins}
-- **Total Active Plugins**: ${e.totalPlugins}
-- **Simplified Extension Points**: ${e.simplifiedExtensionPoints}
-- **Legacy Extension Points**: ${e.legacyExtensionPoints}
-
----
-
-`;
-  }
-  /**
-   * Generate table of contents
-   */
-  static generateTableOfContents(e) {
-    let t = `## Table of Contents
-
-`;
-    return t += `- [Overview](#overview)
-`, t += `- [Extension Points](#extension-points)
-`, e.forEach((n) => {
-      const r = n.id.toLowerCase().replace(/\./g, "");
-      t += `  - [${n.id}](#${r}) (${n.pluginCount} plugins)
-`;
-    }), t += `- [Type Definitions](#type-definitions)
-`, t += `- [Contribution Guide](#contribution-guide)
-`, t += `- [Troubleshooting](#troubleshooting)
-
-`, t;
-  }
-  /**
-   * Generate overview section with health statistics
-   */
-  static generateOverviewSection(e, t) {
-    let n = `## Overview
-
-`;
-    return n += "This document provides a comprehensive reference for all available extension points in the KOS plugin system. ", n += `Extension points allow plugins to contribute functionality to the application.
-
-`, n += `### Extension Point Types
-
-`, n += "- **✨ Simplified Extension Points**: Use the new simplified API from `defineExtensionPoint`\n", n += `- **📚 Legacy Extension Points**: Use the traditional reducer-based system
-
-`, t.deprecatedExtensionPoints > 0 && (n += `### ⚠️ Deprecated Extension Points
-
-`, n += `${t.deprecatedExtensionPoints} extension points are marked as deprecated. `, n += `Consider migrating to newer alternatives.
-
-`), n + `---
-
-`;
-  }
-  /**
-   * Generate documentation section for a single extension point
-   */
-  static generateExtensionPointSection(e, t) {
-    var a;
-    const { includeUsageExamples: n = !0, includePluginHealth: r = !0 } = t;
-    let i = `## ${e.source === "simplified" ? "✨" : "📚"} ${e.id}
-
-`;
-    if (e.displayName && (i += `**Display Name**: ${e.displayName}
-
-`), e.description && (i += `**Description**: ${e.description}
-
-`), i += `**Source**: ${e.source}
-`, i += `**Active Plugins**: ${e.pluginCount}
-
-`, e.metadata) {
-      i += `### Metadata
-
-`;
-      const o = e.metadata;
-      o.category && (i += `- **Category**: ${o.category}
-`), o.owner && (i += `- **Owner**: ${o.owner}
-`), o.since && (i += `- **Since**: ${o.since}
-`), (a = o.tags) != null && a.length && (i += `- **Tags**: ${o.tags.join(", ")}
-`), o.deprecated && (i += `- **⚠️ Status**: Deprecated
-`), i += `
-`;
-    }
-    return n && (i += this.generateUsageExamples(e)), e.plugins.length > 0 ? i += this.generatePluginList(
-      e.plugins,
-      r
-    ) : i += `### Plugins
-
-No plugins currently registered for this extension point.
-
-`, i += this.generateSchemaFieldsSection(e), i += this.generateContributionStructure(e), i + `---
-
-`;
-  }
-  /**
-   * Generate usage examples for an extension point
-   */
-  static generateUsageExamples(e) {
-    let t = `### Usage Examples
-
-`;
-    return e.source === "simplified" && (t += `#### Using Simplified API
-
-`, t += "```typescript\n", t += `// Import the extension point
-`, t += `import { ${this.getExtensionPointImportName(
-      e.id
-    )} } from './extension-points';
-
-`, t += `// Use extension component hook
-`, t += `import { useExtensionComponent } from '@kosdev-code/kos-ui-plugin';
-
-`, t += `const Component = useExtensionComponent(${this.getExtensionPointImportName(
-      e.id
-    )});
-
-`, t += `if (Component) {
-`, t += `  return (
-`, t += `    <Component 
-`, t += `      customProp="value"
-`, t += `      onComplete={handleComplete}
-`, t += `    />
-`, t += `  );
-`, t += `}
-
-`, t += `// Or use with dynamic component
-`, t += `const [Component] = useDynamicComponent({
-`, t += `  extension: ${this.getExtensionPointImportName(
-      e.id
-    )}.id
-`, t += `});
-`, t += "```\n\n", t += `#### Using Typed Hooks
-
-`, t += "```typescript\n", t += `// Get all extensions with type safety
-`, t += `const extensions = useExtensions(${this.getExtensionPointImportName(
-      e.id
-    )});
-
-`, t += `// Get best extension
-`, t += `const bestExtension = useBest(${this.getExtensionPointImportName(
-      e.id
-    )});
-
-`, t += `// Check availability
-`, t += `const hasExtensions = useHasExtensions(${this.getExtensionPointImportName(
-      e.id
-    )});
-`, t += "```\n\n"), t += `#### Using DynamicComponent
-
-`, t += "```typescript\n", t += `import { DynamicComponent } from '@kosdev-code/kos-ui-plugin';
-`, t += `import { ${this.getExtensionPointImportName(
-      e.id
-    )} } from './extension-points';
-
-`, t += `<DynamicComponent
-`, t += `  extension={${this.getExtensionPointImportName(
-      e.id
-    )}.id}
-`, t += `  props={{ customData: "value" }}
-`, t += `  fallback={<div>Loading...</div>}
-`, t += `/>
-`, t += "```\n\n", t += `#### Using Context
-
-`, t += "```typescript\n", t += `import { useKosPluginsContext } from '@kosdev-code/kos-ui-plugin';
-`, t += `import { ${this.getExtensionPointImportName(
-      e.id
-    )} } from './extension-points';
-
-`, t += `const { getExtensions } = useKosPluginsContext();
-`, t += `const extensions = getExtensions(${this.getExtensionPointImportName(
-      e.id
-    )}.id);
-`, t += "```\n\n", t;
-  }
-  /**
-   * Generate plugin list with health information
-   */
-  static generatePluginList(e, t) {
-    let n = `### Active Plugins
-
-`;
-    return e.forEach((r) => {
-      if (n += `#### ${r.id}
-
-`, r.remote && (n += `- **Remote**: ${r.remote}
-`), r.sectionId && (n += `- **Section**: ${r.sectionId}
-`), r.rank !== void 0 && (n += `- **Rank**: ${r.rank}
-`), t) {
-        const i = I.analyzePlugin(r);
-        n += `- **Health**: ${this.getHealthEmoji(i.healthStatus)} ${i.healthStatus}
-`, i.capabilities.length > 0 && (n += `- **Capabilities**: ${i.capabilities.join(", ")}
-`);
-      }
-      n += `
-`;
-    }), n;
-  }
-  /**
-   * Generate schema fields documentation
-   */
-  static generateSchemaFieldsSection(e) {
-    if (e.source !== "simplified")
-      return "";
-    const n = y().getExtensionPoint(e.id);
-    if (!(n != null && n.getSchemaFieldInfo))
-      return "";
-    const r = n.getSchemaFieldInfo();
-    if (r.length === 0)
-      return "";
-    let i = `### Schema Fields
-
-`;
-    return i += `The following fields are defined in the schema for this extension point:
-
-`, i += `| Field | Type | Required | Description |
-`, i += `|-------|------|----------|-------------|
-`, r.forEach((a) => {
-      const o = a.name, c = a.type || "unknown", u = a.required ? "✅" : "⭕", l = a.description || "-";
-      i += `| \`${o}\` | ${c} | ${u} | ${l} |
-`;
-    }), i += `
-`, i;
-  }
-  /**
-   * Generate contribution structure documentation
-   */
-  static generateContributionStructure(e) {
-    let t = `### Contribution Structure
-
-`;
-    t += `To contribute to this extension point, add the following to your plugin descriptor:
-
-`, t += "```json\n", t += `{
-`, t += `  "id": "your-plugin-id",
-`, t += `  "contributes": {
-`;
-    const n = this.inferContributionKey(e);
-    t += `    "${n}": [
-`, t += `      {
-`;
-    const r = this.getSchemaFieldsForContribution(e);
-    if (r.length > 0) {
-      const a = [];
-      r.forEach((o) => {
-        let c;
-        o.name === "id" ? c = '"your-contribution-id"' : o.name === "title" ? c = '"Your Contribution Title"' : o.name === "namespace" ? c = '"your-namespace"' : o.name === "experienceId" ? c = '"your-experience-id"' : o.name === "dashboardKey" ? c = '"your-dashboard-key"' : o.name === "rank" ? c = "10" : o.type === "string" ? c = `"your-${o.name}"` : o.type === "number" ? c = "0" : o.type === "boolean" ? c = "false" : c = `"your-${o.name}"`, (o.required || ["experienceId", "rank", "dashboardKey"].includes(o.name)) && a.push(`        "${o.name}": ${c}`);
-      }), t += a.join(`,
-`);
-    } else {
-      t += `        "id": "your-contribution-id",
-`, t += `        "title": "Your Contribution Title",
-`, t += '        "namespace": "your-namespace"', this.isViewBasedExtensionPoint(e) && (t += `,
-        "experienceId": "your-experience-id"`), this.isRankableExtensionPoint(e) && (t += `,
-        "rank": 10`);
-      const a = this.getSpecificFields(e);
-      a.length > 0 && (t += `,
-        ${a.join(`,
-        `)}`);
-    }
-    return t += `
-      }
-`, t += "    ]", (r.some((a) => a.name === "experienceId") || this.isViewBasedExtensionPoint(e)) && (t += `,
-    "experiences": {
-`, t += `      "your-experience-id": {
-`, t += `        "id": "your-experience-id",
-`, t += `        "component": "YourComponent",
-`, t += `        "location": "./src/components/YourComponent.tsx"
-`, t += `      }
-`, t += "    }"), t += `
-  }
-`, t += `}
-`, t += "```\n\n", t;
-  }
-  /**
-   * Generate TypeScript definitions section
-   */
-  static generateTypeDefinitionsSection(e) {
-    let t = `## Type Definitions
-
-`;
-    return t += `### Extension Point Types
-
-`, t += "```typescript\n", e.forEach((n) => {
-      n.source === "simplified" && (t += `// ${n.id}
-`, t += `interface ${this.getExtensionPointTypeName(n.id)} {
-`, t += `  id: "${n.id}";
-`, t += `  displayName?: "${n.displayName || ""}";
-`, t += `  description?: "${n.description || ""}";
-`, t += `}
-
-`);
-    }), t += "```\n\n", t += `### Plugin Contribution Types
-
-`, t += "```typescript\n", t += `interface BaseContribution {
-`, t += `  id: string;
-`, t += `  title: string;
-`, t += `  namespace: string;
-`, t += `}
-
-`, t += `interface ViewBasedContribution extends BaseContribution {
-`, t += `  experienceId: string;
-`, t += `}
-
-`, t += `interface RankableContribution extends BaseContribution {
-`, t += `  rank: number;
-`, t += `}
-`, t += "```\n\n", t;
-  }
-  /**
-   * Generate contribution guide
-   */
-  static generateContributionGuide() {
-    return `## Contribution Guide
-
-### Creating a Plugin
-
-1. **Create Plugin Project**
-   \`\`\`bash
-   kosui plugin-project --name my-plugin
-   \`\`\`
-
-2. **Add Components**
-   \`\`\`bash
-   kosui component --name MyComponent --pluginType utility --project my-plugin
-   \`\`\`
-
-3. **Update Plugin Descriptor**
-   Add contributions to your \`kosdev-plugin.json\` file following the structure examples above.
-
-4. **Test Integration**
-   Use the Plugin Explorer (Ctrl+Shift+P) to validate your plugin registration.
-
-### Best Practices
-
-- **Use descriptive IDs**: Plugin and contribution IDs should be clear and unique
-- **Follow naming conventions**: Use kebab-case for IDs, PascalCase for components
-- **Provide meaningful titles**: Titles are shown to users in the interface
-- **Set appropriate ranks**: Higher numbers = higher priority for rankable contributions
-- **Include proper metadata**: Namespace helps organize plugins by owner
-
-### Validation
-
-Use the Plugin Discovery Service to validate your plugin descriptor:
-
-\`\`\`typescript
-import { PluginDiscoveryService } from '@kosdev-code/kos-ui-plugin';
-
-const validation = PluginDiscoveryService.validatePluginDescriptor(yourDescriptor);
-console.log(validation.errors); // Check for errors
-console.log(validation.warnings); // Check for warnings
-\`\`\`
-
-`;
-  }
-  /**
-   * Generate troubleshooting section
-   */
-  static generateTroubleshootingSection() {
-    return `## Troubleshooting
-
-### Common Issues
-
-**Plugin not appearing in extension point**
-- Check plugin descriptor syntax
-- Verify contribution key matches extension point requirements
-- Ensure experienceId references exist in experiences section
-
-**Component fails to load**
-- Verify component path in experience location
-- Check module federation configuration
-- Use Plugin Explorer to see detailed error messages
-
-**Type errors with simplified extension points**
-- Ensure extension point is properly imported
-- Check that component props match expected interface
-- Verify extension point is registered before use
-
-### Debugging Tools
-
-**Plugin Explorer**
-- Press Ctrl+Shift+P in development mode
-- View all extension points and their plugins
-- See plugin health status and capabilities
-- Test component rendering with error boundaries
-
-**Validation Service**
-- Use \`PluginDiscoveryService.validatePluginDescriptor()\`
-- Check \`PluginDiscoveryService.checkPluginCompatibility()\`
-- Run \`PluginDiscoveryService.analyzePluginDescriptor()\` for full analysis
-
-**Browser DevTools**
-- Check \`window.KosPlugins.extensions\` for runtime state
-- Look for module federation errors in Network tab
-- Use React DevTools to inspect component loading
-
----
-
-*Generated by KOS Plugin Documentation Generator*
-`;
-  }
-  // Helper methods
-  static getExtensionPointImportName(e) {
-    var a;
-    const n = y().getExtensionPoint(e);
-    if ((a = n == null ? void 0 : n.config.metadata) != null && a.exportName)
-      return n.config.metadata.exportName;
-    const r = e.split(".");
-    return (r.length > 1 ? r.slice(1) : r).map(
-      (o) => (
-        // Handle hyphenated parts (e.g., "pump-detail" -> "PumpDetail")
-        o.split("-").map((c) => c.charAt(0).toUpperCase() + c.slice(1)).join("")
-      )
-    ).join("") + "Extension";
-  }
-  static getExtensionPointTypeName(e) {
-    return this.getExtensionPointImportName(e) + "Type";
-  }
-  static getHealthEmoji(e) {
-    switch (e) {
-      case "healthy":
-        return "✅";
-      case "warning":
-        return "⚠️";
-      case "error":
-        return "❌";
-      default:
-        return "❓";
-    }
-  }
-  static inferContributionKey(e) {
-    if (e.source === "simplified") {
-      const a = y().getExtensionPoint(e.id);
-      if (a != null && a.config.contributionKey)
-        return a.config.contributionKey;
-    }
-    const t = e.id.split("."), n = t[t.length - 1];
-    return {
-      cui: "cui",
-      utility: "utilities",
-      utilities: "utilities",
-      setup: "setupStep",
-      settings: "settings",
-      nav: "navViews",
-      troubleAction: "troubleActions",
-      controlPour: "controlPour"
-    }[n] || n + "s";
-  }
-  static isViewBasedExtensionPoint(e) {
-    if (e.source === "simplified") {
-      const n = y().getExtensionPoint(e.id);
-      return (n == null ? void 0 : n.config.hasView) || !1;
-    }
-    return e.plugins.some(
-      (t) => t.experienceId
-    );
-  }
-  static isRankableExtensionPoint(e) {
-    if (e.source === "simplified") {
-      const n = y().getExtensionPoint(e.id);
-      return (n == null ? void 0 : n.config.isRankable) || !1;
-    }
-    return e.plugins.some(
-      (t) => typeof t.rank == "number"
-    );
-  }
-  /**
-   * Get schema fields for contribution structure generation
-   */
-  static getSchemaFieldsForContribution(e) {
-    if (e.source !== "simplified")
-      return [];
-    const n = y().getExtensionPoint(e.id);
-    return n != null && n.getSchemaFieldInfo ? n.getSchemaFieldInfo() : [];
-  }
-  static getSpecificFields(e) {
-    const t = [];
-    switch (this.inferContributionKey(e)) {
-      case "utilities":
-        t.push('"utilDescriptor": "your-util-descriptor"');
-        break;
-      case "setupStep":
-        t.push('"setupDescriptor": "your-setup-descriptor"');
-        break;
-      case "settings":
-        t.push('"settingsGroup": "your-settings-group"');
-        break;
-      case "navViews":
-        t.push('"navDescriptor": "your-nav-descriptor"');
-        break;
-      case "troubleActions":
-        t.push('"troubleType": "your-trouble-type"');
-        break;
-      case "cui":
-        t.push('"cuiDescriptor": "your-cui-descriptor"');
-        break;
-    }
-    return t;
-  }
-}
-export {
-  O as B,
-  fe as D,
-  I as P,
-  te as R,
-  ce as a,
-  Z as b,
-  y as c,
-  W as d,
-  Y as e,
-  Q as f,
-  re as g,
-  ae as h,
-  oe as i,
-  de as j,
-  ne as k,
-  J as l,
-  C as m,
-  pe as n,
-  ge as o,
-  ue as r,
-  le as v
-};
-//# sourceMappingURL=documentation-generator-B8FuhDjB.js.map