Skip to content

chuspeeism/dashi-ppt-skill / skills/dashi-ppt

dashi-ppt

Flagged

制作 PPT、演示文稿、幻灯片、汇报材料时使用。Dashi PPT 基于预置视觉主题组合页面,生成可离线打开、可在浏览器编辑的 HTML 演示,支持导出 PPTX / PDF 文件。

FileKindSize
.gitignoreother173 B
README.mdmarkdown3.9 KB
SKILL.mdskill md25.4 KB
agents/openai.yamlconfig292 B
assets/skill/dashi-ppt-favicon.pngbinary2.0 KB
assets/skill/dashi-ppt-small.pngbinary895 B
assets/skill/dashi-ppt.pngbinary12.6 KB
assets/skill/theme-style-grid.pngbinary2.1 MB
project/.npmrcother40 B
project/assets/skill/dashi-ppt-favicon.pngbinary2.0 KB
project/assets/social-icons/bilibili.svgother7.9 KB
project/assets/social-icons/douyin.svgother4.7 KB
project/assets/social-icons/github.svgother1.3 KB
project/assets/social-icons/redbook.svgother3.5 KB
project/assets/template-swiss.htmlother465.5 KB
project/assets/ui-icons/sidebar.svgother1.3 KB
project/assets/unicorn/automations_remix_scene.jsonconfig42.9 KB
project/assets/unicorn/goey_balls_remix_scene.jsonconfig14.2 KB
project/assets/unicorn/media/blue_noise_med.pngbinary206.4 KB
project/assets/unicorn/media/font_atlas.pngbinary64.6 KB
project/assets/unicorn/moving_into_remix_scene.jsonconfig67.8 KB
project/assets/unicorn/tech_background_remix_scene.jsonconfig52.2 KB
project/distribution-source.jsonconfig517 B
project/i18n/zh-en.jsonconfig574.5 KB
project/layout-manifest.jsonconfig3.4 MB
project/npmrc.templateother40 B
project/package-lock.jsonmanifest21.8 KB
project/package.jsonmanifest1.2 KB
project/packages/html-deck-to-pptx/LICENSEother1.6 KB
project/packages/html-deck-to-pptx/README.mdmarkdown2.2 KB
project/packages/html-deck-to-pptx/index.mjsscript719 B
project/packages/html-deck-to-pptx/package.jsonmanifest840 B
project/packages/html-deck-to-pptx/src/editable.mjsscript143 B
project/packages/html-deck-to-pptx/src/screenshot.mjsscript147 B
project/scripts/chrome-path.mjsscript6.1 KB
project/scripts/command-paths.mjsscript334 B
project/scripts/ensure-registry.mjsscript2.1 KB
project/scripts/export-pptx.mjsscript6.4 KB
project/scripts/goal-scaffold.mjsscript31.3 KB
project/scripts/inspect-layout.mjsscript2.1 KB
project/scripts/layout-query.mjsscript3.4 KB
project/scripts/media-formats.mjsscript1.3 KB
project/scripts/openssl-path.mjsscript2.2 KB
project/scripts/persist-deck-state.mjsscript6.7 KB
project/scripts/preview-export-auth.mjsscript1.0 KB
project/scripts/preview-freshness.mjsscript6.2 KB
project/scripts/preview-path.mjsscript569 B
project/scripts/preview/ensure-tmpdir.mjsscript3.4 KB
project/scripts/preview/export-routes.mjsscript24.2 KB
project/scripts/preview/launch-export-browser.mjsscript2.5 KB
project/scripts/preview/mime.mjsscript671 B
project/scripts/preview/network.mjsscript799 B
project/scripts/preview/static-serve.mjsscript1.2 KB
project/scripts/preview/tls.mjsscript2.7 KB
project/scripts/render-goal-deck.jsxother2.5 KB
project/scripts/scrub-local-paths.mjsscript898 B
project/scripts/serve-preview-https.mjsscript10.7 KB
project/scripts/skill-workflow-utils.mjsscript1.4 KB
project/scripts/stage-media.mjsexecutablescript14.7 KB
project/scripts/start-preview-server.mjsscript16.1 KB
project/scripts/validate-goal-copy.mjsscript25.4 KB
project/scripts/validate-goal-spec.mjsscript80.7 KB
project/scripts/validate-swiss-deck.mjsscript34.1 KB
project/scripts/workflow-telemetry.mjsscript6.1 KB
project/scripts/workflow/copy-contract.mjsscript19.2 KB
project/scripts/workflow/inspect-fillplan.mjsscript70.6 KB
project/scripts/workflow/layout-allocation.mjsscript8.5 KB
project/scripts/workflow/layout-query.mjsscript64.4 KB
project/scripts/workflow/media-slots.mjsscript15.8 KB
project/scripts/workflow/theme-registry.mjsscript16.1 KB
project/scripts/write-safe-props.mjsscript17.7 KB
project/src/accepted-themes.mjsscript570 B
project/src/components/bespoke/BespokeSlide.jsxother32.0 KB
project/src/components/bespoke/theme-profiles.mjsscript11.5 KB
project/src/components/index.jsxother71 B
project/src/components/shell/SlideShell.jsxother1.5 KB
project/src/components/shell/index.jsxother47 B
project/src/components/themes/canonical-metadata.mjsscript4.6 KB
project/src/components/themes/chart-safety.mjsscript1.9 KB
project/src/components/themes/client-runtime.jsxother57.9 KB
project/src/components/themes/decorative-overrides.mjsscript859 B
project/src/components/themes/generated-metadata.jsscript4.4 MB
project/src/components/themes/index.jsxother2.8 KB
project/src/components/themes/runtime-build.mjsscript7.3 KB
project/src/components/themes/runtime-helpers.jsxother6.2 KB
project/src/components/themes/theme-registry-codegen.mjsscript7.2 KB
project/src/components/themes/theme01/metadata.jsscript363.9 KB
project/src/components/themes/theme01/source/slides/theme.jsscript5.6 KB
project/src/components/themes/theme02/metadata.jsscript384.6 KB
project/src/components/themes/theme02/overrides.jsscript114 B
project/src/components/themes/theme02/source/src/gxnTheme.jsscript19.6 KB
project/src/components/themes/theme03/metadata.jsscript512.5 KB
project/src/components/themes/theme03/overrides.jsscript1.2 KB
project/src/components/themes/theme03/source/assets/3d/01.pngbinary635.1 KB
project/src/components/themes/theme03/source/assets/3d/02.pngbinary865.2 KB
project/src/components/themes/theme03/source/assets/3d/03.pngbinary921.8 KB
project/src/components/themes/theme03/source/assets/3d/04.pngbinary1.1 MB
project/src/components/themes/theme03/source/assets/3d/05.pngbinary920.3 KB
project/src/components/themes/theme03/source/assets/3d/06.pngbinary1.2 MB
project/src/components/themes/theme03/source/assets/3d/07.pngbinary1.6 MB
project/src/components/themes/theme03/source/assets/3d/08.pngbinary1.4 MB
project/src/components/themes/theme03/source/assets/3d/09.pngbinary1.9 MB
project/src/components/themes/theme03/source/assets/3d/10.pngbinary1.4 MB
project/src/components/themes/theme03/source/assets/3d/11.pngbinary1.6 MB
project/src/components/themes/theme03/source/assets/3d/12.pngbinary1.8 MB
project/src/components/themes/theme03/source/src/icons.jsscript799 B
project/src/components/themes/theme03/source/src/preset3d.jsscript119 B
project/src/components/themes/theme03/source/src/presetBase.jsscript3.4 KB
project/src/components/themes/theme03/source/src/registry.jsscript22.3 KB
project/src/components/themes/theme03/source/src/slides/safeProps.jsscript504 B
project/src/components/themes/theme03/source/src/theme.cssother5.4 KB
project/src/components/themes/theme03/source/src/theme.jsscript3.0 KB
project/src/components/themes/theme04/TEXT_CONTROL_POLICY.mdmarkdown344 B
project/src/components/themes/theme04/metadata.jsscript324.4 KB
project/src/components/themes/theme04/overrides.jsscript118 B
project/src/components/themes/theme04/source/image-slot.jsscript41.0 KB
project/src/components/themes/theme05/metadata.jsscript492.0 KB
project/src/components/themes/theme05/source/styles/exc-covers.cssother9.6 KB
project/src/components/themes/theme05/source/styles/pulse-deck.cssother288.9 KB
project/src/components/themes/theme06/metadata.jsscript331.7 KB
project/src/components/themes/theme07/metadata.jsscript319.6 KB
project/src/components/themes/theme07/source/src/theme.jsscript2.9 KB
project/src/components/themes/theme08/metadata.jsscript366.7 KB
project/src/components/themes/theme08/source/image-slot.jsscript45 B
project/src/components/themes/theme09/metadata.jsscript378.4 KB
project/src/components/themes/theme10/metadata.jsscript294.2 KB
project/src/components/themes/theme11/metadata.jsscript399.9 KB
project/src/components/themes/theme12/metadata.jsscript311.7 KB
project/src/components/themes/theme12/source/src/index.jsscript23.1 KB
project/src/components/themes/theme12/source/src/swTheme.jsscript2.3 KB
project/src/components/themes/unicorn-background.jsxother2.0 KB
project/src/control-naming.mjsscript17.2 KB
project/src/deckComposer.jsxother18.8 KB
project/src/generated-metadata-writer.mjsscript722 B
project/src/i18n-core.mjsscript2.3 KB
project/src/i18n.mjsscript1.8 KB
project/src/metadata-serialize.mjsscript6.1 KB
project/src/options.jsxother1.5 KB
project/src/prop-contract-core.mjsscript70.1 KB
project/src/propContracts.jsxother658 B
project/src/react-shim.jsscript51 B
project/src/renderDeck.jsxother14.0 KB
project/src/runtime-assets.mjsscript1.7 KB
project/src/types.d.tsscript1.7 KB
project/src/variant-contract.mjsscript28.8 KB
project/src/variant-materializer.mjsscript9.0 KB
project/src/view-model/context.jsxother382 B
project/src/view-model/index.jsxother26.0 KB
project/src/view-model/schema-v2-canonical.mjsscript471 B
references/examples/annual-review.jsonconfig14.9 KB
references/examples/portfolio.jsonconfig13.1 KB
references/goal-spec.schema.jsonconfig9.9 KB
references/layout-roles.mdmarkdown1.7 KB
references/options.mdmarkdown7.5 KB
scripts/check_latest_version.mjsexecutablescript3.1 KB
scripts/render_goal_deck.ps1script4.5 KB
scripts/render_goal_deck.shexecutablescript2.3 KB

