@elastic/isomer-studio 0.0.0 → 0.4.0

package/dist/model/slack_limits.js

@@ -0,0 +1,213 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+import { isModeledSlackBlockType, isUnmodeledSlackBlock, SLACK_LIMITS, } from '@elastic/isomer-sdk/slack';
+const list = (value) => value ?? [];
+const overLength = (where, text, limit) => typeof text === 'string' && text.length > limit
+    ? [`${where} has ${text.length} characters; Slack allows ${limit}.`]
+    : [];
+const overCount = (where, count, limit) => count > limit ? [`${where} has ${count}; Slack allows ${limit}.`] : [];
+const empty = (where, count) => count === 0 ? [`${where} is empty; Slack requires at least 1.`] : [];
+const inlineText = (inline) => inline.type === 'link' ? (inline.text ?? inline.url) : inline.text;
+const richTextText = (element) => element.type === 'rich_text_list'
+    ? list(element.elements).map(richTextText).join('')
+    : list(element.elements).map(inlineText).join('');
+const cellText = (cell) => cell.type === 'raw_text'
+    ? cell.text
+    : list(cell.elements).map(richTextText).join('');
+const imageProblems = (where, { image_url, alt_text }) => [
+    ...overLength(`${where} image_url`, image_url, SLACK_LIMITS.imageUrlChars),
+    ...overLength(`${where} alt_text`, alt_text, SLACK_LIMITS.imageAltTextChars),
+];
+const optionProblems = (where, { text, value, description, url }) => [
+    ...overLength(`${where} text`, text?.text, SLACK_LIMITS.optionTextChars),
+    ...overLength(`${where} value`, value, SLACK_LIMITS.optionValueChars),
+    ...overLength(`${where} description`, description?.text, SLACK_LIMITS.optionTextChars),
+    ...overLength(`${where} url`, url, SLACK_LIMITS.urlChars),
+];
+const optionsProblems = (where, options, limit) => [
+    ...overCount(`${where} options`, list(options).length, limit),
+    ...list(options).flatMap((option, index) => optionProblems(`${where} options[${index}]`, option)),
+];
+const controlProblems = (where, element) => {
+    const actionId = overLength(`${where} action_id`, element.action_id, SLACK_LIMITS.actionIdChars);
+    switch (element.type) {
+        case 'button':
+            return [
+                ...actionId,
+                ...overLength(`${where} text`, element.text?.text, SLACK_LIMITS.buttonTextChars),
+                ...overLength(`${where} value`, element.value, SLACK_LIMITS.buttonValueChars),
+                ...overLength(`${where} url`, element.url, SLACK_LIMITS.urlChars),
+            ];
+        case 'overflow':
+            return [
+                ...actionId,
+                ...optionsProblems(where, element.options, SLACK_LIMITS.optionsPerOverflow),
+            ];
+        case 'radio_buttons':
+        case 'checkboxes':
+            return [
+                ...actionId,
+                ...optionsProblems(where, element.options, SLACK_LIMITS.optionsPerChoice),
+            ];
+        case 'static_select':
+        case 'multi_static_select': {
+            const groups = element.type === 'static_select' ? list(element.option_groups) : [];
+            return [
+                ...actionId,
+                ...overLength(`${where} placeholder`, element.placeholder?.text, SLACK_LIMITS.placeholderChars),
+                ...optionsProblems(where, element.options, SLACK_LIMITS.optionsPerSelect),
+                ...overCount(`${where} option_groups`, groups.length, SLACK_LIMITS.optionGroupsPerSelect),
+                ...groups.flatMap(({ label, options }, index) => [
+                    ...overLength(`${where} option_groups[${index}] label`, label?.text, SLACK_LIMITS.optionGroupLabelChars),
+                    ...optionsProblems(`${where} option_groups[${index}]`, options, SLACK_LIMITS.optionsPerSelect),
+                ]),
+            ];
+        }
+        default:
+            return actionId;
+    }
+};
+const accessoryProblems = (where, accessory) => accessory.type === 'image'
+    ? imageProblems(where, accessory)
+    : controlProblems(where, accessory);
+const richTextProblems = (where, element, textLimit) => {
+    if (element.type === 'rich_text_list') {
+        return overCount(`${where} indent`, element.indent ?? 0, SLACK_LIMITS.richTextListMaxIndent);
+    }
+    return textLimit === undefined
+        ? []
+        : overLength(`${where} text`, richTextText(element), textLimit);
+};
+/** Only a top-level element has a `textLimit`; list items and table cells count toward the message's budgets alone. */
+const richTextBlockProblems = (where, { elements }, textLimit) => list(elements).flatMap((element, elementIndex) => richTextProblems(`${where} elements[${elementIndex}]`, element, textLimit));
+/** Every block in the message, a container's children after it, each with the path a problem names. */
+const located = (blocks) => blocks.flatMap((block, index) => {
+    const where = `blocks[${index}] (${block.type})`;
+    return [
+        { where, block },
+        ...(block.type === 'container'
+            ? list(block.child_blocks).map((child, childIndex) => ({
+                where: `${where} child_blocks[${childIndex}] (${child.type})`,
+                block: child,
+            }))
+            : []),
+    ];
+});
+const blockProblems = ({ where, block }) => {
+    switch (block.type) {
+        case 'container': {
+            const children = list(block.child_blocks);
+            return [
+                ...overLength(`${where} title`, block.title?.text, SLACK_LIMITS.containerTitleChars),
+                ...overLength(`${where} subtitle`, block.subtitle?.text, SLACK_LIMITS.containerSubtitleChars),
+                ...(block.icon ? imageProblems(`${where} icon`, block.icon) : []),
+                ...(block.rich_text_title
+                    ? richTextBlockProblems(`${where} rich_text_title`, block.rich_text_title, SLACK_LIMITS.sectionTextChars)
+                    : []),
+                ...overCount(`${where} child_blocks`, children.length, SLACK_LIMITS.containerChildBlocks),
+                ...empty(`${where} child_blocks`, children.length),
+                ...children.flatMap(({ type }, childIndex) => type === 'container'
+                    ? [
+                        `${where} child_blocks[${childIndex}] is a container; Slack does not accept one inside another.`,
+                    ]
+                    : []),
+            ];
+        }
+        case 'header':
+            return overLength(`${where} text`, block.text?.text, SLACK_LIMITS.headerTextChars);
+        case 'section': {
+            const fields = list(block.fields);
+            return [
+                ...overLength(`${where} text`, block.text?.text, SLACK_LIMITS.sectionTextChars),
+                ...overCount(`${where} fields`, fields.length, SLACK_LIMITS.fieldsPerSection),
+                ...fields.flatMap((field, fieldIndex) => overLength(`${where} fields[${fieldIndex}]`, field?.text, SLACK_LIMITS.sectionFieldChars)),
+                ...(block.accessory
+                    ? accessoryProblems(`${where} accessory`, block.accessory)
+                    : []),
+            ];
+        }
+        case 'context': {
+            const elements = list(block.elements);
+            return [
+                ...overCount(`${where} elements`, elements.length, SLACK_LIMITS.contextElements),
+                ...elements.flatMap((element, elementIndex) => element.type === 'image'
+                    ? imageProblems(`${where} elements[${elementIndex}]`, element)
+                    : overLength(`${where} elements[${elementIndex}]`, element.text, SLACK_LIMITS.contextElementChars)),
+            ];
+        }
+        case 'actions': {
+            const elements = list(block.elements);
+            return [
+                ...overCount(`${where} elements`, elements.length, SLACK_LIMITS.buttonsPerActions),
+                ...elements.flatMap((element, elementIndex) => controlProblems(`${where} elements[${elementIndex}]`, element)),
+            ];
+        }
+        case 'image':
+            return [
+                ...imageProblems(where, block),
+                ...overLength(`${where} title`, block.title?.text, SLACK_LIMITS.imageTitleChars),
+            ];
+        case 'video':
+            return [
+                ...overLength(`${where} title`, block.title?.text, SLACK_LIMITS.videoTitleChars),
+                ...overLength(`${where} description`, block.description?.text, SLACK_LIMITS.videoDescriptionChars),
+                ...overLength(`${where} author_name`, block.author_name, SLACK_LIMITS.videoAuthorNameChars),
+            ];
+        case 'rich_text':
+            return richTextBlockProblems(where, block, SLACK_LIMITS.sectionTextChars);
+        case 'table': {
+            const rows = list(block.rows);
+            return [
+                ...overCount(`${where} rows`, rows.length, SLACK_LIMITS.tableRows),
+                ...empty(`${where} rows`, rows.length),
+                ...rows.flatMap((row, rowIndex) => [
+                    ...overCount(`${where} rows[${rowIndex}] cells`, list(row).length, SLACK_LIMITS.tableColumns),
+                    ...empty(`${where} rows[${rowIndex}] cells`, list(row).length),
+                    ...list(row).flatMap((cell, cellIndex) => cell.type === 'rich_text'
+                        ? richTextBlockProblems(`${where} rows[${rowIndex}][${cellIndex}]`, cell)
+                        : []),
+                ]),
+            ];
+        }
+        default:
+            return [];
+    }
+};
+const overTableText = (length) => length > SLACK_LIMITS.tableCellCharsPerMessage
+    ? [
+        `The message's table cells have ${length} characters; Slack allows ${SLACK_LIMITS.tableCellCharsPerMessage}.`,
+    ]
+    : [];
+const tableTextLength = (blocks) => blocks.reduce((total, block) => block.type === 'table'
+    ? list(block.rows).reduce((sum, row) => list(row).reduce((cells, cell) => cells + cellText(cell).length, sum), total)
+    : total, 0);
+const staleWrapperProblems = ({ where, block }) => {
+    const { type } = block;
+    return isUnmodeledSlackBlock(block) && isModeledSlackBlockType(type)
+        ? [
+            `${where} is wrapped in \`unmodeledSlackBlock\`, but Isomer models \`${type}\` blocks: return it unwrapped so its limits are fitted.`,
+        ]
+        : [];
+};
+/** One note per block type Isomer does not model: the envelope passed those blocks through unfitted, and {@link slackLimitProblems} cannot check them. */
+export const unmodeledSlackNotes = (blocks) => [
+    ...new Set(located(blocks)
+        .map(({ block: { type } }) => type)
+        .filter((type) => !isModeledSlackBlockType(type))),
+].map((type) => `Isomer doesn't model \`${type}\` blocks, so their Slack limits aren't checked and this preview may not draw them. Check the message in Block Kit Builder.`);
+/** Where a rendered Slack message breaks `SLACK_LIMITS`; empty when Slack would accept it. */
+export const slackLimitProblems = ({ text, blocks, }) => {
+    const all = located(blocks);
+    return [
+        ...overCount('The message blocks', blocks.length, SLACK_LIMITS.blocksPerMessage),
+        ...overLength('The fallback text', text, SLACK_LIMITS.fallbackTextChars),
+        ...overTableText(tableTextLength(all.map(({ block }) => block))),
+        ...all.flatMap(blockProblems),
+        ...all.flatMap(staleWrapperProblems),
+    ];
+};
+//# sourceMappingURL=slack_limits.js.map

