@allyhub/sdk 0.12.0 → 0.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (149) hide show
  1. package/CHANGELOG.md +8 -0
  2. package/dist/node_modules/@allyhub/audio/dist/plan.d.ts +3 -0
  3. package/dist/node_modules/@allyhub/audio/dist/render.js +1 -1
  4. package/dist/node_modules/@allyhub/audio/package.json +1 -1
  5. package/dist/node_modules/@allyhub/chart/dist/chart-file.d.ts +2 -0
  6. package/dist/node_modules/@allyhub/chart/dist/chart-file.js +1 -1
  7. package/dist/node_modules/@allyhub/chart/dist/chart-xml.js +3 -2
  8. package/dist/node_modules/@allyhub/chart/dist/chart.d.ts +5 -12
  9. package/dist/node_modules/@allyhub/chart/dist/chart.js +2 -1
  10. package/dist/node_modules/@allyhub/chart/dist/color.d.ts +37 -0
  11. package/dist/node_modules/@allyhub/chart/dist/color.js +2 -0
  12. package/dist/node_modules/@allyhub/chart/dist/index.d.ts +1 -0
  13. package/dist/node_modules/@allyhub/chart/dist/index.js +1 -1
  14. package/dist/node_modules/@allyhub/chart/dist/svg.js +1 -1
  15. package/dist/node_modules/@allyhub/chart/package.json +1 -1
  16. package/dist/node_modules/@allyhub/diagnostics/package.json +1 -1
  17. package/dist/node_modules/@allyhub/formats/dist/data/deck-code.d.ts +130 -0
  18. package/dist/node_modules/@allyhub/formats/dist/data/deck-code.js +1 -1
  19. package/dist/node_modules/@allyhub/formats/dist/data/gen.d.ts +3 -1
  20. package/dist/node_modules/@allyhub/formats/dist/data/gen.js +1 -1
  21. package/dist/node_modules/@allyhub/formats/dist/data/sheet.d.ts +512 -166
  22. package/dist/node_modules/@allyhub/formats/dist/data/sheet.js +1 -1
  23. package/dist/node_modules/@allyhub/formats/dist/data/slides.d.ts +2523 -136
  24. package/dist/node_modules/@allyhub/formats/dist/data/slides.js +1 -1
  25. package/dist/node_modules/@allyhub/formats/dist/schemas.d.ts +931 -87
  26. package/dist/node_modules/@allyhub/formats/dist/schemas.js +1 -1
  27. package/dist/node_modules/@allyhub/formats/package.json +1 -1
  28. package/dist/node_modules/@allyhub/image-draw/package.json +1 -1
  29. package/dist/node_modules/@allyhub/image-measure/package.json +1 -1
  30. package/dist/node_modules/@allyhub/image-sdk/package.json +1 -1
  31. package/dist/node_modules/@allyhub/measure/package.json +1 -1
  32. package/dist/node_modules/@allyhub/ooxml/dist/color.d.ts +11 -0
  33. package/dist/node_modules/@allyhub/ooxml/dist/color.js +1 -1
  34. package/dist/node_modules/@allyhub/ooxml/dist/ext.d.ts +43 -0
  35. package/dist/node_modules/@allyhub/ooxml/dist/ext.js +1 -1
  36. package/dist/node_modules/@allyhub/ooxml/dist/index.d.ts +2 -1
  37. package/dist/node_modules/@allyhub/ooxml/dist/index.js +1 -1
  38. package/dist/node_modules/@allyhub/ooxml/dist/transform.d.ts +13 -0
  39. package/dist/node_modules/@allyhub/ooxml/dist/transform.js +2 -0
  40. package/dist/node_modules/@allyhub/ooxml/package.json +5 -1
  41. package/dist/node_modules/@allyhub/piece/dist/gen.d.ts +4 -4
  42. package/dist/node_modules/@allyhub/piece/dist/media.d.ts +2 -2
  43. package/dist/node_modules/@allyhub/piece/package.json +1 -1
  44. package/dist/node_modules/@allyhub/protocol/dist/account.d.ts +35 -0
  45. package/dist/node_modules/@allyhub/protocol/dist/account.js +1 -1
  46. package/dist/node_modules/@allyhub/protocol/dist/cloud.d.ts +19 -0
  47. package/dist/node_modules/@allyhub/protocol/dist/cloud.js +1 -1
  48. package/dist/node_modules/@allyhub/protocol/dist/editor.d.ts +35 -20
  49. package/dist/node_modules/@allyhub/protocol/dist/editor.js +1 -1
  50. package/dist/node_modules/@allyhub/protocol/dist/events.d.ts +3 -3
  51. package/dist/node_modules/@allyhub/protocol/dist/frame.d.ts +28 -2
  52. package/dist/node_modules/@allyhub/protocol/dist/frame.js +1 -1
  53. package/dist/node_modules/@allyhub/protocol/dist/jobs.d.ts +6 -6
  54. package/dist/node_modules/@allyhub/protocol/dist/snapshots.d.ts +73 -10
  55. package/dist/node_modules/@allyhub/protocol/dist/snapshots.js +1 -1
  56. package/dist/node_modules/@allyhub/protocol/dist/tools.d.ts +9 -9
  57. package/dist/node_modules/@allyhub/protocol/package.json +1 -1
  58. package/dist/node_modules/@allyhub/runtimes/package.json +1 -1
  59. package/dist/node_modules/@allyhub/scenery/package.json +1 -1
  60. package/dist/node_modules/@allyhub/sheet/dist/annotations.d.ts +14 -0
  61. package/dist/node_modules/@allyhub/sheet/dist/annotations.js +2 -0
  62. package/dist/node_modules/@allyhub/sheet/dist/api/capabilities.js +1 -1
  63. package/dist/node_modules/@allyhub/sheet/dist/api/index.d.ts +1 -1
  64. package/dist/node_modules/@allyhub/sheet/dist/api/index.js +1 -1
  65. package/dist/node_modules/@allyhub/sheet/dist/api/rules.d.ts +24 -0
  66. package/dist/node_modules/@allyhub/sheet/dist/api/rules.js +1 -1
  67. package/dist/node_modules/@allyhub/sheet/dist/api/styles.d.ts +12 -0
  68. package/dist/node_modules/@allyhub/sheet/dist/api/styles.js +1 -1
  69. package/dist/node_modules/@allyhub/sheet/dist/api/workbook.d.ts +3 -1
  70. package/dist/node_modules/@allyhub/sheet/dist/api/workbook.js +1 -1
  71. package/dist/node_modules/@allyhub/sheet/dist/arrange.d.ts +28 -1
  72. package/dist/node_modules/@allyhub/sheet/dist/arrange.js +1 -1
  73. package/dist/node_modules/@allyhub/sheet/dist/data-tools.d.ts +42 -0
  74. package/dist/node_modules/@allyhub/sheet/dist/data-tools.js +2 -0
  75. package/dist/node_modules/@allyhub/sheet/dist/edit.d.ts +43 -2
  76. package/dist/node_modules/@allyhub/sheet/dist/edit.js +1 -1
  77. package/dist/node_modules/@allyhub/sheet/dist/fill.d.ts +10 -0
  78. package/dist/node_modules/@allyhub/sheet/dist/fill.js +1 -1
  79. package/dist/node_modules/@allyhub/sheet/dist/filter.js +1 -1
  80. package/dist/node_modules/@allyhub/sheet/dist/formula/rewrite.d.ts +14 -0
  81. package/dist/node_modules/@allyhub/sheet/dist/formula/rewrite.js +1 -1
  82. package/dist/node_modules/@allyhub/sheet/dist/html.js +10 -10
  83. package/dist/node_modules/@allyhub/sheet/dist/index.d.ts +6 -1
  84. package/dist/node_modules/@allyhub/sheet/dist/index.js +1 -1
  85. package/dist/node_modules/@allyhub/sheet/dist/outline.d.ts +30 -0
  86. package/dist/node_modules/@allyhub/sheet/dist/outline.js +2 -0
  87. package/dist/node_modules/@allyhub/sheet/dist/rich.d.ts +29 -0
  88. package/dist/node_modules/@allyhub/sheet/dist/rich.js +2 -0
  89. package/dist/node_modules/@allyhub/sheet/dist/rules.js +1 -1
  90. package/dist/node_modules/@allyhub/sheet/dist/table-style.d.ts +6 -0
  91. package/dist/node_modules/@allyhub/sheet/dist/table-style.js +1 -1
  92. package/dist/node_modules/@allyhub/sheet/dist/table-styles.js +1 -1
  93. package/dist/node_modules/@allyhub/sheet/dist/workbook.d.ts +5 -1
  94. package/dist/node_modules/@allyhub/sheet/dist/workbook.js +1 -1
  95. package/dist/node_modules/@allyhub/sheet/dist/xlsx/charts.js +1 -1
  96. package/dist/node_modules/@allyhub/sheet/dist/xlsx/import.js +1 -1
  97. package/dist/node_modules/@allyhub/sheet/dist/xlsx/read.d.ts +17 -1
  98. package/dist/node_modules/@allyhub/sheet/dist/xlsx/read.js +2 -2
  99. package/dist/node_modules/@allyhub/sheet/dist/xlsx/runs.d.ts +56 -0
  100. package/dist/node_modules/@allyhub/sheet/dist/xlsx/runs.js +2 -0
  101. package/dist/node_modules/@allyhub/sheet/dist/xlsx/styles.d.ts +6 -0
  102. package/dist/node_modules/@allyhub/sheet/dist/xlsx/styles.js +1 -1
  103. package/dist/node_modules/@allyhub/sheet/dist/xlsx/write.js +1 -1
  104. package/dist/node_modules/@allyhub/sheet/package.json +1 -1
  105. package/dist/node_modules/@allyhub/slides-core/dist/animation.d.ts +117 -21
  106. package/dist/node_modules/@allyhub/slides-core/dist/animation.js +1 -1
  107. package/dist/node_modules/@allyhub/slides-core/dist/api.d.ts +181 -30
  108. package/dist/node_modules/@allyhub/slides-core/dist/api.js +3 -3
  109. package/dist/node_modules/@allyhub/slides-core/dist/capabilities.js +1 -1
  110. package/dist/node_modules/@allyhub/slides-core/dist/chart-api.d.ts +28 -2
  111. package/dist/node_modules/@allyhub/slides-core/dist/chart-api.js +1 -1
  112. package/dist/node_modules/@allyhub/slides-core/dist/check.js +1 -1
  113. package/dist/node_modules/@allyhub/slides-core/dist/enums.d.ts +222 -4
  114. package/dist/node_modules/@allyhub/slides-core/dist/enums.js +1 -1
  115. package/dist/node_modules/@allyhub/slides-core/dist/file.d.ts +6 -0
  116. package/dist/node_modules/@allyhub/slides-core/dist/file.js +3 -3
  117. package/dist/node_modules/@allyhub/slides-core/dist/generated/table-styles.d.ts +3 -0
  118. package/dist/node_modules/@allyhub/slides-core/dist/generated/table-styles.js +2 -0
  119. package/dist/node_modules/@allyhub/slides-core/dist/index.d.ts +3 -0
  120. package/dist/node_modules/@allyhub/slides-core/dist/index.js +1 -1
  121. package/dist/node_modules/@allyhub/slides-core/dist/merge.js +1 -1
  122. package/dist/node_modules/@allyhub/slides-core/dist/model.d.ts +98 -10
  123. package/dist/node_modules/@allyhub/slides-core/dist/numbering.d.ts +6 -0
  124. package/dist/node_modules/@allyhub/slides-core/dist/numbering.js +2 -0
  125. package/dist/node_modules/@allyhub/slides-core/dist/office.d.ts +53 -0
  126. package/dist/node_modules/@allyhub/slides-core/dist/office.js +1 -1
  127. package/dist/node_modules/@allyhub/slides-core/dist/patterns.d.ts +8 -0
  128. package/dist/node_modules/@allyhub/slides-core/dist/patterns.js +2 -0
  129. package/dist/node_modules/@allyhub/slides-core/dist/resolve.d.ts +36 -6
  130. package/dist/node_modules/@allyhub/slides-core/dist/resolve.js +1 -1
  131. package/dist/node_modules/@allyhub/slides-core/dist/script.d.ts +11 -0
  132. package/dist/node_modules/@allyhub/slides-core/dist/script.js +2 -2
  133. package/dist/node_modules/@allyhub/slides-core/dist/sdk.d.ts +1 -1
  134. package/dist/node_modules/@allyhub/slides-core/dist/sdk.js +1 -1
  135. package/dist/node_modules/@allyhub/slides-core/dist/table-style.d.ts +48 -0
  136. package/dist/node_modules/@allyhub/slides-core/dist/table-style.js +2 -0
  137. package/dist/node_modules/@allyhub/slides-core/package.json +1 -1
  138. package/dist/node_modules/@allyhub/video-core/dist/mix-plan.js +1 -1
  139. package/dist/node_modules/@allyhub/video-core/dist/timeline.d.ts +4 -0
  140. package/dist/node_modules/@allyhub/video-core/package.json +1 -1
  141. package/dist/node_modules/@allyhub/video-sdk/package.json +1 -1
  142. package/docs/defaults.md +78 -4
  143. package/docs/image.md +1 -1
  144. package/docs/pictures.md +1 -1
  145. package/docs/project.md +1 -1
  146. package/docs/sheets.md +19 -9
  147. package/docs/slides.md +30 -16
  148. package/docs/speech.md +1 -1
  149. package/package.json +1 -1