project/src/deckComposer.jsx

View on GitHub
// @ts-check
import { DEFAULT_THEME_PACK, THEME_PACK_OPTIONS, slide } from './options.jsx';
import { THEME_PAGES } from './components/themes/index.jsx';
import { isMediaArrayKey } from './prop-contract-core.mjs';
import {
  BESPOKE_SCHEMA_VERSION,
  TEMPLATE_VARIANT_COUNT,
  TOTAL_VARIANT_COUNT,
  isBespokeVariant,
  isTemplateVariant,
} from './variant-contract.mjs';

export const ROLE_KEYWORDS = {
  cover: ['cover', '封面', '首页'],
  statement: ['statement', 'summary', 'overview', 'manifesto', 'quote', '摘要', '主张', '观点', '结论'],
  breakdown: ['contents', 'agenda', 'index', 'directory', '目录', '结构', '纲目'],
  transition: ['section', 'chapter', 'divider', '章节', '序章', '篇章'],
  context: ['market', 'method', 'context', 'industry', '全景', '背景', '方法', '行业'],
  metrics: ['metric', 'stat', 'number', 'score', 'gauge', 'meter', '指标', '数字', '大势', '仪表'],
  trend: ['trend', 'timeline', 'curve', 'area', 'slope', 'stream', '走势', '趋势', '时间', '曲线', '季度'],
  comparison: ['compare', 'versus', 'matrix', 'quadrant', 'delta', 'dumbbell', '对比', '矩阵', '象限', '差距'],
  distribution: ['donut', 'treemap', 'heatmap', 'ranking', 'rank', 'waterfall', 'funnel', 'allocation', 'share', '分布', '占比', '排行', '瀑布', '漏斗'],
  relationship: ['chain', 'flow', 'sankey', 'network', 'orbit', 'ecosystem', 'map', '关系', '链', '流向', '生态', '网络'],
  case: ['case', 'spotlight', 'profile', 'story', '案例', '聚焦', '档案'],
  image: ['image', 'gallery', 'mosaic', 'photo', 'film', 'album', 'poster', 'showcase', '影像', '图景', '图集', '图片', '海报'],
  process: ['process', 'roadmap', 'journey', 'steps', 'gantt', '路径', '流程', '路线', '进程'],
  risks: ['risk', 'faq', 'checklist', '风险', '异议', '问答', '清单'],
  observation: ['quote', 'insight', 'takeaway', 'conclusion', 'statement', 'manifesto', '观点', '洞察', '要点', '结论'],
  actions: ['action', 'roadmap', 'plan', 'join', 'contact', 'next', '行动', '策略', '计划', '套餐'],
  result: ['result', 'outcome', 'score', 'closing', 'conclusion', '成果', '结果', '完成', '结论'],
  team: ['team', 'roster', 'testimonial', 'voice', '团队', '人物', '见证', '证言'],
  closing: ['closing', 'contact', 'join', 'end', 'colophon', '结语', '封底', '行动'],
};

