pptx-ts 0.0.1

package/dist/diagnostics-Du_s75MT.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics-Du_s75MT.d.ts","names":[],"sources":["../src/types/zoom.ts","../src/types/internal.ts","../src/runtime/types.ts","../src/units.ts","../src/presentation.ts","../src/clip.ts","../src/diagnostics.ts"],"mappings":"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"}

package/dist/enums-CvRYniUA.d.ts

@@ -0,0 +1,463 @@
+//#region src/enums.d.ts
+/**
+ * ts-pptx Enums
+ * NOTE: `enum` wont work for objects, so use `Object.freeze`
+ */
+/**
+ * Output-type name accepted by the zip/write layer. Derived from the `OutputType`
+ * enum (see below) so the two never drift: adding a member to the enum extends this
+ * union automatically.
+ */
+type ZIP_OUTPUT_TYPE = `${OutputType}`;
+type WRITE_OUTPUT_TYPE = ZIP_OUTPUT_TYPE;
+/**
+ * Public chart-type name accepted by `addChart()`. Derived from the internal
+ * `ChartType` enum (see below) so the two never drift: adding a member to the
+ * enum extends this union automatically.
+ */
+type CHART_NAME = `${ChartType}`;
+/**
+ * Public scheme-color name. Derived from the `SchemeColor` enum (see below) so the
+ * two never drift.
+ */
+type SCHEME_COLORS = `${SchemeColor}`;
+declare enum TextAnchor {
+  b = "b",
+  ctr = "ctr",
+  t = "t"
+}
+declare enum OutputType {
+  arraybuffer = "arraybuffer",
+  base64 = "base64",
+  binarystring = "binarystring",
+  blob = "blob",
+  nodebuffer = "nodebuffer",
+  uint8array = "uint8array"
+}
+declare enum ChartType {
+  area = "area",
+  bar = "bar",
+  bar3d = "bar3D",
+  bubble = "bubble",
+  bubble3d = "bubble3D",
+  doughnut = "doughnut",
+  line = "line",
+  pie = "pie",
+  radar = "radar",
+  scatter = "scatter",
+  stock = "stock",
+  surface = "surface",
+  waterfall = "waterfall",
+  funnel = "funnel",
+  treemap = "treemap",
+  sunburst = "sunburst",
+  histogram = "histogram",
+  pareto = "pareto",
+  boxWhisker = "boxWhisker",
+  regionMap = "regionMap"
+}
+declare enum ShapeType {
+  accentBorderCallout1 = "accentBorderCallout1",
+  accentBorderCallout2 = "accentBorderCallout2",
+  accentBorderCallout3 = "accentBorderCallout3",
+  accentCallout1 = "accentCallout1",
+  accentCallout2 = "accentCallout2",
+  accentCallout3 = "accentCallout3",
+  actionButtonBackPrevious = "actionButtonBackPrevious",
+  actionButtonBeginning = "actionButtonBeginning",
+  actionButtonBlank = "actionButtonBlank",
+  actionButtonDocument = "actionButtonDocument",
+  actionButtonEnd = "actionButtonEnd",
+  actionButtonForwardNext = "actionButtonForwardNext",
+  actionButtonHelp = "actionButtonHelp",
+  actionButtonHome = "actionButtonHome",
+  actionButtonInformation = "actionButtonInformation",
+  actionButtonMovie = "actionButtonMovie",
+  actionButtonReturn = "actionButtonReturn",
+  actionButtonSound = "actionButtonSound",
+  arc = "arc",
+  bentArrow = "bentArrow",
+  bentUpArrow = "bentUpArrow",
+  bevel = "bevel",
+  blockArc = "blockArc",
+  borderCallout1 = "borderCallout1",
+  borderCallout2 = "borderCallout2",
+  borderCallout3 = "borderCallout3",
+  bracePair = "bracePair",
+  bracketPair = "bracketPair",
+  callout1 = "callout1",
+  callout2 = "callout2",
+  callout3 = "callout3",
+  can = "can",
+  chartPlus = "chartPlus",
+  chartStar = "chartStar",
+  chartX = "chartX",
+  chevron = "chevron",
+  chord = "chord",
+  circularArrow = "circularArrow",
+  cloud = "cloud",
+  cloudCallout = "cloudCallout",
+  corner = "corner",
+  cornerTabs = "cornerTabs",
+  cube = "cube",
+  curvedDownArrow = "curvedDownArrow",
+  curvedLeftArrow = "curvedLeftArrow",
+  curvedRightArrow = "curvedRightArrow",
+  curvedUpArrow = "curvedUpArrow",
+  custGeom = "custGeom",
+  decagon = "decagon",
+  diagStripe = "diagStripe",
+  diamond = "diamond",
+  dodecagon = "dodecagon",
+  donut = "donut",
+  doubleWave = "doubleWave",
+  downArrow = "downArrow",
+  downArrowCallout = "downArrowCallout",
+  ellipse = "ellipse",
+  ellipseRibbon = "ellipseRibbon",
+  ellipseRibbon2 = "ellipseRibbon2",
+  flowChartAlternateProcess = "flowChartAlternateProcess",
+  flowChartCollate = "flowChartCollate",
+  flowChartConnector = "flowChartConnector",
+  flowChartDecision = "flowChartDecision",
+  flowChartDelay = "flowChartDelay",
+  flowChartDisplay = "flowChartDisplay",
+  flowChartDocument = "flowChartDocument",
+  flowChartExtract = "flowChartExtract",
+  flowChartInputOutput = "flowChartInputOutput",
+  flowChartInternalStorage = "flowChartInternalStorage",
+  flowChartMagneticDisk = "flowChartMagneticDisk",
+  flowChartMagneticDrum = "flowChartMagneticDrum",
+  flowChartMagneticTape = "flowChartMagneticTape",
+  flowChartManualInput = "flowChartManualInput",
+  flowChartManualOperation = "flowChartManualOperation",
+  flowChartMerge = "flowChartMerge",
+  flowChartMultidocument = "flowChartMultidocument",
+  flowChartOfflineStorage = "flowChartOfflineStorage",
+  flowChartOffpageConnector = "flowChartOffpageConnector",
+  flowChartOnlineStorage = "flowChartOnlineStorage",
+  flowChartOr = "flowChartOr",
+  flowChartPredefinedProcess = "flowChartPredefinedProcess",
+  flowChartPreparation = "flowChartPreparation",
+  flowChartProcess = "flowChartProcess",
+  flowChartPunchedCard = "flowChartPunchedCard",
+  flowChartPunchedTape = "flowChartPunchedTape",
+  flowChartSort = "flowChartSort",
+  flowChartSummingJunction = "flowChartSummingJunction",
+  flowChartTerminator = "flowChartTerminator",
+  foldedCorner = "foldedCorner",
+  frame = "frame",
+  funnel = "funnel",
+  gear6 = "gear6",
+  gear9 = "gear9",
+  halfFrame = "halfFrame",
+  heart = "heart",
+  heptagon = "heptagon",
+  hexagon = "hexagon",
+  homePlate = "homePlate",
+  horizontalScroll = "horizontalScroll",
+  irregularSeal1 = "irregularSeal1",
+  irregularSeal2 = "irregularSeal2",
+  leftArrow = "leftArrow",
+  leftArrowCallout = "leftArrowCallout",
+  leftBrace = "leftBrace",
+  leftBracket = "leftBracket",
+  leftCircularArrow = "leftCircularArrow",
+  leftRightArrow = "leftRightArrow",
+  leftRightArrowCallout = "leftRightArrowCallout",
+  leftRightCircularArrow = "leftRightCircularArrow",
+  leftRightRibbon = "leftRightRibbon",
+  leftRightUpArrow = "leftRightUpArrow",
+  leftUpArrow = "leftUpArrow",
+  lightningBolt = "lightningBolt",
+  line = "line",
+  lineInv = "lineInv",
+  mathDivide = "mathDivide",
+  mathEqual = "mathEqual",
+  mathMinus = "mathMinus",
+  mathMultiply = "mathMultiply",
+  mathNotEqual = "mathNotEqual",
+  mathPlus = "mathPlus",
+  moon = "moon",
+  noSmoking = "noSmoking",
+  nonIsoscelesTrapezoid = "nonIsoscelesTrapezoid",
+  notchedRightArrow = "notchedRightArrow",
+  octagon = "octagon",
+  parallelogram = "parallelogram",
+  pentagon = "pentagon",
+  pie = "pie",
+  pieWedge = "pieWedge",
+  plaque = "plaque",
+  plaqueTabs = "plaqueTabs",
+  plus = "plus",
+  quadArrow = "quadArrow",
+  quadArrowCallout = "quadArrowCallout",
+  rect = "rect",
+  ribbon = "ribbon",
+  ribbon2 = "ribbon2",
+  rightArrow = "rightArrow",
+  rightArrowCallout = "rightArrowCallout",
+  rightBrace = "rightBrace",
+  rightBracket = "rightBracket",
+  round1Rect = "round1Rect",
+  round2DiagRect = "round2DiagRect",
+  round2SameRect = "round2SameRect",
+  roundRect = "roundRect",
+  rtTriangle = "rtTriangle",
+  smileyFace = "smileyFace",
+  snip1Rect = "snip1Rect",
+  snip2DiagRect = "snip2DiagRect",
+  snip2SameRect = "snip2SameRect",
+  snipRoundRect = "snipRoundRect",
+  squareTabs = "squareTabs",
+  star10 = "star10",
+  star12 = "star12",
+  star16 = "star16",
+  star24 = "star24",
+  star32 = "star32",
+  star4 = "star4",
+  star5 = "star5",
+  star6 = "star6",
+  star7 = "star7",
+  star8 = "star8",
+  stripedRightArrow = "stripedRightArrow",
+  sun = "sun",
+  swooshArrow = "swooshArrow",
+  teardrop = "teardrop",
+  trapezoid = "trapezoid",
+  triangle = "triangle",
+  upArrow = "upArrow",
+  upArrowCallout = "upArrowCallout",
+  upDownArrow = "upDownArrow",
+  upDownArrowCallout = "upDownArrowCallout",
+  uturnArrow = "uturnArrow",
+  verticalScroll = "verticalScroll",
+  wave = "wave",
+  wedgeEllipseCallout = "wedgeEllipseCallout",
+  wedgeRectCallout = "wedgeRectCallout",
+  wedgeRoundRectCallout = "wedgeRoundRectCallout"
+}
+declare enum SchemeColor {
+  text1 = "tx1",
+  text2 = "tx2",
+  background1 = "bg1",
+  background2 = "bg2",
+  accent1 = "accent1",
+  accent2 = "accent2",
+  accent3 = "accent3",
+  accent4 = "accent4",
+  accent5 = "accent5",
+  accent6 = "accent6"
+}
+declare enum AlignH {
+  left = "left",
+  center = "center",
+  right = "right",
+  justify = "justify"
+}
+declare enum AlignV {
+  top = "top",
+  middle = "middle",
+  bottom = "bottom"
+}
+type SHAPE_NAME = 'accentBorderCallout1' | 'accentBorderCallout2' | 'accentBorderCallout3' | 'accentCallout1' | 'accentCallout2' | 'accentCallout3' | 'actionButtonBackPrevious' | 'actionButtonBeginning' | 'actionButtonBlank' | 'actionButtonDocument' | 'actionButtonEnd' | 'actionButtonForwardNext' | 'actionButtonHelp' | 'actionButtonHome' | 'actionButtonInformation' | 'actionButtonMovie' | 'actionButtonReturn' | 'actionButtonSound' | 'arc' | 'bentArrow' | 'bentUpArrow' | 'bevel' | 'blockArc' | 'borderCallout1' | 'borderCallout2' | 'borderCallout3' | 'bracePair' | 'bracketPair' | 'callout1' | 'callout2' | 'callout3' | 'can' | 'chartPlus' | 'chartStar' | 'chartX' | 'chevron' | 'chord' | 'circularArrow' | 'cloud' | 'cloudCallout' | 'corner' | 'cornerTabs' | 'cube' | 'curvedDownArrow' | 'curvedLeftArrow' | 'curvedRightArrow' | 'curvedUpArrow' | 'custGeom' | 'decagon' | 'diagStripe' | 'diamond' | 'dodecagon' | 'donut' | 'doubleWave' | 'downArrow' | 'downArrowCallout' | 'ellipse' | 'ellipseRibbon' | 'ellipseRibbon2' | 'flowChartAlternateProcess' | 'flowChartCollate' | 'flowChartConnector' | 'flowChartDecision' | 'flowChartDelay' | 'flowChartDisplay' | 'flowChartDocument' | 'flowChartExtract' | 'flowChartInputOutput' | 'flowChartInternalStorage' | 'flowChartMagneticDisk' | 'flowChartMagneticDrum' | 'flowChartMagneticTape' | 'flowChartManualInput' | 'flowChartManualOperation' | 'flowChartMerge' | 'flowChartMultidocument' | 'flowChartOfflineStorage' | 'flowChartOffpageConnector' | 'flowChartOnlineStorage' | 'flowChartOr' | 'flowChartPredefinedProcess' | 'flowChartPreparation' | 'flowChartProcess' | 'flowChartPunchedCard' | 'flowChartPunchedTape' | 'flowChartSort' | 'flowChartSummingJunction' | 'flowChartTerminator' | 'foldedCorner' | 'frame' | 'funnel' | 'gear6' | 'gear9' | 'halfFrame' | 'heart' | 'heptagon' | 'hexagon' | 'homePlate' | 'horizontalScroll' | 'irregularSeal1' | 'irregularSeal2' | 'leftArrow' | 'leftArrowCallout' | 'leftBrace' | 'leftBracket' | 'leftCircularArrow' | 'leftRightArrow' | 'leftRightArrowCallout' | 'leftRightCircularArrow' | 'leftRightRibbon' | 'leftRightUpArrow' | 'leftUpArrow' | 'lightningBolt' | 'line' | 'lineInv' | 'mathDivide' | 'mathEqual' | 'mathMinus' | 'mathMultiply' | 'mathNotEqual' | 'mathPlus' | 'moon' | 'noSmoking' | 'nonIsoscelesTrapezoid' | 'notchedRightArrow' | 'octagon' | 'parallelogram' | 'pentagon' | 'pie' | 'pieWedge' | 'plaque' | 'plaqueTabs' | 'plus' | 'quadArrow' | 'quadArrowCallout' | 'rect' | 'ribbon' | 'ribbon2' | 'rightArrow' | 'rightArrowCallout' | 'rightBrace' | 'rightBracket' | 'round1Rect' | 'round2DiagRect' | 'round2SameRect' | 'roundRect' | 'rtTriangle' | 'smileyFace' | 'snip1Rect' | 'snip2DiagRect' | 'snip2SameRect' | 'snipRoundRect' | 'squareTabs' | 'star10' | 'star12' | 'star16' | 'star24' | 'star32' | 'star4' | 'star5' | 'star6' | 'star7' | 'star8' | 'stripedRightArrow' | 'sun' | 'swooshArrow' | 'teardrop' | 'trapezoid' | 'triangle' | 'upArrow' | 'upArrowCallout' | 'upDownArrow' | 'upDownArrowCallout' | 'uturnArrow' | 'verticalScroll' | 'wave' | 'wedgeEllipseCallout' | 'wedgeRectCallout' | 'wedgeRoundRectCallout' | CONNECTOR_PRESET_NAME;
+/**
+ * Valid ECMA-376 `ST_ShapeType` presets that are not surfaced with a friendly
+ * `ShapeType` name. They are still legal geometries PowerPoint renders, so the
+ * preset-validation set must accept them.
+ */
+declare const EXTRA_SHAPE_PRESETS: readonly ['straightConnector1', 'bentConnector2', 'bentConnector3', 'bentConnector4', 'bentConnector5', 'curvedConnector2', 'curvedConnector3', 'curvedConnector4', 'curvedConnector5'];
+/**
+ * Connector preset geometries (`straightConnector1` / `bentConnector{2-5}` /
+ * `curvedConnector{2-5}`) that `addShape` can serialize but that are not surfaced
+ * as friendly `ShapeType` names. Derived from `EXTRA_SHAPE_PRESETS` so the public
+ * `SHAPE_NAME` union and the runtime `VALID_SHAPE_PRESETS` set share one source of
+ * truth and cannot drift. Use `addConnector` for live, endpoint-bound connectors;
+ * pass these to `addShape` for a static box-positioned connector geometry.
+ */
+type CONNECTOR_PRESET_NAME = (typeof EXTRA_SHAPE_PRESETS)[number];
+/**
+ * Every shape geometry name ts-pptx can serialize without corrupting the
+ * package: the OOXML preset geometries (`ST_ShapeType` — `ShapeType` values
+ * plus the unexposed connectors above) and `custGeom` (freeform paths, emitted
+ * as `<a:custGeom>` rather than `<a:prstGeom>`). Used to reject bogus presets
+ * before they become an invalid `<a:prstGeom prst="...">` that triggers
+ * PowerPoint's "needs repair" dialog and drops the shape.
+ */
+declare const VALID_SHAPE_PRESETS: ReadonlySet<string>;
+/**
+ * Narrow a public `CHART_NAME` to the internal `ChartType` enum. Because
+ * `CHART_NAME` is derived from `ChartType`, every `CHART_NAME` value is by
+ * construction a valid enum value, so this conversion is total and safe — it is
+ * the single boundary cast that lets internal code compare against the enum
+ * (enum-to-enum) instead of enum-to-string.
+ */
+declare function asChartType(name: CHART_NAME): ChartType;
+/**
+ * Is `name` a chart type this library emits?
+ *
+ * `CHART_NAME` constrains TypeScript callers, but `addChart` is reachable from plain JavaScript
+ * where nothing enforces the union — and the two emitters partition the catalog between them by
+ * `switch`, so an off-catalog string has no arm in either and cannot produce a plot. Checked once
+ * at define time (`gen/define/chart.ts`) so the caller hears about it at the call that was wrong,
+ * rather than getting a chart-shaped hole in the deck.
+ */
+declare function isChartType(name: unknown): name is CHART_NAME;
+/**
+ * Is `type` a chartEx (cx:) chart? Accepts a `ChartType`/`CHART_NAME` string; anything else —
+ * including a combo-chart `ChartMulti[]` array or `undefined` — is not a chartEx type (combos are
+ * classic-only), so those return `false`.
+ */
+declare function isChartExType(type: unknown): boolean;
+declare enum SlideObjectType {
+  chart = "chart",
+  connector = "connector",
+  group = "group",
+  hyperlink = "hyperlink",
+  image = "image",
+  media = "media",
+  model3d = "model3d",
+  oleObject = "oleObject",
+  online = "online",
+  placeholder = "placeholder",
+  table = "table",
+  tablecell = "tablecell",
+  text = "text",
+  notes = "notes",
+  zoom = "zoom"
+}
+/**
+ * Maps a friendly `ConnectorType` to its OOXML connector preset *family*. `straight`
+ * has a single fixed preset; `elbow` and `curved` select a member by bend count
+ * (`bentConnector{3,4,5}` / `curvedConnector{3,4,5}`) — see `connectorPresetFor`.
+ */
+declare const CONNECTOR_PRESETS: {
+  readonly straight: 'straightConnector1';
+  readonly elbow: 'bentConnector';
+  readonly curved: 'curvedConnector';
+};
+/**
+ * Resolve the concrete connector preset geometry name for a `type` + bend count.
+ * `straight` ignores `bends` (it has no adjustable jog). For `elbow` / `curved`, the
+ * preset suffix is `bends + 2`, so `bends` of 1/2/3 maps to `…Connector3/4/5`, each
+ * of which exposes exactly `bends` adjustable guides (`adj1…adjN`).
+ * @param {'straight' | 'elbow' | 'curved'} type - friendly connector routing style
+ * @param {number} bends - number of adjustable bends (1–3); ignored for `straight`
+ * @return {CONNECTOR_PRESET_NAME} OOXML preset geometry name (e.g. `bentConnector4`)
+ */
+declare function connectorPresetFor(type: 'straight' | 'elbow' | 'curved', bends: number): CONNECTOR_PRESET_NAME;
+declare enum PlaceholderType {
+  title = "title",
+  body = "body",
+  image = "pic",
+  chart = "chart",
+  table = "tbl",
+  media = "media"
+}
+/**
+ * Placeholder-type name. Derived from the `PlaceholderType` enum (above) so the two
+ * never drift.
+ */
+type PLACEHOLDER_TYPE = `${PlaceholderType}`;
+/**
+ * Bullet glyph presets. Only `DEFAULT` is currently wired through to output; the remaining entries are
+ * reserved and not yet selectable via options.
+ */
+declare enum BulletType {
+  DEFAULT = "&#x2022;",
+  CHECK = "&#x2713;",
+  STAR = "&#x2605;",
+  TRIANGLE = "&#x25B6;"
+}
+/**
+ * Built-in PowerPoint table style IDs.
+ *
+ * Each value is the GUID that goes into `<a:tableStyleId>` inside `<a:tblPr>`.
+ * These 74 GUIDs are the complete set defined in [MS-OE376] §5.1.6.10 and are
+ * resolved by PowerPoint without embedding any style definition in the file.
+ *
+ * Only these enum members are supported. Raw GUID strings are not accepted;
+ * use `TableStyle` members exclusively.
+ */
+declare enum TableStyle {
+  NO_STYLE_NO_GRID = "{2D5ABB26-0587-4C30-8999-92F81FD0307C}",
+  NO_STYLE_TABLE_GRID = "{5940675A-B579-460E-94D1-54222C63F5DA}",
+  THEMED_STYLE_1_ACCENT_1 = "{3C2FFA5D-87B4-456A-9821-1D502468CF0F}",
+  THEMED_STYLE_1_ACCENT_2 = "{284E427A-3D55-4303-BF80-6455036E1DE7}",
+  THEMED_STYLE_1_ACCENT_3 = "{69C7853C-536D-4A76-A0AE-DD22124D55A5}",
+  THEMED_STYLE_1_ACCENT_4 = "{775DCB02-9BB8-47FD-8907-85C794F793BA}",
+  THEMED_STYLE_1_ACCENT_5 = "{35758FB7-9AC5-4552-8A53-C91805E547FA}",
+  THEMED_STYLE_1_ACCENT_6 = "{08FB837D-C827-4EFA-A057-4D05807E0F7C}",
+  THEMED_STYLE_2_ACCENT_1 = "{D113A9D2-9D6B-4929-AA2D-F23B5EE8CBE7}",
+  THEMED_STYLE_2_ACCENT_2 = "{18603FDC-E32A-4AB5-989C-0864C3EAD2B8}",
+  THEMED_STYLE_2_ACCENT_3 = "{306799F8-075E-4A3A-A7F6-7FBC6576F1A4}",
+  THEMED_STYLE_2_ACCENT_4 = "{E269D01E-BC32-4049-B463-5C60D7B0CCD2}",
+  THEMED_STYLE_2_ACCENT_5 = "{327F97BB-C833-4FB7-BDE5-3F7075034690}",
+  THEMED_STYLE_2_ACCENT_6 = "{638B1855-1B75-4FBE-930C-398BA8C253C6}",
+  LIGHT_STYLE_1 = "{9D7B26C5-4107-4FEC-AEDC-1716B250A1EF}",
+  LIGHT_STYLE_1_ACCENT_1 = "{3B4B98B0-60AC-42C2-AFA5-B58CD77FA1E5}",
+  LIGHT_STYLE_1_ACCENT_2 = "{0E3FDE45-AF77-4B5C-9715-49D594BDF05E}",
+  LIGHT_STYLE_1_ACCENT_3 = "{C083E6E3-FA7D-4D7B-A595-EF9225AFEA82}",
+  LIGHT_STYLE_1_ACCENT_4 = "{D27102A9-8310-4765-A935-A1911B00CA55}",
+  LIGHT_STYLE_1_ACCENT_5 = "{5FD0F851-EC5A-4D38-B0AD-8093EC10F338}",
+  LIGHT_STYLE_1_ACCENT_6 = "{68D230F3-CF80-4859-8CE7-A43EE81993B5}",
+  LIGHT_STYLE_2 = "{7E9639D4-E3E2-4D34-9284-5A2195B3D0D7}",
+  LIGHT_STYLE_2_ACCENT_1 = "{69012ECD-51FC-41F1-AA8D-1B2483CD663E}",
+  LIGHT_STYLE_2_ACCENT_2 = "{72833802-FEF1-4C79-8D5D-14CF1EAF98D9}",
+  LIGHT_STYLE_2_ACCENT_3 = "{F2DE63D5-997A-4646-A377-4702673A728D}",
+  LIGHT_STYLE_2_ACCENT_4 = "{17292A2E-F333-43FB-9621-5CBBE7FDCDCB}",
+  LIGHT_STYLE_2_ACCENT_5 = "{5A111915-BE36-4E01-A7E5-04B1672EAD32}",
+  LIGHT_STYLE_2_ACCENT_6 = "{912C8C85-51F0-491E-9774-3900AFEF0FD7}",
+  LIGHT_STYLE_3 = "{616DA210-FB5B-4158-B5E0-FEB733F419BA}",
+  LIGHT_STYLE_3_ACCENT_1 = "{BC89EF96-8CEA-46FF-86C4-4CE0E7609802}",
+  LIGHT_STYLE_3_ACCENT_2 = "{5DA37D80-6434-44D0-A028-1B22A696006F}",
+  LIGHT_STYLE_3_ACCENT_3 = "{8799B23B-EC83-4686-B30A-512413B5E67A}",
+  LIGHT_STYLE_3_ACCENT_4 = "{ED083AE6-46FA-4A59-8FB0-9F97EB10719F}",
+  LIGHT_STYLE_3_ACCENT_5 = "{BDBED569-4797-4DF1-A0F4-6AAB3CD982D8}",
+  LIGHT_STYLE_3_ACCENT_6 = "{E8B1032C-EA38-4F05-BA0D-38AFFFC7BED3}",
+  MEDIUM_STYLE_1 = "{793D81CF-94F2-401A-BA57-92F5A7B2D0C5}",
+  MEDIUM_STYLE_1_ACCENT_1 = "{B301B821-A1FF-4177-AEE7-76D212191A09}",
+  MEDIUM_STYLE_1_ACCENT_2 = "{9DCAF9ED-07DC-4A11-8D7F-57B35C25682E}",
+  MEDIUM_STYLE_1_ACCENT_3 = "{1FECB4D8-DB02-4DC6-A0A2-4F2EBAE1DC90}",
+  MEDIUM_STYLE_1_ACCENT_4 = "{1E171933-4619-4E11-9A3F-F7608DF75F80}",
+  MEDIUM_STYLE_1_ACCENT_5 = "{FABFCF23-3B69-468F-B69F-88F6DE6A72F2}",
+  MEDIUM_STYLE_1_ACCENT_6 = "{10A1B5D5-9B99-4C35-A422-299274C87663}",
+  MEDIUM_STYLE_2 = "{073A0DAA-6AF3-43AB-8588-CEC1D06C72B9}",
+  MEDIUM_STYLE_2_ACCENT_1 = "{5C22544A-7EE6-4342-B048-85BDC9FD1C3A}",
+  MEDIUM_STYLE_2_ACCENT_2 = "{21E4AEA4-8DFA-4A89-87EB-49C32662AFE0}",
+  MEDIUM_STYLE_2_ACCENT_3 = "{F5AB1C69-6EDB-4FF4-983F-18BD219EF322}",
+  MEDIUM_STYLE_2_ACCENT_4 = "{00A15C55-8517-42AA-B614-E9B94910E393}",
+  MEDIUM_STYLE_2_ACCENT_5 = "{7DF18680-E054-41AD-8BC1-D1AEF772440D}",
+  MEDIUM_STYLE_2_ACCENT_6 = "{93296810-A885-4BE3-A3E7-6D5BEEA58F35}",
+  MEDIUM_STYLE_3 = "{8EC20E35-A176-4012-BC5E-935CFFF8708E}",
+  MEDIUM_STYLE_3_ACCENT_1 = "{6E25E649-3F16-4E02-A733-19D2CDBF48F0}",
+  MEDIUM_STYLE_3_ACCENT_2 = "{85BE263C-DBD7-4A20-BB59-AAB30ACAA65A}",
+  MEDIUM_STYLE_3_ACCENT_3 = "{EB344D84-9AFB-497E-A393-DC336BA19D2E}",
+  MEDIUM_STYLE_3_ACCENT_4 = "{EB9631B5-78F2-41C9-869B-9F39066F8104}",
+  MEDIUM_STYLE_3_ACCENT_5 = "{74C1A8A3-306A-4EB7-A6B1-4F7E0EB9C5D6}",
+  MEDIUM_STYLE_3_ACCENT_6 = "{2A488322-F2BA-4B5B-9748-0D474271808F}",
+  MEDIUM_STYLE_4 = "{D7AC3CCA-C797-4891-BE02-D94E43425B78}",
+  MEDIUM_STYLE_4_ACCENT_1 = "{69CF1AB2-1976-4502-BF36-3FF5EA218861}",
+  MEDIUM_STYLE_4_ACCENT_2 = "{8A107856-5554-42FB-B03E-39F5DBC370BA}",
+  MEDIUM_STYLE_4_ACCENT_3 = "{0505E3EF-67EA-436B-97B2-0124C06EBD24}",
+  MEDIUM_STYLE_4_ACCENT_4 = "{C4B1156A-380E-4F78-BDF5-A606A8083BF9}",
+  MEDIUM_STYLE_4_ACCENT_5 = "{22838BEF-8BB2-4498-84A7-C5851F593DF1}",
+  MEDIUM_STYLE_4_ACCENT_6 = "{16D9F66E-5EB9-4882-86FB-DCBF35E3C3E4}",
+  DARK_STYLE_1 = "{E8034E78-7F5D-4C2E-B375-FC64B27BC917}",
+  DARK_STYLE_1_ACCENT_1 = "{125E5076-3810-47DD-B79F-674D7AD40C01}",
+  DARK_STYLE_1_ACCENT_2 = "{37CE84F3-28C3-443E-9E96-99CF82512B78}",
+  DARK_STYLE_1_ACCENT_3 = "{D03447BB-5D67-496B-8E87-E561075AD55C}",
+  DARK_STYLE_1_ACCENT_4 = "{E929F9F4-4A8F-4326-A1B4-22849713DDAB}",
+  DARK_STYLE_1_ACCENT_5 = "{8FD4443E-F989-4FC4-A0C8-D5A2AF1F390B}",
+  DARK_STYLE_1_ACCENT_6 = "{AF606853-7671-496A-8E4F-DF71F8EC918B}",
+  DARK_STYLE_2 = "{5202B0CA-FC54-4496-8BCA-5EF66A818D29}",
+  /** Header uses Accent 2, body rows use Accent 1 */
+  DARK_STYLE_2_ACCENT_1_ACCENT_2 = "{0660B408-B3CF-4A94-85FC-2B1E0A45F4A2}",
+  /** Header uses Accent 4, body rows use Accent 3 */
+  DARK_STYLE_2_ACCENT_3_ACCENT_4 = "{91EBBBCC-DAD2-459C-BE2E-F6DE35CF9A28}",
+  /** Header uses Accent 6, body rows use Accent 5 */
+  DARK_STYLE_2_ACCENT_5_ACCENT_6 = "{46F890A9-2807-4EBB-B81D-B2AA78EC7F39}"
+}
+//#endregion
+export { isChartExType as C, connectorPresetFor as S, TextAnchor as _, CONNECTOR_PRESETS as a, ZIP_OUTPUT_TYPE as b, OutputType as c, SCHEME_COLORS as d, SHAPE_NAME as f, TableStyle as g, SlideObjectType as h, CHART_NAME as i, PLACEHOLDER_TYPE as l, ShapeType as m, AlignV as n, CONNECTOR_PRESET_NAME as o, SchemeColor as p, BulletType as r, ChartType as s, AlignH as t, PlaceholderType as u, VALID_SHAPE_PRESETS as v, isChartType as w, asChartType as x, WRITE_OUTPUT_TYPE as y };
+//# sourceMappingURL=enums-CvRYniUA.d.ts.map