package/dist/model/slack_limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack_limits.js","sourceRoot":"","sources":["../../src/model/slack_limits.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nimport type {\n  SlackActionElement,\n  SlackBlock,\n  SlackOptionObject,\n  SlackRichTextBlock,\n  SlackRichTextBlockElement,\n  SlackRichTextInline,\n  SlackSectionAccessory,\n  SlackTableCell,\n} from '@elastic/isomer-sdk/slack';\nimport {\n  isModeledSlackBlockType,\n  isUnmodeledSlackBlock,\n  SLACK_LIMITS,\n} from '@elastic/isomer-sdk/slack';\n\nconst list = <T>(value: readonly T[] | undefined): readonly T[] => value ?? [];\n\nconst overLength = (\n  where: string,\n  text: string | undefined,\n  limit: number\n): string[] =>\n  typeof text === 'string' && text.length > limit\n    ? [`${where} has ${text.length} characters; Slack allows ${limit}.`]\n    : [];\n\nconst overCount = (where: string, count: number, limit: number): string[] =>\n  count > limit ? [`${where} has ${count}; Slack allows ${limit}.`] : [];\n\nconst empty = (where: string, count: number): string[] =>\n  count === 0 ? [`${where} is empty; Slack requires at least 1.`] : [];\n\nconst inlineText = (inline: SlackRichTextInline): string =>\n  inline.type === 'link' ? (inline.text ?? inline.url) : inline.text;\n\nconst richTextText = (element: SlackRichTextBlockElement): string =>\n  element.type === 'rich_text_list'\n    ? list(element.elements).map(richTextText).join('')\n    : list(element.elements).map(inlineText).join('');\n\nconst cellText = (cell: SlackTableCell): string =>\n  cell.type === 'raw_text'\n    ? cell.text\n    : list(cell.elements).map(richTextText).join('');\n\nconst imageProblems = (\n  where: string,\n  { image_url, alt_text }: { image_url?: string; alt_text?: string }\n): string[] => [\n  ...overLength(`${where} image_url`, image_url, SLACK_LIMITS.imageUrlChars),\n  ...overLength(`${where} alt_text`, alt_text, SLACK_LIMITS.imageAltTextChars),\n];\n\nconst optionProblems = (\n  where: string,\n  { text, value, description, url }: SlackOptionObject\n): string[] => [\n  ...overLength(`${where} text`, text?.text, SLACK_LIMITS.optionTextChars),\n  ...overLength(`${where} value`, value, SLACK_LIMITS.optionValueChars),\n  ...overLength(\n    `${where} description`,\n    description?.text,\n    SLACK_LIMITS.optionTextChars\n  ),\n  ...overLength(`${where} url`, url, SLACK_LIMITS.urlChars),\n];\n\nconst optionsProblems = (\n  where: string,\n  options: readonly SlackOptionObject[] | undefined,\n  limit: number\n): string[] => [\n  ...overCount(`${where} options`, list(options).length, limit),\n  ...list(options).flatMap((option, index) =>\n    optionProblems(`${where} options[${index}]`, option)\n  ),\n];\n\nconst controlProblems = (\n  where: string,\n  element: SlackActionElement\n): string[] => {\n  const actionId = overLength(\n    `${where} action_id`,\n    element.action_id,\n    SLACK_LIMITS.actionIdChars\n  );\n  switch (element.type) {\n    case 'button':\n      return [\n        ...actionId,\n        ...overLength(\n          `${where} text`,\n          element.text?.text,\n          SLACK_LIMITS.buttonTextChars\n        ),\n        ...overLength(\n          `${where} value`,\n          element.value,\n          SLACK_LIMITS.buttonValueChars\n        ),\n        ...overLength(`${where} url`, element.url, SLACK_LIMITS.urlChars),\n      ];\n    case 'overflow':\n      return [\n        ...actionId,\n        ...optionsProblems(\n          where,\n          element.options,\n          SLACK_LIMITS.optionsPerOverflow\n        ),\n      ];\n    case 'radio_buttons':\n    case 'checkboxes':\n      return [\n        ...actionId,\n        ...optionsProblems(\n          where,\n          element.options,\n          SLACK_LIMITS.optionsPerChoice\n        ),\n      ];\n    case 'static_select':\n    case 'multi_static_select': {\n      const groups =\n        element.type === 'static_select' ? list(element.option_groups) : [];\n      return [\n        ...actionId,\n        ...overLength(\n          `${where} placeholder`,\n          element.placeholder?.text,\n          SLACK_LIMITS.placeholderChars\n        ),\n        ...optionsProblems(\n          where,\n          element.options,\n          SLACK_LIMITS.optionsPerSelect\n        ),\n        ...overCount(\n          `${where} option_groups`,\n          groups.length,\n          SLACK_LIMITS.optionGroupsPerSelect\n        ),\n        ...groups.flatMap(({ label, options }, index) => [\n          ...overLength(\n            `${where} option_groups[${index}] label`,\n            label?.text,\n            SLACK_LIMITS.optionGroupLabelChars\n          ),\n          ...optionsProblems(\n            `${where} option_groups[${index}]`,\n            options,\n            SLACK_LIMITS.optionsPerSelect\n          ),\n        ]),\n      ];\n    }\n    default:\n      return actionId;\n  }\n};\n\nconst accessoryProblems = (\n  where: string,\n  accessory: SlackSectionAccessory\n): string[] =>\n  accessory.type === 'image'\n    ? imageProblems(where, accessory)\n    : controlProblems(where, accessory);\n\nconst richTextProblems = (\n  where: string,\n  element: SlackRichTextBlockElement,\n  textLimit: number | undefined\n): string[] => {\n  if (element.type === 'rich_text_list') {\n    return overCount(\n      `${where} indent`,\n      element.indent ?? 0,\n      SLACK_LIMITS.richTextListMaxIndent\n    );\n  }\n  return textLimit === undefined\n    ? []\n    : overLength(`${where} text`, richTextText(element), textLimit);\n};\n\n/** Only a top-level element has a `textLimit`; list items and table cells count toward the message's budgets alone. */\nconst richTextBlockProblems = (\n  where: string,\n  { elements }: SlackRichTextBlock,\n  textLimit?: number\n): string[] =>\n  list(elements).flatMap((element, elementIndex) =>\n    richTextProblems(`${where} elements[${elementIndex}]`, element, textLimit)\n  );\n\ninterface LocatedBlock {\n  where: string;\n  block: SlackBlock;\n}\n\n/** Every block in the message, a container's children after it, each with the path a problem names. */\nconst located = (blocks: readonly SlackBlock[]): LocatedBlock[] =>\n  blocks.flatMap((block, index) => {\n    const where = `blocks[${index}] (${block.type})`;\n    return [\n      { where, block },\n      ...(block.type === 'container'\n        ? list(block.child_blocks).map((child, childIndex) => ({\n            where: `${where} child_blocks[${childIndex}] (${child.type})`,\n            block: child,\n          }))\n        : []),\n    ];\n  });\n\nconst blockProblems = ({ where, block }: LocatedBlock): string[] => {\n  switch (block.type) {\n    case 'container': {\n      const children = list(block.child_blocks);\n      return [\n        ...overLength(\n          `${where} title`,\n          block.title?.text,\n          SLACK_LIMITS.containerTitleChars\n        ),\n        ...overLength(\n          `${where} subtitle`,\n          block.subtitle?.text,\n          SLACK_LIMITS.containerSubtitleChars\n        ),\n        ...(block.icon ? imageProblems(`${where} icon`, block.icon) : []),\n        ...(block.rich_text_title\n          ? richTextBlockProblems(\n              `${where} rich_text_title`,\n              block.rich_text_title,\n              SLACK_LIMITS.sectionTextChars\n            )\n          : []),\n        ...overCount(\n          `${where} child_blocks`,\n          children.length,\n          SLACK_LIMITS.containerChildBlocks\n        ),\n        ...empty(`${where} child_blocks`, children.length),\n        ...children.flatMap(({ type }, childIndex) =>\n          (type as string) === 'container'\n            ? [\n                `${where} child_blocks[${childIndex}] is a container; Slack does not accept one inside another.`,\n              ]\n            : []\n        ),\n      ];\n    }\n    case 'header':\n      return overLength(\n        `${where} text`,\n        block.text?.text,\n        SLACK_LIMITS.headerTextChars\n      );\n    case 'section': {\n      const fields = list(block.fields);\n      return [\n        ...overLength(\n          `${where} text`,\n          block.text?.text,\n          SLACK_LIMITS.sectionTextChars\n        ),\n        ...overCount(\n          `${where} fields`,\n          fields.length,\n          SLACK_LIMITS.fieldsPerSection\n        ),\n        ...fields.flatMap((field, fieldIndex) =>\n          overLength(\n            `${where} fields[${fieldIndex}]`,\n            field?.text,\n            SLACK_LIMITS.sectionFieldChars\n          )\n        ),\n        ...(block.accessory\n          ? accessoryProblems(`${where} accessory`, block.accessory)\n          : []),\n      ];\n    }\n    case 'context': {\n      const elements = list(block.elements);\n      return [\n        ...overCount(\n          `${where} elements`,\n          elements.length,\n          SLACK_LIMITS.contextElements\n        ),\n        ...elements.flatMap((element, elementIndex) =>\n          element.type === 'image'\n            ? imageProblems(`${where} elements[${elementIndex}]`, element)\n            : overLength(\n                `${where} elements[${elementIndex}]`,\n                element.text,\n                SLACK_LIMITS.contextElementChars\n              )\n        ),\n      ];\n    }\n    case 'actions': {\n      const elements = list(block.elements);\n      return [\n        ...overCount(\n          `${where} elements`,\n          elements.length,\n          SLACK_LIMITS.buttonsPerActions\n        ),\n        ...elements.flatMap((element, elementIndex) =>\n          controlProblems(`${where} elements[${elementIndex}]`, element)\n        ),\n      ];\n    }\n    case 'image':\n      return [\n        ...imageProblems(where, block),\n        ...overLength(\n          `${where} title`,\n          block.title?.text,\n          SLACK_LIMITS.imageTitleChars\n        ),\n      ];\n    case 'video':\n      return [\n        ...overLength(\n          `${where} title`,\n          block.title?.text,\n          SLACK_LIMITS.videoTitleChars\n        ),\n        ...overLength(\n          `${where} description`,\n          block.description?.text,\n          SLACK_LIMITS.videoDescriptionChars\n        ),\n        ...overLength(\n          `${where} author_name`,\n          block.author_name,\n          SLACK_LIMITS.videoAuthorNameChars\n        ),\n      ];\n    case 'rich_text':\n      return richTextBlockProblems(where, block, SLACK_LIMITS.sectionTextChars);\n    case 'table': {\n      const rows = list(block.rows);\n      return [\n        ...overCount(`${where} rows`, rows.length, SLACK_LIMITS.tableRows),\n        ...empty(`${where} rows`, rows.length),\n        ...rows.flatMap((row, rowIndex) => [\n          ...overCount(\n            `${where} rows[${rowIndex}] cells`,\n            list(row).length,\n            SLACK_LIMITS.tableColumns\n          ),\n          ...empty(`${where} rows[${rowIndex}] cells`, list(row).length),\n          ...list(row).flatMap((cell, cellIndex) =>\n            cell.type === 'rich_text'\n              ? richTextBlockProblems(\n                  `${where} rows[${rowIndex}][${cellIndex}]`,\n                  cell\n                )\n              : []\n          ),\n        ]),\n      ];\n    }\n    default:\n      return [];\n  }\n};\n\nconst overTableText = (length: number): string[] =>\n  length > SLACK_LIMITS.tableCellCharsPerMessage\n    ? [\n        `The message's table cells have ${length} characters; Slack allows ${SLACK_LIMITS.tableCellCharsPerMessage}.`,\n      ]\n    : [];\n\nconst tableTextLength = (blocks: readonly SlackBlock[]): number =>\n  blocks.reduce(\n    (total, block) =>\n      block.type === 'table'\n        ? list(block.rows).reduce(\n            (sum, row) =>\n              list(row).reduce(\n                (cells, cell) => cells + cellText(cell).length,\n                sum\n              ),\n            total\n          )\n        : total,\n    0\n  );\n\nconst staleWrapperProblems = ({ where, block }: LocatedBlock): string[] => {\n  const { type } = block;\n  return isUnmodeledSlackBlock(block) && isModeledSlackBlockType(type)\n    ? [\n        `${where} is wrapped in \\`unmodeledSlackBlock\\`, but Isomer models \\`${type}\\` blocks: return it unwrapped so its limits are fitted.`,\n      ]\n    : [];\n};\n\n/** One note per block type Isomer does not model: the envelope passed those blocks through unfitted, and {@link slackLimitProblems} cannot check them. */\nexport const unmodeledSlackNotes = (blocks: readonly SlackBlock[]): string[] =>\n  [\n    ...new Set(\n      located(blocks)\n        .map(({ block: { type } }): string => type)\n        .filter((type) => !isModeledSlackBlockType(type))\n    ),\n  ].map(\n    (type) =>\n      `Isomer doesn't model \\`${type}\\` blocks, so their Slack limits aren't checked and this preview may not draw them. Check the message in Block Kit Builder.`\n  );\n\n/** Where a rendered Slack message breaks `SLACK_LIMITS`; empty when Slack would accept it. */\nexport const slackLimitProblems = ({\n  text,\n  blocks,\n}: {\n  text: string;\n  blocks: readonly SlackBlock[];\n}): string[] => {\n  const all = located(blocks);\n  return [\n    ...overCount(\n      'The message blocks',\n      blocks.length,\n      SLACK_LIMITS.blocksPerMessage\n    ),\n    ...overLength('The fallback text', text, SLACK_LIMITS.fallbackTextChars),\n    ...overTableText(tableTextLength(all.map(({ block }) => block))),\n    ...all.flatMap(blockProblems),\n    ...all.flatMap(staleWrapperProblems),\n  ];\n};\n"]}