export const ROLE_ALIASES = {
  agenda: 'breakdown',
  summary: 'statement',
  insight: 'observation',
  quote: 'observation',
  chart: 'metrics',
  data: 'metrics',
  timeline: 'trend',
  compare: 'comparison',
  flow: 'process',
  roadmap: 'actions',
  visual: 'image',
  gallery: 'image',
  media: 'image',
  picture: 'image',
  photo: 'image',
};

const DEFAULT_ROLE_SEQUENCE = [
  'cover',
  'statement',
  'breakdown',
  'context',
  'metrics',
  'comparison',
  'distribution',
  'relationship',
  'case',
  'image',
  'trend',
  'process',
  'risks',
  'actions',
  'result',
  'closing',
];

export const THEME_ROLE_LAYOUT_POOLS = Object.fromEntries(
  Object.keys(THEME_PACK_OPTIONS).map(themeKey => [themeKey, buildRoleLayoutPools(themeKey)]),
);

export const ROLE_LAYOUT_POOLS = THEME_ROLE_LAYOUT_POOLS[DEFAULT_THEME_PACK] || {};

export const ROLE_LAYOUTS = Object.fromEntries(
  Object.entries(ROLE_LAYOUT_POOLS).map(([role, layouts]) => [role, layouts[0]]),
);

