structured-render 0.0.0 → 0.0.2

package/dist/structured-render-data/create-section.d.ts

@@ -0,0 +1,23 @@
+import { type AnyObject } from '@augment-vir/common';
+/**
+ * Used to create a new structured render section with common properties. Not _all_ sections use
+ * this, but most do.
+ *
+ * @category Internal
+ */
+export declare function createStructuredRenderSection<const Type extends string, ExtraProperties extends AnyObject>(structuredRenderType: Type, extraProperties: ExtraProperties): import("object-shape-tester").Shape<{
+    type: import("object-shape-tester").Shape<import("@sinclair/typebox").TUnsafe<Type>>;
+    sectionTitle: import("object-shape-tester").Shape<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>>;
+    sources: import("object-shape-tester").Shape<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TArray<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TObject<{
+        type: import("@sinclair/typebox").TUnsafe<"source">;
+        pageNumbers: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TArray<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNumber | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>>)[]>>;
+        fileName: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>;
+        fileBoundingBoxes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TArray<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TObject<{
+            x1: import("@sinclair/typebox").TNumber;
+            y1: import("@sinclair/typebox").TNumber;
+            x2: import("@sinclair/typebox").TNumber;
+            y2: import("@sinclair/typebox").TNumber;
+        }>)[]>>>)[]>>;
+        quote: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>;
+    }>)[]>>>)[]>>>;
+} & ExtraProperties>;

package/dist/structured-render-data/create-section.js

@@ -0,0 +1,16 @@
+import { defineShape, exactShape, nullableShape } from 'object-shape-tester';
+import { structuredRenderSourceShape } from './sections/source.section.js';
+/**
+ * Used to create a new structured render section with common properties. Not _all_ sections use
+ * this, but most do.
+ *
+ * @category Internal
+ */
+export function createStructuredRenderSection(structuredRenderType, extraProperties) {
+    return defineShape({
+        type: exactShape(structuredRenderType),
+        sectionTitle: nullableShape(''),
+        sources: nullableShape([nullableShape(structuredRenderSourceShape)]),
+        ...extraProperties,
+    });
+}

package/dist/structured-render-data/sections/code-block.section.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Shape definition for {@link StructuredRenderCodeBlock}.
+ *
+ * @category Internal
+ */
+export declare const structuredRenderCodeBlockShape: import("object-shape-tester").Shape<{
+    type: import("object-shape-tester").Shape<import("@sinclair/typebox").TUnsafe<"codeBlock">>;
+    sectionTitle: import("object-shape-tester").Shape<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>>;
+    sources: import("object-shape-tester").Shape<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TArray<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TObject<{
+        type: import("@sinclair/typebox").TUnsafe<"source">;
+        pageNumbers: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TArray<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNumber | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>>)[]>>;
+        fileName: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>;
+        fileBoundingBoxes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TArray<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TObject<{
+            x1: import("@sinclair/typebox").TNumber;
+            y1: import("@sinclair/typebox").TNumber;
+            x2: import("@sinclair/typebox").TNumber;
+            y2: import("@sinclair/typebox").TNumber;
+        }>)[]>>>)[]>>;
+        quote: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>;
+    }>)[]>>>)[]>>>;
+} & {
+    syntax: import("object-shape-tester").Shape<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>>;
+    code: string;
+}>;
+/**
+ * A section that renders a block of code.
+ *
+ * @category Section
+ */
+export type StructuredRenderCodeBlock = typeof structuredRenderCodeBlockShape.runtimeType;

package/dist/structured-render-data/sections/code-block.section.js

@@ -0,0 +1,11 @@
+import { nullableShape } from 'object-shape-tester';
+import { createStructuredRenderSection } from '../create-section.js';
+/**
+ * Shape definition for {@link StructuredRenderCodeBlock}.
+ *
+ * @category Internal
+ */
+export const structuredRenderCodeBlockShape = createStructuredRenderSection('codeBlock', {
+    syntax: nullableShape(''),
+    code: '',
+});

package/dist/structured-render-data/sections/empty.section.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Shape definition for {@link StructuredRenderEmpty}.
+ *
+ * @category Internal
+ */
+export declare const structuredRenderEmptyShape: import("object-shape-tester").Shape<{
+    type: import("object-shape-tester").Shape<import("@sinclair/typebox").TUnsafe<"empty">>;
+}>;
+/**
+ * A section that renders nothing.
+ *
+ * @category Section
+ */
+export type StructuredRenderEmpty = typeof structuredRenderEmptyShape.runtimeType;