package/dist/node/app_bundle.d.ts

@@ -0,0 +1,45 @@
+import type { BuildOptions, Metafile, Plugin } from 'esbuild';
+export type AppMode = 'build' | 'dev';
+/** The package root, whether this module runs from `dist/node` or `src/node`. */
+export declare const PACKAGE_DIR: string;
+/** Whether the CLI runs from its TypeScript source, as `pnpm studio:dev` does, rather than from `dist`. */
+export declare const RUNS_FROM_SOURCE: boolean;
+/** The package's prebuilt, pack-independent assets: `dist/app/`. */
+export declare const APP_DIR: string;
+/** Without an extension, so the bundle takes `dist/browser/*.js`, or the `.ts(x)` beside it when the CLI runs from source. */
+export declare const browserModule: (name: string) => string;
+/** The bundle's entry: the config's default export mounted with the mode's host functions. In `dev`, a changed config re-renders the mounted Studio in place. */
+export declare const appEntry: (configPath: string, mode: AppMode) => string;
+/** The package directories of the config's `react` and `react-dom`, which every React import in the bundle resolves into. */
+export declare const reactDirectories: (configPath: string) => string[];
+/**
+ * Resolves `react`, `react-dom` and their subpaths as if imported from the config, so the app, the pack and
+ * Emotion share the config's React. Re-resolving the specifier, rather than aliasing a directory, keeps
+ * each package's `browser` and `exports` mappings, which pick `react-dom/server`'s browser build.
+ */
+export declare const reactFromConfig: (configPath: string) => Plugin;
+/** Resolves `SHARED_PACKAGES` from the project when imported from outside it, and `STUDIO_PACKAGES` from the Studio when the project lacks them. */
+export declare const projectResolution: (configPath: string) => Plugin;
+/** esbuild options for a static build's `assets/app.js` and its chunks, written to `assetsDir`. */
+export declare const appBuildOptions: ({ configPath, assetsDir, plugins, }: {
+    configPath: string;
+    assetsDir: string;
+    plugins?: Plugin[] | undefined;
+}) => BuildOptions;
+/**
+ * The entry's CSS bundle, relative to the working directory: every CSS file the config reaches, lazy chunks
+ * included, with `url()`s relative to `assets/`. The per-chunk CSS esbuild also writes is never linked.
+ */
+export declare const appStylesheets: (metafile: Metafile, entryPoint?: string) => {
+    bundle: string | undefined;
+    chunks: string[];
+};
+/** `dist/app/index.html` with the deployment's `<base href>`, the config's title, and the entry script. */
+export declare const renderIndexHtml: ({ base, title, entry, stylesheets, }: {
+    base: string;
+    title?: string | undefined;
+    entry?: string | undefined;
+    /** Linked after the Studio's own stylesheets, relative to `base`. */
+    stylesheets?: readonly string[] | undefined;
+}) => string;
+//# sourceMappingURL=app_bundle.d.ts.map