const THEME_PAGE_BY_KEY = new Map(THEME_PAGES.map(page => [page.key, page]));
const VARIANT_STATE_ID_SEPARATOR = '::';

export function composeDeck(spec = {}) {
  const expandedVariants = spec.schemaVersion === BESPOKE_SCHEMA_VERSION;
  if (spec.schemaVersion != null && !expandedVariants) {
    throw new Error(`Unsupported deck schemaVersion "${spec.schemaVersion}".`);
  }
  const goal = spec.goal || spec.title || '主题汇报';
  const title = spec.title || goal;
  const randomSeed = spec.randomSeed || `${title}:${goal}`;
  const themePack = normalizeThemePack(spec.themePack) || DEFAULT_THEME_PACK;
  const sourceSlides = spec.slides?.length
    ? spec.slides
    : defaultSlides({ title, goal, pageCount: getPageCount(spec) });
  const usedLayouts = new Set();
  const slides = sourceSlides.map((page, index) => composeSlide(page, {
    randomSeed,
    index,
    usedLayouts,
    rolePools: THEME_ROLE_LAYOUT_POOLS[themePack] || ROLE_LAYOUT_POOLS,
    expandedVariants,
  }));
  assertSlideIdentities(slides);
  return {
    ...(expandedVariants ? {
      schemaVersion: BESPOKE_SCHEMA_VERSION,
      variantPresentation: 'expanded',
      variantOutputMode: spec.variantOutputMode ?? 'comparison',
    } : {}),
    themePack,
    title,
    language: spec.language,
    text: spec.text || {},
    media: spec.media || {},
    props: spec.props || {},
    preview: spec.preview || {},
    slides,
  };
}