package/dist/structured-render-data/sections/empty.section.js

@@ -0,0 +1,9 @@
+import { defineShape, exactShape } from 'object-shape-tester';
+/**
+ * Shape definition for {@link StructuredRenderEmpty}.
+ *
+ * @category Internal
+ */
+export const structuredRenderEmptyShape = defineShape({
+    type: exactShape('empty'),
+});

package/dist/structured-render-data/sections/icon.section.d.ts

@@ -0,0 +1,25 @@
+import { type RenderOptions } from '../../render/render-types.js';
+/**
+ * Shape definition for {@link StructuredRenderIcon}.
+ *
+ * @category Internal
+ */
+export declare const structuredRenderIconShape: import("object-shape-tester").Shape<{
+    type: import("object-shape-tester").Shape<import("@sinclair/typebox").TUnsafe<"icon">>;
+    iconKey: string;
+    strokeColor: import("object-shape-tester").Shape<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>>;
+    fillColor: import("object-shape-tester").Shape<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>>;
+    strokeWidth: import("object-shape-tester").Shape<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNumber)[]>)[]>>>;
+}>;
+/**
+ * A section that renders an icon in HTML.
+ *
+ * @category Section
+ */
+export type StructuredRenderIcon = typeof structuredRenderIconShape.runtimeType;
+/**
+ * Create a Colored Vira icon from {@link StructuredRenderIcon}.
+ *
+ * @category Internal
+ */
+export declare function createStructuredRenderIcon(iconSection: Readonly<StructuredRenderIcon>, { icons }: Readonly<Pick<RenderOptions, 'icons'>>): import("vira").ViraIconSvg | undefined;

package/dist/structured-render-data/sections/icon.section.js

@@ -0,0 +1,40 @@
+import { check } from '@augment-vir/assert';
+import { addSuffix } from '@augment-vir/common';
+import { defineShape, exactShape, nullableShape, unionShape } from 'object-shape-tester';
+import { createColoredIcon } from 'vira';
+/**
+ * Shape definition for {@link StructuredRenderIcon}.
+ *
+ * @category Internal
+ */
+export const structuredRenderIconShape = defineShape({
+    type: exactShape('icon'),
+    iconKey: '',
+    strokeColor: nullableShape(''),
+    fillColor: nullableShape(''),
+    strokeWidth: nullableShape(unionShape('', -1)),
+});
+/**
+ * Create a Colored Vira icon from {@link StructuredRenderIcon}.
+ *
+ * @category Internal
+ */
+export function createStructuredRenderIcon(iconSection, { icons }) {
+    const icon = icons[iconSection.iconKey];
+    if (!icon) {
+        return undefined;
+    }
+    const coloredIcon = createColoredIcon(icon, {
+        'vira-icon-fill-color': iconSection.fillColor || undefined,
+        'vira-icon-stroke-color': iconSection.strokeColor || undefined,
+        'vira-icon-stroke-width': check.isString(iconSection.strokeWidth)
+            ? iconSection.strokeWidth
+            : check.isNumber(iconSection.strokeWidth)
+                ? addSuffix({
+                    value: iconSection.strokeWidth,
+                    suffix: 'px',
+                })
+                : undefined,
+    });
+    return coloredIcon;
+}

package/dist/structured-render-data/sections/inline-code.section.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Shape definition for {@link StructuredRenderInlineCode}.
+ *
+ * @category Internal
+ */
+export declare const structuredRenderInlineCodeShape: import("object-shape-tester").Shape<{
+    type: import("object-shape-tester").Shape<import("@sinclair/typebox").TUnsafe<"inlineCode">>;
+    sectionTitle: import("object-shape-tester").Shape<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>>;
+    sources: import("object-shape-tester").Shape<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TArray<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TObject<{
+        type: import("@sinclair/typebox").TUnsafe<"source">;
+        pageNumbers: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TArray<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNumber | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>>)[]>>;
+        fileName: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>;
+        fileBoundingBoxes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TArray<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TObject<{
+            x1: import("@sinclair/typebox").TNumber;
+            y1: import("@sinclair/typebox").TNumber;
+            x2: import("@sinclair/typebox").TNumber;
+            y2: import("@sinclair/typebox").TNumber;
+        }>)[]>>>)[]>>;
+        quote: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>;
+    }>)[]>>>)[]>>>;
+} & {
+    code: string;
+}>;
+/**
+ * A section that renders inline code.
+ *
+ * @category Section
+ */
+export type StructuredRenderInlineCode = typeof structuredRenderInlineCodeShape.runtimeType;

