@allyhub/sdk 0.14.0 → 0.15.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.
package/CHANGELOG.md CHANGED
@@ -2,6 +2,15 @@
2
2
 
3
3
  Feature highlights from each AllyHub release.
4
4
 
5
+ ## 0.15.0
6
+
7
+ - **Reports are set aside.** AllyHub no longer makes reports, and `allyhub report style` is gone. Write a page of findings as a doc, a sheet or a deck instead.
8
+
9
+ ## 0.14.1
10
+
11
+ - **Plain files read better.** Notes and plain text read as a page, ⌘F is a find bar with replace, and a PDF opens with its pages one under another.
12
+ - **The right viewer whatever a name's case**, and a file that cannot be shown as text, or is too large, says so instead of being read.
13
+
5
14
  ## 0.14.0
6
15
 
7
16
  - **Any file opens.** A note, data, a config, a log, subtitles or a loose picture, video or sound opens as text or media, edited by hand beside the agent and marked up like any other work. The agent can show any file, listed in the project or not.
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@allyhub/audio",
3
- "version": "0.14.0",
3
+ "version": "0.15.0",
4
4
  "type": "module",
5
5
  "exports": {
6
6
  ".": {
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@allyhub/chart",
3
- "version": "0.14.0",
3
+ "version": "0.15.0",
4
4
  "type": "module",
5
5
  "exports": {
6
6
  ".": {
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@allyhub/diagnostics",
3
- "version": "0.14.0",
3
+ "version": "0.15.0",
4
4
  "type": "module",
5
5
  "exports": {
6
6
  ".": {
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@allyhub/formats",
3
- "version": "0.14.0",
3
+ "version": "0.15.0",
4
4
  "type": "module",
5
5
  "exports": {
6
6
  ".": {
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@allyhub/image-draw",
3
- "version": "0.14.0",
3
+ "version": "0.15.0",
4
4
  "type": "module",
5
5
  "exports": {
6
6
  "./*": {
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@allyhub/image-measure",
3
- "version": "0.14.0",
3
+ "version": "0.15.0",
4
4
  "type": "module",
5
5
  "exports": {
6
6
  "./*": {
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@allyhub/image-sdk",
3
- "version": "0.14.0",
3
+ "version": "0.15.0",
4
4
  "type": "module",
5
5
  "exports": {
6
6
  ".": {
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@allyhub/measure",
3
- "version": "0.14.0",
3
+ "version": "0.15.0",
4
4
  "type": "module",
5
5
  "exports": {
6
6
  ".": {
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@allyhub/ooxml",
3
- "version": "0.14.0",
3
+ "version": "0.15.0",
4
4
  "type": "module",
5
5
  "exports": {
6
6
  ".": {
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@allyhub/piece",
3
- "version": "0.14.0",
3
+ "version": "0.15.0",
4
4
  "type": "module",
5
5
  "exports": {
6
6
  ".": {
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@allyhub/protocol",
3
- "version": "0.14.0",
3
+ "version": "0.15.0",
4
4
  "type": "module",
5
5
  "exports": {
6
6
  ".": {
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@allyhub/runtimes",
3
- "version": "0.14.0",
3
+ "version": "0.15.0",
4
4
  "type": "module",
5
5
  "exports": {
6
6
  ".": {
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@allyhub/scenery",
3
- "version": "0.14.0",
3
+ "version": "0.15.0",
4
4
  "type": "module",
5
5
  "exports": {
6
6
  ".": {
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@allyhub/sheet",
3
- "version": "0.14.0",
3
+ "version": "0.15.0",
4
4
  "type": "module",
5
5
  "exports": {
6
6
  ".": {
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@allyhub/slides-core",
3
- "version": "0.14.0",
3
+ "version": "0.15.0",
4
4
  "type": "module",
5
5
  "exports": {
6
6
  ".": {
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@allyhub/video-core",
3
- "version": "0.14.0",
3
+ "version": "0.15.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.14.0",
3
+ "version": "0.15.0",
4
4
  "type": "module",
5
5
  "exports": {
6
6
  ".": {
package/docs/README.md CHANGED
@@ -16,7 +16,6 @@ What a piece is written with, for the version of the SDK installed beside them.
16
16
  - [scenery.md](scenery.md): 3D sceneries: `defineScenery()`, cameras and their moves, the hand that holds one, the `scenery()` layer and its screens.
17
17
  - [modeling.md](modeling.md): a prop modelled in code with `@allyhub/model` and put in a scenery.
18
18
  - [docs.md](docs.md): a doc, one MDX file: its title, the Markdown and tags it reads, pictures and links, check and render.
19
- - [reports.md](reports.md): a report, one HTML file written freely: what it loads from the project, how it is drawn, its check, frames and render, report styles.
20
19
  - [sheets.md](sheets.md): a sheet, a workbook as YAML and CSV: tables, formulas, names, checks, the openpyxl API (`@allyhub/sdk/sheets`), calc, trace and render.
21
20
  - [canvas.md](canvas.md): a canvas, a JSON Canvas file laying a project's work out with notes, groups and edges.
22
21
  - [x.md](x.md): an X post, thread or long post in POST /2/tweets's fields, and an X article in X's blocks: what X counts and refuses, and what they render to.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@allyhub/sdk",
3
- "version": "0.14.0",
3
+ "version": "0.15.0",
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",
package/docs/reports.md DELETED
@@ -1,89 +0,0 @@
1
- # Reports
2
-
3
- A report is a page read on a screen and sent as a link: one HTML file you write freely, in HTML, CSS and JavaScript, listed in `allyhub.yaml` as `kind: report` ([project.md](project.md#items)), and whatever it loads beside it. AllyHub gives it no components, classes or layout: every part of the page is yours. It draws the page offline, the same on every computer, checks it for what is objectively wrong, draws pictures of it to look at, and makes it into files.
4
-
5
- ## A report item
6
-
7
- ```
8
- research/channels/
9
- channels.html the report
10
- charts.js anything it loads, beside it or elsewhere in the project
11
- ```
12
-
13
- ```yaml
14
- work:
15
- - file: research/channels/channels.html
16
- kind: report
17
- title: AI productivity channels
18
- ```
19
-
20
- - Its id is its file without its extension (`research/channels/channels`); commands take either.
21
- - Its file ends in `.html`; one that does not, or is not there, is AK-M017.
22
-
23
- ## What it loads
24
-
25
- The page is drawn from a server of the project's folder: it loads the project's files by their paths, relative to the report (`../../data/channels.csv`), and nothing else.
26
-
27
- - **Data**: `fetch` a CSV or a JSON by its path and draw from it, so a figure, a table and a chart are one number. A sheet's table files hold the rows typed into it, not what its formulas compute: for those, render the sheet into the report's folder (`allyhub render <sheet> --type csv` or `json`, then copy the file beside the report) and load that.
28
- - **Libraries** are files of the project: a package installed and loaded by its path (`../../node_modules/chart.js/dist/chart.umd.min.js`), or a file beside the report. A classic script or a module with no imports is carried by the self-contained HTML export; a module that imports others is not (bundle it into one file).
29
- - **Faces** are files: `@font-face` rules naming font files in the project (a `@fontsource` package's CSS, or your own). The built-in faces of the stage (project.md, "Fonts") are not loaded for a report.
30
- - **Nothing from the network**: an address outside the project (a CDN, Google Fonts) is refused when the page is drawn and is AK-N003. Put the file in the project instead.
31
- - A report style (below) brings its faces and Chart.js as files.
32
-
33
- ## How it is drawn
34
-
35
- `check`, `frames` and `render` draw the page the same way, in the pinned Chrome:
36
-
37
- - At a window of 1440 × 900 CSS pixels (`100vh` is 900), at 1 device pixel per CSS pixel, unless asked otherwise.
38
- - `prefers-reduced-motion: reduce` and `prefers-color-scheme: light`, unless asked otherwise. `Math.random` gives the same numbers each time; the clock is the real one.
39
- - It is drawn once it has settled: loaded, its network quiet (up to 3 s after the load event), its fonts ready, its pictures decoded, `window.allyhubReady` kept when the page sets it to a promise, its CSS animations finished (an endless one paused at its start), then 1.2 s more for what scripts animate. A page that draws later than that (a chart animating for longer) sets `window.allyhubReady`, or turns its motion off under reduced motion.
40
- - A page that has not loaded and settled within 30 s is AK-P004.
41
-
42
- Each of these is a `--param` of `allyhub render` (`width`, `height`, `scale`, `timeout`, `network`, `quiet`, `dark`, `paper`): `allyhub help render`.
43
-
44
- ## Check
45
-
46
- `allyhub check` draws each report and reports objective errors alone:
47
-
48
- | Code | What |
49
- | --- | --- |
50
- | AK-M017 | Its file is not an HTML file, or is not there |
51
- | AK-A001 | It asks for a file of the project that is not there |
52
- | AK-N003 | It asks for an address outside the project, which is refused |
53
- | AK-R001 | Its scripts threw and did not catch |
54
- | AK-P004 | It did not load, or did not settle, within its timeout |
55
- | AK-L006 | Text is drawn in a face of the computer rather than a file of the project (a warning: another computer draws it in its own) |
56
-
57
- How it looks, what it says and how it is laid out are never problems.
58
-
59
- ## In Studio and allyhub dev
60
-
61
- A report opens in its view: the page in a frame, served from the project's files with the same rule as the render (nothing from outside the project loads), at the window's width or a desktop's, a tablet's or a phone's, scaled down when wider than the window. It is drawn again when a file it is made from changes: its own, or one its page loaded (the CSV it fetched, a face its stylesheet named), wherever it is in the project. A person changes one thing in it by hand, its theme, where its report style writes themes: the view's theme menu sets `data-theme` on the page's `<html>`, every other byte of the file kept, and you see it in the file. A read-only view (a snapshot) and a share's viewer offer no theme to set, as they offer nothing that changes the item. Anything else they point at with Mark up and send to you.
62
-
63
- ## Look at it
64
-
65
- `allyhub frames <report>` draws the page as the render does, from its top, and writes the picture under `.allyhub/work/frames/<place>/`:
66
-
67
- - `--width 375` at a phone's width, `--dark` as a reader who asks for dark sees it (a page with no `prefers-color-scheme: dark` styles looks the same), `--print` laid out for paper (`@media print`) as one long picture;
68
- - `--at <selector>` one element alone, at its size, its picture named by the selector;
69
- - a page more than about 1.6 times as tall as it is wide is cut into bands laid side by side (at most six), so one picture shows all of it.
70
-
71
- It says the page's height, and what it asked for that was missing or refused and what it threw.
72
-
73
- ## Render
74
-
75
- `allyhub render <report>` writes under `.allyhub/out/`, by its id:
76
-
77
- - `html` (the default): one self-contained HTML file, and the render says its size and how much of it is faces. Every file the page loaded is put inside it, its bytes as they are in the project: scripts and style sheets in their tags, pictures and faces as `data:` URLs, and what its scripts loaded (`fetch`, `XMLHttpRequest`, a picture or a script made by code) answered from a table in a first script. It runs offline on any computer, its interactivity kept. A module script that imports another file stops it, with why.
78
- - `pdf`: Chrome's print of the page, its backgrounds printed, on Letter (`--param paper=a4`) unless its `@page` names a size; write `@media print` for paper.
79
- - `png`: the whole page as one long picture at its width.
80
-
81
- `--type html,pdf,png` makes them all.
82
-
83
- ## Report styles
84
-
85
- A report style is a look written down for a report to start from when the person gives no style of their own: a reference, never a limit, and never a component.
86
-
87
- - `allyhub report style list` names them, each with its themes.
88
- - `allyhub report style show <name>` prints one: its themes, tokens, type, page, example parts and charts.
89
- - `allyhub report style use <report> <name>` writes its `style.css` (the tokens as CSS variables, each theme as `[data-theme="…"]`, the faces' `@font-face` rules, reduced motion) and `tokens.js` (the same tokens for a canvas chart: `reportToken("hero-deco2")`) in the report's `style/` folder, and copies its faces and Chart.js once into the project's `assets/report-styles/<name>/`. It prints the lines to link them. The files are then the report's own: change them as it needs; `--force` writes style.css and tokens.js again.