function composeSlide(page, context) {
  if (context.expandedVariants) {
    return composeExpandedVariantSlide(page, context);
  }
  if (typeof page === 'string') {
    context.usedLayouts.add(page);
    return slide(page, {});
  }
  if (Object.prototype.hasOwnProperty.call(page || {}, 'variants')) {
    const variants = Array.isArray(page.variants) ? page.variants : [];
    if (variants.length !== TEMPLATE_VARIANT_COUNT) {
      throw new Error('Slide variants must contain exactly 3 entries.');
    }
    const normalizedVariants = variants.map((variant, variantIndex) => {
      const layout = variant?.layout || chooseLayout(variant || {}, normalizeRole(variant?.role || page.role), context);
      context.usedLayouts.add(layout);
      return {
        ...slide(layout, variant?.props || {}),
        id: variant?.id || `variant-${variantIndex + 1}`,
        key: variant?.key || variant?.slideKey,
        label: variant?.label,
        media: variant?.media,
      };
    });
    return {
      id: page.id || page.key || page.slideKey || `slide-${context.index + 1}`,
      key: page.key || page.slideKey,
      label: page.label,
      logicalIndex: page.logicalIndex,
      selectedVariant: page.selectedVariant || normalizedVariants[0].id,
      variants: normalizedVariants,
    };
  }
  const role = normalizeRole(page.role);
  const layout = page.layout || chooseLayout(page, role, context);
  context.usedLayouts.add(layout);
  return {
    ...slide(layout, page.props || {}),
    id: page.id,
    key: page.key || page.slideKey,
    label: page.label,
    logicalIndex: page.logicalIndex,
    copy: page.copy,
  };
}

function composeExpandedVariantSlide(page, context) {
  if (!isPlainRecord(page) || !Array.isArray(page.variants) || page.variants.length !== TOTAL_VARIANT_COUNT) {
    throw new Error(`schemaVersion ${BESPOKE_SCHEMA_VERSION} slides must contain exactly ${TOTAL_VARIANT_COUNT} variants.`);
  }
  if (!isPlainRecord(page.content)) {
    throw new Error(`schemaVersion ${BESPOKE_SCHEMA_VERSION} slide ${context.index + 1} must define logical content as an object.`);
  }

  const normalizedVariants = page.variants.map((variant, variantIndex) => {
    if (!isPlainRecord(variant)) {
      throw new Error(`Slide ${context.index + 1} variant ${variantIndex + 1} must be an object.`);
    }
    if (Object.prototype.hasOwnProperty.call(variant, 'content')) {
      throw new Error(`Slide ${context.index + 1} variant ${variantIndex + 1} must reference logical slide content through contentMap.`);
    }
    if (variantIndex < TEMPLATE_VARIANT_COUNT) {
      return composeExpandedTemplateVariant(variant, variantIndex, context);
    }
    return composeBespokeVariant(variant, variantIndex, context);
  });

  return {
    id: page.id || page.key || page.slideKey || `slide-${context.index + 1}`,
    key: page.key || page.slideKey,
    label: page.label,
    logicalIndex: page.logicalIndex,
    content: page.content,
    selectedVariant: page.selectedVariant || normalizedVariants[0].id,
    variants: normalizedVariants,
  };
}