package/dist/structured-render-data/sections/inline-code.section.js

@@ -0,0 +1,9 @@
+import { createStructuredRenderSection } from '../create-section.js';
+/**
+ * Shape definition for {@link StructuredRenderInlineCode}.
+ *
+ * @category Internal
+ */
+export const structuredRenderInlineCodeShape = createStructuredRenderSection('inlineCode', {
+    code: '',
+});

package/dist/structured-render-data/sections/list.section.d.ts

@@ -0,0 +1,169 @@
+/**
+ * Shape definition for {@link StructuredRenderListItem}.
+ *
+ * @category Internal
+ */
+export declare const structuredRenderListItemShape: import("object-shape-tester").Shape<{
+    content: import("object-shape-tester").Shape<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TObject<{
+        type: import("@sinclair/typebox").TUnsafe<"empty">;
+    }> | import("@sinclair/typebox").TObject<{
+        type: import("@sinclair/typebox").TUnsafe<"tag">;
+        sectionTitle: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>;
+        sources: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TArray<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TObject<{
+            type: import("@sinclair/typebox").TUnsafe<"source">;
+            pageNumbers: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TArray<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNumber | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>>)[]>>;
+            fileName: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>;
+            fileBoundingBoxes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TArray<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TObject<{
+                x1: import("@sinclair/typebox").TNumber;
+                y1: import("@sinclair/typebox").TNumber;
+                x2: import("@sinclair/typebox").TNumber;
+                y2: import("@sinclair/typebox").TNumber;
+            }>)[]>>>)[]>>;
+            quote: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>;
+        }>)[]>>>)[]>>;
+        text: import("@sinclair/typebox").TString | import("@sinclair/typebox").TNumber | import("@sinclair/typebox").TBoolean | import("@sinclair/typebox").TSymbol | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TBigInt;
+        useBigTag: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TBoolean | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>;
+        color: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TObject<{
+            custom: import("@sinclair/typebox").TObject<{
+                backgroundColor: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>;
+                foregroundColor: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>;
+            }>;
+        }> | import("@sinclair/typebox").TObject<{
+            variant: import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TLiteral<import("vira").ViraColorVariant.Accent> | import("@sinclair/typebox").TLiteral<import("vira").ViraColorVariant.Plain> | import("@sinclair/typebox").TLiteral<import("vira").ViraColorVariant.Neutral> | import("@sinclair/typebox").TLiteral<import("vira").ViraColorVariant.Danger> | import("@sinclair/typebox").TLiteral<import("vira").ViraColorVariant.Warning> | import("@sinclair/typebox").TLiteral<import("vira").ViraColorVariant.Positive> | import("@sinclair/typebox").TLiteral<import("vira").ViraColorVariant.None>)[]>;
+        }>)[]>)[]>>;
+    }> | import("@sinclair/typebox").TObject<{
+        type: import("@sinclair/typebox").TUnsafe<"text">;
+        sectionTitle: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>;
+        sources: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TArray<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TObject<{
+            type: import("@sinclair/typebox").TUnsafe<"source">;
+            pageNumbers: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TArray<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNumber | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>>)[]>>;
+            fileName: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>;
+            fileBoundingBoxes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TArray<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TObject<{
+                x1: import("@sinclair/typebox").TNumber;
+                y1: import("@sinclair/typebox").TNumber;
+                x2: import("@sinclair/typebox").TNumber;
+                y2: import("@sinclair/typebox").TNumber;
+            }>)[]>>>)[]>>;
+            quote: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>;
+        }>)[]>>>)[]>>;
+        text: import("@sinclair/typebox").TString | import("@sinclair/typebox").TNumber | import("@sinclair/typebox").TBoolean | import("@sinclair/typebox").TSymbol | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TBigInt;
+        style: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TLiteral<import("./text.section.js").StructuredRenderTextStyle.Faint> | import("@sinclair/typebox").TLiteral<import("./text.section.js").StructuredRenderTextStyle.Small> | import("@sinclair/typebox").TLiteral<import("./text.section.js").StructuredRenderTextStyle.Bold>)[]>)[]>>;
+        icon: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TObject<{
+            type: import("@sinclair/typebox").TUnsafe<"icon">;
+            iconKey: import("@sinclair/typebox").TString;
+            strokeColor: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>;
+            fillColor: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>;
+            strokeWidth: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNumber)[]>)[]>>;
+        }>)[]>>;
+    }>)[]>)[]>>>;
+    /**
+     * Replaces the bullet. If a given icon key is not found in the supported list of icons, it is
+     * ignored.
+     */
+    icon: import("object-shape-tester").Shape<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TObject<{
+        type: import("@sinclair/typebox").TUnsafe<"icon">;
+        iconKey: import("@sinclair/typebox").TString;
+        strokeColor: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>;
+        fillColor: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>;
+        strokeWidth: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNumber)[]>)[]>>;
+    }>)[]>>>;
+}>;
+/**
+ * Shape definition for {@link StructuredRenderList}.
+ *
+ * @category Internal
+ */
+export declare const structuredRenderListShape: import("object-shape-tester").Shape<{
+    type: import("object-shape-tester").Shape<import("@sinclair/typebox").TUnsafe<"list">>;
+    sectionTitle: import("object-shape-tester").Shape<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>>;
+    sources: import("object-shape-tester").Shape<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TArray<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TObject<{
+        type: import("@sinclair/typebox").TUnsafe<"source">;
+        pageNumbers: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TArray<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNumber | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>>)[]>>;
+        fileName: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>;
+        fileBoundingBoxes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TArray<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TObject<{
+            x1: import("@sinclair/typebox").TNumber;
+            y1: import("@sinclair/typebox").TNumber;
+            x2: import("@sinclair/typebox").TNumber;
+            y2: import("@sinclair/typebox").TNumber;
+        }>)[]>>>)[]>>;
+        quote: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>;
+    }>)[]>>>)[]>>>;
+} & {
+    items: import("object-shape-tester").Shape<{
+        content: import("object-shape-tester").Shape<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TObject<{
+            type: import("@sinclair/typebox").TUnsafe<"empty">;
+        }> | import("@sinclair/typebox").TObject<{
+            type: import("@sinclair/typebox").TUnsafe<"tag">;
+            sectionTitle: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>;
+            sources: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TArray<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TObject<{
+                type: import("@sinclair/typebox").TUnsafe<"source">;
+                pageNumbers: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TArray<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNumber | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>>)[]>>;
+                fileName: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>;
+                fileBoundingBoxes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TArray<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TObject<{
+                    x1: import("@sinclair/typebox").TNumber;
+                    y1: import("@sinclair/typebox").TNumber;
+                    x2: import("@sinclair/typebox").TNumber;
+                    y2: import("@sinclair/typebox").TNumber;
+                }>)[]>>>)[]>>;
+                quote: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>;
+            }>)[]>>>)[]>>;
+            text: import("@sinclair/typebox").TString | import("@sinclair/typebox").TNumber | import("@sinclair/typebox").TBoolean | import("@sinclair/typebox").TSymbol | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TBigInt;
+            useBigTag: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TBoolean | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>;
+            color: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TObject<{
+                custom: import("@sinclair/typebox").TObject<{
+                    backgroundColor: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>;
+                    foregroundColor: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>;
+                }>;
+            }> | import("@sinclair/typebox").TObject<{
+                variant: import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TLiteral<import("vira").ViraColorVariant.Accent> | import("@sinclair/typebox").TLiteral<import("vira").ViraColorVariant.Plain> | import("@sinclair/typebox").TLiteral<import("vira").ViraColorVariant.Neutral> | import("@sinclair/typebox").TLiteral<import("vira").ViraColorVariant.Danger> | import("@sinclair/typebox").TLiteral<import("vira").ViraColorVariant.Warning> | import("@sinclair/typebox").TLiteral<import("vira").ViraColorVariant.Positive> | import("@sinclair/typebox").TLiteral<import("vira").ViraColorVariant.None>)[]>;
+            }>)[]>)[]>>;
+        }> | import("@sinclair/typebox").TObject<{
+            type: import("@sinclair/typebox").TUnsafe<"text">;
+            sectionTitle: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>;
+            sources: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TArray<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TObject<{
+                type: import("@sinclair/typebox").TUnsafe<"source">;
+                pageNumbers: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TArray<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNumber | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>>)[]>>;
+                fileName: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>;
+                fileBoundingBoxes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TArray<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TObject<{
+                    x1: import("@sinclair/typebox").TNumber;
+                    y1: import("@sinclair/typebox").TNumber;
+                    x2: import("@sinclair/typebox").TNumber;
+                    y2: import("@sinclair/typebox").TNumber;
+                }>)[]>>>)[]>>;
+                quote: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>;
+            }>)[]>>>)[]>>;
+            text: import("@sinclair/typebox").TString | import("@sinclair/typebox").TNumber | import("@sinclair/typebox").TBoolean | import("@sinclair/typebox").TSymbol | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TBigInt;
+            style: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TLiteral<import("./text.section.js").StructuredRenderTextStyle.Faint> | import("@sinclair/typebox").TLiteral<import("./text.section.js").StructuredRenderTextStyle.Small> | import("@sinclair/typebox").TLiteral<import("./text.section.js").StructuredRenderTextStyle.Bold>)[]>)[]>>;
+            icon: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TObject<{
+                type: import("@sinclair/typebox").TUnsafe<"icon">;
+                iconKey: import("@sinclair/typebox").TString;
+                strokeColor: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>;
+                fillColor: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>;
+                strokeWidth: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNumber)[]>)[]>>;
+            }>)[]>>;
+        }>)[]>)[]>>>;
+        /**
+         * Replaces the bullet. If a given icon key is not found in the supported list of icons, it is
+         * ignored.
+         */
+        icon: import("object-shape-tester").Shape<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TObject<{
+            type: import("@sinclair/typebox").TUnsafe<"icon">;
+            iconKey: import("@sinclair/typebox").TString;
+            strokeColor: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>;
+            fillColor: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>;
+            strokeWidth: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNumber)[]>)[]>>;
+        }>)[]>>>;
+    }>[];
+}>;
+/**
+ * A single item within a {@link StructuredRenderList}.
+ *
+ * @category Internal
+ */
+export type StructuredRenderListItem = typeof structuredRenderListItemShape.runtimeType;
+/**
+ * A section that renders a list of items.
+ *
+ * @category Section
+ */
+export type StructuredRenderList = typeof structuredRenderListShape.runtimeType;

