ppt-dsl-renderer 1.1.0

package/src/index.d.ts

@@ -0,0 +1,24 @@
+import type { PptDslDocument } from './types/ppt-dsl.js'
+
+export type * from './types/ppt-dsl.js'
+
+export interface RenderOptions {
+  /** 从 1 开始；省略时生成全部页。重复页码合并，始终按文档顺序返回。 */
+  pages?: number[]
+}
+
+export interface RenderedPage {
+  pageNumber: number
+  slideId: string
+  width: number
+  height: number
+  html: string
+}
+
+export interface RenderStatus {
+  status: 'loading' | 'ready' | 'error'
+  errors: string[]
+}
+
+/** 生成 HTML 字符串，不启动浏览器、不写文件、不修改输入。 */
+export function renderToHtml(document: PptDslDocument, options?: RenderOptions): Promise<RenderedPage[]>

package/src/pptx.d.ts

@@ -0,0 +1,30 @@
+import type { PptDslDocument } from './types/ppt-dsl.js'
+
+export interface PptxExportOptions {
+  /** 从 1 开始；省略导出全部页，重复页码合并并按文档顺序导出。 */
+  pages?: number[]
+}
+
+export interface PptxExportState {
+  /** generated 仅表示二进制已生成，不表示已上传或保存。 */
+  status: 'idle' | 'exporting' | 'writing' | 'generated' | 'error'
+  completedPages: number
+  totalPages: number
+  fileName: string
+  errors: string[]
+}
+
+/** 浏览器侧状态；同一页面同时只允许一次导出。 */
+export const pptxExportState: PptxExportState
+
+/** 返回完整 PPTX ArrayBuffer，不触发下载或上传；包含音视频并应用默认母版。仅限浏览器。 */
+export function exportToPptx(document: PptDslDocument, options?: PptxExportOptions): Promise<ArrayBuffer>
+
+declare global {
+  interface Window {
+    /** 加载 dist/pptx/exporter.js 后可用；仅导入模块不会安装全局方法。 */
+    exportToPptx?: typeof exportToPptx
+    /** 运行脚本加载后即可读取初始状态。 */
+    __PPT_DSL_EXPORT__?: PptxExportState
+  }
+}

package/src/types/ppt-dsl.d.ts