function composeExpandedTemplateVariant(variant, variantIndex, context) {
  if (
    variant.kind !== 'template'
    || !isTemplateVariant(variant)
    || typeof variant.layout !== 'string'
    || !variant.layout.trim()
  ) {
    throw new Error(`schemaVersion ${BESPOKE_SCHEMA_VERSION} slide ${context.index + 1} variant ${variantIndex + 1} must be an explicit template variant with a layout.`);
  }
  if (variant.props === undefined
    ? !isPlainRecord(variant.projection?.structure)
    : !isPlainRecord(variant.props)) {
    throw new Error(`Slide ${context.index + 1} template variant ${variantIndex + 1} requires object props or projection.structure.`);
  }
  if (!isPlainRecord(variant.contentMap)) {
    throw new Error(`Slide ${context.index + 1} template variant ${variantIndex + 1} contentMap must be an object.`);
  }

  context.usedLayouts.add(variant.layout);
  return {
    ...slide(variant.layout, variant.props || {}),
    id: variant.id || `variant-${variantIndex + 1}`,
    kind: 'template',
    key: variant.key || variant.slideKey,
    label: variant.label,
    media: variant.media,
    contentMap: variant.contentMap,
    projection: variant.projection,
  };
}

function composeBespokeVariant(variant, variantIndex, context) {
  if (variant.kind !== 'bespoke' || !isBespokeVariant(variant)) {
    throw new Error(`schemaVersion ${BESPOKE_SCHEMA_VERSION} slide ${context.index + 1} variant ${variantIndex + 1} must be a bespoke variant.`);
  }
  for (const forbidden of ['layout', 'props', 'controls']) {
    if (Object.prototype.hasOwnProperty.call(variant, forbidden)) {
      throw new Error(`Slide ${context.index + 1} bespoke variant must not define ${forbidden}.`);
    }
  }
  if (variant.adjustable !== false) {
    throw new Error(`Slide ${context.index + 1} bespoke variant must set adjustable to false.`);
  }
  if (!isPlainRecord(variant.composition)) {
    throw new Error(`Slide ${context.index + 1} bespoke variant composition must be an object.`);
  }
  if (!isPlainRecord(variant.contentMap)) {
    throw new Error(`Slide ${context.index + 1} bespoke variant contentMap must be an object.`);
  }

  return {
    id: variant.id || `variant-${variantIndex + 1}`,
    kind: 'bespoke',
    key: variant.key || variant.slideKey,
    label: variant.label,
    media: variant.media,
    adjustable: false,
    composition: variant.composition,
    contentMap: variant.contentMap,
    projection: variant.projection,
  };
}

function isPlainRecord(value) {
  return value != null && typeof value === 'object' && !Array.isArray(value);
}

function assertSlideIdentities(slides) {
  const logicalIdUsages = new Map();
  slides.forEach((page, slideIndex) => {
    const logicalId = resolveLogicalSlideId(page, slideIndex);
    if (logicalId.includes(VARIANT_STATE_ID_SEPARATOR)) {
      throw new Error(`Slide ${slideIndex + 1} logical slide id "${logicalId}" contains reserved delimiter "${VARIANT_STATE_ID_SEPARATOR}" used by stateId.`);
    }
    const positions = logicalIdUsages.get(logicalId) || [];
    positions.push(slideIndex + 1);
    logicalIdUsages.set(logicalId, positions);

    if (!Array.isArray(page?.variants)) return;
    const variantIdUsages = new Map();
    page.variants.forEach((variant, variantIndex) => {
      const variantId = String(variant?.id || `variant-${variantIndex + 1}`);
      if (variantId.includes(VARIANT_STATE_ID_SEPARATOR)) {
        throw new Error(`Slide ${slideIndex + 1} variant ${variantIndex + 1} variant id "${variantId}" contains reserved delimiter "${VARIANT_STATE_ID_SEPARATOR}" used by stateId.`);
      }
      const variantPositions = variantIdUsages.get(variantId) || [];
      variantPositions.push(variantIndex + 1);
      variantIdUsages.set(variantId, variantPositions);
    });
    for (const [variantId, variantPositions] of variantIdUsages.entries()) {
      if (variantPositions.length <= 1) continue;
      throw new Error(`Slide ${slideIndex + 1} has duplicate variant id "${variantId}" on variants ${variantPositions.join(', ')}.`);
    }
  });
  for (const [logicalId, positions] of logicalIdUsages.entries()) {
    if (positions.length <= 1) continue;
    throw new Error(`Deck has duplicate logical slide id "${logicalId}" on slides ${positions.join(', ')}.`);
  }
}