package/dist/structured-render-data/sections/list.section.js

@@ -0,0 +1,29 @@
+import { defineShape, nullableShape, unionShape } from 'object-shape-tester';
+import { createStructuredRenderSection } from '../create-section.js';
+import { structuredRenderEmptyShape } from './empty.section.js';
+import { structuredRenderIconShape } from './icon.section.js';
+import { structuredRenderTagShape } from './tag.section.js';
+import { structuredRenderTextShape } from './text.section.js';
+/**
+ * Shape definition for {@link StructuredRenderListItem}.
+ *
+ * @category Internal
+ */
+export const structuredRenderListItemShape = defineShape({
+    content: nullableShape(unionShape(structuredRenderTextShape, structuredRenderTagShape, structuredRenderEmptyShape)),
+    /**
+     * Replaces the bullet. If a given icon key is not found in the supported list of icons, it is
+     * ignored.
+     */
+    icon: nullableShape(structuredRenderIconShape),
+});
+/**
+ * Shape definition for {@link StructuredRenderList}.
+ *
+ * @category Internal
+ */
+export const structuredRenderListShape = createStructuredRenderSection('list', {
+    items: [
+        structuredRenderListItemShape,
+    ],
+});

package/dist/structured-render-data/sections/markdown.section.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Shape definition for {@link RenderDataMarkdown}.
+ *
+ * @category Internal
+ */
+export declare const renderDataMarkdownShape: import("object-shape-tester").Shape<{
+    type: import("object-shape-tester").Shape<import("@sinclair/typebox").TUnsafe<"markdown">>;
+    sectionTitle: import("object-shape-tester").Shape<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>>;
+    sources: import("object-shape-tester").Shape<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TArray<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TObject<{
+        type: import("@sinclair/typebox").TUnsafe<"source">;
+        pageNumbers: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TArray<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNumber | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>>)[]>>;
+        fileName: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>;
+        fileBoundingBoxes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TArray<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TObject<{
+            x1: import("@sinclair/typebox").TNumber;
+            y1: import("@sinclair/typebox").TNumber;
+            x2: import("@sinclair/typebox").TNumber;
+            y2: import("@sinclair/typebox").TNumber;
+        }>)[]>>>)[]>>;
+        quote: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>;
+    }>)[]>>>)[]>>>;
+} & {
+    markdown: string;
+}>;
+/**
+ * A section that renders markdown content.
+ *
+ * @category Section
+ */
+export type RenderDataMarkdown = typeof renderDataMarkdownShape.runtimeType;