@@ -0,0 +1,241 @@
+export type PptDslElementType = 'text' | 'image' | 'shape' | 'line' | 'chart' | 'table' | 'latex' | 'video' | 'audio'
+
+export interface PptDslOutline {
+  color?: string
+  style?: 'solid' | 'dashed' | 'dotted'
+  width?: number
+}
+
+export interface PptDslShadow {
+  blur: number
+  color: string
+  h: number
+  v: number
+}
+
+export interface PptDslGradient {
+  colors: Array<{ color: string; pos: number }>
+  rotate?: number
+  type: 'linear' | 'radial'
+}
+
+export interface PptDslBaseElement {
+  class?: string
+  groupId?: string
+  height?: number
+  id: string
+  left: number
+  link?: { target: string; type: 'slide' | 'web' }
+  lock?: boolean
+  name?: string
+  opacity?: number
+  rotate?: number
+  top: number
+  type: PptDslElementType
+  width?: number
+}
+
+export interface PptDslTextElement extends PptDslBaseElement {
+  content: string
+  defaultColor?: string
+  defaultFontName?: string
+  fill?: string
+  fixedHeight?: boolean
+  /** 内边距，按上、右、下、左排列，单位为 CSS 像素。 */
+  inset?: [number, number, number, number]
+  lineHeight?: number
+  outline?: PptDslOutline
+  paragraphSpace?: number
+  shadow?: PptDslShadow
+  type: 'text'
+  /** 文本用途标记；PPTX 导出保持原始文本框尺寸。 */
+  textType?: 'title' | 'subtitle' | 'content' | 'item' | 'itemTitle' | 'notes' | 'header' | 'footer' | 'partNumber' | 'itemNumber'
+  vAlign?: 'bottom' | 'middle' | 'top'
+  vertical?: boolean
+  wordSpace?: number
+}
+
+export interface PptDslImageElement extends PptDslBaseElement {
+  clip?: { range: [[number, number], [number, number]]; shape?: string }
+  colorMask?: string
+  filters?: Record<string, string>
+  fixedRatio?: boolean
+  fit?: 'contain' | 'cover' | 'fill'
+  flipH?: boolean
+  flipV?: boolean
+  outline?: PptDslOutline
+  radius?: number
+  shadow?: PptDslShadow
+  src: string
+  type: 'image'
+}
+
+export interface PptDslShapeText {
+  align?: 'bottom' | 'middle' | 'top'
+  content: string
+  defaultColor?: string
+  defaultFontName?: string
+  /** 内边距，按上、右、下、左排列，单位为 CSS 像素。 */
+  inset?: [number, number, number, number]
+  lineHeight?: number
+  paragraphSpace?: number
+  wordSpace?: number
+}
+
+export interface PptDslShapeElement extends PptDslBaseElement {
+  fill?: string
+  fixedRatio?: boolean
+  flipH?: boolean
+  flipV?: boolean
+  gradient?: PptDslGradient
+  keypoints?: number[]
+  outline?: PptDslOutline
+  path: string
+  /** PPTX 导出支持图片填充；只读预览暂不使用。 */
+  pattern?: string
+  pathFormula?: string
+  shadow?: PptDslShadow
+  special?: boolean
+  text?: PptDslShapeText
+  type: 'shape'
+  viewBox: [number, number]
+}
+
+export interface PptDslLineElement extends PptDslBaseElement {
+  /** 以下控制点用于 PPTX 导出，坐标相对线条 left/top。 */
+  broken?: [number, number]
+  broken2?: [number, number]
+  broken2Direction?: 'horizontal' | 'vertical'
+  curve?: [number, number]
+  cubic?: [[number, number], [number, number]]
+  color: string
+  end: [number, number]
+  points?: ['', ''] | ['arrow' | 'dot' | '', 'arrow' | 'dot' | '']
+  start: [number, number]
+  shadow?: PptDslShadow
+  style?: 'solid' | 'dashed' | 'dotted'
+  type: 'line'
+}
+
+export type PptDslChartType = 'area' | 'bar' | 'column' | 'line' | 'pie' | 'radar' | 'ring' | 'scatter'
+
+export interface PptDslChartElement extends PptDslBaseElement {
+  chartType: PptDslChartType
+  data: {
+    labels: string[]
+    legends: string[]
+    series: number[][]
+  }
+  fill?: string
+  lineColor?: string
+  options?: { lineSmooth?: boolean; stack?: boolean }
+  outline?: PptDslOutline
+  textColor?: string
+  themeColors?: string[]
+  type: 'chart'
+}
+
+export interface PptDslTableCell {
+  colspan?: number
+  id: string
+  rowspan?: number
+  style?: {
+    align?: 'center' | 'justify' | 'left' | 'right'
+    backcolor?: string
+    bold?: boolean
+    color?: string
+    em?: boolean
+    fontname?: string
+    fontsize?: string
+    underline?: boolean
+    vAlign?: 'bottom' | 'middle' | 'top'
+  }
+  text: string
+}
+
+export interface PptDslTableElement extends PptDslBaseElement {
+  cellMinHeight?: number
+  colWidths?: number[]
+  data: PptDslTableCell[][]
+  fill?: string
+  outline?: PptDslOutline
+  /** PPTX 导出使用的表格主题，单元格显式背景优先。 */
+  theme?: {
+    color: string
+    rowHeader: boolean
+    rowFooter: boolean
+    colHeader: boolean
+    colFooter: boolean
+  }
+  type: 'table'
+}
+
+export interface PptDslLatexElement extends PptDslBaseElement {
+  color?: string
+  fixedRatio?: boolean
+  latex: string
+  path?: string
+  strokeWidth?: number
+  type: 'latex'
+  viewBox?: [number, number]
+}
+
+export interface PptDslVideoElement extends PptDslBaseElement {
+  autoplay?: boolean
+  ext?: string
+  poster?: string
+  src: string
+  type: 'video'
+}
+
+export interface PptDslAudioElement extends PptDslBaseElement {
+  autoplay?: boolean
+  color?: string
+  ext?: string
+  fixedRatio?: boolean
+  loop?: boolean
+  src: string
+  type: 'audio'
+}
+
+export type PptDslElement = PptDslTextElement | PptDslImageElement | PptDslShapeElement | PptDslLineElement | PptDslChartElement | PptDslTableElement | PptDslLatexElement | PptDslVideoElement | PptDslAudioElement
+
+export interface PptDslBackground {
+  color?: string
+  gradient?: PptDslGradient
+  image?: { size?: 'contain' | 'cover' | 'stretch'; src: string }
+  type: 'gradient' | 'image' | 'solid'
+}
+
+export interface PptDslSlide {
+  background?: PptDslBackground
+  elements: PptDslElement[]
+  id: string
+  remark?: string
+  type?: 'content' | 'contents' | 'cover' | 'end' | 'transition'
+}
+
+export interface PptDslTheme {
+  backgroundColor?: string
+  fontColor?: string
+  fontName?: string
+  outline?: PptDslOutline
+  shadow?: PptDslShadow
+  themeColors?: string[]
+}
+
+export interface PptDslDocument {
+  height: number
+  slides: PptDslSlide[]
+  theme?: PptDslTheme
+  title: string
+  width: number
+}
+
+export interface PptDslElementFrame {
+  height: number
+  left: number
+  rotate: number
+  top: number
+  width: number
+}