function resolveLogicalSlideId(slideModel, index) {
  if (slideModel?.id != null && slideModel.id !== '') return String(slideModel.id);
  const layout = slideModel?.layout || 'slide';
  return `${layout}-${index + 1}`;
}

function chooseLayout(page, role, { randomSeed, index, usedLayouts, rolePools }) {
  const layouts = normalizeLayoutPool(page.layouts || page.layoutPool || page.candidates || rolePools[role]);
  if (!layouts.length) {
    throw new Error(`Unknown slide role "${page.role}". Use layout directly or choose one of: ${Object.keys(rolePools).join(', ')}`);
  }
  const requestedMediaCount = getRequestedMediaCount(page);
  const mediaReadyLayouts = requestedMediaCount
    ? layouts.filter(layout => layoutHasMediaSlot(layout, requestedMediaCount))
    : layouts;
  if (requestedMediaCount && !mediaReadyLayouts.length) {
    throw new Error(`Slide role "${page.role || role}" requires ${requestedMediaCount} media slot(s), but no candidate layout has a usable media slot.`);
  }
  const sourceLayouts = mediaReadyLayouts.length ? mediaReadyLayouts : layouts;
  const available = sourceLayouts.filter(layout => !usedLayouts.has(layout));
  const pool = available.length ? available : sourceLayouts;
  return pool[hashSeed(`${randomSeed}:${role}:${index}`) % pool.length];
}

function normalizeLayoutPool(layouts) {
  if (!layouts) return [];
  return (Array.isArray(layouts) ? layouts : [layouts]).filter(Boolean);
}

function normalizeRole(role) {
  if (!role) return null;
  return ROLE_ALIASES[role] || role;
}

function normalizeThemePack(themePack) {
  return THEME_PACK_OPTIONS[themePack] ? themePack : null;
}

function buildRoleLayoutPools(themeKey) {
  const pages = THEME_PAGES.filter(page => page.themeKey === themeKey);
  const allLayouts = pages.map(page => page.key);
  return Object.fromEntries(Object.entries(ROLE_KEYWORDS).map(([role, keywords]) => {
    const matched = pages
      .filter(page => {
        if (role === 'cover') return page.pageNumber >= 1 && page.pageNumber <= 5;
        if (role === 'image') return pageHasMediaSlot(page);
        return pageMatches(page, keywords);
      })
      .map(page => page.key);
    return [role, matched.length ? matched : fallbackRoleLayouts(role, allLayouts)];
  }));
}

function pageMatches(page, keywords) {
  const text = `${page.slot || ''} ${page.label || ''}`.toLowerCase();
  return keywords.some(keyword => text.includes(keyword.toLowerCase()));
}

function fallbackRoleLayouts(role, layouts) {
  if (!layouts.length) return [];
  if (role === 'cover') return layouts.slice(0, 5);
  if (role === 'closing') return [layouts[layouts.length - 1]];
  return layouts;
}

function getRequestedMediaCount(page = {}) {
  const explicit = countMediaItems(page.mediaCount);
  if (explicit) return explicit;
  const provided = countMediaItems(page.providedImages);
  if (provided) return provided;
  const providedMedia = countMediaItems(page.providedMedia);
  if (providedMedia) return providedMedia;
  const planned = countMediaItems(page.plannedImages);
  if (planned) return planned;
  if (page.needsVisual === true || page.needsImageGen === true || page.imageGen === true) return 1;
  return 0;
}

function countMediaItems(value) {
  if (Array.isArray(value)) return value.length;
  if (value === true) return 1;
  const number = Number(value);
  if (Number.isFinite(number) && number > 0) return Math.round(number);
  return 0;
}

export function layoutHasMediaSlot(layout, count = 1) {
  const page = THEME_PAGE_BY_KEY.get(layout);
  return page ? pageHasMediaSlot(page, count) : false;
}