package/dist/structured-render-data/sections/markdown.section.js

@@ -0,0 +1,9 @@
+import { createStructuredRenderSection } from '../create-section.js';
+/**
+ * Shape definition for {@link RenderDataMarkdown}.
+ *
+ * @category Internal
+ */
+export const renderDataMarkdownShape = createStructuredRenderSection('markdown', {
+    markdown: '',
+});

package/dist/structured-render-data/sections/processing.section.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Shape definition for {@link StructuredRenderProcessing}.
+ *
+ * @category Internal
+ */
+export declare const structuredRenderProcessingShape: import("object-shape-tester").Shape<{
+    type: import("object-shape-tester").Shape<import("@sinclair/typebox").TUnsafe<"processing">>;
+}>;
+/**
+ * A section that renders a processing indicator in HTML.
+ *
+ * @category Section
+ */
+export type StructuredRenderProcessing = typeof structuredRenderProcessingShape.runtimeType;

package/dist/structured-render-data/sections/processing.section.js

@@ -0,0 +1,9 @@
+import { defineShape, exactShape } from 'object-shape-tester';
+/**
+ * Shape definition for {@link StructuredRenderProcessing}.
+ *
+ * @category Internal
+ */
+export const structuredRenderProcessingShape = defineShape({
+    type: exactShape('processing'),
+});