@@ -1,3 +1,3 @@
1
1
  /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
2
- import{readDataFile as S}from"@allyhub/formats";import{isCollection as m,isMap as c,isSeq as w,parseDocument as g}from"yaml";export function scriptWords(s,e){const n=new Map(s.slides.map(r=>[r.id,r]));return r=>{if(!r.startsWith(`${e}.`))return;const f=r.slice(e.length+1),t=f.lastIndexOf(".");if(t<0)return;const o=n.get(f.slice(0,t)),l=f.slice(t+1);return l==="notes"?typeof o?.notes=="string"?o.notes:void 0:o?.text?.[l]}}export function readScript(s){const e=g(s);if(e.errors.length>0)return;const n=S("script",e.toJS()??{});return n.ok?n.value:void 0}function k(s){let e=s.get("slides",!0);if(w(e)||(c(s.contents)?s.set("slides",s.createNode([])):s.contents=s.createNode({slides:[]}),e=s.get("slides",!0)),!w(e))throw new Error("The script has no slides list.");return e.flow===!0&&(e.flow=!1),e}function x(s,e){!m(s)||!m(e)||(e.flow===!0&&(s.flow=!0),s.items.forEach((n,r)=>{x(n,e.items[r])}))}export function editDeckScript(s,e){const n=g(s===void 0||s.trim()===""?`slides: []
3
- `:s);if(n.errors.length>0)throw new Error("The script is not YAML: it is mended by hand first.");return editDeckScriptDocument(n,e),n.toString()}export function editDeckScriptDocument(s,e){const n=k(s),r=n.items.findIndex(o=>c(o)&&o.get("id")===e.slide);if(e.op==="remove"){r>=0&&n.items.splice(r,1);return}const f=e.op==="text"?e.words===void 0:e.op==="alt"?e.alt===void 0:e.notes===void 0;if(r<0&&f)return;let t=n.items[r];if(c(t)||(n.items.push(s.createNode({id:e.slide})),t=n.items.at(-1)),!!c(t)){if(e.op==="notes")e.notes===void 0?t.delete("notes"):t.set("notes",s.createNode(e.notes));else if(e.op==="alt")if(e.alt===void 0){t.deleteIn(["alt",e.shape]);const o=t.get("alt",!0);c(o)&&o.items.length===0&&t.delete("alt")}else t.setIn(["alt",e.shape],e.alt);else if(e.words===void 0){t.deleteIn(["text",e.shape]);const o=t.get("text",!0);c(o)&&o.items.length===0&&t.delete("text")}else{const o=s.createNode(e.words);x(o,t.getIn(["text",e.shape],!0)),t.setIn(["text",e.shape],o)}t.items.length===1&&n.items.splice(n.items.indexOf(t),1)}}const a=s=>JSON.stringify(s);export function deckScriptEdits(s,e){const n=[],r=new Map(s.slides.map(t=>[t.id,t])),f=new Map(e.slides.map(t=>[t.id,t]));for(const t of r.keys())f.has(t)||n.push({op:"remove",slide:t});for(const[t,o]of f){const l=r.get(t),p=l?.text??{},u=o.text??{};for(const i of new Set([...Object.keys(p),...Object.keys(u)]))a(p[i])!==a(u[i])&&n.push({op:"text",slide:t,shape:i,words:u[i]});const h=l?.alt??{},d=o.alt??{};for(const i of new Set([...Object.keys(h),...Object.keys(d)]))h[i]!==d[i]&&n.push({op:"alt",slide:t,shape:i,alt:d[i]});a(l?.notes)!==a(o.notes)&&n.push({op:"notes",slide:t,notes:o.notes})}return n}
2
+ import{readDataFile as w}from"@allyhub/formats";import{isCollection as m,isMap as a,isSeq as g,parseDocument as y}from"yaml";export function scriptWords(t,e){const s=new Map(t.slides.map(i=>[i.id,i])),o=i=>typeof i=="string"?i:Array.isArray(i)?i.map(o).filter(n=>n!==void 0):void 0;return i=>{if(!i.startsWith(`${e}.`))return;const[n="",...r]=i.slice(e.length+1).split("."),c=s.get(n);if(r.length===1&&r[0]==="notes")return typeof c?.notes=="string"?c.notes:void 0;if(r.length===2&&r[0]==="alt")return c?.alt?.[r[1]??""];let f=c?.text;for(const u of r)f=typeof f=="object"&&f!==null&&!Array.isArray(f)?f[u]:void 0;return o(f)}}export const CHART_AXIS_WORDS=["category_axis","value_axis","secondary_axis"];export function chartWordsOf(t){if(typeof t=="string")return{title:t};if(typeof t!="object"||Array.isArray(t))return{};const e={};for(const s of["title",...CHART_AXIS_WORDS]){const o=t[s];typeof o=="string"&&(e[s]=o)}return e}export function chartScriptText(t){const e=Object.fromEntries(Object.entries(t).filter(([,o])=>o!==void 0&&o!=="")),s=Object.keys(e);if(s.length!==0)return s.length===1&&e.title!==void 0?e.title:e}export function readScript(t){const e=y(t);if(e.errors.length>0)return;const s=w("script",e.toJS()??{});return s.ok?s.value:void 0}function S(t){let e=t.get("slides",!0);if(g(e)||(a(t.contents)?t.set("slides",t.createNode([])):t.contents=t.createNode({slides:[]}),e=t.get("slides",!0)),!g(e))throw new Error("The script has no slides list.");return e.flow===!0&&(e.flow=!1),e}function x(t,e){!m(t)||!m(e)||(e.flow===!0&&(t.flow=!0),t.items.forEach((s,o)=>{x(s,e.items[o])}))}export function editDeckScript(t,e){const s=y(t===void 0||t.trim()===""?`slides: []
3
+ `:t);if(s.errors.length>0)throw new Error("The script is not YAML: it is mended by hand first.");return editDeckScriptDocument(s,e),s.toString()}export function editDeckScriptDocument(t,e){const s=S(t),o=s.items.findIndex(r=>a(r)&&r.get("id")===e.slide);if(e.op==="remove"){o>=0&&s.items.splice(o,1);return}const i=e.op==="text"?e.words===void 0:e.op==="alt"?e.alt===void 0:e.notes===void 0;if(o<0&&i)return;let n=s.items[o];if(a(n)||(s.items.push(t.createNode({id:e.slide})),n=s.items.at(-1)),!!a(n)){if(e.op==="notes")e.notes===void 0?n.delete("notes"):n.set("notes",t.createNode(e.notes));else if(e.op==="alt")if(e.alt===void 0){n.deleteIn(["alt",e.shape]);const r=n.get("alt",!0);a(r)&&r.items.length===0&&n.delete("alt")}else n.setIn(["alt",e.shape],e.alt);else if(e.words===void 0){n.deleteIn(["text",e.shape]);const r=n.get("text",!0);a(r)&&r.items.length===0&&n.delete("text")}else{const r=t.createNode(e.words);x(r,n.getIn(["text",e.shape],!0)),n.setIn(["text",e.shape],r)}n.items.length===1&&s.items.splice(s.items.indexOf(n),1)}}const p=t=>JSON.stringify(t);export function deckScriptEdits(t,e){const s=[],o=new Map(t.slides.map(n=>[n.id,n])),i=new Map(e.slides.map(n=>[n.id,n]));for(const n of o.keys())i.has(n)||s.push({op:"remove",slide:n});for(const[n,r]of i){const c=o.get(n),f=c?.text??{},u=r.text??{};for(const l of new Set([...Object.keys(f),...Object.keys(u)]))p(f[l])!==p(u[l])&&s.push({op:"text",slide:n,shape:l,words:u[l]});const h=c?.alt??{},d=r.alt??{};for(const l of new Set([...Object.keys(h),...Object.keys(d)]))h[l]!==d[l]&&s.push({op:"alt",slide:n,shape:l,alt:d[l]});p(c?.notes)!==p(r.notes)&&s.push({op:"notes",slide:n,notes:r.notes})}return s}
@@ -1,7 +1,7 @@
1
1
  import { presentationFor } from "./index.js";