function pageHasMediaSlot(page, count = 1) {
  return getMediaSlotCapacities(page).some(capacity => capacity >= Math.max(1, Number(count) || 1));
}

/** @param {import('./types').PageRecord} page */
function getMediaSlotCapacities(page) {
  const props = page.defaultProps || {};
  const controls = page.controls || [];
  const capacities = Object.keys(props)
    .filter(key => Array.isArray(props[key]) && isMediaArrayKey(key))
    .map(key => mediaArrayCapacity(key, props, controls));

  for (const control of controls) {
    if (!isMediaControl(control)) continue;
    const key = control.prop || control.key;
    if (!key || capacities.length) continue;
    capacities.push(mediaControlCapacity(key, props, controls));
  }

  return capacities;
}

function mediaArrayCapacity(key, props, controls) {
  const countControl = mediaCountControlForArrayField(key, controls);
  const max = Number(countControl?.max);
  if (Number.isFinite(max) && max > 0) return max;
  return props[key].length || 1;
}

function mediaControlCapacity(key, props, controls) {
  const countControl = mediaCountControlForArrayField(key, controls);
  const max = Number(countControl?.max);
  if (Number.isFinite(max) && max > 0) return max;
  const value = props[key];
  return Array.isArray(value) ? Math.max(1, value.length) : 1;
}

function mediaCountControlForArrayField(key, controls = []) {
  const countControls = controls.filter(control => {
    const prop = control.prop || control.key;
    return prop && prop.endsWith('Count') && prop.toLowerCase().includes(key.replace(/s$/i, '').toLowerCase());
  });
  if (countControls.length) return countControls[0];
  const visualSlotControls = controls.filter(isVisualSlotCountControl);
  return visualSlotControls.length === 1 ? visualSlotControls[0] : null;
}

function isVisualSlotCountControl(control) {
  const type = String(control.type || '').toLowerCase();
  const key = String(control.prop || control.key || '');
  const text = `${key} ${control.label || ''} ${control.desc || control.description || ''}`;
  return /(count|数量)$/i.test(key)
    && ['number', 'range', 'slider'].includes(type)
    && /(frame|image|media|photo|picture|slot|gallery|画框|画格|图片|图像|媒体|照片|相册)/i.test(text);
}

function isMediaControl(control) {
  const type = String(control.type || '').toLowerCase();
  const key = String(control.prop || control.key || '').toLowerCase();
  const label = String(control.label || '').toLowerCase();
  if (['images', 'image', 'media', 'picture'].includes(type)) return true;
  if (isMediaArrayKey(key)) return true;
  return /图片|图像|视频|媒体/.test(label) && !/^show/.test(key);
}


function getPageCount(spec) {
  const value = Number(spec.pageCount ?? spec.pages ?? spec.slideCount);
  if (!Number.isFinite(value)) return 8;
  return Math.max(3, Math.min(30, Math.round(value)));
}

function defaultSlides({ title, goal, pageCount }) {
  const count = Math.max(3, pageCount);
  const middleCount = count - 2;
  const middle = DEFAULT_ROLE_SEQUENCE.slice(1, -1);
  const roles = ['cover'];
  for (let i = 0; i < middleCount; i += 1) roles.push(middle[i % middle.length]);
  roles.push('closing');
  return roles.map((role, index) => ({
    role,
    props: index === 0
      ? { titleLines: [title, goal].filter(Boolean).slice(0, 2) }
      : {},
  }));
}

function hashSeed(value) {
  let hash = 2166136261;
  for (let i = 0; i < value.length; i += 1) {
    hash ^= value.charCodeAt(i);
    hash = Math.imul(hash, 16777619);
  }
  return hash >>> 0;
}
canvas-designanthropics/skillsCreate beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
docxanthropics/skillsUse this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
pdfanthropics/skillsUse this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
pptxanthropics/skillsUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the user mentions "deck," "slides," "presentation," or references a .pptx or .potx filename, regardless of what they plan to do with the content afterward. If a .pptx or .potx file needs to be opened, created, or touched, use this skill.Stars: 198kUpdated Claude CodeCodexVerifiedInstall