@quario/docx 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,32 @@
+# @quario/docx
+
+## 0.1.0
+
+### Minor Changes
+
+- **A Word target.** `@quario/docx` renders the same report definition every other target reads into
+  the bytes of a `.docx` — real Word tables, inline pictures, and a grouping that becomes the
+  navigation pane.
+
+  It is a **flow** target rather than a painter: it states the geometry and the typography and lets
+  Word paginate, so the promise is the preview's look rather than the preview's page breaks. Page
+  bands become a section's header and footer, and a bare `{{ page.number }}` or `{{ page.total }}`
+  becomes a live field the reader's own application recomputes.
+
+  ```js
+  import { docx } from "@quario/docx";
+  import { quario } from "quario";
+
+  const bytes = await quario()
+    .report(schema)
+    .render(docx({ page: { size: "A4" }, meta: { title: "Sales 2026" } }), data);
+  ```
+
+  Its one runtime dependency is `fflate`, confined to the module that writes the zip — pure
+  JavaScript, so the same schema, data and options produce byte-identical output on every supported
+  runtime. SCHEMA.md's "The DOCX target" states the full contract.
+
+### Patch Changes
+
+- Updated dependencies
+  - quario@0.8.0

package/LICENSE

@@ -0,0 +1,219 @@
+# Quario License Agreement
+
+> **In short:** Quario is commercial software with visible source.
+> Evaluate it free for as long as you like. Evaluation output is
+> watermarked. Anything else needs a per-developer license, after
+> which deployment is unlimited and royalty-free. This summary is not
+> the license; the full terms below govern.
+
+Version 1.0, August 2026
+
+This agreement is between you and Webstronauts, trading as Quario,
+established in the Netherlands ("we", "us"), and governs the Software
+defined below.
+
+Quario is commercial software. Its packages ship with readable source
+code, but it is not open source. No rights are granted beyond those in
+this agreement.
+
+## 1. Definitions
+
+- The **Software** is any software we publish under the Quario name,
+  including the `quario` and `@quario/*` packages, except where a
+  product states its own terms. Each release states the edition of this
+  agreement that governs it.
+- **You** means the individual exercising rights under this agreement
+  and, where that individual acts for a company or other organization,
+  that organization. In that case the organization is the licensee, and
+  the rights and limits in this agreement apply to it as a whole.
+- An **Application** is software you create that incorporates the
+  Software and adds substantial functionality beyond it. A
+  licensee-operated service that embeds the Software and renders
+  reports for your End Users is an Application under this agreement,
+  even if it does little more than render.
+- A **Developer** is any individual (employee or contractor working on
+  your behalf) who writes or maintains code that uses the Software's
+  APIs, or who creates or maintains report definitions for use with the
+  Software. That includes people who never install or run the Software
+  themselves, when their definitions are rendered by a service that
+  embeds it.
+- A **Seat** is a paid license for one named Developer, purchased from
+  us or an authorized reseller.
+- **End Users** are people who interact with the Software only through
+  an Application: running it, viewing the reports it produces, or
+  supplying parameters or other input to existing report definitions
+  the Application provides. Creating or maintaining report definitions
+  makes someone a Developer. End Users do not purchase a license; their
+  rights come from section 5.
+
+## 2. Acceptance
+
+This file is our standing offer. Anyone who exercises the evaluation
+rights in section 3 accepts them, subject to their conditions. All
+other rights arise when Seats are purchased. Where a purchase is made
+for an organization, the person completing it confirms that they are
+authorized to accept this agreement on the organization's behalf, and
+acceptance covers the whole organization. If you do not accept this
+agreement, do not use the Software.
+
+## 3. Evaluation
+
+You may download, install, and use the Software free of charge to
+evaluate it: assessing whether it suits your purposes, and building
+prototypes or proofs of concept. Evaluation covers the full feature
+set, needs no key, and has no fixed time limit. The Software marks
+evaluation output as described in section 6.
+
+Evaluation is limited to assessment: you may not distribute any
+Application containing the Software, use the Software in live business
+operations, or expose it in services offered to third parties. The
+moment your use goes beyond evaluating the Software, it requires Seats
+under section 4.
+
+## 4. Developer licenses
+
+Any use of the Software beyond section 3 requires a Seat for every
+Developer, whether or not an Application has shipped. With those Seats
+in place:
+
+- Each licensed Developer may install and use the Software on any number
+  of machines for developing Applications.
+- Automated build, test, and CI systems do not consume Seats.
+- Seats are per named individual. They may be reassigned when a
+  Developer stops working with the Software, but not shared or pooled
+  between concurrently active Developers. Contractors' work for you is
+  covered by your Seats; work they do for other clients is not.
+
+## 5. Distribution and runtime
+
+With Seats under section 4 in place, you may deploy and operate your
+Applications yourself, and distribute the Software as an embedded part
+of them, **royalty-free**: no additional fees or per-deployment
+licenses are required for any number of servers, copies, or End Users.
+You may embed your license key in an Application and ship it at no
+charge, so section 6 does not mark that Application's output.
+
+For that purpose, we grant you the right to pass through to each End
+User, and to anyone who distributes or operates your Application on your
+behalf, a limited, non-exclusive, non-transferable right to execute the
+Software only as embedded in the Application. You must not permit them
+to extract the Software from the Application or use it to develop
+software of their own.
+
+If you operate a service that embeds the Software and renders reports
+for your End Users, that service is an Application under section 1. You
+may run it royalty-free under this section, and you may put your license
+key in it as in any Application. Calling applications that only request
+renders from it need not incorporate the Software. People who use those
+applications only as End Users under section 1 get the pass-through
+rights above.
+
+You may not:
+
+- distribute the Software on its own, or as part of a product whose
+  primary purpose is to provide report-engine, report-design, or
+  document-generation capability to third-party developers;
+- expose the Software's APIs to third parties as a development tool or
+  service that substitutes for those parties buying their own Seats. A
+  licensee-operated service that embeds the Software and renders for
+  your own End Users falls outside that ban;
+- fork, mirror, repackage, rename, or wrap the Software, or republish
+  it on any package registry or code-hosting platform, other than as
+  embedded in an Application.
+
+For as long as this agreement is in force, you may not create any tool,
+library, product, or service that competes with the Software or any
+other Quario product, whether the competition is direct or indirect;
+this restriction does not survive termination. You may not remove or
+alter copyright or license notices in the Software. If your Application
+is itself a closed development product for third-party developers (OEM
+redistribution), contact us for separate terms.
+
+## 6. License keys and output marking
+
+The Software accepts a license key that evidences your Seats under
+section 4. Key checks run offline.
+
+Without a valid key, or with a key whose validity period does not cover
+the installed version's release date, the Software runs with its full
+feature set but marks its output as unlicensed. Using a key you are not
+entitled to is a material breach of this agreement.
+
+You may not remove, disable, or circumvent the key check or the output
+marking, or distribute anything that does.
+
+## 7. Term, updates, and perpetual fallback
+
+Seats are sold as an annual subscription. While the subscription is
+active, licensed Developers receive all Software versions we release,
+and support for the Software through our issue tracker and by email. We
+provide support with commercially reasonable effort; we do not guarantee
+specific response times.
+
+If the subscription lapses, your license to the versions released during
+your subscription is **perpetual, for the number of Seats held at the
+lapse**: up to that many Developers may keep using those versions, and
+your Applications may keep shipping them, forever, at no further cost.
+Versions released after the lapse require renewal. We encode this rule
+in purchased keys: a key remains valid for every version released
+during its validity period, with no end date.
+
+## 8. Source availability
+
+The Software's packages ship with readable source code so that you can
+review and debug what you run. Readable source does not grant extra
+rights: this agreement governs all use of the source, and you may
+publish the Software (modified or not) only as part of an Application
+under section 5.
+
+## 9. Ownership, trademarks, and feedback
+
+We license the Software; we retain all intellectual property rights in
+it. Report definitions, data, and output you create with the Software
+are yours. "Quario" and the Quario logo are our trademarks; this
+agreement grants no rights to use them beyond identifying the Software.
+If you send us feedback or suggestions, we may use them without
+obligation.
+
+## 10. Warranty and liability
+
+We provide the Software as is. To the fullest extent the law allows, we
+disclaim all warranties and conditions, express or implied, including
+merchantability, fitness for a particular purpose, and non-infringement.
+
+To the fullest extent the law allows: we are not liable for indirect or
+consequential damages, loss of profits, loss of data, or business
+interruption; and our total aggregate liability under this agreement is
+limited to the greater of EUR 100 and the fees you paid us in the
+twelve months preceding the event giving rise to the claim. These
+limitations do not apply where the damage results from the intent or
+deliberate recklessness (opzet of bewuste roekeloosheid) of us or our
+management, or where mandatory law does not permit them.
+
+## 11. Termination and survival
+
+If you materially breach this agreement, we may terminate it by notice.
+If the breach can be remedied, we will first allow 30 days from that
+notice to remedy it, and termination takes effect only if the breach
+remains. On termination, the licenses granted here end.
+Perpetual-fallback rights under section 7 survive termination only if
+they arose from a lapse that predates the breach, and section 5
+survives with them to the extent needed to keep exercising them.
+Sections 8 through 12 survive any termination.
+
+## 12. General
+
+Dutch law governs this agreement. Disputes go to the competent court for
+our registered office. You may not assign this agreement without our
+consent, except to a successor of your whole business; we may assign it
+to a successor of ours. If a provision is unenforceable, the remainder
+stays in force. Failure to enforce a provision does not waive it. This
+agreement, together with your order for Seats, is the entire agreement
+about the Software, unless we agree otherwise in writing.
+
+---
+
+**Purchasing and contact:** <contact@getquario.com> ·
+<https://getquario.com>
+
+Copyright © 2026 Webstronauts. All rights reserved.