package/dist/node/app_bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app_bundle.d.ts","sourceRoot":"","sources":["../../src/node/app_bundle.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAQ9D,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,KAAK,CAAC;AAItC,iFAAiF;AACjF,eAAO,MAAM,WAAW,QAAyB,CAAC;AAElD,2GAA2G;AAC3G,eAAO,MAAM,gBAAgB,SAAkC,CAAC;AAEhE,oEAAoE;AACpE,eAAO,MAAM,OAAO,QAAgC,CAAC;AAErD,8HAA8H;AAC9H,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,MACV,CAAC;AAOpC,iKAAiK;AACjK,eAAO,MAAM,QAAQ,GAAI,YAAY,MAAM,EAAE,MAAM,OAAO,KAAG,MAmB5D,CAAC;AAEF,6HAA6H;AAC7H,eAAO,MAAM,gBAAgB,GAAI,YAAY,MAAM,KAAG,MAAM,EAK3D,CAAC;AAIF;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,YAAY,MAAM,KAAG,MAoBnD,CAAC;AAIH,oJAAoJ;AACpJ,eAAO,MAAM,iBAAiB,GAAI,YAAY,MAAM,KAAG,MAkCtD,CAAC;AAiDF,mGAAmG;AACnG,eAAO,MAAM,eAAe,GAAI,qCAI7B;IACD,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CAChC,KAAG,YA4BF,CAAC;AAKH;;;GAGG;AACH,eAAO,MAAM,cAAc,GACzB,UAAU,QAAQ,EAClB,aAAY,MAAwB,KACnC;IAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAUhD,CAAC;AAcF,2GAA2G;AAC3G,eAAO,MAAM,eAAe,GAAI,sCAK7B;IACD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,qEAAqE;IACrE,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CAC7C,KAAG,MAqBH,CAAC"}

