@allyhub/sdk 0.16.0 → 0.17.1
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.
- package/CHANGELOG.md +13 -0
- package/dist/node_modules/@allyhub/audio/dist/index.d.ts +1 -0
- package/dist/node_modules/@allyhub/audio/dist/index.js +1 -1
- package/dist/node_modules/@allyhub/audio/dist/place.d.ts +26 -0
- package/dist/node_modules/@allyhub/audio/dist/place.js +2 -0
- package/dist/node_modules/@allyhub/audio/package.json +1 -1
- package/dist/node_modules/@allyhub/chart/package.json +1 -1
- package/dist/node_modules/@allyhub/diagnostics/package.json +1 -1
- package/dist/node_modules/@allyhub/formats/dist/data/slides.d.ts +15 -3
- package/dist/node_modules/@allyhub/formats/dist/data/slides.js +1 -1
- package/dist/node_modules/@allyhub/formats/dist/items.d.ts +40 -7
- package/dist/node_modules/@allyhub/formats/dist/items.js +1 -1
- package/dist/node_modules/@allyhub/formats/dist/schemas.d.ts +4 -0
- package/dist/node_modules/@allyhub/formats/package.json +1 -1
- package/dist/node_modules/@allyhub/image-draw/dist/stage.js +1 -1
- package/dist/node_modules/@allyhub/image-draw/package.json +1 -1
- package/dist/node_modules/@allyhub/image-measure/package.json +1 -1
- package/dist/node_modules/@allyhub/image-sdk/package.json +1 -1
- package/dist/node_modules/@allyhub/measure/package.json +1 -1
- package/dist/node_modules/@allyhub/ooxml/package.json +1 -1
- package/dist/node_modules/@allyhub/piece/dist/layer.d.ts +15 -0
- package/dist/node_modules/@allyhub/piece/dist/page/index.d.ts +1 -0
- package/dist/node_modules/@allyhub/piece/dist/page/index.js +1 -1
- package/dist/node_modules/@allyhub/piece/dist/page/runtimes.d.ts +9 -0
- package/dist/node_modules/@allyhub/piece/dist/page/runtimes.js +2 -0
- package/dist/node_modules/@allyhub/piece/dist/source.d.ts +51 -10
- package/dist/node_modules/@allyhub/piece/dist/source.js +1 -1
- package/dist/node_modules/@allyhub/piece/package.json +1 -1
- package/dist/node_modules/@allyhub/protocol/dist/account.d.ts +0 -6
- package/dist/node_modules/@allyhub/protocol/dist/account.js +1 -1
- package/dist/node_modules/@allyhub/protocol/dist/events.d.ts +39 -0
- package/dist/node_modules/@allyhub/protocol/dist/events.js +1 -1
- package/dist/node_modules/@allyhub/protocol/dist/frame.d.ts +3 -0
- package/dist/node_modules/@allyhub/protocol/dist/frame.js +1 -1
- package/dist/node_modules/@allyhub/protocol/dist/kinds.d.ts +30 -0
- package/dist/node_modules/@allyhub/protocol/dist/kinds.js +1 -1
- package/dist/node_modules/@allyhub/protocol/dist/tools.d.ts +6 -0
- package/dist/node_modules/@allyhub/protocol/dist/tools.js +1 -1
- package/dist/node_modules/@allyhub/protocol/package.json +1 -1
- package/dist/node_modules/@allyhub/runtimes/package.json +1 -1
- package/dist/node_modules/@allyhub/scenery/package.json +1 -1
- package/dist/node_modules/@allyhub/sheet/dist/calc/coerce.js +1 -1
- package/dist/node_modules/@allyhub/sheet/dist/calc/engine.d.ts +12 -0
- package/dist/node_modules/@allyhub/sheet/dist/calc/engine.js +1 -1
- package/dist/node_modules/@allyhub/sheet/dist/calc/functions/criteria.js +1 -1
- package/dist/node_modules/@allyhub/sheet/dist/calc/functions/date.js +1 -1
- package/dist/node_modules/@allyhub/sheet/dist/calc/functions/dynamic.js +1 -1
- package/dist/node_modules/@allyhub/sheet/dist/calc/functions/info.js +1 -1
- package/dist/node_modules/@allyhub/sheet/dist/calc/functions/logical.js +1 -1
- package/dist/node_modules/@allyhub/sheet/dist/calc/functions/lookup.js +1 -1
- package/dist/node_modules/@allyhub/sheet/dist/calc/functions/text.js +1 -1
- package/dist/node_modules/@allyhub/sheet/dist/formula/parse.js +1 -1
- package/dist/node_modules/@allyhub/sheet/dist/xlsx/charts.d.ts +1 -1
- package/dist/node_modules/@allyhub/sheet/dist/xlsx/charts.js +1 -1
- package/dist/node_modules/@allyhub/sheet/dist/xlsx/import.js +1 -1
- package/dist/node_modules/@allyhub/sheet/dist/xlsx/read.js +2 -2
- package/dist/node_modules/@allyhub/sheet/dist/xlsx/write.js +1 -1
- package/dist/node_modules/@allyhub/sheet/package.json +1 -1
- package/dist/node_modules/@allyhub/slides-core/dist/animation.d.ts +10 -0
- package/dist/node_modules/@allyhub/slides-core/dist/animation.js +1 -1
- package/dist/node_modules/@allyhub/slides-core/dist/api.js +1 -1
- package/dist/node_modules/@allyhub/slides-core/dist/components.js +1 -1
- package/dist/node_modules/@allyhub/slides-core/dist/model.d.ts +3 -1
- package/dist/node_modules/@allyhub/slides-core/dist/resolve.d.ts +5 -0
- package/dist/node_modules/@allyhub/slides-core/dist/resolve.js +1 -1
- package/dist/node_modules/@allyhub/slides-core/package.json +1 -1
- package/dist/node_modules/@allyhub/video-core/package.json +1 -1
- package/dist/node_modules/@allyhub/video-sdk/dist/free.d.ts +1 -1
- package/dist/node_modules/@allyhub/video-sdk/package.json +1 -1
- package/docs/docs.md +11 -0
- package/docs/layers.md +2 -0
- package/docs/slides.md +1 -1
- package/package.json +1 -1
package/docs/slides.md
CHANGED
|
@@ -179,7 +179,7 @@ slides: []
|
|
|
179
179
|
| `slides[].shapes` | Its shapes by name: what it changes of its layout's placeholders, and its own |
|
|
180
180
|
| `slides[].background` | Its own background over its layout's: one of `fill` (a colour), `gradient` (as a shape's) or `picture` (a file, stretched over the slide) |
|
|
181
181
|
|
|
182
|
-
A shape there changes a placeholder of the slide's layout (or a generated shape) with `frame` (`{ x, y, w, h }` in points), `text` (on all of its text, every level, as PowerPoint sets a selected shape's: `size` in points, `bold`, `italic`, `underline`, `strike`, `color`, `font`, a family, `align`: `l`, `ctr`, `r`, `just`, `line_spacing`, a multiple of single spacing, `1.5`, `space_before` and `space_after` in points, or `{ lines: 0.5 }`, a share of a line at the text's size, `anchor`, where the text stands in its shape: `t`, `ctr`, `b`, `orientation`, which way it runs (PowerPoint's Text Direction): `horz`, `vert` (turned 90°), `vert270`, `eaVert` (East Asian vertical), `wordArtVert` (stacked), `wordArtVertRtl`, `mongolianVert`, `underline`, `true` or a style (`dbl`, `heavy`, `dotted`, `dottedHeavy`, `dash`, `dashHeavy`, `dashLong`, `dashLongHeavy`, `dotDash`, `dotDashHeavy`, `dotDotDash`, `dotDotDashHeavy`, `wavy`, `wavyHeavy`, `wavyDbl`, `words`), `strike`, `true` or `dblStrike`, `caps`, `small` or `all` (`none` over a level that has them), `bullet`, a character, `"•"`, or `false` for none, `numbered`, its paragraphs counted in place of a bullet, any of ECMA-376's 41 schemes (`arabicPeriod`, `arabicParenR`, `arabicParenBoth`, `arabicPlain`, `alphaLcPeriod`, `alphaUcParenR`, `romanUcPeriod`, `circleNumDbPlain`, `ea1ChsPeriod`…), `start_at`, the number it starts at, `bullet_color`, its bullets' or numbers' colour, `bullet_size`, their size, a share of the text's (`0.75`); given both, `numbered` stands; a bullet or a number in text with no indent hangs as PowerPoint's does, and one wider than its hanging indent pushes its line's text on to the next of PowerPoint's default tab stops, an inch apart from the text's inset, as PowerPoint's does: the slides file holds no tab stops of its own), `fill` (a colour, or `none`), `fill_transparency` (a share that shows through), `gradient` (`angle`, degrees clockwise from left to right, and `stops`, each `at`, a share of the way, `color` and `transparency`; or `path`, out from a focus instead of along a line, `circle` (PowerPoint's Radial), `rect` (Rectangular) or `shape` (Path), its first stop at the focus, and `focus`, `{ left, top, right, bottom }`, the share in from each side, the middle unless said: `{ left: 0, top: 0, right: 1, bottom: 1 }` is From Top Left Corner, and a share below 0 or above 1 is beyond that side, as some files have it; a circle reaches the farthest corner, and the stage draws a rectangle's and a path's contours as an ellipse reaching the farthest side, which is what CSS has), `pattern` (PowerPoint's Pattern Fill: `preset`, any of ECMA-376's 54 (`pct5` to `pct90`, `horz`, `vert`, `ltHorz`, `dkVert`, `narHorz`, `dashHorz`, `cross`, `dnDiag`, `upDiag`, `wdDnDiag`, `dashUpDiag`, `diagCross`, `smCheck`, `lgCheck`, `smGrid`, `lgGrid`, `dotGrid`, `smConfetti`, `lgConfetti`, `horzBrick`, `diagBrick`, `solidDmnd`, `openDmnd`, `dotDmnd`, `plaid`, `sphere`, `weave`, `divot`, `shingle`, `wave`, `trellis`, `zigZag`…), `fg` and `bg` colours, `accent1` over `bg1` unless said; drawn as 8 × 8 cells a pixel each at 100%, the percentages, lines, grids, checks and diamonds as their names say, the pictorial ones near PowerPoint's), `picture_fill` (PowerPoint's Picture or Texture Fill: `path`, an image of the project from the deck's folder, stretched over the shape, or with `tile` tiled: `scale_x` and `scale_y`, shares of its own size, a pixel of it a 96th of an inch, `x` and `y` in points from where `align` puts its first tile, `tl` (the default), `t`, `tr`, `l`, `ctr`, `r`, `bl`, `b`, `br`; `transparency`, a share; a tile's mirroring in a file is drawn unmirrored, said); a shape has one fill, the first of `picture_fill`, `pattern`, `gradient` and `fill` it says, and a slide's fill of any kind stands over its placeholder's, `shadow` (`blur` and `distance` in points, `angle`, `color`, `transparency`), `inner_shadow` (a shadow inside it, the same fields, PowerPoint's Inner shadows), `glow` (`color`, `size` in points, `transparency`), `soft_edges` (points its edges fade over), `reflection` (`transparency` where it starts and `size`, the share of the shape it shows, `distance` below and `blur` in points; mirrored under the shape as PowerPoint's touching reflections; the stage draws it with CSS's reflection, which does not blur, and every effect over the shape's outline and its text as SVG's and CSS's filters), `line` (its outline: a colour, or `none`), `line_width` in points, `line_dash` (`solid`, `sysDot`, `sysDash`, `dash`, `dashDot`, `lgDash`, `lgDashDot`, `lgDashDotDot`, PowerPoint's Dashes, and `dot`, `sysDashDot`, `sysDashDotDot`, Word's; a file's own dashes, `a:custDash`, come in as `dash`), `line_cap` (how its ends and dashes end: `flat`, the default, `rnd` or `sq`), `line_join` (how its corners meet: `miter`, the default, as the Office theme's lines, `round` or `bevel`), `line_compound` (`sng`, the default, `dbl`, `thickThin`, `thinThick` or `tri`: PowerPoint's Compound type, drawn as its lines look in PowerPoint, a thick line twice a thin one; on a line with no inside, a connector or an open freeform, `thickThin` and `thinThick` are drawn as `dbl`), a line's transparency being its colour's `alpha` (`accent1 alpha 50%`), `line_begin` and `line_end` (`none`, `triangle`, `arrow`, `stealth`, `diamond`, `oval`), `line_begin_size` and `line_end_size` (`{ w, len }`, each `sm`, `med` or `lg`: the head's width and length, PowerPoint's Arrow size), `rotation` (degrees clockwise about its centre, 0 up to 360, python-pptx's `rotation`), `flip_h` and `flip_v` (`true`: mirrored left to right, top to bottom; a line runs from its frame's other corner; its text reads as it is), `crop` (a picture's: `left`, `top`, `right` and `bottom`, the share of it cut from each side, PowerPoint's `a:srcRect`; a negative share is space left beside it; the editor's Crop menu writes Fill and Fit, [pictures.md](pictures.md#a-decks-pictures)), `z`; or is the slide's own with one of `textbox: true` (its words are the script's; it wraps, and grows from its frame's `h` to its text, so its frame still has all four of `x`, `y`, `w` and `h`), `picture`, `movie` (a video file of the project; a video item goes on a slide as its render, `allyhub render`), `geometry` (any of PowerPoint's 187 preset shapes by its `prst` name, ECMA-376's `ST_ShapeType`: `rect`, `roundRect`, `ellipse`, `triangle`, `star5`, `chevron`, `rightArrow`, `wedgeRectCallout`, `heart`, `cloud`, `donut`, `flowChartProcess`…, drawn from ECMA-376's preset shape definitions as PowerPoint draws them; a connector, `line`, `straightConnector1`, `bentConnector2` to `5` or `curvedConnector2` to `5`, has the connector's line, no fill and no text, and its `line_begin` and `line_end` face along its path, and `connect: { begin: { shape, site }, end: { shape, site } }` glues its ends to shapes of the slide by name, at sites of their geometries (a rectangle's 0 top, 1 left, 2 bottom, 3 right; PowerPoint's `a:stCxn` and `a:endCxn`): its frame is then where its ends sit, and they follow the shapes; `none` lets go of an end the code glued, as dragging the end off its shape does; with `adjustments`, its handles' values in the definition's order as python-pptx's `adjustments` has them, a share each: `roundRect`'s `[0.1]` is a corner of a tenth of its shorter side), `path` (a freeform: `{ w, h, d }`, its outline in a box of `w` × `h` units stretched to its frame, `d` in SVG's `M`, `L`, `C` and `Z`, absolute, so a logo or a cursor is a real shape), `table` (`columns`, widths in points, and `rows`, each a `height` with its `fill`, `text` and `line`, a rule at its foot; `merged`, cells merged as PowerPoint's Merge Cells, each `{ row, column, rows, columns }`, its first cell from 0 and how many rows and columns it takes, one unless said, inside the table and taking no cell another merge takes, its words its first cell's; stretched to its frame, its words the script's, a list of rows, each a list of cells; `style`, one of PowerPoint's 74 built-in table styles by the name its Table Styles gallery shows (`Medium Style 2 - Accent 1`, `Light Style 1`, `Themed Style 2 - Accent 3`, `Dark Style 2 - Accent 1/Accent 2`, `No Style, Table Grid`) or its id (`{5C22544A-7EE6-4342-B048-85BDC9FD1C3A}`), drawn under what its rows set, and Table Design's options for it, `first_row` (Header Row), `last_row` (Total Row), `first_col`, `last_col`, `horz_banding` (Banded Rows) and `vert_banding`, each `true`) or `component` (with `props`, and `dur`, how long it moves), and a `frame`. `group`, a name a slide's own shapes share, makes them one group in PowerPoint, standing together where the topmost of them stands; a group in a group is the outer's name, a slash and its own (`card/lines`: those shapes are a group inside `card`, whose other shapes say `card`), as deep as wanted. A table's look is its style's under what its rows and cells say; `add_table` starts one as python-pptx and PowerPoint do, Medium Style 2 - Accent 1 with `first_row` and `horz_banding`, and `table.style` sets another by name or id (the styles' look is PowerPoint's as far as their definitions are known: their colours, bands and rules; a Dark style with no accent, which no public definition gives, is approximated). A picture or a movie put in a picture, media or object placeholder fills it. Colours are the theme's (`accent1`…) or the colour map's (`tx1`, `bg1`, `tx2`, `bg2`, which the master's map makes a theme colour: text and background on a light master, the other way on a dark one); the theme's lighter or darker, in PowerPoint's words (`accent1 lighter 40%`, `dk1 darker 25%`, a share over 0 up to 100 %), which follows a change of theme as PowerPoint's picker's tints and shades do; `#RRGGBB`; or one of them with DrawingML's transforms after it, in order (`accent1 lumMod 75% lumOff 25%`, `tx1 tint 50%`, `#4472C4 alpha 50%`, `accent2 hueOff 30°`; `tint`, `shade`, `lumMod`, `lumOff`, `lum`, `satMod`, `satOff`, `sat`, `hueMod`, `hueOff`, `hue`, `alpha`, `alphaMod`, `alphaOff`, a share in `%`, `hue` and `hueOff` in degrees), as a file PowerPoint wrote has them. In code a colour (`ColorFormat`) has python-pptx's `brightness`, -1 to 1 (`0.4` is lighter 40 %), on a theme colour only. `z` orders a shape among the slide's shapes and placeholders, so a negative `z` puts one under a placeholder's words. Paths are from the deck's module's folder.
|
|
182
|
+
A shape there changes a placeholder of the slide's layout (or a generated shape) with `frame` (`{ x, y, w, h }` in points), `text` (on all of its text, every level, as PowerPoint sets a selected shape's: `size` in points, `bold`, `italic`, `underline`, `strike`, `color`, `font`, a family, `align`: `l`, `ctr`, `r`, `just`, `line_spacing`, a multiple of single spacing, `1.5`, `space_before` and `space_after` in points, or `{ lines: 0.5 }`, a share of a line at the text's size, `anchor`, where the text stands in its shape: `t`, `ctr`, `b`, `orientation`, which way it runs (PowerPoint's Text Direction): `horz`, `vert` (turned 90°), `vert270`, `eaVert` (East Asian vertical), `wordArtVert` (stacked), `wordArtVertRtl`, `mongolianVert`, `underline`, `true` or a style (`dbl`, `heavy`, `dotted`, `dottedHeavy`, `dash`, `dashHeavy`, `dashLong`, `dashLongHeavy`, `dotDash`, `dotDashHeavy`, `dotDotDash`, `dotDotDashHeavy`, `wavy`, `wavyHeavy`, `wavyDbl`, `words`), `strike`, `true` or `dblStrike`, `caps`, `small` or `all` (`none` over a level that has them), `bullet`, a character, `"•"`, or `false` for none, `numbered`, its paragraphs counted in place of a bullet, any of ECMA-376's 41 schemes (`arabicPeriod`, `arabicParenR`, `arabicParenBoth`, `arabicPlain`, `alphaLcPeriod`, `alphaUcParenR`, `romanUcPeriod`, `circleNumDbPlain`, `ea1ChsPeriod`…), `start_at`, the number it starts at, `bullet_color`, its bullets' or numbers' colour, `bullet_size`, their size, a share of the text's (`0.75`); given both, `numbered` stands; a bullet or a number in text with no indent hangs as PowerPoint's does, and one wider than its hanging indent pushes its line's text on to the next of PowerPoint's default tab stops, an inch apart from the text's inset, as PowerPoint's does: the slides file holds no tab stops of its own), `fill` (a colour, or `none`), `fill_transparency` (a share that shows through), `gradient` (`angle`, degrees clockwise from left to right, and `stops`, each `at`, a share of the way, `color` and `transparency`; or `path`, out from a focus instead of along a line, `circle` (PowerPoint's Radial), `rect` (Rectangular) or `shape` (Path), its first stop at the focus, and `focus`, `{ left, top, right, bottom }`, the share in from each side, the middle unless said: `{ left: 0, top: 0, right: 1, bottom: 1 }` is From Top Left Corner, and a share below 0 or above 1 is beyond that side, as some files have it; a circle reaches the farthest corner, and the stage draws a rectangle's and a path's contours as an ellipse reaching the farthest side, which is what CSS has), `pattern` (PowerPoint's Pattern Fill: `preset`, any of ECMA-376's 54 (`pct5` to `pct90`, `horz`, `vert`, `ltHorz`, `dkVert`, `narHorz`, `dashHorz`, `cross`, `dnDiag`, `upDiag`, `wdDnDiag`, `dashUpDiag`, `diagCross`, `smCheck`, `lgCheck`, `smGrid`, `lgGrid`, `dotGrid`, `smConfetti`, `lgConfetti`, `horzBrick`, `diagBrick`, `solidDmnd`, `openDmnd`, `dotDmnd`, `plaid`, `sphere`, `weave`, `divot`, `shingle`, `wave`, `trellis`, `zigZag`…), `fg` and `bg` colours, `accent1` over `bg1` unless said; drawn as 8 × 8 cells a pixel each at 100%, the percentages, lines, grids, checks and diamonds as their names say, the pictorial ones near PowerPoint's), `picture_fill` (PowerPoint's Picture or Texture Fill: `path`, an image of the project from the deck's folder, stretched over the shape, or with `tile` tiled: `scale_x` and `scale_y`, shares of its own size, a pixel of it a 96th of an inch, `x` and `y` in points from where `align` puts its first tile, `tl` (the default), `t`, `tr`, `l`, `ctr`, `r`, `bl`, `b`, `br`; `transparency`, a share; a tile's mirroring in a file is drawn unmirrored, said); a shape has one fill, the first of `picture_fill`, `pattern`, `gradient` and `fill` it says, and a slide's fill of any kind stands over its placeholder's, `shadow` (`blur` and `distance` in points, `angle`, `color`, `transparency`), `inner_shadow` (a shadow inside it, the same fields, PowerPoint's Inner shadows), `glow` (`color`, `size` in points, `transparency`), `soft_edges` (points its edges fade over), `reflection` (`transparency` where it starts and `size`, the share of the shape it shows, `distance` below and `blur` in points; mirrored under the shape as PowerPoint's touching reflections; the stage draws it with CSS's reflection, which does not blur, and every effect over the shape's outline and its text as SVG's and CSS's filters), `line` (its outline: a colour, or `none`), `line_width` in points, `line_dash` (`solid`, `sysDot`, `sysDash`, `dash`, `dashDot`, `lgDash`, `lgDashDot`, `lgDashDotDot`, PowerPoint's Dashes, and `dot`, `sysDashDot`, `sysDashDotDot`, Word's; a file's own dashes, `a:custDash`, come in as `dash`), `line_cap` (how its ends and dashes end: `flat`, the default, `rnd` or `sq`), `line_join` (how its corners meet: `miter`, the default, as the Office theme's lines, `round` or `bevel`), `line_compound` (`sng`, the default, `dbl`, `thickThin`, `thinThick` or `tri`: PowerPoint's Compound type, drawn as its lines look in PowerPoint, a thick line twice a thin one; on a line with no inside, a connector or an open freeform, `thickThin` and `thinThick` are drawn as `dbl`), a line's transparency being its colour's `alpha` (`accent1 alpha 50%`), `line_begin` and `line_end` (`none`, `triangle`, `arrow`, `stealth`, `diamond`, `oval`), `line_begin_size` and `line_end_size` (`{ w, len }`, each `sm`, `med` or `lg`: the head's width and length, PowerPoint's Arrow size), `rotation` (degrees clockwise about its centre, 0 up to 360, python-pptx's `rotation`), `flip_h` and `flip_v` (`true`: mirrored left to right, top to bottom; a line runs from its frame's other corner; its text reads as it is), `crop` (a picture's: `left`, `top`, `right` and `bottom`, the share of it cut from each side, PowerPoint's `a:srcRect`; a negative share is space left beside it; the editor's Crop menu writes Fill and Fit, [pictures.md](pictures.md#a-decks-pictures)), `z`; or is the slide's own with one of `textbox: true` (its words are the script's; it wraps, and grows from its frame's `h` to its text, so its frame still has all four of `x`, `y`, `w` and `h`), `picture`, `movie` (a video file of the project; a video item goes on a slide live as `item`), `geometry` (any of PowerPoint's 187 preset shapes by its `prst` name, ECMA-376's `ST_ShapeType`: `rect`, `roundRect`, `ellipse`, `triangle`, `star5`, `chevron`, `rightArrow`, `wedgeRectCallout`, `heart`, `cloud`, `donut`, `flowChartProcess`…, drawn from ECMA-376's preset shape definitions as PowerPoint draws them; a connector, `line`, `straightConnector1`, `bentConnector2` to `5` or `curvedConnector2` to `5`, has the connector's line, no fill and no text, and its `line_begin` and `line_end` face along its path, and `connect: { begin: { shape, site }, end: { shape, site } }` glues its ends to shapes of the slide by name, at sites of their geometries (a rectangle's 0 top, 1 left, 2 bottom, 3 right; PowerPoint's `a:stCxn` and `a:endCxn`): its frame is then where its ends sit, and they follow the shapes; `none` lets go of an end the code glued, as dragging the end off its shape does; with `adjustments`, its handles' values in the definition's order as python-pptx's `adjustments` has them, a share each: `roundRect`'s `[0.1]` is a corner of a tenth of its shorter side), `path` (a freeform: `{ w, h, d }`, its outline in a box of `w` × `h` units stretched to its frame, `d` in SVG's `M`, `L`, `C` and `Z`, absolute, so a logo or a cursor is a real shape), `table` (`columns`, widths in points, and `rows`, each a `height` with its `fill`, `text` and `line`, a rule at its foot; `merged`, cells merged as PowerPoint's Merge Cells, each `{ row, column, rows, columns }`, its first cell from 0 and how many rows and columns it takes, one unless said, inside the table and taking no cell another merge takes, its words its first cell's; stretched to its frame, its words the script's, a list of rows, each a list of cells; or its words from a project file, `data` (a sheet's table, `../sales/sales.yaml#revenue`, computed as the sheet computes it, a CSV or a data file of rows, from the deck's folder): a row of the file is a row of the table, under a head row of its columns' names (`head: false`, none), `fields` its columns in their order (default all of them, as its first row has them), `rows` giving each row its look and the last one's to the rows past it, each value as its source shows it (a sheet's number formats: `1,800`, `12%`), a plain file's as it holds it; `style`, one of PowerPoint's 74 built-in table styles by the name its Table Styles gallery shows (`Medium Style 2 - Accent 1`, `Light Style 1`, `Themed Style 2 - Accent 3`, `Dark Style 2 - Accent 1/Accent 2`, `No Style, Table Grid`) or its id (`{5C22544A-7EE6-4342-B048-85BDC9FD1C3A}`), drawn under what its rows set, and Table Design's options for it, `first_row` (Header Row), `last_row` (Total Row), `first_col`, `last_col`, `horz_banding` (Banded Rows) and `vert_banding`, each `true`) or `component` (with `props`, and `dur`, how long it moves), or `item` (another item of the project drawn live, its entry from the deck's folder, `../film/teaser.ts`: drawn by its own kind in its own format, fitted to the frame and centred, in the deck's language where it has it; it plays as a movie does, by `playback`'s `start`, `trim` and `loop`, and a slide settles when its trim ends; a show plays its sound with the slide's, from where it plays (its trim, its loop); a PowerPoint file holds a picture of it as the slide shows it and a movie of its frames while it plays, at most 60 seconds, with its sound; `allyhub inspect uses` lists it, and an item that uses the deck back is AK-M016), and a `frame`. `group`, a name a slide's own shapes share, makes them one group in PowerPoint, standing together where the topmost of them stands; a group in a group is the outer's name, a slash and its own (`card/lines`: those shapes are a group inside `card`, whose other shapes say `card`), as deep as wanted. A table's look is its style's under what its rows and cells say; `add_table` starts one as python-pptx and PowerPoint do, Medium Style 2 - Accent 1 with `first_row` and `horz_banding`, and `table.style` sets another by name or id (the styles' look is PowerPoint's as far as their definitions are known: their colours, bands and rules; a Dark style with no accent, which no public definition gives, is approximated). A picture or a movie put in a picture, media or object placeholder fills it. Colours are the theme's (`accent1`…) or the colour map's (`tx1`, `bg1`, `tx2`, `bg2`, which the master's map makes a theme colour: text and background on a light master, the other way on a dark one); the theme's lighter or darker, in PowerPoint's words (`accent1 lighter 40%`, `dk1 darker 25%`, a share over 0 up to 100 %), which follows a change of theme as PowerPoint's picker's tints and shades do; `#RRGGBB`; or one of them with DrawingML's transforms after it, in order (`accent1 lumMod 75% lumOff 25%`, `tx1 tint 50%`, `#4472C4 alpha 50%`, `accent2 hueOff 30°`; `tint`, `shade`, `lumMod`, `lumOff`, `lum`, `satMod`, `satOff`, `sat`, `hueMod`, `hueOff`, `hue`, `alpha`, `alphaMod`, `alphaOff`, a share in `%`, `hue` and `hueOff` in degrees), as a file PowerPoint wrote has them. In code a colour (`ColorFormat`) has python-pptx's `brightness`, -1 to 1 (`0.4` is lighter 40 %), on a theme colour only. `z` orders a shape among the slide's shapes and placeholders, so a negative `z` puts one under a placeholder's words. Paths are from the deck's module's folder.
|
|
183
183
|
|
|
184
184
|
A slide's `animations` are PowerPoint's Animation Pane, in order, each on one of the slide's own shapes (`shape`, by name; in a block, `<slide>/<shape>`), or one `paragraph` of its text, from 0:
|
|
185
185
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@allyhub/sdk",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.17.1",
|
|
4
4
|
"description": "What an agent writes videos, decks and workbooks with: each built-in kind's authoring API, re-exported from its extension. The root, /dom, /media and /scenery are the video's: video(), parts with their speech, footage and sounds, defineComponent() and custom() layers, the layout, motion and input helpers, the scenery() layer's options; /slides is the deck's, python-pptx's API; /image is the image's, its boards each its own size; /sheets is the sheet's, openpyxl's API. Nothing a host needs.",
|
|
5
5
|
"license": "SEE LICENSE IN LICENSE.md",
|
|
6
6
|
"homepage": "https://allyhub.com",
|