package/dist/enums-CvRYniUA.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums-CvRYniUA.d.ts","names":[],"sources":["../src/enums.ts"],"mappings":";;;;;;;;;;KAUY,qBAAqB;KACrB,oBAAoB;;;;;;KAMpB,gBAAgB;;;;;KAKhB,mBAAmB;aAEnB;EACX;EACA;EACA;;aAIW;EACX;EACA;EACA;EACA;EACA;EACA;;aAEW;EACX;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;aAEW;EACX;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;aAEW;EACX;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;aAEW;EACX;EACA;EACA;EACA;;aAEW;EACX;EACA;EACA;;KAGW,8iGAoLT;;;;;;cAOG;;;;;;;;;KAoBM,gCAAgC;;;;;;;;;cAU/B,qBAAqB;;;;;;;;iBAYlB,YAAY,MAAM,aAAa;;;;;;;;;;iBAgB/B,YAAY,gBAAgB,QAAQ;;;;;;iBA4BpC,cAAc;aAIlB;EACX;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;;;;;;cAQY;WACF;WACH;WACC;;;;;;;;;;;iBAYO,mBAAmB,uCAAuC,gBAAgB;aAI9E;EACX;EACA;EACA;EACA;EACA;EACA;;;;;;KAMW,sBAAsB;;;;;aAMtB;EACX;EACA;EACA;EACA;;;;;;;;;;;;aAaW;EAEX;EACA;EAGA;EACA;EACA;EACA;EACA;EACA;EAGA;EACA;EACA;EACA;EACA;EACA;EAGA;EACA;EACA;EACA;EACA;EACA;EACA;EAGA;EACA;EACA;EACA;EACA;EACA;EACA;EAGA;EACA;EACA;EACA;EACA;EACA;EACA;EAGA;EACA;EACA;EACA;EACA;EACA;EACA;EAGA;EACA;EACA;EACA;EACA;EACA;EACA;EAGA;EACA;EACA;EACA;EACA;EACA;EACA;EAGA;EACA;EACA;EACA;EACA;EACA;EACA;EAGA;EACA;EACA;EACA;EACA;EACA;EACA;EAGA;;EAEA;;EAEA;;EAEA"}