package/dist/node/app_bundle.js

@@ -0,0 +1,212 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+import { readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { isStudioSpecifier, projectDirectory, sharedResolveDir, } from './project_resolution.js';
+const here = dirname(fileURLToPath(import.meta.url));
+/** The package root, whether this module runs from `dist/node` or `src/node`. */
+export const PACKAGE_DIR = resolve(here, '../..');
+/** Whether the CLI runs from its TypeScript source, as `pnpm studio:dev` does, rather than from `dist`. */
+export const RUNS_FROM_SOURCE = import.meta.url.endsWith('.ts');
+/** The package's prebuilt, pack-independent assets: `dist/app/`. */
+export const APP_DIR = join(PACKAGE_DIR, 'dist/app');
+/** Without an extension, so the bundle takes `dist/browser/*.js`, or the `.ts(x)` beside it when the CLI runs from source. */
+export const browserModule = (name) => resolve(here, '../browser', name);
+const HOSTS = {
+    dev: { module: 'dev_host', name: 'devHost' },
+    build: { module: 'static_host', name: 'staticHost' },
+};
+/** The bundle's entry: the config's default export mounted with the mode's host functions. In `dev`, a changed config re-renders the mounted Studio in place. */
+export const appEntry = (configPath, mode) => {
+    const { module, name } = HOSTS[mode];
+    const config = JSON.stringify(configPath);
+    return [
+        `import config from ${config};`,
+        `import { mountStudio } from ${JSON.stringify(browserModule('mount'))};`,
+        `import { ${name} } from ${JSON.stringify(browserModule(module))};`,
+        `const studio = mountStudio(config, ${name}(config));`,
+        ...(mode === 'dev'
+            ? [
+                'if (import.meta.hot) {',
+                `  import.meta.hot.accept(${config}, (next) => {`,
+                `    if (next) studio.update(next.default, ${name}(next.default));`,
+                '  });',
+                '}',
+            ]
+            : []),
+        '',
+    ].join('\n');
+};
+/** The package directories of the config's `react` and `react-dom`, which every React import in the bundle resolves into. */
+export const reactDirectories = (configPath) => {
+    const require = createRequire(configPath);
+    return ['react', 'react-dom'].map((name) => dirname(require.resolve(`${name}/package.json`)));
+};
+const REACT_SPECIFIER = /^react(-dom)?(\/.*)?$/;
+/**
+ * Resolves `react`, `react-dom` and their subpaths as if imported from the config, so the app, the pack and
+ * Emotion share the config's React. Re-resolving the specifier, rather than aliasing a directory, keeps
+ * each package's `browser` and `exports` mappings, which pick `react-dom/server`'s browser build.
+ */
+export const reactFromConfig = (configPath) => ({
+    name: 'isomer-studio-react',
+    setup: (build) => {
+        build.onResolve({ filter: REACT_SPECIFIER }, async ({ path, kind, pluginData }) => {
+            if (pluginData === REACT_SPECIFIER) {
+                return undefined;
+            }
+            const result = await build.resolve(path, {
+                kind,
+                resolveDir: dirname(configPath),
+                pluginData: REACT_SPECIFIER,
+            });
+            return result.errors.length
+                ? { errors: result.errors }
+                : { path: result.path };
+        });
+    },
+});
+const SKIP = Symbol.for('elastic.isomer.studio.project_resolution');
+/** Resolves `SHARED_PACKAGES` from the project when imported from outside it, and `STUDIO_PACKAGES` from the Studio when the project lacks them. */
+export const projectResolution = (configPath) => {
+    const projectDir = projectDirectory(configPath);
+    return {
+        name: 'isomer-studio-project-resolution',
+        setup: (build) => {
+            build.onResolve({ filter: /^[^./]/ }, async ({ path, importer, kind, resolveDir, pluginData }) => {
+                if (pluginData === SKIP || REACT_SPECIFIER.test(path)) {
+                    return undefined;
+                }
+                const resolveFrom = async (dir) => build.resolve(path, { kind, resolveDir: dir, pluginData: SKIP });
+                const shared = sharedResolveDir(path, importer, projectDir);
+                if (shared !== undefined) {
+                    const result = await resolveFrom(shared);
+                    if (!result.errors.length) {
+                        return { path: result.path };
+                    }
+                }
+                if (!isStudioSpecifier(path)) {
+                    return undefined;
+                }
+                const own = await resolveFrom(resolveDir);
+                const result = own.errors.length
+                    ? await resolveFrom(PACKAGE_DIR)
+                    : own;
+                return result.errors.length
+                    ? { errors: own.errors }
+                    : { path: result.path };
+            });
+        },
+    };
+};
+const ENTRY = 'isomer-studio:app';
+const entryPlugin = (configPath) => ({
+    name: 'isomer-studio-entry',
+    setup: (build) => {
+        build.onResolve({ filter: /^isomer-studio:app$/ }, ({ path }) => ({
+            path,
+            namespace: 'isomer-studio',
+        }));
+        build.onLoad({ filter: /.*/, namespace: 'isomer-studio' }, () => ({
+            contents: appEntry(configPath, 'build'),
+            resolveDir: dirname(configPath),
+            loader: 'js',
+        }));
+    },
+});
+/** Fonts and images a stylesheet or module may reference, emitted to `assets/media/`. */
+const ASSET_LOADERS = Object.fromEntries([
+    '.avif',
+    '.eot',
+    '.gif',
+    '.ico',
+    '.jpeg',
+    '.jpg',
+    '.otf',
+    '.png',
+    '.svg',
+    '.ttf',
+    '.webp',
+    '.woff',
+    '.woff2',
+].map((extension) => [extension, 'file']));
+/** `assets/studio.css` already carries Monaco's stylesheet, which Monaco's modules also import piecemeal. */
+const monacoCssEmpty = {
+    name: 'isomer-studio-monaco-css',
+    setup: (build) => {
+        build.onLoad({ filter: /[\\/]monaco-editor[\\/].*\.css$/ }, () => ({
+            contents: '',
+            loader: 'empty',
+        }));
+    },
+};
+/** esbuild options for a static build's `assets/app.js` and its chunks, written to `assetsDir`. */
+export const appBuildOptions = ({ configPath, assetsDir, plugins = [], }) => ({
+    entryPoints: { app: ENTRY },
+    outdir: assetsDir,
+    chunkNames: 'chunks/[name]-[hash]',
+    assetNames: 'media/[name]-[hash]',
+    bundle: true,
+    splitting: true,
+    format: 'esm',
+    platform: 'browser',
+    target: 'es2022',
+    loader: {
+        '.css': 'css',
+        '.module.css': 'local-css',
+        ...ASSET_LOADERS,
+    },
+    define: {
+        'process.env.NODE_ENV': JSON.stringify('production'),
+        global: 'globalThis',
+    },
+    minify: true,
+    logLevel: 'warning',
+    plugins: [
+        entryPlugin(configPath),
+        reactFromConfig(configPath),
+        projectResolution(configPath),
+        monacoCssEmpty,
+        ...plugins,
+    ],
+});
+/** The bundle entry's id in an esbuild metafile. */
+const APP_ENTRY_POINT = `isomer-studio:${ENTRY}`;
+/**
+ * The entry's CSS bundle, relative to the working directory: every CSS file the config reaches, lazy chunks
+ * included, with `url()`s relative to `assets/`. The per-chunk CSS esbuild also writes is never linked.
+ */
+export const appStylesheets = (metafile, entryPoint = APP_ENTRY_POINT) => {
+    const bundle = Object.values(metafile.outputs).find((output) => output.entryPoint === entryPoint)?.cssBundle;
+    return {
+        bundle,
+        chunks: Object.keys(metafile.outputs).filter((output) => output.endsWith('.css') && output !== bundle),
+    };
+};
+const SLACK_STYLESHEET = '<link rel="stylesheet" href="assets/slack.css" />';
+const HTML_ESCAPES = {
+    '&': '&amp;',
+    '<': '&lt;',
+    '>': '&gt;',
+    '"': '&quot;',
+};
+const escapeHtml = (value) => value.replace(/[&<>"]/g, (char) => HTML_ESCAPES[char] ?? char);
+/** `dist/app/index.html` with the deployment's `<base href>`, the config's title, and the entry script. */
+export const renderIndexHtml = ({ base, title = 'Isomer Studio', entry = 'assets/app.js', stylesheets = [], }) => {
+    const template = readFileSync(join(APP_DIR, 'index.html'), 'utf8');
+    return template
+        .replace('<base href="./" />', `<base href="${escapeHtml(base)}" />`)
+        .replace('<title>Isomer Studio</title>', `<title>${escapeHtml(title)}</title>`)
+        .replace(SLACK_STYLESHEET, [
+        SLACK_STYLESHEET,
+        ...stylesheets.map((href) => `<link rel="stylesheet" href="${escapeHtml(href)}" />`),
+    ].join('\n    '))
+        .replace('<script type="module" src="assets/app.js"></script>', `<script type="module" src="${escapeHtml(entry)}"></script>`);
+};
+//# sourceMappingURL=app_bundle.js.map

package/dist/node/app_bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app_bundle.js","sourceRoot":"","sources":["../../src/node/app_bundle.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nimport { readFileSync } from 'node:fs';\nimport { createRequire } from 'node:module';\nimport { dirname, join, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport type { BuildOptions, Metafile, Plugin } from 'esbuild';\n\nimport {\n  isStudioSpecifier,\n  projectDirectory,\n  sharedResolveDir,\n} from './project_resolution';\n\nexport type AppMode = 'build' | 'dev';\n\nconst here = dirname(fileURLToPath(import.meta.url));\n\n/** The package root, whether this module runs from `dist/node` or `src/node`. */\nexport const PACKAGE_DIR = resolve(here, '../..');\n\n/** Whether the CLI runs from its TypeScript source, as `pnpm studio:dev` does, rather than from `dist`. */\nexport const RUNS_FROM_SOURCE = import.meta.url.endsWith('.ts');\n\n/** The package's prebuilt, pack-independent assets: `dist/app/`. */\nexport const APP_DIR = join(PACKAGE_DIR, 'dist/app');\n\n/** Without an extension, so the bundle takes `dist/browser/*.js`, or the `.ts(x)` beside it when the CLI runs from source. */\nexport const browserModule = (name: string): string =>\n  resolve(here, '../browser', name);\n\nconst HOSTS: Readonly<Record<AppMode, { module: string; name: string }>> = {\n  dev: { module: 'dev_host', name: 'devHost' },\n  build: { module: 'static_host', name: 'staticHost' },\n};\n\n/** The bundle's entry: the config's default export mounted with the mode's host functions. In `dev`, a changed config re-renders the mounted Studio in place. */\nexport const appEntry = (configPath: string, mode: AppMode): string => {\n  const { module, name } = HOSTS[mode];\n  const config = JSON.stringify(configPath);\n  return [\n    `import config from ${config};`,\n    `import { mountStudio } from ${JSON.stringify(browserModule('mount'))};`,\n    `import { ${name} } from ${JSON.stringify(browserModule(module))};`,\n    `const studio = mountStudio(config, ${name}(config));`,\n    ...(mode === 'dev'\n      ? [\n          'if (import.meta.hot) {',\n          `  import.meta.hot.accept(${config}, (next) => {`,\n          `    if (next) studio.update(next.default, ${name}(next.default));`,\n          '  });',\n          '}',\n        ]\n      : []),\n    '',\n  ].join('\\n');\n};\n\n/** The package directories of the config's `react` and `react-dom`, which every React import in the bundle resolves into. */\nexport const reactDirectories = (configPath: string): string[] => {\n  const require = createRequire(configPath);\n  return ['react', 'react-dom'].map((name) =>\n    dirname(require.resolve(`${name}/package.json`))\n  );\n};\n\nconst REACT_SPECIFIER = /^react(-dom)?(\\/.*)?$/;\n\n/**\n * Resolves `react`, `react-dom` and their subpaths as if imported from the config, so the app, the pack and\n * Emotion share the config's React. Re-resolving the specifier, rather than aliasing a directory, keeps\n * each package's `browser` and `exports` mappings, which pick `react-dom/server`'s browser build.\n */\nexport const reactFromConfig = (configPath: string): Plugin => ({\n  name: 'isomer-studio-react',\n  setup: (build) => {\n    build.onResolve(\n      { filter: REACT_SPECIFIER },\n      async ({ path, kind, pluginData }) => {\n        if (pluginData === REACT_SPECIFIER) {\n          return undefined;\n        }\n        const result = await build.resolve(path, {\n          kind,\n          resolveDir: dirname(configPath),\n          pluginData: REACT_SPECIFIER,\n        });\n        return result.errors.length\n          ? { errors: result.errors }\n          : { path: result.path };\n      }\n    );\n  },\n});\n\nconst SKIP = Symbol.for('elastic.isomer.studio.project_resolution');\n\n/** Resolves `SHARED_PACKAGES` from the project when imported from outside it, and `STUDIO_PACKAGES` from the Studio when the project lacks them. */\nexport const projectResolution = (configPath: string): Plugin => {\n  const projectDir = projectDirectory(configPath);\n  return {\n    name: 'isomer-studio-project-resolution',\n    setup: (build) => {\n      build.onResolve(\n        { filter: /^[^./]/ },\n        async ({ path, importer, kind, resolveDir, pluginData }) => {\n          if (pluginData === SKIP || REACT_SPECIFIER.test(path)) {\n            return undefined;\n          }\n          const resolveFrom = async (dir: string) =>\n            build.resolve(path, { kind, resolveDir: dir, pluginData: SKIP });\n          const shared = sharedResolveDir(path, importer, projectDir);\n          if (shared !== undefined) {\n            const result = await resolveFrom(shared);\n            if (!result.errors.length) {\n              return { path: result.path };\n            }\n          }\n          if (!isStudioSpecifier(path)) {\n            return undefined;\n          }\n          const own = await resolveFrom(resolveDir);\n          const result = own.errors.length\n            ? await resolveFrom(PACKAGE_DIR)\n            : own;\n          return result.errors.length\n            ? { errors: own.errors }\n            : { path: result.path };\n        }\n      );\n    },\n  };\n};\n\nconst ENTRY = 'isomer-studio:app';\n\nconst entryPlugin = (configPath: string): Plugin => ({\n  name: 'isomer-studio-entry',\n  setup: (build) => {\n    build.onResolve({ filter: /^isomer-studio:app$/ }, ({ path }) => ({\n      path,\n      namespace: 'isomer-studio',\n    }));\n    build.onLoad({ filter: /.*/, namespace: 'isomer-studio' }, () => ({\n      contents: appEntry(configPath, 'build'),\n      resolveDir: dirname(configPath),\n      loader: 'js',\n    }));\n  },\n});\n\n/** Fonts and images a stylesheet or module may reference, emitted to `assets/media/`. */\nconst ASSET_LOADERS = Object.fromEntries(\n  [\n    '.avif',\n    '.eot',\n    '.gif',\n    '.ico',\n    '.jpeg',\n    '.jpg',\n    '.otf',\n    '.png',\n    '.svg',\n    '.ttf',\n    '.webp',\n    '.woff',\n    '.woff2',\n  ].map((extension) => [extension, 'file' as const])\n);\n\n/** `assets/studio.css` already carries Monaco's stylesheet, which Monaco's modules also import piecemeal. */\nconst monacoCssEmpty: Plugin = {\n  name: 'isomer-studio-monaco-css',\n  setup: (build) => {\n    build.onLoad({ filter: /[\\\\/]monaco-editor[\\\\/].*\\.css$/ }, () => ({\n      contents: '',\n      loader: 'empty',\n    }));\n  },\n};\n\n/** esbuild options for a static build's `assets/app.js` and its chunks, written to `assetsDir`. */\nexport const appBuildOptions = ({\n  configPath,\n  assetsDir,\n  plugins = [],\n}: {\n  configPath: string;\n  assetsDir: string;\n  plugins?: Plugin[] | undefined;\n}): BuildOptions => ({\n  entryPoints: { app: ENTRY },\n  outdir: assetsDir,\n  chunkNames: 'chunks/[name]-[hash]',\n  assetNames: 'media/[name]-[hash]',\n  bundle: true,\n  splitting: true,\n  format: 'esm',\n  platform: 'browser',\n  target: 'es2022',\n  loader: {\n    '.css': 'css',\n    '.module.css': 'local-css',\n    ...ASSET_LOADERS,\n  },\n  define: {\n    'process.env.NODE_ENV': JSON.stringify('production'),\n    global: 'globalThis',\n  },\n  minify: true,\n  logLevel: 'warning',\n  plugins: [\n    entryPlugin(configPath),\n    reactFromConfig(configPath),\n    projectResolution(configPath),\n    monacoCssEmpty,\n    ...plugins,\n  ],\n});\n\n/** The bundle entry's id in an esbuild metafile. */\nconst APP_ENTRY_POINT = `isomer-studio:${ENTRY}`;\n\n/**\n * The entry's CSS bundle, relative to the working directory: every CSS file the config reaches, lazy chunks\n * included, with `url()`s relative to `assets/`. The per-chunk CSS esbuild also writes is never linked.\n */\nexport const appStylesheets = (\n  metafile: Metafile,\n  entryPoint: string = APP_ENTRY_POINT\n): { bundle: string | undefined; chunks: string[] } => {\n  const bundle = Object.values(metafile.outputs).find(\n    (output) => output.entryPoint === entryPoint\n  )?.cssBundle;\n  return {\n    bundle,\n    chunks: Object.keys(metafile.outputs).filter(\n      (output) => output.endsWith('.css') && output !== bundle\n    ),\n  };\n};\n\nconst SLACK_STYLESHEET = '<link rel=\"stylesheet\" href=\"assets/slack.css\" />';\n\nconst HTML_ESCAPES: Readonly<Record<string, string>> = {\n  '&': '&amp;',\n  '<': '&lt;',\n  '>': '&gt;',\n  '\"': '&quot;',\n};\n\nconst escapeHtml = (value: string): string =>\n  value.replace(/[&<>\"]/g, (char) => HTML_ESCAPES[char] ?? char);\n\n/** `dist/app/index.html` with the deployment's `<base href>`, the config's title, and the entry script. */\nexport const renderIndexHtml = ({\n  base,\n  title = 'Isomer Studio',\n  entry = 'assets/app.js',\n  stylesheets = [],\n}: {\n  base: string;\n  title?: string | undefined;\n  entry?: string | undefined;\n  /** Linked after the Studio's own stylesheets, relative to `base`. */\n  stylesheets?: readonly string[] | undefined;\n}): string => {\n  const template = readFileSync(join(APP_DIR, 'index.html'), 'utf8');\n  return template\n    .replace('<base href=\"./\" />', `<base href=\"${escapeHtml(base)}\" />`)\n    .replace(\n      '<title>Isomer Studio</title>',\n      `<title>${escapeHtml(title)}</title>`\n    )\n    .replace(\n      SLACK_STYLESHEET,\n      [\n        SLACK_STYLESHEET,\n        ...stylesheets.map(\n          (href) => `<link rel=\"stylesheet\" href=\"${escapeHtml(href)}\" />`\n        ),\n      ].join('\\n    ')\n    )\n    .replace(\n      '<script type=\"module\" src=\"assets/app.js\"></script>',\n      `<script type=\"module\" src=\"${escapeHtml(entry)}\"></script>`\n    );\n};\n"]}

package/dist/node/build_site.d.ts

@@ -0,0 +1,28 @@
+import type { StudioConfig } from '../config.js';
+import type { PngManifest } from '../model/png_manifest.js';
+import type { ConfigLoader } from './load_config.js';
+import type { NodeRasterizer } from './rasterize.js';
+export interface PrerenderResult {
+    manifest: PngManifest;
+    /** Examples that could not be rasterized, as `primitive › example (theme): message`. */
+    failures: string[];
+}
+/** Rasterizes every example in both themes into `dir`, keyed by `compositionKey`, plus `manifest.json`. */
+export declare const prerenderPngs: (config: StudioConfig, rasterize: NodeRasterizer, dir: string) => Promise<PrerenderResult>;
+/** Written into every build, so a later build only clears a directory a Studio build made. */
+export declare const BUILD_MARKER = ".isomer-studio-build";
+/** Clears `out` for a new build, refusing a non-empty directory that is not a previous build. */
+export declare const prepareOut: (out: string) => void;
+export interface BuildSiteOptions {
+    configPath: string;
+    out: string;
+    base: string;
+    loader?: ConfigLoader | undefined;
+}
+export interface BuildSiteResult {
+    pngs: number;
+    failures: string[];
+}
+/** Writes the static Studio for `configPath` to `out`: the prebuilt assets, `app.js`, and the PNG manifest. */
+export declare const buildSite: ({ configPath, out, base, loader, }: BuildSiteOptions) => Promise<BuildSiteResult>;
+//# sourceMappingURL=build_site.d.ts.map

package/dist/node/build_site.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build_site.d.ts","sourceRoot":"","sources":["../../src/node/build_site.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,YAAY,EAAe,MAAM,WAAW,CAAC;AAG3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AASzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAKlD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,WAAW,CAAC;IACtB,wFAAwF;IACxF,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,2GAA2G;AAC3G,eAAO,MAAM,aAAa,GACxB,QAAQ,YAAY,EACpB,WAAW,cAAc,EACzB,KAAK,MAAM,KACV,OAAO,CAAC,eAAe,CAsCzB,CAAC;AAEF,8FAA8F;AAC9F,eAAO,MAAM,YAAY,yBAAyB,CAAC;AAEnD,iGAAiG;AACjG,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM,KAAG,IAaxC,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,+GAA+G;AAC/G,eAAO,MAAM,SAAS,GAAU,oCAK7B,gBAAgB,KAAG,OAAO,CAAC,eAAe,CAoC5C,CAAC"}