package/dist/structured-render-data/sections/source.section.d.ts

@@ -0,0 +1,59 @@
+import { type AtLeastTuple, type MaybeArray } from '@augment-vir/common';
+/**
+ * Shape definition for {@link StructuredRenderFileBoundingBox}.
+ *
+ * @category Internal
+ */
+export declare const structuredRenderFileBoundingBoxShape: import("object-shape-tester").Shape<{
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+}>;
+/**
+ * A bounding box within a source file.
+ *
+ * @category Section
+ */
+export type StructuredRenderFileBoundingBox = typeof structuredRenderFileBoundingBoxShape.runtimeType;
+/**
+ * A shape definition for structured render sources. Any structured render can have sources.
+ *
+ * @category Internal
+ */
+export declare const structuredRenderSourceShape: import("object-shape-tester").Shape<{
+    type: import("object-shape-tester").Shape<import("@sinclair/typebox").TUnsafe<"source">>;
+    pageNumbers: import("object-shape-tester").Shape<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TArray<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNumber | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>>)[]>>>;
+    fileName: import("object-shape-tester").Shape<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>>;
+    fileBoundingBoxes: import("object-shape-tester").Shape<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TArray<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined | import("@sinclair/typebox").TObject<{
+        x1: import("@sinclair/typebox").TNumber;
+        y1: import("@sinclair/typebox").TNumber;
+        x2: import("@sinclair/typebox").TNumber;
+        y2: import("@sinclair/typebox").TNumber;
+    }>)[]>>>)[]>>>;
+    quote: import("object-shape-tester").Shape<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<(import("@sinclair/typebox").TString | import("@sinclair/typebox").TNull | import("@sinclair/typebox").TUndefined)[]>>>;
+}>;
+/**
+ * A section that renders a source reference.
+ *
+ * @category Section
+ */
+export type StructuredRenderSource = typeof structuredRenderSourceShape.runtimeType;
+/**
+ * All acceptable configurations of a source section that can be rendered.
+ *
+ * @category Internal
+ */
+export type SourcesInput = Readonly<MaybeArray<StructuredRenderSource | undefined | null>>;
+/**
+ * Handle all the possible values for sources and combine them into an easy to use return type.
+ *
+ * @category Internal
+ */
+export declare function createCleanSources(rawSources: SourcesInput): undefined | AtLeastTuple<StructuredRenderSource, 1>;
+/**
+ * Check if a source section has any content.
+ *
+ * @category Internal
+ */
+export declare function sourceHasContent(section: Readonly<StructuredRenderSource> | undefined | null): section is NonNullable<typeof section>;