package/dist/errors-Bvln0H-7.js

@@ -0,0 +1,112 @@
+//#region src/errors.ts
+/**
+* Base class for every error ts-pptx throws.
+*
+* Catch this to catch anything from the library; narrow with `instanceof` on a subclass, or branch
+* on {@link TsPptxError.code}, to react to something specific. It is never thrown directly — every
+* site picks one of the five subclasses.
+*/
+var TsPptxError = class extends Error {
+	/** Stable condition identifier — see {@link ErrorCode}. Branch on this, not on the text. */
+	code;
+	/** Structured context for the condition, when the throwing site had any to give. */
+	detail;
+	/**
+	* @param code - the stable condition identifier
+	* @param message - explanation for a human reading a stack trace; not part of the contract
+	* @param options - standard `cause`, plus optional structured `detail`
+	*/
+	constructor(code, message, options) {
+		super(message, options);
+		this.name = new.target.name;
+		this.code = code;
+		if (options?.detail !== void 0) this.detail = options.detail;
+	}
+};
+/**
+* The caller passed something the library cannot use — a non-finite coordinate, an unknown enum
+* value, a required option left out, a value outside its legal range.
+*
+* This is the error behind the project's throw-rather-than-coerce policy: emitting a degenerate
+* result (a zero-size shape, a silently dropped option) hides the mistake, so the library refuses
+* instead. Reaching one means the calling code needs to change.
+*/
+var InvalidOptionError = class extends TsPptxError {
+	constructor(code, message, options) {
+		super(code, message, options);
+	}
+};
+/**
+* The request is well-formed but cannot be expressed here: an optional peer dependency is not
+* installed, the runtime lacks a capability, or the shape/feature has no OOXML representation the
+* library emits.
+*
+* Distinct from {@link InvalidOptionError} because the caller did nothing wrong — the answer is
+* "not here", not "not like that" — and the fix is usually to install something or pick a different
+* approach rather than to correct a value.
+*/
+var UnsupportedFeatureError = class extends TsPptxError {
+	constructor(code, message, options) {
+		super(code, message, options);
+	}
+};
+/**
+* The bytes handed to the library are not a package it can read, or a part inside one is
+* structurally malformed — a missing `[Content_Types].xml`, a relationship pointing at nothing, a
+* slide part with no root element.
+*
+* Always about *input*. A problem with something the library is being asked to produce is an
+* {@link InvalidOptionError}.
+*/
+var PackageReadError = class extends TsPptxError {
+	constructor(code, message, options) {
+		super(code, message, options);
+	}
+};
+/**
+* A referenced image, font, or audio/video resource could not be fetched, read, or decoded.
+*
+* Kept apart from {@link PackageReadError} because the failure is in a resource the deck *points
+* at*, not in the package structure — a broken URL, an unreadable path, a corrupt font file — and
+* a consumer typically retries or substitutes rather than rejecting the deck.
+*/
+var MediaError = class extends TsPptxError {
+	constructor(code, message, options) {
+		super(code, message, options);
+	}
+};
+/**
+* Where a report of an `InternalError` should go. Appended to the message rather than left to the
+* docs, because a stack trace is the only artefact of the failure that reaches whoever (or
+* whatever) is debugging it — a pointer anywhere else is a pointer they have to already be looking
+* for. Most code that calls this library is written by an agent in a repository that is not this
+* one, and an agent that hits a library defect routes around it silently unless something in front
+* of it says the report is worth making.
+*/
+const REPORT_NOTICE = "This is a bug in ts-pptx, not in your deck or your code. Please report it:\nhttps://github.com/shbernal/ts-pptx/issues/new?template=agent-report.yml";
+/**
+* An invariant the library maintains itself did not hold.
+*
+* No consumer input should be able to produce one, which is the whole reason it is a separate
+* class: seeing it means the bug is in ts-pptx, and the useful response is to file it rather than
+* to keep adjusting the input.
+*
+* It is the one class in the taxonomy that extends its own message, appending `REPORT_NOTICE`
+* below the invariant that broke. The constructor is where that lives so a throw site added later
+* inherits it — the alternative, a notice pasted at each of the sites, is one every future site can
+* forget. Every other class leaves `message` exactly as given: a malformed package is the routine
+* outcome for a library that reads untrusted files, and a "report this" banner on each corrupt
+* input would train callers to ignore the one banner that always means something.
+*
+* This does not make the message API — see the class doc on {@link TsPptxError}. Branch on
+* `instanceof` or on {@link InternalError.code}, never on the text.
+*/
+var InternalError = class extends TsPptxError {
+	constructor(code, message, options) {
+		super(code, `${message}\n\n${REPORT_NOTICE}`, options);
+	}
+};
+//#endregion
+export { TsPptxError as a, PackageReadError as i, InvalidOptionError as n, UnsupportedFeatureError as o, MediaError as r, InternalError as t };
+
+//# sourceMappingURL=errors-Bvln0H-7.js.map

