@qkix/strapi-plugin-blueprint 0.1.0

package/dist/server/index.js

@@ -0,0 +1,35 @@
+"use strict";const E=require("@dagrejs/dagre"),W=e=>e&&e.__esModule?e:{default:e},v=W(E),z={default:{exclude:[]},validator(e){if(e.exclude!==void 0&&!Array.isArray(e.exclude))throw new Error("[blueprint] `exclude` must be an array of content-type uids.")}},c={headerHeight:30,rowHeight:18,paddingX:12,charWidth:6.6,minWidth:150,maxWidth:320,typeGutter:74},f=12,A=e=>e.fields.length<=f?{fields:e.fields,hidden:0}:{fields:e.fields.slice(0,f),hidden:e.fields.length-f},F=e=>{const{fields:t,hidden:n}=A(e),i=Math.max(e.label.length+4,...t.map(l=>l.name.length+2),0),s=Math.min(c.maxWidth,Math.max(c.minWidth,i*c.charWidth+c.paddingX*2+c.typeGutter));return{width:Math.round(s),height:c.headerHeight+(t.length+(n>0?1:0))*c.rowHeight+8}},w=(e,t="TB")=>{const n=new v.default.graphlib.Graph({multigraph:!0});n.setGraph({rankdir:t,nodesep:40,ranksep:70,marginx:20,marginy:20}),n.setDefaultEdgeLabel(()=>({}));const i=new Map;for(const a of e.nodes){const r=F(a);i.set(a.uid,r),n.setNode(a.uid,{...r})}e.edges.forEach((a,r)=>{n.setEdge(a.from,a.to,{},`e${r}`)}),v.default.layout(n);const s=e.nodes.map(a=>{const r=n.node(a.uid),o=i.get(a.uid);return{...a,x:Math.round(r.x-o.width/2),y:Math.round(r.y-o.height/2),width:o.width,height:o.height}}),l=e.edges.map((a,r)=>{const o=n.edge(a.from,a.to,`e${r}`);return{...a,points:(o?.points??[]).map(x=>({x:Math.round(x.x),y:Math.round(x.y)}))}}),d=n.graph();return{nodes:s,edges:l,width:Math.ceil(d.width??0),height:Math.ceil(d.height??0)}},p=e=>e.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&apos;"),b=(e,t)=>{const n=Math.floor(t/c.charWidth);return e.length<=n?e:`${e.slice(0,Math.max(1,n-1))}…`},H=`
+  .bp-surface { fill: var(--bp-surface, #ffffff); }
+  .bp-box { fill: var(--bp-box, #ffffff); stroke: var(--bp-border, #dcdce4); }
+  .bp-box-component { fill: var(--bp-box-component, #f6f6f9); stroke: var(--bp-border, #dcdce4); }
+  /* A saturated stripe rather than a pale filled header: the 100-tones that
+     look right on a white page are almost black in a dark theme, and the three
+     kinds of box stop being told apart. These read on either. */
+  .bp-accent-collectionType { fill: var(--bp-accent, #4945ff); }
+  .bp-accent-component { fill: var(--bp-accent-component, #2f6846); }
+  .bp-accent-singleType { fill: var(--bp-accent-single, #d9822f); }
+  .bp-divider { stroke: var(--bp-border, #dcdce4); }
+  .bp-title { fill: var(--bp-title, #32324d); font-weight: 600; }
+  .bp-field { fill: var(--bp-field, #32324d); }
+  .bp-type { fill: var(--bp-type, #8e8ea9); }
+  .bp-edge { stroke: var(--bp-edge, #8e8ea9); fill: none; }
+  .bp-edge-component { stroke-dasharray: 5 3; }
+  .bp-edge-dynamiczone { stroke-dasharray: 2 3; }
+  text { font-family: var(--bp-font, ui-sans-serif, system-ui, sans-serif); font-size: 11px; }
+  .bp-title-text { font-size: 12px; }
+  /* Every box is a link to its content type, so it says so on hover. Written
+     into the drawing rather than added by the admin panel because the hit area
+     is the box, and only the drawing knows where that is. Harmless in a
+     downloaded file, where nothing is hovering anything. */
+  /* Only boxes that lead somewhere invite a click. A plugin's internal tables
+     are on the diagram because they are part of the schema, but the Content-Type
+     Builder has no page for them, so they get no pointer and no highlight. */
+  .bp-nodes > g[data-navigable="true"] { cursor: pointer; }
+  .bp-nodes > g[data-navigable="true"]:hover .bp-box,
+  .bp-nodes > g[data-navigable="true"]:hover .bp-box-component { fill: var(--bp-hover, #f0f0ff); }
+  /* The outline picks up the box's own stripe colour, so hovering a component
+     does not turn it the colour of a content type. */
+  .bp-nodes > g[data-navigable="true"][data-kind="collectionType"]:hover .bp-box { stroke: var(--bp-accent, #4945ff); }
+  .bp-nodes > g[data-navigable="true"][data-kind="singleType"]:hover .bp-box { stroke: var(--bp-accent-single, #d9822f); }
+  .bp-nodes > g[data-navigable="true"][data-kind="component"]:hover .bp-box-component { stroke: var(--bp-accent-component, #2f6846); }
+`,L=e=>`bp-accent-${e.kind}`,X=e=>{const{fields:t,hidden:n}=A(e),i=n>0?[`<text class="bp-type" x="${e.x+c.paddingX}" `,`y="${e.y+c.headerHeight+t.length*c.rowHeight+13}">`,`+${n} more`,"</text>"].join(""):"",s=t.map((l,d)=>{const a=e.y+c.headerHeight+d*c.rowHeight+13,r=e.width-c.paddingX*2-c.typeGutter,o=l.relation??l.type;return[`<text class="bp-field" x="${e.x+c.paddingX}" y="${a}">`,p(b(l.name,r)),l.required?'<tspan class="bp-type"> *</tspan>':"","</text>",`<text class="bp-type" x="${e.x+e.width-c.paddingX}" y="${a}" text-anchor="end">`,p(b(o,c.typeGutter)),"</text>"].join("")}).join("");return[`<g data-uid="${p(e.uid)}" data-kind="${e.kind}" data-navigable="${e.navigable}">`,`<rect class="${e.kind==="component"?"bp-box-component":"bp-box"}" `,`x="${e.x}" y="${e.y}" width="${e.width}" height="${e.height}" rx="4" />`,`<path class="${L(e)}" d="M${e.x},${e.y+4} a4,4 0 0 1 4,-4 h${e.width-8} a4,4 0 0 1 4,4 v2 h-${e.width} z" />`,`<line class="bp-divider" x1="${e.x}" y1="${e.y+c.headerHeight}" x2="${e.x+e.width}" y2="${e.y+c.headerHeight}" />`,`<text class="bp-title bp-title-text" x="${e.x+c.paddingX}" y="${e.y+21}">`,p(b(e.label,e.width-c.paddingX*2)),"</text>",s,i,"</g>"].join("")},D=e=>{if(e.length<3)return e.map((i,s)=>`${s===0?"M":"L"}${i.x},${i.y}`).join(" ");const t=[`M${e[0].x},${e[0].y}`];for(let i=1;i<e.length-1;i+=1){const s=e[i],l=e[i+1],d=Math.round((s.x+l.x)/2),a=Math.round((s.y+l.y)/2);t.push(`Q${s.x},${s.y} ${d},${a}`)}const n=e[e.length-1];return t.push(`L${n.x},${n.y}`),t.join(" ")},G=e=>{if(e.points.length===0)return"";const t=D(e.points);return[`<path class="bp-edge bp-edge-${e.kind}" d="${t}" `,`marker-end="url(#bp-arrow)" data-field="${p(e.field)}" />`].join("")},$=e=>{const t=Math.max(e.width,1),n=Math.max(e.height,1);return[`<svg xmlns="http://www.w3.org/2000/svg" width="${t}" height="${n}" `,`viewBox="0 0 ${t} ${n}" role="img" aria-label="Content type diagram">`,`<style>${H}</style>`,"<defs>",'<marker id="bp-arrow" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="6" markerHeight="6" orient="auto-start-reverse">','<path d="M0,0 L10,5 L0,10 z" fill="var(--bp-edge, #8e8ea9)" />',"</marker>","</defs>",`<rect class="bp-surface" x="0" y="0" width="${t}" height="${n}" />`,`<g class="bp-edges">${e.edges.map(G).join("")}</g>`,`<g class="bp-nodes">${e.nodes.map(X).join("")}</g>`,"</svg>"].join("")},u="blueprint",h=e=>e.plugin(u).service("graph"),m=(e,t)=>e===void 0||e===""?t:e!=="false"&&e!=="0"&&e!==!1,k=e=>{const t=Array.isArray(e)?e:typeof e=="string"?e.split(","):[];return[...new Set(t.map(n=>String(n).trim()).filter(Boolean))]},y=(e,t={})=>({includeForeign:m(t.foreign,!1),includeComponents:m(t.components,!0),includeDefaultFields:m(t.defaultFields,!1),exclude:[...k(t.exclude),...k(e.config.get(`plugin::${u}.exclude`,[]))]}),T=(e={})=>e.direction==="LR"?"LR":"TB",S=({strapi:e})=>({async svg(t){const n=h(e).build(y(e,t.query)),i=w(n,T(t.query));t.body={svg:$(i),width:i.width,height:i.height,counts:{nodes:n.nodes.length,edges:n.edges.length,components:n.nodes.filter(s=>s.kind==="component").length}}},async download(t){const n=h(e).build(y(e,t.query)),i=w(n,T(t.query));t.set("Content-Type","image/svg+xml; charset=utf-8"),t.set("Content-Disposition",'attachment; filename="blueprint.svg"'),t.body=$(i)},async graph(t){t.body=h(e).build(y(e,t.query))},async catalogue(t){t.body={contentTypes:h(e).catalogue()}}}),B={diagram:S},C=e=>t=>{const n=t.state?.userAbility;return n?n.can(`plugin::${u}.${e}`):!1},_={canRead:C("read")},q=({strapi:e})=>{const t=[{section:"plugins",displayName:"Access the schema diagram",uid:"read",pluginName:u}];e.admin?.services?.permission?.actionProvider?.registerMany?.(t)},g=["plugin::blueprint.canRead"],N={type:"admin",routes:[{method:"GET",path:"/diagram",handler:"diagram.svg",config:{policies:g}},{method:"GET",path:"/diagram.svg",handler:"diagram.download",config:{policies:g}},{method:"GET",path:"/graph",handler:"diagram.graph",config:{policies:g}},{method:"GET",path:"/content-types",handler:"diagram.catalogue",config:{policies:g}}]},R={admin:N},M=new Set(["createdAt","updatedAt","publishedAt","createdBy","updatedBy","locale","localizations"]),P={includeForeign:!1,includeComponents:!0,includeDefaultFields:!1,exclude:[]},I=e=>e.modelType==="component"||e.pluginOptions?.["content-type-builder"]?.visible!==!1,U=e=>{if(e.startsWith("api::"))return"api";const[t]=e.split(".");return t??e},O=e=>e.startsWith("api::"),j=e=>e.info?.displayName??e.info?.singularName??e.uid,Y=({strapi:e})=>{const t={build(n={}){const i={...P,...n},s=new Set(i.exclude),l=Object.values(e.contentTypes),d=Object.values(e.components??{}),a=new Map;for(const o of l)s.has(o.uid)||!i.includeForeign&&!O(o.uid)||a.set(o.uid,o);if(i.includeComponents)for(const o of d)s.has(o.uid)||a.set(o.uid,o);return{nodes:[...a.values()].map(o=>({uid:o.uid,kind:o.modelType==="component"?"component":o.kind==="singleType"?"singleType":"collectionType",label:j(o),group:o.modelType==="component"?o.category??"components":U(o.uid),foreign:o.modelType==="component"?!1:!O(o.uid),navigable:I(o),fields:t.fieldsOf(o,i)})),edges:t.edgesOf(a,i)}},fieldsOf(n,i){const s=[];for(const[l,d]of Object.entries(n.attributes??{}))!i.includeDefaultFields&&M.has(l)||s.push({name:l,type:d.type,...d.relation?{relation:d.relation}:{},...d.required?{required:!0}:{}});return s},edgesOf(n,i){const s=[],l=d=>{n.has(d.to)&&s.push(d)};for(const d of n.values())for(const[a,r]of Object.entries(d.attributes??{}))if(!(!i.includeDefaultFields&&M.has(a))){if(r.type==="relation"&&r.target){if(r.mappedBy)continue;l({from:d.uid,to:r.target,kind:"relation",field:a,cardinality:r.relation,many:(r.relation??"").endsWith("Many")});continue}if(r.type==="component"&&r.component){l({from:d.uid,to:r.component,kind:"component",field:a,many:r.repeatable===!0});continue}if(r.type==="dynamiczone")for(const o of r.components??[])l({from:d.uid,to:o,kind:"dynamiczone",field:a,many:!0})}return s},catalogue(){const n=Object.values(e.contentTypes),i=Object.values(e.components??{});return[...n,...i].map(s=>({uid:s.uid,label:j(s),kind:s.modelType==="component"?"component":s.kind??"collectionType"}))}};return t},Q={graph:Y},J={register:q,config:z,controllers:B,policies:_,routes:R,services:Q};module.exports=J;

package/dist/server/index.mjs

@@ -0,0 +1,438 @@
+import v from "@dagrejs/dagre";
+const E = {
+  default: {
+    /**
+     * Uids never to draw, whatever the UI asks for.
+     *
+     * For schemas with a corner nobody wants on the picture — a bulky
+     * integration type, a legacy import table. The UI can hide things too; this
+     * is the version that survives a page reload and applies to the API as well.
+     *
+     *   blueprint: {
+     *     enabled: true,
+     *     config: { exclude: ['api::import-log.import-log'] },
+     *   }
+     */
+    exclude: []
+  },
+  validator(e) {
+    if (e.exclude !== void 0 && !Array.isArray(e.exclude))
+      throw new Error("[blueprint] `exclude` must be an array of content-type uids.");
+  }
+}, c = {
+  headerHeight: 30,
+  rowHeight: 18,
+  paddingX: 12,
+  /** Rough width of one character at the font size the renderer uses. */
+  charWidth: 6.6,
+  minWidth: 150,
+  maxWidth: 320,
+  /** Room for the type, drawn right-aligned on the same row as the name. */
+  typeGutter: 74
+}, f = 12, A = (e) => e.fields.length <= f ? { fields: e.fields, hidden: 0 } : {
+  fields: e.fields.slice(0, f),
+  hidden: e.fields.length - f
+}, W = (e) => {
+  const { fields: t, hidden: n } = A(e), i = Math.max(
+    e.label.length + 4,
+    ...t.map((l) => l.name.length + 2),
+    0
+  ), s = Math.min(
+    c.maxWidth,
+    Math.max(
+      c.minWidth,
+      i * c.charWidth + c.paddingX * 2 + c.typeGutter
+    )
+  );
+  return {
+    width: Math.round(s),
+    height: c.headerHeight + (t.length + (n > 0 ? 1 : 0)) * c.rowHeight + 8
+  };
+}, w = (e, t = "TB") => {
+  const n = new v.graphlib.Graph({ multigraph: !0 });
+  n.setGraph({
+    rankdir: t,
+    nodesep: 40,
+    ranksep: 70,
+    marginx: 20,
+    marginy: 20
+  }), n.setDefaultEdgeLabel(() => ({}));
+  const i = /* @__PURE__ */ new Map();
+  for (const a of e.nodes) {
+    const r = W(a);
+    i.set(a.uid, r), n.setNode(a.uid, { ...r });
+  }
+  e.edges.forEach((a, r) => {
+    n.setEdge(a.from, a.to, {}, `e${r}`);
+  }), v.layout(n);
+  const s = e.nodes.map((a) => {
+    const r = n.node(a.uid), o = i.get(a.uid);
+    return {
+      ...a,
+      // dagre reports centres; everything downstream wants a top-left corner.
+      x: Math.round(r.x - o.width / 2),
+      y: Math.round(r.y - o.height / 2),
+      width: o.width,
+      height: o.height
+    };
+  }), l = e.edges.map((a, r) => {
+    const o = n.edge(a.from, a.to, `e${r}`);
+    return {
+      ...a,
+      points: (o?.points ?? []).map((x) => ({
+        x: Math.round(x.x),
+        y: Math.round(x.y)
+      }))
+    };
+  }), d = n.graph();
+  return {
+    nodes: s,
+    edges: l,
+    width: Math.ceil(d.width ?? 0),
+    height: Math.ceil(d.height ?? 0)
+  };
+}, p = (e) => e.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;"), b = (e, t) => {
+  const n = Math.floor(t / c.charWidth);
+  return e.length <= n ? e : `${e.slice(0, Math.max(1, n - 1))}…`;
+}, z = `
+  .bp-surface { fill: var(--bp-surface, #ffffff); }
+  .bp-box { fill: var(--bp-box, #ffffff); stroke: var(--bp-border, #dcdce4); }
+  .bp-box-component { fill: var(--bp-box-component, #f6f6f9); stroke: var(--bp-border, #dcdce4); }
+  /* A saturated stripe rather than a pale filled header: the 100-tones that
+     look right on a white page are almost black in a dark theme, and the three
+     kinds of box stop being told apart. These read on either. */
+  .bp-accent-collectionType { fill: var(--bp-accent, #4945ff); }
+  .bp-accent-component { fill: var(--bp-accent-component, #2f6846); }
+  .bp-accent-singleType { fill: var(--bp-accent-single, #d9822f); }
+  .bp-divider { stroke: var(--bp-border, #dcdce4); }
+  .bp-title { fill: var(--bp-title, #32324d); font-weight: 600; }
+  .bp-field { fill: var(--bp-field, #32324d); }
+  .bp-type { fill: var(--bp-type, #8e8ea9); }
+  .bp-edge { stroke: var(--bp-edge, #8e8ea9); fill: none; }
+  .bp-edge-component { stroke-dasharray: 5 3; }
+  .bp-edge-dynamiczone { stroke-dasharray: 2 3; }
+  text { font-family: var(--bp-font, ui-sans-serif, system-ui, sans-serif); font-size: 11px; }
+  .bp-title-text { font-size: 12px; }
+  /* Every box is a link to its content type, so it says so on hover. Written
+     into the drawing rather than added by the admin panel because the hit area
+     is the box, and only the drawing knows where that is. Harmless in a
+     downloaded file, where nothing is hovering anything. */
+  /* Only boxes that lead somewhere invite a click. A plugin's internal tables
+     are on the diagram because they are part of the schema, but the Content-Type
+     Builder has no page for them, so they get no pointer and no highlight. */
+  .bp-nodes > g[data-navigable="true"] { cursor: pointer; }
+  .bp-nodes > g[data-navigable="true"]:hover .bp-box,
+  .bp-nodes > g[data-navigable="true"]:hover .bp-box-component { fill: var(--bp-hover, #f0f0ff); }
+  /* The outline picks up the box's own stripe colour, so hovering a component
+     does not turn it the colour of a content type. */
+  .bp-nodes > g[data-navigable="true"][data-kind="collectionType"]:hover .bp-box { stroke: var(--bp-accent, #4945ff); }
+  .bp-nodes > g[data-navigable="true"][data-kind="singleType"]:hover .bp-box { stroke: var(--bp-accent-single, #d9822f); }
+  .bp-nodes > g[data-navigable="true"][data-kind="component"]:hover .bp-box-component { stroke: var(--bp-accent-component, #2f6846); }
+`, F = (e) => `bp-accent-${e.kind}`, H = (e) => {
+  const { fields: t, hidden: n } = A(e), i = n > 0 ? [
+    `<text class="bp-type" x="${e.x + c.paddingX}" `,
+    `y="${e.y + c.headerHeight + t.length * c.rowHeight + 13}">`,
+    `+${n} more`,
+    "</text>"
+  ].join("") : "", s = t.map((l, d) => {
+    const a = e.y + c.headerHeight + d * c.rowHeight + 13, r = e.width - c.paddingX * 2 - c.typeGutter, o = l.relation ?? l.type;
+    return [
+      `<text class="bp-field" x="${e.x + c.paddingX}" y="${a}">`,
+      p(b(l.name, r)),
+      l.required ? '<tspan class="bp-type"> *</tspan>' : "",
+      "</text>",
+      `<text class="bp-type" x="${e.x + e.width - c.paddingX}" y="${a}" text-anchor="end">`,
+      p(b(o, c.typeGutter)),
+      "</text>"
+    ].join("");
+  }).join("");
+  return [
+    `<g data-uid="${p(e.uid)}" data-kind="${e.kind}" data-navigable="${e.navigable}">`,
+    `<rect class="${e.kind === "component" ? "bp-box-component" : "bp-box"}" `,
+    `x="${e.x}" y="${e.y}" width="${e.width}" height="${e.height}" rx="4" />`,
+    `<path class="${F(e)}" d="M${e.x},${e.y + 4} a4,4 0 0 1 4,-4 h${e.width - 8} a4,4 0 0 1 4,4 v2 h-${e.width} z" />`,
+    `<line class="bp-divider" x1="${e.x}" y1="${e.y + c.headerHeight}" x2="${e.x + e.width}" y2="${e.y + c.headerHeight}" />`,
+    `<text class="bp-title bp-title-text" x="${e.x + c.paddingX}" y="${e.y + 21}">`,
+    p(b(e.label, e.width - c.paddingX * 2)),
+    "</text>",
+    s,
+    i,
+    "</g>"
+  ].join("");
+}, L = (e) => {
+  if (e.length < 3)
+    return e.map((i, s) => `${s === 0 ? "M" : "L"}${i.x},${i.y}`).join(" ");
+  const t = [`M${e[0].x},${e[0].y}`];
+  for (let i = 1; i < e.length - 1; i += 1) {
+    const s = e[i], l = e[i + 1], d = Math.round((s.x + l.x) / 2), a = Math.round((s.y + l.y) / 2);
+    t.push(`Q${s.x},${s.y} ${d},${a}`);
+  }
+  const n = e[e.length - 1];
+  return t.push(`L${n.x},${n.y}`), t.join(" ");
+}, X = (e) => {
+  if (e.points.length === 0) return "";
+  const t = L(e.points);
+  return [
+    `<path class="bp-edge bp-edge-${e.kind}" d="${t}" `,
+    `marker-end="url(#bp-arrow)" data-field="${p(e.field)}" />`
+  ].join("");
+}, $ = (e) => {
+  const t = Math.max(e.width, 1), n = Math.max(e.height, 1);
+  return [
+    `<svg xmlns="http://www.w3.org/2000/svg" width="${t}" height="${n}" `,
+    `viewBox="0 0 ${t} ${n}" role="img" aria-label="Content type diagram">`,
+    `<style>${z}</style>`,
+    "<defs>",
+    '<marker id="bp-arrow" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="6" markerHeight="6" orient="auto-start-reverse">',
+    '<path d="M0,0 L10,5 L0,10 z" fill="var(--bp-edge, #8e8ea9)" />',
+    "</marker>",
+    "</defs>",
+    `<rect class="bp-surface" x="0" y="0" width="${t}" height="${n}" />`,
+    // Edges first so a line never crosses over the box it points at.
+    `<g class="bp-edges">${e.edges.map(X).join("")}</g>`,
+    `<g class="bp-nodes">${e.nodes.map(H).join("")}</g>`,
+    "</svg>"
+  ].join("");
+}, u = "blueprint", h = (e) => e.plugin(u).service("graph"), m = (e, t) => e === void 0 || e === "" ? t : e !== "false" && e !== "0" && e !== !1, k = (e) => {
+  const t = Array.isArray(e) ? e : typeof e == "string" ? e.split(",") : [];
+  return [...new Set(t.map((n) => String(n).trim()).filter(Boolean))];
+}, y = (e, t = {}) => ({
+  includeForeign: m(t.foreign, !1),
+  includeComponents: m(t.components, !0),
+  includeDefaultFields: m(t.defaultFields, !1),
+  exclude: [
+    ...k(t.exclude),
+    ...k(e.config.get(`plugin::${u}.exclude`, []))
+  ]
+}), T = (e = {}) => e.direction === "LR" ? "LR" : "TB", G = ({ strapi: e }) => ({
+  /**
+   * The diagram, already drawn.
+   *
+   * The admin panel receives finished SVG rather than a graph to render itself.
+   * That is the design: one renderer, on the server, so what you see in the
+   * panel and what you download are the same bytes, and so the diagram can be
+   * produced by anything that can make an HTTP request — a docs build, CI — and
+   * not only by a browser running the admin panel.
+   */
+  async svg(t) {
+    const n = h(e).build(y(e, t.query)), i = w(n, T(t.query));
+    t.body = {
+      svg: $(i),
+      width: i.width,
+      height: i.height,
+      counts: {
+        nodes: n.nodes.length,
+        edges: n.edges.length,
+        components: n.nodes.filter((s) => s.kind === "component").length
+      }
+    };
+  },
+  /**
+   * The same drawing as a file.
+   *
+   * Separate from `svg` because a download wants `image/svg+xml` and a
+   * filename, not JSON with a string in it.
+   */
+  async download(t) {
+    const n = h(e).build(y(e, t.query)), i = w(n, T(t.query));
+    t.set("Content-Type", "image/svg+xml; charset=utf-8"), t.set("Content-Disposition", 'attachment; filename="blueprint.svg"'), t.body = $(i);
+  },
+  /** The graph itself, for anyone who would rather draw it their own way. */
+  async graph(t) {
+    t.body = h(e).build(y(e, t.query));
+  },
+  /** Everything that could be hidden, so the UI can offer a list. */
+  async catalogue(t) {
+    t.body = { contentTypes: h(e).catalogue() };
+  }
+}), S = {
+  diagram: G
+}, D = (e) => (t) => {
+  const n = t.state?.userAbility;
+  return n ? n.can(`plugin::${u}.${e}`) : !1;
+}, B = {
+  canRead: D("read")
+}, C = ({ strapi: e }) => {
+  const t = [
+    {
+      section: "plugins",
+      displayName: "Access the schema diagram",
+      uid: "read",
+      pluginName: u
+    }
+  ];
+  e.admin?.services?.permission?.actionProvider?.registerMany?.(t);
+}, g = ["plugin::blueprint.canRead"], N = {
+  type: "admin",
+  routes: [
+    {
+      method: "GET",
+      path: "/diagram",
+      handler: "diagram.svg",
+      config: { policies: g }
+    },
+    {
+      method: "GET",
+      path: "/diagram.svg",
+      handler: "diagram.download",
+      config: { policies: g }
+    },
+    {
+      method: "GET",
+      path: "/graph",
+      handler: "diagram.graph",
+      config: { policies: g }
+    },
+    {
+      method: "GET",
+      path: "/content-types",
+      handler: "diagram.catalogue",
+      config: { policies: g }
+    }
+  ]
+}, q = {
+  admin: N
+}, M = /* @__PURE__ */ new Set([
+  "createdAt",
+  "updatedAt",
+  "publishedAt",
+  "createdBy",
+  "updatedBy",
+  "locale",
+  "localizations"
+]), R = {
+  includeForeign: !1,
+  includeComponents: !0,
+  includeDefaultFields: !1,
+  exclude: []
+}, P = (e) => e.modelType === "component" || e.pluginOptions?.["content-type-builder"]?.visible !== !1, I = (e) => {
+  if (e.startsWith("api::")) return "api";
+  const [t] = e.split(".");
+  return t ?? e;
+}, O = (e) => e.startsWith("api::"), j = (e) => e.info?.displayName ?? e.info?.singularName ?? e.uid, U = ({ strapi: e }) => {
+  const t = {
+    /**
+     * The whole schema as a graph.
+     *
+     * Reads Strapi's own loaded models rather than the files on disk, so a
+     * content type a plugin adds at runtime is on the diagram too, and nothing
+     * has to be parsed.
+     */
+    build(n = {}) {
+      const i = { ...R, ...n }, s = new Set(i.exclude), l = Object.values(
+        e.contentTypes
+      ), d = Object.values(
+        e.components ?? {}
+      ), a = /* @__PURE__ */ new Map();
+      for (const o of l)
+        s.has(o.uid) || !i.includeForeign && !O(o.uid) || a.set(o.uid, o);
+      if (i.includeComponents)
+        for (const o of d)
+          s.has(o.uid) || a.set(o.uid, o);
+      return { nodes: [...a.values()].map((o) => ({
+        uid: o.uid,
+        kind: o.modelType === "component" ? "component" : o.kind === "singleType" ? "singleType" : "collectionType",
+        label: j(o),
+        group: o.modelType === "component" ? o.category ?? "components" : I(o.uid),
+        foreign: o.modelType === "component" ? !1 : !O(o.uid),
+        navigable: P(o),
+        fields: t.fieldsOf(o, i)
+      })), edges: t.edgesOf(a, i) };
+    },
+    fieldsOf(n, i) {
+      const s = [];
+      for (const [l, d] of Object.entries(n.attributes ?? {}))
+        !i.includeDefaultFields && M.has(l) || s.push({
+          name: l,
+          type: d.type,
+          ...d.relation ? { relation: d.relation } : {},
+          ...d.required ? { required: !0 } : {}
+        });
+      return s;
+    },
+    /**
+     * Edges, one per reason two boxes are joined.
+     *
+     * Both ends of a two-sided relation describe the same line. Strapi marks
+     * the non-owning end with `mappedBy`, so skipping those leaves exactly one
+     * edge — deduplicating by node pair instead would silently merge two
+     * genuinely different relations between the same two types.
+     *
+     * Edges to something not on the diagram are dropped rather than drawn into
+     * nothing: with `includeComponents` off, every component attribute would
+     * otherwise become a line to a box that is not there.
+     *
+     * A field that is not drawn does not get a line either, and that is not a
+     * detail. i18n adds a `localizations` relation **to every content type,
+     * pointing at itself**, so skipping it in the field list but not here put a
+     * self-loop on every single box on the diagram.
+     */
+    edgesOf(n, i) {
+      const s = [], l = (d) => {
+        n.has(d.to) && s.push(d);
+      };
+      for (const d of n.values())
+        for (const [a, r] of Object.entries(d.attributes ?? {}))
+          if (!(!i.includeDefaultFields && M.has(a))) {
+            if (r.type === "relation" && r.target) {
+              if (r.mappedBy) continue;
+              l({
+                from: d.uid,
+                to: r.target,
+                kind: "relation",
+                field: a,
+                cardinality: r.relation,
+                many: (r.relation ?? "").endsWith("Many")
+              });
+              continue;
+            }
+            if (r.type === "component" && r.component) {
+              l({
+                from: d.uid,
+                to: r.component,
+                kind: "component",
+                field: a,
+                many: r.repeatable === !0
+              });
+              continue;
+            }
+            if (r.type === "dynamiczone")
+              for (const o of r.components ?? [])
+                l({
+                  from: d.uid,
+                  to: o,
+                  kind: "dynamiczone",
+                  field: a,
+                  many: !0
+                });
+          }
+      return s;
+    },
+    /** Everything that could be excluded, for the settings UI. */
+    catalogue() {
+      const n = Object.values(
+        e.contentTypes
+      ), i = Object.values(
+        e.components ?? {}
+      );
+      return [...n, ...i].map((s) => ({
+        uid: s.uid,
+        label: j(s),
+        kind: s.modelType === "component" ? "component" : s.kind ?? "collectionType"
+      }));
+    }
+  };
+  return t;
+}, Y = {
+  graph: U
+}, Q = {
+  register: C,
+  config: E,
+  controllers: S,
+  policies: B,
+  routes: q,
+  services: Y
+};
+export {
+  Q as default
+};

package/dist/server/src/config/index.d.ts

@@ -0,0 +1,21 @@
+declare const _default: {
+    default: {
+        /**
+         * Uids never to draw, whatever the UI asks for.
+         *
+         * For schemas with a corner nobody wants on the picture — a bulky
+         * integration type, a legacy import table. The UI can hide things too; this
+         * is the version that survives a page reload and applies to the API as well.
+         *
+         *   blueprint: {
+         *     enabled: true,
+         *     config: { exclude: ['api::import-log.import-log'] },
+         *   }
+         */
+        exclude: string[];
+    };
+    validator(config: {
+        exclude?: unknown;
+    }): void;
+};
+export default _default;

package/dist/server/src/controllers/diagram.d.ts

@@ -0,0 +1,27 @@
+import type { Core } from '@strapi/strapi';
+declare const controller: ({ strapi }: {
+    strapi: Core.Strapi;
+}) => {
+    /**
+     * The diagram, already drawn.
+     *
+     * The admin panel receives finished SVG rather than a graph to render itself.
+     * That is the design: one renderer, on the server, so what you see in the
+     * panel and what you download are the same bytes, and so the diagram can be
+     * produced by anything that can make an HTTP request — a docs build, CI — and
+     * not only by a browser running the admin panel.
+     */
+    svg(ctx: any): Promise<void>;
+    /**
+     * The same drawing as a file.
+     *
+     * Separate from `svg` because a download wants `image/svg+xml` and a
+     * filename, not JSON with a string in it.
+     */
+    download(ctx: any): Promise<void>;
+    /** The graph itself, for anyone who would rather draw it their own way. */
+    graph(ctx: any): Promise<void>;
+    /** Everything that could be hidden, so the UI can offer a list. */
+    catalogue(ctx: any): Promise<void>;
+};
+export default controller;

package/dist/server/src/controllers/index.d.ts

@@ -0,0 +1,11 @@
+declare const _default: {
+    diagram: ({ strapi }: {
+        strapi: import("@strapi/types/dist/core").Strapi;
+    }) => {
+        svg(ctx: any): Promise<void>;
+        download(ctx: any): Promise<void>;
+        graph(ctx: any): Promise<void>;
+        catalogue(ctx: any): Promise<void>;
+    };
+};
+export default _default;

package/dist/server/src/index.d.ts

@@ -0,0 +1,54 @@
+declare const _default: {
+    register: ({ strapi }: {
+        strapi: import("@strapi/types/dist/core").Strapi;
+    }) => void;
+    config: {
+        default: {
+            exclude: string[];
+        };
+        validator(config: {
+            exclude?: unknown;
+        }): void;
+    };
+    controllers: {
+        diagram: ({ strapi }: {
+            strapi: import("@strapi/types/dist/core").Strapi;
+        }) => {
+            svg(ctx: any): Promise<void>;
+            download(ctx: any): Promise<void>;
+            graph(ctx: any): Promise<void>;
+            catalogue(ctx: any): Promise<void>;
+        };
+    };
+    policies: {
+        canRead: (policyContext: any) => any;
+    };
+    routes: {
+        admin: {
+            type: string;
+            routes: {
+                method: string;
+                path: string;
+                handler: string;
+                config: {
+                    policies: string[];
+                };
+            }[];
+        };
+    };
+    services: {
+        graph: ({ strapi }: {
+            strapi: import("@strapi/types/dist/core").Strapi;
+        }) => {
+            build(options?: Partial<import("./types").GraphOptions>): import("./types").Graph;
+            fieldsOf(model: import("./services/graph").RawModel, opts: import("./types").GraphOptions): import("./types").Field[];
+            edgesOf(present: Map<string, import("./services/graph").RawModel>, opts: import("./types").GraphOptions): import("./types").Edge[];
+            catalogue(): {
+                uid: string;
+                label: string;
+                kind: string;
+            }[];
+        };
+    };
+};
+export default _default;

package/dist/server/src/policies/index.d.ts

@@ -0,0 +1,4 @@
+declare const _default: {
+    canRead: (policyContext: any) => any;
+};
+export default _default;

package/dist/server/src/register.d.ts

@@ -0,0 +1,12 @@
+import type { Core } from '@strapi/strapi';
+/**
+ * One permission: who may see the diagram.
+ *
+ * There is nothing to configure and nothing to write, so there is nothing else
+ * to guard. The schema this draws is already visible to anyone who can open the
+ * Content-Type Builder.
+ */
+declare const register: ({ strapi }: {
+    strapi: Core.Strapi;
+}) => void;
+export default register;

package/dist/server/src/routes/admin.d.ts

@@ -0,0 +1,12 @@
+declare const _default: {
+    type: string;
+    routes: {
+        method: string;
+        path: string;
+        handler: string;
+        config: {
+            policies: string[];
+        };
+    }[];
+};
+export default _default;

package/dist/server/src/routes/index.d.ts

@@ -0,0 +1,14 @@
+declare const _default: {
+    admin: {
+        type: string;
+        routes: {
+            method: string;
+            path: string;
+            handler: string;
+            config: {
+                policies: string[];
+            };
+        }[];
+    };
+};
+export default _default;