@aglyn/aglyn 1.0.0-beta.233 → 1.0.0-beta.235

package/src/lib/app-utils/docs-help-section-excerpt-text.d.ts

@@ -0,0 +1,14 @@
+import type { PluginDocsKey } from './docs-help.generated';
+export interface PluginDocsSectionExcerptProps {
+    topic: PluginDocsKey;
+    anchor: string;
+    /** The page's own description, for a section the generator did not carry. */
+    fallback: string;
+}
+/**
+ * One section's tooltip prose. The static import of the section registry
+ * belongs to this module alone: `docs-help-section-excerpt.ts` reaches it
+ * through `lazy()`, so the prose is the payload of that chunk (AGL-3707).
+ */
+export declare function PluginDocsSectionExcerptText({ topic, anchor, fallback, }: PluginDocsSectionExcerptProps): import("react").JSX.Element;
+export default PluginDocsSectionExcerptText;

package/src/lib/app-utils/docs-help-section-excerpt-text.js

@@ -0,0 +1,31 @@
+import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { PLUGIN_DOCS_SECTION_EXCERPTS } from "./docs-help-sections.generated.js";
+/**
+ * One section's tooltip prose. The static import of the section registry
+ * belongs to this module alone: `docs-help-section-excerpt.ts` reaches it
+ * through `lazy()`, so the prose is the payload of that chunk (AGL-3707).
+ */ export function PluginDocsSectionExcerptText({ topic, anchor, fallback }) {
+    var _ref;
+    const sections = PLUGIN_DOCS_SECTION_EXCERPTS[topic];
+    return /*#__PURE__*/ _jsx(_Fragment, {
+        children: (_ref = sections == null ? void 0 : sections[anchor]) != null ? _ref : fallback
+    });
+}
+export default PluginDocsSectionExcerptText;
+
+//# sourceMappingURL=docs-help-section-excerpt-text.js.map