package/README.md

@@ -0,0 +1,100 @@
+# @quario/docx
+
+**The Word render target for [quario](https://www.npmjs.com/package/quario).** Renders a report
+definition to the bytes of a `.docx` package: a flow document, so the geometry and the typography
+are quario's and the pagination is Word's.
+
+## Install
+
+```bash
+npm install quario @quario/docx
+```
+
+The engine is a peer dependency, installed beside the target. ESM-only, Node 22+, and
+browser-ready through any standards-based ESM bundler. The renderer resolves a `Uint8Array`; you
+write the file.
+
+## Quick start
+
+```js
+import { writeFileSync } from "node:fs";
+import { docx } from "@quario/docx";
+import { quario } from "quario";
+
+const schema = {
+  data: "$.orders[*]",
+  detail: {
+    columns: [
+      { header: "Product", value: "{{ @.product }}" },
+      { header: "Price", value: "{{ @.price }}" },
+    ],
+  },
+};
+
+const data = { orders: [{ product: "Desk", price: 250 }] };
+
+const bytes = await quario().report(schema).render(docx(), data);
+writeFileSync("orders.docx", bytes);
+```
+
+## Options
+
+Both are optional, and both are validated at the factory call — an unknown option, or one of the
+wrong type, throws there rather than at the first render.
+
+```js
+docx({
+  // Page geometry in PostScript points: "A4" (the default), "letter", or a
+  // [width, height] pair. The margin defaults to 54 pt, and a report that
+  // declares `page.margin` itself sets it instead — declaring both is an error.
+  page: { size: "A4", margin: 54 },
+  // Document properties. Strings only: no dates ride along, so rendering the
+  // same report twice produces the same bytes.
+  meta: { title: "Orders", author: "Acme BV", subject: "Q1" },
+});
+```
+
+## What it renders
+
+A report's bands become paragraphs; a table detail becomes a **real Word table** carrying the
+author's column shares as a fixed grid, with `span` as `gridSpan` and a header row that repeats
+after every page break. A split is a borderless one-row table, and an image is an inline picture at its natural size, capped at the text
+column, carrying its `alt` as the drawing's description.
+
+The grouping becomes the **navigation pane**: a group header's first item takes `Heading{depth+1}`
+from this package's own `styles.xml`, so no theme typography leaks in. Everything a report declares
+is direct formatting on the runs and paragraphs that wear it — `Normal` stays empty, because a look
+that depends on a style lookup is a look three readers may resolve three ways.
+
+Page bands become a section's header and footer. A bare `{{ page.number }}` or `{{ page.total }}`
+becomes a live `PAGE` / `NUMPAGES` field the reader's own application recomputes; anything computed
+from them is frozen at the value the render saw. A group's `reset: "page"` opens a section that
+restarts the numbering, and `break: "page"` starts the instance on a fresh page.
+
+## Determinism
+
+Two renders of one report are byte-identical, on **every supported runtime**: `fflate` is pure
+JavaScript, so its deflate output does not vary by engine. Every entry in the package is stamped
+1980-01-01 and nothing in the document carries a clock, so a digest over the bytes is a fair test.
+
+## Documentation
+
+[The quario documentation](https://getquario.com/docs/) is the reference.
+The [report schema](https://getquario.com/docs/reference/report-schema/) is the normative
+specification of what a report may declare, and the
+[support matrix](https://getquario.com/docs/reference/support-matrix/) says what each target makes
+of a declaration.
+
+## License
+
+Commercial software with readable source. Free, unlimited, watermarked evaluation; per-developer
+licenses at [getquario.com](https://getquario.com). See the bundled LICENSE.
+
+Pass your license key once, on the instance; it is verified offline:
+
+```js
+const q = quario({ license: "quario_..." });
+await q.license; // { licensed: true, licensee: "Acme BV", id: "1-ACME" }
+```
+
+An unlicensed render carries the marking as the first paragraph of every footer.