package/dist/errors-Bvln0H-7.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors-Bvln0H-7.js","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/**\n * The library's error taxonomy.\n *\n * Every failure ts-pptx raises is a {@link TsPptxError} carrying a stable {@link ErrorCode}, so a\n * consumer can tell *\"you passed a bad coordinate\"* from *\"this font file is corrupt\"* from\n * *\"these bytes are not a package\"* without matching on message substrings. The classes are a\n * deliberately flat, coarse bucket — five of them — and the code carries the specificity. Do not\n * add a class per throw site; add a code.\n *\n * **The class and the code are API. The message is not.** Branch on `instanceof` and on `code`;\n * the wording behind them is free to improve in any release. Every error remains an\n * `instanceof Error`, so existing `catch` blocks keep working.\n *\n * Which class to reach for:\n *\n * | class | the failure is | who fixes it |\n * |---|---|---|\n * | {@link InvalidOptionError} | the caller passed something unusable | the caller's code |\n * | {@link UnsupportedFeatureError} | a well-formed request this build/runtime/shape cannot express | the caller's expectations, or the environment |\n * | {@link PackageReadError} | the input bytes are not a readable package | the input file |\n * | {@link MediaError} | a referenced image/font/AV resource would not load or decode | the resource |\n * | {@link InternalError} | an invariant of the library itself did not hold | ts-pptx (file a bug) |\n *\n * **Which of these is worth reporting upstream.** `InternalError` always is, and says so at\n * runtime. The middle three are worth reporting when the environment disagrees with us:\n * a `PackageReadError` on a file that opens cleanly in PowerPoint, a `MediaError` on an asset every\n * other tool loads, an `UnsupportedFeatureError` for something PowerPoint can plainly express.\n * `InvalidOptionError` is worth reporting only if the deck it refused is one PowerPoint can\n * express. See `skills/ts-pptx-upstream` for how to file one.\n *\n * @see `docs/errors.md` for the consumer-facing contract.\n * @see `codes.ts` for the code vocabulary, which is shared with the diagnostic (warning) surface.\n */\n\nimport type {\n\tErrorCode,\n\tInternalErrorCode,\n\tInvalidOptionErrorCode,\n\tMediaErrorCode,\n\tPackageReadErrorCode,\n\tUnsupportedFeatureErrorCode,\n} from './codes.js'\n\n/** Extra context accepted by every {@link TsPptxError} constructor. */\nexport interface TsPptxErrorOptions extends ErrorOptions {\n\t/**\n\t * Structured context for the condition, when a site has any to give. Mirrors `Diagnostic.detail`\n\t * so the same condition looks the same whether it was warned or thrown.\n\t */\n\treadonly detail?: Readonly<Record<string, unknown>>\n}\n\n/**\n * Base class for every error ts-pptx throws.\n *\n * Catch this to catch anything from the library; narrow with `instanceof` on a subclass, or branch\n * on {@link TsPptxError.code}, to react to something specific. It is never thrown directly — every\n * site picks one of the five subclasses.\n */\nexport class TsPptxError extends Error {\n\t/** Stable condition identifier — see {@link ErrorCode}. Branch on this, not on the text. */\n\treadonly code: ErrorCode\n\n\t/** Structured context for the condition, when the throwing site had any to give. */\n\treadonly detail?: Readonly<Record<string, unknown>>\n\n\t/**\n\t * @param code - the stable condition identifier\n\t * @param message - explanation for a human reading a stack trace; not part of the contract\n\t * @param options - standard `cause`, plus optional structured `detail`\n\t */\n\tconstructor(code: ErrorCode, message: string, options?: TsPptxErrorOptions) {\n\t\tsuper(message, options)\n\t\t// `name` drives how a stack trace and `console.log` label the error, and the default from\n\t\t// `Error` would say \"Error\" for every subclass. Derive it from the constructor so a subclass\n\t\t// never has to remember to set it.\n\t\tthis.name = new.target.name\n\t\tthis.code = code\n\t\tif (options?.detail !== undefined) this.detail = options.detail\n\t}\n}\n\n/**\n * The caller passed something the library cannot use — a non-finite coordinate, an unknown enum\n * value, a required option left out, a value outside its legal range.\n *\n * This is the error behind the project's throw-rather-than-coerce policy: emitting a degenerate\n * result (a zero-size shape, a silently dropped option) hides the mistake, so the library refuses\n * instead. Reaching one means the calling code needs to change.\n */\nexport class InvalidOptionError extends TsPptxError {\n\tdeclare readonly code: InvalidOptionErrorCode\n\tconstructor(code: InvalidOptionErrorCode, message: string, options?: TsPptxErrorOptions) {\n\t\tsuper(code, message, options)\n\t}\n}\n\n/**\n * The request is well-formed but cannot be expressed here: an optional peer dependency is not\n * installed, the runtime lacks a capability, or the shape/feature has no OOXML representation the\n * library emits.\n *\n * Distinct from {@link InvalidOptionError} because the caller did nothing wrong — the answer is\n * \"not here\", not \"not like that\" — and the fix is usually to install something or pick a different\n * approach rather than to correct a value.\n */\nexport class UnsupportedFeatureError extends TsPptxError {\n\tdeclare readonly code: UnsupportedFeatureErrorCode\n\tconstructor(code: UnsupportedFeatureErrorCode, message: string, options?: TsPptxErrorOptions) {\n\t\tsuper(code, message, options)\n\t}\n}\n\n/**\n * The bytes handed to the library are not a package it can read, or a part inside one is\n * structurally malformed — a missing `[Content_Types].xml`, a relationship pointing at nothing, a\n * slide part with no root element.\n *\n * Always about *input*. A problem with something the library is being asked to produce is an\n * {@link InvalidOptionError}.\n */\nexport class PackageReadError extends TsPptxError {\n\tdeclare readonly code: PackageReadErrorCode\n\tconstructor(code: PackageReadErrorCode, message: string, options?: TsPptxErrorOptions) {\n\t\tsuper(code, message, options)\n\t}\n}\n\n/**\n * A referenced image, font, or audio/video resource could not be fetched, read, or decoded.\n *\n * Kept apart from {@link PackageReadError} because the failure is in a resource the deck *points\n * at*, not in the package structure — a broken URL, an unreadable path, a corrupt font file — and\n * a consumer typically retries or substitutes rather than rejecting the deck.\n */\nexport class MediaError extends TsPptxError {\n\tdeclare readonly code: MediaErrorCode\n\tconstructor(code: MediaErrorCode, message: string, options?: TsPptxErrorOptions) {\n\t\tsuper(code, message, options)\n\t}\n}\n\n/**\n * Where a report of an `InternalError` should go. Appended to the message rather than left to the\n * docs, because a stack trace is the only artefact of the failure that reaches whoever (or\n * whatever) is debugging it — a pointer anywhere else is a pointer they have to already be looking\n * for. Most code that calls this library is written by an agent in a repository that is not this\n * one, and an agent that hits a library defect routes around it silently unless something in front\n * of it says the report is worth making.\n */\nconst REPORT_NOTICE =\n\t'This is a bug in ts-pptx, not in your deck or your code. Please report it:\\n' +\n\t'https://github.com/shbernal/ts-pptx/issues/new?template=agent-report.yml'\n\n/**\n * An invariant the library maintains itself did not hold.\n *\n * No consumer input should be able to produce one, which is the whole reason it is a separate\n * class: seeing it means the bug is in ts-pptx, and the useful response is to file it rather than\n * to keep adjusting the input.\n *\n * It is the one class in the taxonomy that extends its own message, appending `REPORT_NOTICE`\n * below the invariant that broke. The constructor is where that lives so a throw site added later\n * inherits it — the alternative, a notice pasted at each of the sites, is one every future site can\n * forget. Every other class leaves `message` exactly as given: a malformed package is the routine\n * outcome for a library that reads untrusted files, and a \"report this\" banner on each corrupt\n * input would train callers to ignore the one banner that always means something.\n *\n * This does not make the message API — see the class doc on {@link TsPptxError}. Branch on\n * `instanceof` or on {@link InternalError.code}, never on the text.\n */\nexport class InternalError extends TsPptxError {\n\tdeclare readonly code: InternalErrorCode\n\tconstructor(code: InternalErrorCode, message: string, options?: TsPptxErrorOptions) {\n\t\tsuper(code, `${message}\\n\\n${REPORT_NOTICE}`, options)\n\t}\n}\n"],"mappings":";;;;;;;;AA2DA,IAAa,cAAb,cAAiC,MAAM;;CAEtC;;CAGA;;;;;;CAOA,YAAY,MAAiB,SAAiB,SAA8B;EAC3E,MAAM,SAAS,OAAO;EAItB,KAAK,OAAO,WAAW;EACvB,KAAK,OAAO;EACZ,IAAI,SAAS,WAAW,KAAA,GAAW,KAAK,SAAS,QAAQ;CAC1D;AACD;;;;;;;;;AAUA,IAAa,qBAAb,cAAwC,YAAY;CAEnD,YAAY,MAA8B,SAAiB,SAA8B;EACxF,MAAM,MAAM,SAAS,OAAO;CAC7B;AACD;;;;;;;;;;AAWA,IAAa,0BAAb,cAA6C,YAAY;CAExD,YAAY,MAAmC,SAAiB,SAA8B;EAC7F,MAAM,MAAM,SAAS,OAAO;CAC7B;AACD;;;;;;;;;AAUA,IAAa,mBAAb,cAAsC,YAAY;CAEjD,YAAY,MAA4B,SAAiB,SAA8B;EACtF,MAAM,MAAM,SAAS,OAAO;CAC7B;AACD;;;;;;;;AASA,IAAa,aAAb,cAAgC,YAAY;CAE3C,YAAY,MAAsB,SAAiB,SAA8B;EAChF,MAAM,MAAM,SAAS,OAAO;CAC7B;AACD;;;;;;;;;AAUA,MAAM,gBACL;;;;;;;;;;;;;;;;;;AAoBD,IAAa,gBAAb,cAAmC,YAAY;CAE9C,YAAY,MAAyB,SAAiB,SAA8B;EACnF,MAAM,MAAM,GAAG,QAAQ,MAAM,iBAAiB,OAAO;CACtD;AACD"}