package/src/lib/app-utils/docs-help-section-excerpt-text.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/docs-help-section-excerpt-text.tsx"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport { PLUGIN_DOCS_SECTION_EXCERPTS } from './docs-help-sections.generated'\nimport type { PluginDocsKey } from './docs-help.generated'\n\nexport interface PluginDocsSectionExcerptProps {\n  topic: PluginDocsKey\n  anchor: string\n  /** The page's own description, for a section the generator did not carry. */\n  fallback: string\n}\n\n/**\n * One section's tooltip prose. The static import of the section registry\n * belongs to this module alone: `docs-help-section-excerpt.ts` reaches it\n * through `lazy()`, so the prose is the payload of that chunk (AGL-3707).\n */\nexport function PluginDocsSectionExcerptText({\n  topic,\n  anchor,\n  fallback,\n}: PluginDocsSectionExcerptProps) {\n  const sections = PLUGIN_DOCS_SECTION_EXCERPTS[topic] as\n    | Readonly<Record<string, string>>\n    | undefined\n  return <>{sections?.[anchor] ?? fallback}</>\n}\n\nexport default PluginDocsSectionExcerptText\n"],"names":["PLUGIN_DOCS_SECTION_EXCERPTS","PluginDocsSectionExcerptText","topic","anchor","fallback","sections"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GACD,SAASA,4BAA4B,QAAQ,oCAAgC;AAU7E;;;;CAIC,GACD,OAAO,SAASC,6BAA6B,EAC3CC,KAAK,EACLC,MAAM,EACNC,QAAQ,EACsB;;IAC9B,MAAMC,WAAWL,4BAA4B,CAACE,MAAM;IAGpD,qBAAO;0BAAGG,4BAAAA,QAAU,CAACF,OAAO,mBAAIC;;AAClC;AAEA,eAAeH,6BAA4B"}

package/src/lib/app-utils/docs-help-section-excerpt.d.ts

@@ -0,0 +1,13 @@
+import type { PluginDocsSectionExcerptProps } from './docs-help-section-excerpt-text';
+/**
+ * A plugin card's section prose, fetched when its tooltip first opens
+ * (AGL-3707) — the plugin counterpart of the console's `DocsHelpExcerpt`.
+ *
+ * The plugin help subset is imported by every plugin console up front, and
+ * the linked sections' prose is ~30 KB gzipped that nothing reads until
+ * someone hovers a `?`. A tooltip's content mounts only when it opens, so the
+ * chunk loads then; the page's own description stands in for the moment it
+ * takes.
+ */
+export declare function PluginDocsSectionExcerpt(props: PluginDocsSectionExcerptProps): import("react").FunctionComponentElement<import("react").SuspenseProps>;
+export default PluginDocsSectionExcerpt;

package/src/lib/app-utils/docs-help-section-excerpt.js

@@ -0,0 +1,37 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { createElement, lazy, Suspense } from "react";
+const PluginDocsSectionExcerptText = lazy(()=>import("./docs-help-section-excerpt-text.js"));
+/**
+ * A plugin card's section prose, fetched when its tooltip first opens
+ * (AGL-3707) — the plugin counterpart of the console's `DocsHelpExcerpt`.
+ *
+ * The plugin help subset is imported by every plugin console up front, and
+ * the linked sections' prose is ~30 KB gzipped that nothing reads until
+ * someone hovers a `?`. A tooltip's content mounts only when it opens, so the
+ * chunk loads then; the page's own description stands in for the moment it
+ * takes.
+ */ // Written with createElement, not JSX: docs-help.ts imports this module and
+// server.ts re-exports docs-help, so plain-TS loaders (jiti in the ops scripts,
+// ts-jest under `jsx: preserve`) must be able to parse it.
+export function PluginDocsSectionExcerpt(props) {
+    return createElement(Suspense, {
+        fallback: props.fallback
+    }, createElement(PluginDocsSectionExcerptText, props));
+}
+export default PluginDocsSectionExcerpt;
+
+//# sourceMappingURL=docs-help-section-excerpt.js.map

package/src/lib/app-utils/docs-help-section-excerpt.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/docs-help-section-excerpt.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport { createElement, lazy, Suspense } from 'react'\nimport type { PluginDocsSectionExcerptProps } from './docs-help-section-excerpt-text'\n\nconst PluginDocsSectionExcerptText = lazy(\n  () => import('./docs-help-section-excerpt-text'),\n)\n\n/**\n * A plugin card's section prose, fetched when its tooltip first opens\n * (AGL-3707) — the plugin counterpart of the console's `DocsHelpExcerpt`.\n *\n * The plugin help subset is imported by every plugin console up front, and\n * the linked sections' prose is ~30 KB gzipped that nothing reads until\n * someone hovers a `?`. A tooltip's content mounts only when it opens, so the\n * chunk loads then; the page's own description stands in for the moment it\n * takes.\n */\n// Written with createElement, not JSX: docs-help.ts imports this module and\n// server.ts re-exports docs-help, so plain-TS loaders (jiti in the ops scripts,\n// ts-jest under `jsx: preserve`) must be able to parse it.\nexport function PluginDocsSectionExcerpt(props: PluginDocsSectionExcerptProps) {\n  return createElement(\n    Suspense,\n    { fallback: props.fallback },\n    createElement(PluginDocsSectionExcerptText, props),\n  )\n}\n\nexport default PluginDocsSectionExcerpt\n"],"names":["createElement","lazy","Suspense","PluginDocsSectionExcerptText","PluginDocsSectionExcerpt","props","fallback"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD,SAASA,aAAa,EAAEC,IAAI,EAAEC,QAAQ,QAAQ,QAAO;AAGrD,MAAMC,+BAA+BF,KACnC,IAAM,MAAM,CAAC;AAGf;;;;;;;;;CASC,GACD,4EAA4E;AAC5E,gFAAgF;AAChF,2DAA2D;AAC3D,OAAO,SAASG,yBAAyBC,KAAoC;IAC3E,OAAOL,cACLE,UACA;QAAEI,UAAUD,MAAMC,QAAQ;IAAC,GAC3BN,cAAcG,8BAA8BE;AAEhD;AAEA,eAAeD,yBAAwB"}

package/src/lib/app-utils/docs-help-sections.generated.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { PluginDocsKey } from './docs-help.generated';
+/**
+ * The opening sentence under each heading a plugin card links — that card's
+ * tooltip prose (AGL-3707).
+ *
+ * A module of its own because the plugin help subset is imported by every
+ * plugin console up front, and four hundred sections of prose are ~30 KB
+ * gzipped that no page needs until someone opens a tooltip.
+ * `PluginDocsSectionExcerpt` fetches this module when one does.
+ */
+export declare const PLUGIN_DOCS_SECTION_EXCERPTS: {
+    readonly [K in PluginDocsKey]?: {
+        readonly [anchor: `#${string}`]: string;
+    };
+};