2
2
  /** python-pptx's length functions: each gives a Length, a number of EMU that says itself in other units (`Pt(12).pt`, `.inches`, `.cm`, `.mm`, `.emu`). */
3
3
  export declare const Emu: (n: number) => import("./units.js").LengthValue, Inches: (n: number) => import("./units.js").LengthValue, Pt: (n: number) => import("./units.js").LengthValue, Cm: (n: number) => import("./units.js").LengthValue, Mm: (n: number) => import("./units.js").LengthValue, Centipoints: (n: number) => import("./units.js").LengthValue;
4
- export { RGBColor, MSO_ANCHOR, CategoryChartData, MSO_ARROWHEAD, MSO_ARROWHEAD_SIZE, XL_CHART_TYPE, XL_LABEL_POSITION, XL_LEGEND_POSITION, MSO_AUTO_SIZE, MSO_CONNECTOR, MSO_FILL, MSO_LINE, MSO_LINE_DASH_STYLE, MSO_SHAPE, MSO_SHAPE_TYPE, MSO_THEME_COLOR, PP_ALIGN, PP_PARAGRAPH_ALIGNMENT, PP_PLACEHOLDER, THEME_FONT, SLIDE_SIZES, presentationFor, isDeck, type Anchor, type AutoSize, type Background, type Cell, type ColorFormat, type ComponentContext, type ComponentInput, type Deck, type FillFormat, type FreeformBuilder, type GradientStop, type GroupShape, type Font, type GeneratedSlide, type Generator, type Length, type LengthValue, type LineFormat, type ListLevel, type ListStyle, type Paragraph, type Placeholders, type PlaceholderType, type Presentation, type PresentationOptions, type PropSpec, type Run, type Shape, type ShapeCollection, type ShapeType, type SlideLayout, type SlideLayouts, type SlideMaster, type SlideMasters, type SlideSizeName, type Table, type TextFrame, type TextStyles, type ThemeInput, } from "./index.js";
4
+ export { RGBColor, MSO_ANCHOR, CategoryChartData, MSO_ARROWHEAD, MSO_ARROWHEAD_SIZE, XL_CHART_TYPE, XL_LABEL_POSITION, XL_LEGEND_POSITION, MSO_AUTO_SIZE, MSO_CONNECTOR, MSO_FILL, MSO_LINE, MSO_LINE_DASH_STYLE, MSO_LINE_CAP, MSO_LINE_COMPOUND, MSO_LINE_JOIN, MSO_PATTERN, MSO_PATTERN_TYPE, TILE_ALIGNMENT, MSO_SHAPE, MSO_SHAPE_TYPE, MSO_TEXT_CAPS, MSO_TEXT_ORIENTATION, MSO_TEXT_STRIKE, MSO_TEXT_UNDERLINE_TYPE, MSO_THEME_COLOR, MSO_UNDERLINE, PP_ALIGN, PP_PARAGRAPH_ALIGNMENT, PP_PLACEHOLDER, THEME_FONT, SLIDE_SIZES, presentationFor, isDeck, type Anchor, type AutoSize, type Background, type Cell, type ColorFormat, type ComponentContext, type ComponentInput, type Deck, type FillFormat, type FreeformBuilder, type GradientStop, type GroupShape, type Font, type GeneratedSlide, type Generator, type Length, type LengthValue, type LineFormat, type ListLevel, type ListStyle, type Paragraph, type Placeholders, type PlaceholderOptions, type PlaceholderType, type Presentation, type PresentationOptions, type PropSpec, type Run, type Shape, type ShapeCollection, type ShapeType, type SlideLayout, type SlideLayouts, type SlideMaster, type SlideMasters, type SlideSizeName, type Table, type TextFrame, type TextStyles, type ThemeInput, } from "./index.js";
5
5
  /**
6
6
  * A deck: the default export of a deck's module. Its function makes
7
7
  * the presentation's slide masters, layouts, components and generators;
@@ -1,2 +1,2 @@
1
1
  /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
2
- import{LENGTH_UNITS as O,presentationFor as _}from"./index.js";export const{Emu,Inches,Pt,Cm,Mm,Centipoints}=O;export{RGBColor,MSO_ANCHOR,CategoryChartData,MSO_ARROWHEAD,MSO_ARROWHEAD_SIZE,XL_CHART_TYPE,XL_LABEL_POSITION,XL_LEGEND_POSITION,MSO_AUTO_SIZE,MSO_CONNECTOR,MSO_FILL,MSO_LINE,MSO_LINE_DASH_STYLE,MSO_SHAPE,MSO_SHAPE_TYPE,MSO_THEME_COLOR,PP_ALIGN,PP_PARAGRAPH_ALIGNMENT,PP_PLACEHOLDER,THEME_FONT,SLIDE_SIZES,presentationFor,isDeck}from"./index.js";export const presentation=_(""),slidesFor=E=>({presentation:_(E.file)});
2
+ import{LENGTH_UNITS as O,presentationFor as _}from"./index.js";export const{Emu,Inches,Pt,Cm,Mm,Centipoints}=O;export{RGBColor,MSO_ANCHOR,CategoryChartData,MSO_ARROWHEAD,MSO_ARROWHEAD_SIZE,XL_CHART_TYPE,XL_LABEL_POSITION,XL_LEGEND_POSITION,MSO_AUTO_SIZE,MSO_CONNECTOR,MSO_FILL,MSO_LINE,MSO_LINE_DASH_STYLE,MSO_LINE_CAP,MSO_LINE_COMPOUND,MSO_LINE_JOIN,MSO_PATTERN,MSO_PATTERN_TYPE,TILE_ALIGNMENT,MSO_SHAPE,MSO_SHAPE_TYPE,MSO_TEXT_CAPS,MSO_TEXT_ORIENTATION,MSO_TEXT_STRIKE,MSO_TEXT_UNDERLINE_TYPE,MSO_THEME_COLOR,MSO_UNDERLINE,PP_ALIGN,PP_PARAGRAPH_ALIGNMENT,PP_PLACEHOLDER,THEME_FONT,SLIDE_SIZES,presentationFor,isDeck}from"./index.js";export const presentation=_(""),slidesFor=E=>({presentation:_(E.file)});
@@ -0,0 +1,48 @@
1
+ import type { Color } from "@allyhub/chart";
2
+ import { TABLE_STYLES } from "./generated/table-styles.js";
3
+ import type { CellBorder, TableDef } from "./model.js";
4
+ /** A part of a table a style paints. */
5
+ export type TableStylePart = "wholeTbl" | "band1H" | "band2H" | "band1V" | "band2V" | "lastCol" | "firstCol" | "lastRow" | "firstRow";
6
+ /** An edge a style part rules: its outer sides, and between its cells. */
7
+ export type TableStyleEdge = "left" | "right" | "top" | "bottom" | "insideH" | "insideV";
8
+ /** What a style part paints: its text's weight and colour, its fill (null: none), its edges (null: none). */
9
+ export interface TableStylePartDef {
10
+ bold?: boolean;
11
+ text?: Color;
12
+ fill?: Color | null;
13
+ borders?: Partial<Record<TableStyleEdge, CellBorder | null>>;
14
+ }
15
+ /** A built-in table style: its id (`{5C22544A-…}`), its English name as PowerPoint's gallery shows it, its family and accent, its parts. */
16
+ export interface TableStyleDef {
17
+ id: string;
18
+ name: string;
19
+ family: string;
20
+ accent?: number;
21
+ /** What is behind its cells (`a:tblBg`), which a fill that lets some through shows. */
22
+ background?: Color;
23
+ parts: Partial<Record<TableStylePart, TableStylePartDef>>;
24
+ }
25
+ /** PowerPoint's 74 built-in table styles, in its gallery's order. */
26
+ export { TABLE_STYLES };
27
+ /** The style PowerPoint and python-pptx give a new table: Medium Style 2 – Accent 1. */
28
+ export declare const DEFAULT_TABLE_STYLE = "{5C22544A-7EE6-4342-B048-85BDC9FD1C3A}";
29
+ /** A built-in style by its id or its English name ("Medium Style 2 - Accent 1"); undefined for any other. */
30
+ export declare function tableStyleOf(idOrName: string | undefined): TableStyleDef | undefined;
31
+ /** Table Design's options as a table holds them (`a:tblPr`'s flags). */
32
+ export type TableFlags = Pick<TableDef, "first_row" | "last_row" | "first_col" | "last_col" | "horz_banding" | "vert_banding">;
33
+ /** The look a style gives a cell: its fill, each edge, its text's weight and colour (absent: the style says nothing). */
34
+ export interface CellLook {
35
+ fill?: Color | null;
36
+ borders: Partial<Record<"left" | "right" | "top" | "bottom", CellBorder | null>>;
37
+ bold?: boolean;
38
+ text?: Color;
39
+ }
40
+ /**
41
+ * The look a style gives the cell at row `r`, column `c` of a table of
42
+ * `rows` × `cols` (a merged cell's last row and column `r2`, `c2`): the
43
+ * whole table's, then a band's, then the last and first column's and the
44
+ * last and first row's where those options are on, each over the one
45
+ * before; an edge between two cells is the part's inside rule.
46
+ */
47
+ export declare function cellLook(style: TableStyleDef, flags: TableFlags, r: number, c: number, rows: number, cols: number, r2?: number, c2?: number): CellLook;
48
+ //# sourceMappingURL=table-style.d.ts.map
@@ -0,0 +1,2 @@
1
+ /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
2
+ import{TABLE_STYLES as b}from"./generated/table-styles.js";export{b as TABLE_STYLES};export const DEFAULT_TABLE_STYLE="{5C22544A-7EE6-4342-B048-85BDC9FD1C3A}";const V=new Map(b.map(t=>[t.id.toUpperCase(),t])),R=new Map(b.map(t=>[B(t.name),t]));function B(t){return t.toLowerCase().replace(/[–—]/gu,"-").replace(/\s+/gu," ").trim()}export function tableStyleOf(t){if(t!==void 0)return V.get(t.trim().toUpperCase())??R.get(B(t))}export function cellLook(t,e,r,s,a,c,l=r,p=s){const f={borders:{}},_=e.first_row===!0?1:0,w=e.first_col===!0?1:0,C=e.last_row===!0&&l===a-1,h=e.last_col===!0&&p===c-1,i=["wholeTbl"];e.horz_banding===!0&&r>=_&&!C&&i.push((r-_)%2===0?"band1H":"band2H"),e.vert_banding===!0&&s>=w&&!h&&i.push((s-w)%2===0?"band1V":"band2V"),h&&i.push("lastCol"),e.first_col===!0&&s===0&&i.push("firstCol"),C&&i.push("lastRow"),e.first_row===!0&&r===0&&i.push("firstRow");for(const o of i){const n=t.parts[o];if(!n)continue;n.fill!==void 0&&(f.fill=n.fill),n.bold!==void 0&&(f.bold=n.bold),n.text!==void 0&&(f.text=n.text);const m=n.borders??{},x=o==="firstRow"||o==="lastRow"||o==="band1H"||o==="band2H",E=o==="firstCol"||o==="lastCol"||o==="band1V"||o==="band2V",d={top:x?r:0,bottom:x?l:a-1,left:E?s:0,right:E?p:c-1},u=(L,H,T)=>{const A=H?m[L]:m[T];A!==void 0&&(f.borders[L]=A)};u("left",s===d.left,"insideV"),u("right",p===d.right,"insideV"),u("top",r===d.top,"insideH"),u("bottom",l===d.bottom,"insideH")}return f}
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@allyhub/slides-core",
3
- "version": "0.12.0",
3
+ "version": "0.13.0",
4
4
  "type": "module",