package/src/types/vue.d.ts

@@ -0,0 +1,40 @@
+import type { VNode } from 'vue'
+import type { PptDslElement, PptDslShapeElement, PptDslSlide, PptDslTableCell, PptDslTableElement, PptDslTextElement } from './ppt-dsl.js'
+
+export interface SlideRendererProps {
+  slide: PptDslSlide
+  width: number
+  height: number
+  /** 仅缩放展示，不改变 DSL 坐标或布局占位；默认 1。 */
+  scale?: number
+}
+
+export interface ElementRendererProps {
+  element: PptDslElement
+  /** 从 0 开始的 DSL 数组下标，用于确定图层顺序。 */
+  elementIndex: number
+}
+
+export interface TextEditorSlotProps {
+  element: PptDslTextElement
+  content: string
+}
+
+export interface ShapeTextEditorSlotProps {
+  element: PptDslShapeElement
+  content: string
+}
+
+export interface TableCellEditorSlotProps {
+  element: PptDslTableElement
+  cell: PptDslTableCell
+  rowIndex: number
+  colIndex: number
+}
+
+/** 仅替换内容，容器、形状、表格结构和样式仍由渲染器维护。 */
+export interface ElementRendererSlots {
+  'text-editor'?: (props: TextEditorSlotProps) => VNode[]
+  'shape-text-editor'?: (props: ShapeTextEditorSlotProps) => VNode[]
+  'table-cell-editor'?: (props: TableCellEditorSlotProps) => VNode[]
+}

package/src/vue.d.ts

@@ -0,0 +1,16 @@
+import type { CSSProperties, DefineComponent, DefineSetupFnComponent, HTMLAttributes, SlotsType } from 'vue'
+import type { PptDslElement, PptDslElementFrame, PptDslLineElement, PptDslSlide } from './types/ppt-dsl.js'
+import type { ElementRendererProps, ElementRendererSlots, SlideRendererProps } from './types/vue.js'
+
+export type * from './types/ppt-dsl.js'
+export type * from './types/vue.js'
+
+/** 只读整页组件；class、style、id 和原生事件透传至根节点。 */
+export const SlideRenderer: DefineComponent<SlideRendererProps & HTMLAttributes>
+
+/** 单元素组件；编辑内容由插槽注入，数据更新及交互由宿主处理。 */
+export const ElementRenderer: DefineSetupFnComponent<ElementRendererProps & HTMLAttributes, {}, SlotsType<ElementRendererSlots>>
+
+export function getPptDslElementFrame(element: PptDslElement): PptDslElementFrame
+export function getPptDslLineFrame(element: PptDslLineElement): PptDslElementFrame
+export function getPptDslSlideStyle(slide: PptDslSlide, width: number, height: number, scale?: number): CSSProperties

package/third-party-licenses/core-util-is/LICENSE

@@ -0,0 +1,19 @@
+Copyright Node.js contributors. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to
+deal in the Software without restriction, including without limitation the
+rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
+sell copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+IN THE SOFTWARE.