5
5
  "exports": {
6
6
  ".": {
@@ -1,2 +1,2 @@
1
1
  /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
2
- import{addEnvelopes as v,duckEnvelope as I,hashSeed as w,MIX_DEFAULTS as D,resolveVoice as E,SFX_HIT as F,speechEnvelope as S,speechSpans as O}from"@allyhub/audio";import{MUSIC_DEFAULTS as M,musicSegments as k,placeStretches as A,wholeLoop as G}from"./music.js";import{wordsIn as U}from"./speech.js";export function voicePlan(t,s){const a=o=>E(o),c=s.filter(o=>o.mic!==void 0);return{mic:{video:a(t),...c.length>0?{parts:Object.fromEntries(c.map(o=>[o.key,a(o.mic)]))}:{}}}}export function wordsOnFilm(t,s){return t.flatMap(a=>U(s(a.file)??[],a.from,a.dur,a.at,a.speed??1)).map(a=>({start:a.start,end:a.end})).sort((a,c)=>a.start-c.start)}const g=(t,s)=>s===void 0||!Number.isFinite(s)?0:t-s,L=t=>[...t].sort((s,a)=>s.t-a.t);export function musicPlayed(t,s,a){return t.play?k(t.play,t.seam??M.seam,s,"before",!t.loop):t.loop?k(G(t.from,s,a,t.seam),s>1?t.seam??M.loopSeam:0,s,"after",!1):k(A([{from:t.from,to:s}],void 0,s,a),0,s)}export function mixPlan(t,s,a){const c=t.duration,o=t.audio.mix??D,i={duration:c,speech:[],footage:[],sfx:[]};for(const e of[...t.audio.speech??[],...t.audio.room??[]]){const f=s[e.file];!f||e.dur<=0||i.speech.push({file:e.file,...e.part===void 0?{}:{part:e.part},at:e.at,from:e.from,dur:e.dur,gainDb:g(o.speech,f.loudness)+(e.gainDb??0),...e.speed!==void 0&&e.speed!==1?{speed:e.speed}:{},...e.denoise?{denoise:e.denoise}:{},...e.fadeIn?{fadeIn:e.fadeIn}:{},...e.fadeOut?{fadeOut:e.fadeOut}:{}})}const m=O(i.speech,o.duck),h=S(m,o.footageUnderSpeech-o.footage,o.duck);for(const e of t.footage??[]){const f=s[e.file];if(!e.audio||e.take===!0||!f)continue;const d=e.speed>0?e.speed:1,u=Math.max(0,e.from),b=e.start+(u-e.from)/d,y=f.duration===void 0?1/0:f.duration-u,x=Math.min(e.end-b,y/d);x<=0||i.footage.push({file:e.file,at:b,from:u,dur:x,...d===1?{}:{speed:d},gainDb:g(o.footage,f.loudness)+e.gainDb,...h.length>0?{envelope:h}:{}})}const n=t.audio.music,r=n?.file===void 0?void 0:s[n.file];if(n?.file!==void 0&&r){const e=(n.gain??[]).map(u=>({t:u.t,db:u.db})),f=r.duration??n.from+c,d={file:n.file,segments:musicPlayed(n,f,c),gainDb:g(o.musicAlone,r.loudness),alone:o.musicAlone,fadeIn:o.musicFade.in,fadeOut:Math.min(o.musicFade.out,c/4),...n.until===void 0?{}:{until:n.until},duck:v(v(S(m,o.music-o.musicAlone,o.duck),I(wordsOnFilm(i.speech,u=>s[u]?.words),o.duck)),L(e)),...n.shape?{shape:n.shape}:{}};i.music=d}const l=speechGains(t);l.length>0&&(i.speechGain=l);const p=t.audio.mic;return p&&(i.voice={video:p.video,...p.parts?{parts:p.parts}:{},spans:t.parts.map(e=>({part:e.key,start:e.start,end:e.end})),seed:a.seed}),t.cues.forEach((e,f)=>{const d=e.gainDb??0;if(e.file!==void 0){const b=s[e.file];if(!b)return;i.sfx.push({sound:e.sound,file:e.file,at:e.t,gainDb:g(o.sfx,b.loudness)+d,seed:0,...e.shape?{shape:e.shape,level:{target:o.sfx,gainDb:d}}:{}});return}const u=F[e.sound];u!==void 0&&i.sfx.push({sound:e.sound,at:Math.max(0,e.t-u),gainDb:o.sfx-D.sfx+d,seed:w(`${a.seed}:${e.sound}:${String(f)}`),...e.shape?{shape:e.shape}:{}})}),i}export function speechGains(t){const s=new Map;for(const n of t.parts)n.speechGainDb!==void 0&&n.speechGainDb!==0&&s.set(n.key,n.speechGainDb);if(s.size===0)return[];const a=[];for(const n of t.parts)a.push({start:n.start,end:n.end,db:s.get(n.key)??0,rank:0});const c=[...(t.audio.speech??[]).map(n=>({c:n,rank:2})),...(t.audio.room??[]).map(n=>({c:n,rank:1}))];for(const{c:n,rank:r}of c)n.part===void 0||n.dur<=0||a.push({start:n.at,end:n.at+n.dur,db:s.get(n.part)??0,rank:r});const o=[...new Set(a.flatMap(n=>[n.start,n.end]))].sort((n,r)=>n-r),i=[];for(let n=0;n+1<o.length;n++){const r=o[n]??0,l=o[n+1]??r,p=(r+l)/2;let e;for(const d of a)p<d.start||p>=d.end||(!e||d.rank>e.rank||d.rank===e.rank&&d.start>=e.start)&&(e=d);const f=e?.db??0;i.at(-1)?.db!==f&&i.push({t:r,db:f})}if(i.every(n=>n.db===0))return[];const m=.005,h=[];for(const[n,r]of i.entries()){if(n===0){h.push({t:r.t,db:r.db});continue}const l=i[n-1]?.db??0;h.push({t:Math.max(0,r.t-m),db:l},{t:r.t+m,db:r.db})}return h}
2
+ import{addEnvelopes as v,duckEnvelope as I,hashSeed as w,MIX_DEFAULTS as D,resolveVoice as E,SFX_HIT as F,speechEnvelope as S,speechSpans as O}from"@allyhub/audio";import{MUSIC_DEFAULTS as M,musicSegments as k,placeStretches as A,wholeLoop as G}from"./music.js";import{wordsIn as U}from"./speech.js";export function voicePlan(t,o){const a=s=>E(s),p=o.filter(s=>s.mic!==void 0);return{mic:{video:a(t),...p.length>0?{parts:Object.fromEntries(p.map(s=>[s.key,a(s.mic)]))}:{}}}}export function wordsOnFilm(t,o){return t.flatMap(a=>U(o(a.file)??[],a.from,a.dur,a.at,a.speed??1)).map(a=>({start:a.start,end:a.end})).sort((a,p)=>a.start-p.start)}const g=(t,o)=>o===void 0||!Number.isFinite(o)?0:t-o,L=t=>[...t].sort((o,a)=>o.t-a.t);export function musicPlayed(t,o,a){return t.play?k(t.play,t.seam??M.seam,o,"before",!t.loop):t.loop?k(G(t.from,o,a,t.seam),o>1?t.seam??M.loopSeam:0,o,"after",!1):k(A([{from:t.from,to:o}],void 0,o,a),0,o)}export function mixPlan(t,o,a){const p=t.duration,s=t.audio.mix??D,f={duration:p,speech:[],footage:[],sfx:[]};for(const e of[...t.audio.speech??[],...t.audio.room??[]]){const i=o[e.file];!i||e.dur<=0||f.speech.push({file:e.file,...e.part===void 0?{}:{part:e.part},at:e.at,from:e.from,dur:e.dur,gainDb:g(s.speech,i.loudness)+(e.gainDb??0),...e.speed!==void 0&&e.speed!==1?{speed:e.speed}:{},...e.denoise?{denoise:e.denoise}:{},...e.fadeIn?{fadeIn:e.fadeIn}:{},...e.fadeOut?{fadeOut:e.fadeOut}:{}})}const m=O(f.speech,s.duck),h=S(m,s.footageUnderSpeech-s.footage,s.duck);for(const e of t.footage??[]){const i=o[e.file];if(!e.audio||e.take===!0||!i)continue;const d=e.speed>0?e.speed:1,u=Math.max(0,e.from),b=e.start+(u-e.from)/d,y=i.duration===void 0?1/0:i.duration-u,x=Math.min(e.end-b,y/d);x<=0||f.footage.push({file:e.file,at:b,from:u,dur:x,...d===1?{}:{speed:d},gainDb:g(s.footage,i.loudness)+e.gainDb,...h.length>0?{envelope:h}:{}})}const n=t.audio.music,r=n?.file===void 0?void 0:o[n.file];if(n?.file!==void 0&&r){const e=(n.gain??[]).map(u=>({t:u.t,db:u.db})),i=r.duration??n.from+p,d={file:n.file,segments:musicPlayed(n,i,p),gainDb:g(s.musicAlone,r.loudness),alone:s.musicAlone,fadeIn:s.musicFade.in,fadeOut:Math.min(s.musicFade.out,p/4),...n.until===void 0?{}:{until:n.until},duck:v(v(S(m,s.music-s.musicAlone,s.duck),I(wordsOnFilm(f.speech,u=>o[u]?.words),s.duck)),L(e)),...n.shape?{shape:n.shape}:{}};f.music=d}const l=speechGains(t);l.length>0&&(f.speechGain=l);const c=t.audio.mic;return c&&(f.voice={video:c.video,...c.parts?{parts:c.parts}:{},spans:t.parts.map(e=>({part:e.key,start:e.start,end:e.end})),seed:a.seed}),t.cues.forEach((e,i)=>{const d=e.gainDb??0;if(e.file!==void 0){const b=o[e.file];if(!b)return;f.sfx.push({sound:e.sound,file:e.file,at:e.t,gainDb:g(s.sfx,b.loudness)+d,seed:0,...e.from===void 0?{}:{from:e.from},...e.length===void 0?{}:{length:e.length},...e.shape?{shape:e.shape,level:{target:s.sfx,gainDb:d}}:{}});return}const u=F[e.sound];u!==void 0&&f.sfx.push({sound:e.sound,at:Math.max(0,e.t-u),gainDb:s.sfx-D.sfx+d,seed:w(`${a.seed}:${e.sound}:${String(i)}`),...e.shape?{shape:e.shape}:{}})}),f}export function speechGains(t){const o=new Map;for(const n of t.parts)n.speechGainDb!==void 0&&n.speechGainDb!==0&&o.set(n.key,n.speechGainDb);if(o.size===0)return[];const a=[];for(const n of t.parts)a.push({start:n.start,end:n.end,db:o.get(n.key)??0,rank:0});const p=[...(t.audio.speech??[]).map(n=>({c:n,rank:2})),...(t.audio.room??[]).map(n=>({c:n,rank:1}))];for(const{c:n,rank:r}of p)n.part===void 0||n.dur<=0||a.push({start:n.at,end:n.at+n.dur,db:o.get(n.part)??0,rank:r});const s=[...new Set(a.flatMap(n=>[n.start,n.end]))].sort((n,r)=>n-r),f=[];for(let n=0;n+1<s.length;n++){const r=s[n]??0,l=s[n+1]??r,c=(r+l)/2;let e;for(const d of a)c<d.start||c>=d.end||(!e||d.rank>e.rank||d.rank===e.rank&&d.start>=e.start)&&(e=d);const i=e?.db??0;f.at(-1)?.db!==i&&f.push({t:r,db:i})}if(f.every(n=>n.db===0))return[];const m=.005,h=[];for(const[n,r]of f.entries()){if(n===0){h.push({t:r.t,db:r.db});continue}const l=f[n-1]?.db??0;h.push({t:Math.max(0,r.t-m),db:l},{t:r.t+m,db:r.db})}return h}
@@ -169,6 +169,10 @@ export interface Cue {
169
169
  gainDb?: number;
170
170
  /** How it is shaped before it is levelled (its sound's `shape`). */
171
171
  shape?: FixedShape;
172
+ /** Seconds into its file it plays from (a trim's start); its file's start unless said. */
173
+ from?: number;
174
+ /** Seconds of it that play from there; to its file's end unless said. */
175
+ length?: number;
172
176
  }
173
177
  /**
174
178
  * A footage layer's background as its `background` option resolved: what
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@allyhub/video-core",
3
- "version": "0.12.0",
3
+ "version": "0.13.0",
4
4
  "type": "module",
5
5
  "exports": {
6
6
  ".": {
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@allyhub/video-sdk",
3
- "version": "0.12.0",
3
+ "version": "0.13.0",
4
4
  "type": "module",
5
5
  "exports": {
6
6
  ".": {
package/docs/defaults.md CHANGED
@@ -96,9 +96,9 @@ A new master's text styles (`master.text_styles`: `title_style`, `body_style`, `
96
96
 
97
97
  | Key | Value |
98
98
  | --- | --- |
99
- | `title` | `[{"alignment":"l","line_spacing":{"lines":0.9},"space_before":0,"bullet":null,"font":{"name":"+mj-lt","size":558800,"color":"dk1"}},{"alignment":"l","line_spacing":{"lines":0.9},"space_before":0,"bullet":null,"font":{"name":"+mj-lt","size":558800,"color":"dk1"}},{"alignment":"l","line_spacing":{"lines":0.9},"space_before":0,"bullet":null,"font":{"name":"+mj-lt","size":558800,"color":"dk1"}},{"alignment":"l","line_spacing":{"lines":0.9},"space_before":0,"bullet":null,"font":{"name":"+mj-lt","size":558800,"color":"dk1"}},{"alignment":"l","line_spacing":{"lines":0.9},"space_before":0,"bullet":null,"font":{"name":"+mj-lt","size":558800,"color":"dk1"}},{"alignment":"l","line_spacing":{"lines":0.9},"space_before":0,"bullet":null,"font":{"name":"+mj-lt","size":558800,"color":"dk1"}},{"alignment":"l","line_spacing":{"lines":0.9},"space_before":0,"bullet":null,"font":{"name":"+mj-lt","size":558800,"color":"dk1"}},{"alignment":"l","line_spacing":{"lines":0.9},"space_before":0,"bullet":null,"font":{"name":"+mj-lt","size":558800,"color":"dk1"}},{"alignment":"l","line_spacing":{"lines":0.9},"space_before":0,"bullet":null,"font":{"name":"+mj-lt","size":558800,"color":"dk1"}}]` |
100
- | `body` | `[{"alignment":"l","line_spacing":{"lines":0.9},"space_before":127000,"bullet":"•","bullet_font":"Arial","margin_left":228600,"indent":-228600,"font":{"name":"+mn-lt","size":355600,"color":"dk1"}},{"alignment":"l","line_spacing":{"lines":0.9},"space_before":63500,"bullet":"•","bullet_font":"Arial","margin_left":685800,"indent":-228600,"font":{"name":"+mn-lt","size":304800,"color":"dk1"}},{"alignment":"l","line_spacing":{"lines":0.9},"space_before":63500,"bullet":"•","bullet_font":"Arial","margin_left":1143000,"indent":-228600,"font":{"name":"+mn-lt","size":254000,"color":"dk1"}},{"alignment":"l","line_spacing":{"lines":0.9},"space_before":63500,"bullet":"•","bullet_font":"Arial","margin_left":1600200,"indent":-228600,"font":{"name":"+mn-lt","size":228600,"color":"dk1"}},{"alignment":"l","line_spacing":{"lines":0.9},"space_before":63500,"bullet":"•","bullet_font":"Arial","margin_left":2057400,"indent":-228600,"font":{"name":"+mn-lt","size":228600,"color":"dk1"}},{"alignment":"l","line_spacing":{"lines":0.9},"space_before":63500,"bullet":"•","bullet_font":"Arial","margin_left":2514600,"indent":-228600,"font":{"name":"+mn-lt","size":228600,"color":"dk1"}},{"alignment":"l","line_spacing":{"lines":0.9},"space_before":63500,"bullet":"•","bullet_font":"Arial","margin_left":2971800,"indent":-228600,"font":{"name":"+mn-lt","size":228600,"color":"dk1"}},{"alignment":"l","line_spacing":{"lines":0.9},"space_before":63500,"bullet":"•","bullet_font":"Arial","margin_left":3429000,"indent":-228600,"font":{"name":"+mn-lt","size":228600,"color":"dk1"}},{"alignment":"l","line_spacing":{"lines":0.9},"space_before":63500,"bullet":"•","bullet_font":"Arial","margin_left":3886200,"indent":-228600,"font":{"name":"+mn-lt","size":228600,"color":"dk1"}}]` |
101
- | `other` | `[{"alignment":"l","margin_left":0,"font":{"name":"+mn-lt","size":228600,"color":"dk1"}},{"alignment":"l","margin_left":457200,"font":{"name":"+mn-lt","size":228600,"color":"dk1"}},{"alignment":"l","margin_left":914400,"font":{"name":"+mn-lt","size":228600,"color":"dk1"}},{"alignment":"l","margin_left":1371600,"font":{"name":"+mn-lt","size":228600,"color":"dk1"}},{"alignment":"l","margin_left":1828800,"font":{"name":"+mn-lt","size":228600,"color":"dk1"}},{"alignment":"l","margin_left":2286000,"font":{"name":"+mn-lt","size":228600,"color":"dk1"}},{"alignment":"l","margin_left":2743200,"font":{"name":"+mn-lt","size":228600,"color":"dk1"}},{"alignment":"l","margin_left":3200400,"font":{"name":"+mn-lt","size":228600,"color":"dk1"}},{"alignment":"l","margin_left":3657600,"font":{"name":"+mn-lt","size":228600,"color":"dk1"}}]` |
99
+ | `title` | `[{"alignment":"l","line_spacing":{"lines":0.9},"space_before":0,"bullet":null,"font":{"name":"+mj-lt","size":558800,"color":"tx1"}},{"alignment":"l","line_spacing":{"lines":0.9},"space_before":0,"bullet":null,"font":{"name":"+mj-lt","size":558800,"color":"tx1"}},{"alignment":"l","line_spacing":{"lines":0.9},"space_before":0,"bullet":null,"font":{"name":"+mj-lt","size":558800,"color":"tx1"}},{"alignment":"l","line_spacing":{"lines":0.9},"space_before":0,"bullet":null,"font":{"name":"+mj-lt","size":558800,"color":"tx1"}},{"alignment":"l","line_spacing":{"lines":0.9},"space_before":0,"bullet":null,"font":{"name":"+mj-lt","size":558800,"color":"tx1"}},{"alignment":"l","line_spacing":{"lines":0.9},"space_before":0,"bullet":null,"font":{"name":"+mj-lt","size":558800,"color":"tx1"}},{"alignment":"l","line_spacing":{"lines":0.9},"space_before":0,"bullet":null,"font":{"name":"+mj-lt","size":558800,"color":"tx1"}},{"alignment":"l","line_spacing":{"lines":0.9},"space_before":0,"bullet":null,"font":{"name":"+mj-lt","size":558800,"color":"tx1"}},{"alignment":"l","line_spacing":{"lines":0.9},"space_before":0,"bullet":null,"font":{"name":"+mj-lt","size":558800,"color":"tx1"}}]` |
100
+ | `body` | `[{"alignment":"l","line_spacing":{"lines":0.9},"space_before":127000,"bullet":"•","bullet_font":"Arial","margin_left":228600,"indent":-228600,"font":{"name":"+mn-lt","size":355600,"color":"tx1"}},{"alignment":"l","line_spacing":{"lines":0.9},"space_before":63500,"bullet":"•","bullet_font":"Arial","margin_left":685800,"indent":-228600,"font":{"name":"+mn-lt","size":304800,"color":"tx1"}},{"alignment":"l","line_spacing":{"lines":0.9},"space_before":63500,"bullet":"•","bullet_font":"Arial","margin_left":1143000,"indent":-228600,"font":{"name":"+mn-lt","size":254000,"color":"tx1"}},{"alignment":"l","line_spacing":{"lines":0.9},"space_before":63500,"bullet":"•","bullet_font":"Arial","margin_left":1600200,"indent":-228600,"font":{"name":"+mn-lt","size":228600,"color":"tx1"}},{"alignment":"l","line_spacing":{"lines":0.9},"space_before":63500,"bullet":"•","bullet_font":"Arial","margin_left":2057400,"indent":-228600,"font":{"name":"+mn-lt","size":228600,"color":"tx1"}},{"alignment":"l","line_spacing":{"lines":0.9},"space_before":63500,"bullet":"•","bullet_font":"Arial","margin_left":2514600,"indent":-228600,"font":{"name":"+mn-lt","size":228600,"color":"tx1"}},{"alignment":"l","line_spacing":{"lines":0.9},"space_before":63500,"bullet":"•","bullet_font":"Arial","margin_left":2971800,"indent":-228600,"font":{"name":"+mn-lt","size":228600,"color":"tx1"}},{"alignment":"l","line_spacing":{"lines":0.9},"space_before":63500,"bullet":"•","bullet_font":"Arial","margin_left":3429000,"indent":-228600,"font":{"name":"+mn-lt","size":228600,"color":"tx1"}},{"alignment":"l","line_spacing":{"lines":0.9},"space_before":63500,"bullet":"•","bullet_font":"Arial","margin_left":3886200,"indent":-228600,"font":{"name":"+mn-lt","size":228600,"color":"tx1"}}]` |
101
+ | `other` | `[{"alignment":"l","margin_left":0,"font":{"name":"+mn-lt","size":228600,"color":"tx1"}},{"alignment":"l","margin_left":457200,"font":{"name":"+mn-lt","size":228600,"color":"tx1"}},{"alignment":"l","margin_left":914400,"font":{"name":"+mn-lt","size":228600,"color":"tx1"}},{"alignment":"l","margin_left":1371600,"font":{"name":"+mn-lt","size":228600,"color":"tx1"}},{"alignment":"l","margin_left":1828800,"font":{"name":"+mn-lt","size":228600,"color":"tx1"}},{"alignment":"l","margin_left":2286000,"font":{"name":"+mn-lt","size":228600,"color":"tx1"}},{"alignment":"l","margin_left":2743200,"font":{"name":"+mn-lt","size":228600,"color":"tx1"}},{"alignment":"l","margin_left":3200400,"font":{"name":"+mn-lt","size":228600,"color":"tx1"}},{"alignment":"l","margin_left":3657600,"font":{"name":"+mn-lt","size":228600,"color":"tx1"}}]` |
102
102
 
103
103
  ### `TEXT_FALLBACK`
104
104
 
@@ -113,7 +113,7 @@ What text has where not even a master's text styles say: 18 pt in the theme's mi
113
113
  | `indent` | `0` |
114
114
  | `font.name` | `"+mn-lt"` |
115
115
  | `font.size` | `228600` |
116
- | `font.color` | `"dk1"` |
116
+ | `font.color` | `"tx1"` |
117
117
 
118
118
  ### `TEXT_INSETS`
119
119
 
@@ -169,6 +169,80 @@ A shape's shadow where a `shadow` in a deck's slides file or `shape.shadow` says
169
169
  | `angle` | `45` |
170
170
  | `transparency` | `0.6` |
171
171
 
172
+ ### `PLAYBACK_DEFAULTS`
173
+
174
+ How a movie or a sound plays where its `playback` in a deck's slides file (or `add_movie`'s and `add_audio`'s) says nothing: it starts as it comes on, at PowerPoint's 80 % of its sound in a PowerPoint file (presenting and a render play it at its own level), and a sound's icon (`icon`, EMU) is half an inch square.
175
+
176
+ | Key | Value |
177
+ | --- | --- |
178
+ | `start` | `"auto"` |
179
+ | `volume` | `0.8` |
180
+ | `icon` | `457200` |
181
+
182
+ ### `LINE_DEFAULTS`
183
+
184
+ A line where a deck's slides file (`line_cap`, `line_join`, `line_compound`) or `shape.line` (`cap_type`, `join_type`, `compound_type`) says nothing: flat ends, mitred corners (the Office theme's lines', limited to 8 widths), one line.
185
+
186
+ | Key | Value |
187
+ | --- | --- |
188
+ | `cap` | `"flat"` |
189
+ | `join` | `"miter"` |
190
+ | `compound` | `"sng"` |
191
+
192
+ ### `PATTERN_DEFAULTS`
193
+
194
+ A pattern fill's colours where a deck's slides file (`pattern: { preset }`) or `fill.patterned()` says none: its foreground, `fg`, and its background, `bg`.
195
+
196
+ | Key | Value |
197
+ | --- | --- |
198
+ | `fg` | `"accent1"` |
199
+ | `bg` | `"bg1"` |
200
+
201
+ ### `TILE_DEFAULTS`
202
+
203
+ A tiled picture fill where `picture_fill.tile` (or `fill.picture`'s `tile`) says nothing: its own size each way, its first tile at the top left, not moved (`offset_x`, `offset_y` in EMU; the slides file's `x` and `y` are points).
204
+
205
+ | Key | Value |
206
+ | --- | --- |
207
+ | `scale_x` | `1` |
208
+ | `scale_y` | `1` |
209
+ | `offset_x` | `0` |
210
+ | `offset_y` | `0` |
211
+ | `align` | `"tl"` |
212
+
213
+ ### `INNER_SHADOW_DEFAULTS`
214
+
215
+ A shadow inside a shape where `inner_shadow` in a deck's slides file or `shape.inner_shadow` says nothing, as PowerPoint's Inside: Top Left: `color`, `blur` and `distance` (EMU), `angle` (degrees clockwise from the right), `transparency` (a share).
216
+
217
+ | Key | Value |
218
+ | --- | --- |
219
+ | `color.rgb` | `"#000000"` |
220
+ | `blur` | `63500` |
221
+ | `distance` | `50800` |
222
+ | `angle` | `45` |
223
+ | `transparency` | `0.5` |
224
+
225
+ ### `GLOW_DEFAULTS`
226
+
227
+ A glow where `glow` in a deck's slides file or `shape.glow` says nothing, as PowerPoint's 5 pt glow in Accent 1: `color`, `size` (EMU), `transparency` (a share).
228
+
229
+ | Key | Value |
230
+ | --- | --- |
231
+ | `color` | `"accent1"` |
232
+ | `size` | `63500` |
233
+ | `transparency` | `0.6` |
234
+
235
+ ### `REFLECTION_DEFAULTS`
236
+
237
+ A reflection where `reflection` in a deck's slides file or `shape.reflection` says nothing, as PowerPoint's Tight Reflection: Touching: `transparency` where it starts and `size` (shares), `distance` and `blur` (EMU).
238
+
239
+ | Key | Value |
240
+ | --- | --- |
241
+ | `transparency` | `0.5` |
242
+ | `size` | `0.35` |
243
+ | `distance` | `0` |
244
+ | `blur` | `6350` |
245
+
172
246
  ### `SLIDE_SECONDS`
173
247
 
174
248
  A slide's window on the stage's clock, seconds: a still of it is drawn at its end, when what moves in its components has settled. It is also how long a component moves, which its `dur` changes (in the slides file, or `add_component`'s `{ dur }`): its slide rests no sooner, and a PowerPoint file's video of it is that long.
package/docs/image.md CHANGED
@@ -49,7 +49,7 @@ export default image({
49
49
  });
50
50
  ```
51
51
 
52
- A picture a board starts from is never changed: a pixel edit (a matte, a part removed, the picture expanded) is a new file beside it, recorded in its `.gen.json`, which a layer then shows.
52
+ A picture a board starts from is never changed: a pixel edit (a matte, a part removed, the picture expanded) is a new file beside it, recorded in its `.provenance`, which a layer then shows.
53
53
 
54
54
  ## `image()`
55
55
 
package/docs/pictures.md CHANGED
@@ -52,7 +52,7 @@ Besides these, the layer options of any graphic layer: `at`, `until`, `dur`, `z`
52
52
  A picture's pixels are changed by AllyHub's cloud tools, each its own command (`allyhub ai-media <tool>`; `allyhub help ai-media <tool>` gives its input, its limits and its price): `generate-image`, `edit-image` (where a `mask` or a `markup` says, when given), `extend-image` and `cut-out-image` (the cut-out and its matte). A picture's parts as layers are the agent's to make: a part cut out (`cut-out-image`) and the picture without it (`edit-image` with a mask). No tool takes a model: what serves each is the cloud's to choose.
53
53
 
54
54
  - **A picture on this computer** goes in by the address `allyhub upload` gives it.
55
- - **What a call makes** is a new file, never the picture given changed, with its record beside it (`<file>.gen.json`: the tool, the whole input, what it returned, the credits). The same call to the same `--file` finds that file and calls nothing. Files the output names deeper (a matte, the layers) are downloaded beside it, each listed in the result.
55
+ - **What a call makes** is a new file, never the picture given changed, with its record beside it (`<file>.provenance`: the tool, the whole input, what it returned, the credits). The same call to the same `--file` finds that file and calls nothing. Files the output names deeper (a matte, the layers) are downloaded beside it, each listed in the result.
56
56
  - **Outside a mask** the model may redraw a little: what is kept exactly, and how, is the code's.
57
57
  - **A Mark up note's region** is SVG path data in the pixels of the picture whose file it names.
58
58
 
package/docs/project.md CHANGED
@@ -245,7 +245,7 @@ export default video({
245
245
  ```
246
246
 
247
247
  - **Media** (pictures `png jpg jpeg webp gif svg avif`; sound `mp3 wav m4a ogg aac flac`; video `mp4 webm mov m4v qt`; fonts `woff2 woff ttf otf`; 3D `glb gltf bin ktx2`, environments `hdr exr`) imports as a `MediaInfo`: `path` from the project's root, `sha256`, `kind`, `width` and `height`, `duration`, `audio`, and what the build measured (`words`, `loudness`, `tempo`, `faces`, `matte`…). `url` is where the stage loads it, valid only at run time; a media value turned into a string is its `url` (`img.src = logo`).
248
- - **Beside a media file**, files of the same name add to it: `<name>.words.json` (its word times: the file is a take, [speech.md](speech.md)), `<name>.elements.json` (a screenshot's named element boxes, `elements`), `<file>.gen.json` (how the file was made: `gen`; move it with its file).
248
+ - **Beside a media file**, files of the same name add to it: `<name>.words.json` (its word times: the file is a take, [speech.md](speech.md)), `<name>.elements.json` (a screenshot's named element boxes, `elements`), `<file>.provenance` (how the file was made: `gen`; move it with its file).
249
249
  - **Data**: CSV imports as an array of objects keyed by the header row, a column whose every value is a number as numbers; YAML as its value; JSON as usual.
250
250
  - A file that is not there is AK-A001; one of the wrong kind AK-A003; a picture on the stage that does not load AK-A005.
251
251
 
package/docs/sheets.md CHANGED
@@ -58,7 +58,7 @@ Its JSON Schema is `https://allyhub.com/schemas/sheet.schema.json`.
58
58
  | `title` | The workbook's title |
59
59
  | `names` | Defined names: a constant, or a place or formula after `=`; `hidden_names` lists those Excel's Name Manager does not show |
60
60
  | `sheets[]` | `name`, at most 31 characters, none of `\ / ? * [ ] :`; `hidden`; `freeze`, the first cell that scrolls; `gridlines: false`; `tab`, its tab's colour; `names`, its own, read on it before the workbook's and from elsewhere as `Sheet!name` |
61
- | `sheets[].tables[]` | `name`, `at` (its header's top left), `rows` (a CSV file from the sheet's folder), `key`, `style` (Excel's, `TableStyleMedium2` unless it says, `none` for none), `columns` (by name: `formula`, `format`, a look, `width`, `files`) |
61
+ | `sheets[].tables[]` | `name`, `at` (its header's top left), `rows` (a CSV file from the sheet's folder), `key`, `style` (Excel's, `TableStyleMedium2` unless it says, `none` for none), Table Style Options `banded_rows` (unless `false`), `banded_columns`, `first_column`, `last_column`, `columns` (by name: `formula`, `format`, a look, `width`, `files`) |
62
62
  | `sheets[].columns` | By letter: `width` in pixels, `hidden`, `format`, a look, `files` (see [Files in a cell](#files-in-a-cell)) |
63
63
  | `sheets[].charts[]` | A chart over the cells: see [Charts](#charts) |
64
64
  | `sheets[].rows` | By number: `height` in pixels, `hidden`, `format`, a look |
@@ -66,20 +66,29 @@ Its JSON Schema is `https://allyhub.com/schemas/sheet.schema.json`.
66
66
  | `sheets[].format` | A list of `{ range, format, …look }`: later entries win over earlier ones, a cell's own look wins over them |
67
67
  | `sheets[].merges` | Merged ranges |
68
68
  | `sheets[].blocks` | `{ at, rows }`: a CSV file of typed cells, from a cell |
69
- | `sheets[].filter` | An AutoFilter on a range: `{ range, columns }`, its columns by letter, each `{ values, blanks }`: what it keeps, as the column shows it. A table's is `tables[].filter`, `{ columns }` by column name, or `false` for no buttons. What it hides is worked out, never written |
69
+ | `sheets[].filter` | An AutoFilter on a range: `{ range, columns }`, its columns by letter, each `{ values, blanks }`, what it keeps as the column shows it, or Excel's Custom AutoFilter `{ conditions: [{ operator, value }], or }` (`equal`, `notEqual`, `greaterThan`, `greaterThanOrEqual`, `lessThan`, `lessThanOrEqual`; text with `*` and `?`), Top 10 `{ top: { count, percent, bottom } }`, `{ average: above }` or `below`, or `{ color: { fill } }` or `{ font }`. A table's is `tables[].filter`, `{ columns }` by column name, or `false` for no buttons. What it hides is worked out, never written |
70
70
  | `sheets[].conditional` | Conditional formats, the first the strongest: `{ range, type, …, stop }`; ranges apart by spaces. See below |
71
71
  | `sheets[].validations` | Data validation: `{ range, type, operator, formula, values, blank, dropdown, prompt, error }`. See below |
72
72
  | `checks` | `{ name, formula }`: a formula that must hold. One that is false, 0 or an error is a problem (AK-M009) |
73
73
  | `scenarios` | Named sets of inputs, each what names hold instead: see [Scenarios](#scenarios) |
74
74
  | `iteration` | Excel's iterative calculation: `true`, or `{ max_iterations, max_change }` (Excel's 100 and 0.001 unless it says). A circular reference is then computed again until it settles |
75
75
 
76
- A **cell** is YAML's value: a number, `true`, text; text that starts with `=` is a formula. In a `{ … }` a formula with a comma or a bracket is quoted. Its long form is `{ value | formula, format, name, start, …look }`: `name` is a defined name for that cell; `start` is what a formula's cell holds before it is computed, where [iterative calculation](#formulas) starts, as an Excel cell keeps its last value.
76
+ A **cell** is YAML's value: a number, `true`, text; text that starts with `=` is a formula. In a `{ … }` a formula with a comma or a bracket is quoted. Its long form is `{ value | formula | runs, format, name, start, …look }`: `name` is a defined name for that cell; `start` is what a formula's cell holds before it is computed, where [iterative calculation](#formulas) starts, as an Excel cell keeps its last value.
77
+
78
+ **Rich text** is a cell's `runs` in place of its `value`: its text in parts, each `{ text, bold, italic, underline, strike, font, size, color, script }` (`script` is `superscript` or `subscript`), what a run does not say being the cell's look. The cell's value is the runs' text joined, and it is text whatever it reads as. Runs are a loose cell's, never a range key's, a table's or a CSV block's, whose cells are plain text.
79
+
80
+ ```yaml
81
+ A1:
82
+ runs:
83
+ - text: "Revenue "
84
+ - { text: "(USD, millions)", italic: true, color: "#808080" }
85
+ ```
77
86
 
78
87
  A **range key** (`B3:M3`) gives one value or formula to every cell in it. A formula is written for its first cell and moved as a fill moves it: relative references shift, `$` ones stay. A single cell's key wins over a range's, and a later range over an earlier one; `B5: null` keeps a cell of a range empty.
79
88
 
80
- `format` is Excel's number format code. A **look** is `bold`, `italic`, `underline` (`true` or Excel's `single`, `double`, `singleAccounting`, `doubleAccounting`), `strike`, `font`, `size`, `color` and `fill` (`#RRGGBB`; a fill may be `{ pattern, color, background }`), `align`, `valign`, `wrap`, `shrink`, `indent`, `rotation`, `border` (`left`, `right`, `top`, `bottom`, each `{ style, color }`). Later `format` entries win field by field, and a `border` side by side, so `{ style: none }` takes one side away.
89
+ `format` is Excel's number format code. A **look** is `bold`, `italic`, `underline` (`true` or Excel's `single`, `double`, `singleAccounting`, `doubleAccounting`), `strike`, `font`, `size`, `color` and `fill` (`#RRGGBB`; a fill may be `{ pattern, color, background }`), `align`, `valign`, `wrap`, `shrink`, `indent`, `rotation`, `border` (`left`, `right`, `top`, `bottom`, each `{ style, color }`), and Format Cells › Protection's `locked` (a cell is locked unless it says `false`, which lets a person change it on a protected sheet) and `hide_formula` (its formula not shown on a protected sheet). Later `format` entries win field by field, and a `border` side by side, so `{ style: none }` takes one side away.
81
90
 
82
- **Conditional formats.** A `type` is Excel's, and a rule that gives a look says it in the rule: `bold`, `italic`, `underline`, `strike`, `color`, `fill`, `border`.
91
+ **Conditional formats.** A `type` is Excel's, and a rule that gives a look says it in the rule: `bold`, `italic`, `underline`, `strike`, `color`, `fill`, `border`, and `format`, the number format the cell shows while it holds.
83
92
 
84
93
  | `type` | With |
85
94
  | ------------------------------------ | -------------------------------------------------------------------------------------------- |
@@ -106,7 +115,7 @@ They are text, so a formula counts one with a wildcard, `=COUNTIF(D:D,"*vip*")`,
106
115
 
107
116
  ### For the file
108
117
 
109
- A worksheet holds what Excel prints and shows around its cells. Each goes in the `.xlsx`. A PDF prints by `print` as Excel does; the grid and a PDF do not draw links, notes, pictures and outlines yet.
118
+ A worksheet holds what Excel prints and shows around its cells. Each goes in the `.xlsx`. A PDF prints by `print` as Excel does, and its links are links; the editor shows notes, links and outlines as Excel does, and a PDF, like Excel's, prints no notes.
110
119
 
111
120
  ```yaml
112
121
  sheets:
@@ -125,12 +134,13 @@ sheets:
125
134
  pictures:
126
135
  - { file: files/logo.png, at: B1, x: 4, y: 4, height: 40 } # over the cells; pixels
127
136
  rows: { 12: { level: 1 } } # grouped, 1 to 7; columns too
128
- protect: true # Protect Sheet, with no password
137
+ outline: { summary_below: false } # a group's summary row above it; summary_right for columns
138
+ protect: true # Protect Sheet, with no password; a cell's look `locked: false` lets it change
129
139
  ```
130
140
 
131
141
  `allyhub render` says, with each Excel file, how each sheet prints (its pages across and down and its scale), the cells whose text its column and the empty cells after it cannot hold (Excel cuts it where the next cell starts), the numbers wider than their column (Excel shows ####), counted in characters of Calibri 11's digit as Excel counts a column's width, and the numbers of 1,000 or more with no number format.
132
142
 
133
- In a script: `ws.page_setup.orientation`, `.paperSize`, `.fitToWidth`, `.fitToHeight`, `ws.page_margins.left`, `ws.print_area`, `ws.print_title_rows`, `ws.print_title_cols`, `ws.oddFooter.right.text`, `cell.hyperlink`, `cell.comment = new Comment("Check", "Finance")`, `ws.add_image(new Image("files/logo.png"), "B1")`, `ws.row_dimensions[12].outlineLevel`, `ws.protection.sheet`.
143
+ In a script: `ws.page_setup.orientation`, `.paperSize`, `.fitToWidth`, `.fitToHeight`, `ws.page_margins.left`, `ws.print_area`, `ws.print_title_rows`, `ws.print_title_cols`, `ws.oddFooter.right.text`, `cell.hyperlink`, `cell.comment = new Comment("Check", "Finance")`, `ws.add_image(new Image("files/logo.png"), "B1")`, `ws.row_dimensions[12].outlineLevel`, `ws.protection.sheet`, `cell.protection = new Protection({ locked: false })`.
134
144
 
135
145
  ### Files in a cell
136
146
 
@@ -414,7 +424,7 @@ A name of openpyxl's that is not held throws where it is used, naming what the c
414
424
  **In.** `allyhub sheet import <file.xlsx>` reads a file whatever wrote it and writes what it means as short text: neighbours with one formula as one range key, a table as a table, a column of one formula as a calculated column, a large rectangle of typed cells as a CSV file, looks as rectangles. It prints:
415
425
 
416
426
  - Excel's scenarios come in by the names of the cells they set; a cell with no name is said, and a `Base case` that holds what the cells hold is left out.
417
- - `Not carried over:` VBA, pivot tables, a chart of a kind a sheet has none of (radar, stock, surface, bubble, 3-D, a pie or a scatter among other kinds) or whose numbers are written in it, shapes, links to other workbooks, a protection's password, page breaks, rich text (kept as text), filters by condition, kinds of rule the format has no place for, and so on, with where. Notes, links, pictures (beside the workbook file), outlines, Page Layout, protection, a sheet's own names and hidden names come in.
427
+ - `Not carried over:` VBA, pivot tables, a chart of a kind a sheet has none of (radar, stock, surface, bubble, 3-D, a pie or a scatter among other kinds) or whose numbers are written in it, shapes, links to other workbooks, a protection's password, rich text in a table (kept as text), filters by date, kinds of rule the format has no place for, a chart's trendlines and error bars, the names of cell styles, and so on, with where. Notes, links, pictures (beside the workbook file), outlines, Page Layout with its scale and page breaks, protection with each cell's Locked and Hidden, Table Style Options, a sheet's own names and hidden names come in.
418
428
  - A formula that cannot be computed here (a function the engine does not have, another workbook) keeps its value, listed with its cell and why. An array formula over several cells is its first cell's, and the others spill from it.
419
429
  - `Computed here against the file:` every formula's result compared with the value the file holds, each difference with its cell (`--tolerance` is how close numbers must be, `--all` lists every one; a formula that reads the clock or a random number is not compared). JSON has every difference.
420
430