@openpresentation/opf-render 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenPresentation
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,44 @@
+# OPF Render
+
+Deterministic local renderer for Open Presentation Format documents. This repo is the Phase 1 toolkit lane for SVG, PNG, and PDF output.
+
+## Scope
+
+- Package: `@openpresentation/opf-render`
+- Repository: `OpenPresentation/opf-render`
+- License: MIT
+- Compatibility target: `@openpresentation/opf`
+- Planned public API: `renderSvg(opf, opts)`, `svgToPng(svg, opts)`, and `svgToPdf(svgs, opts)`
+
+Feature implementation is intentionally not in this provisioning slice. The first implementation task owns validation, catalog resolution, placeholder binding, SVG emission, and deterministic golden tests.
+
+## Runtime Policy
+
+The package runtime must stay local and deterministic:
+
+- No hosted service in the critical path
+- No telemetry or hidden analytics
+- No commercial SDK dependency in the critical path
+- No required network calls
+- No clock, locale, random, or system-font fallback drift in render output
+- Host applications own auth, storage, queues, analytics, collaboration, and product workflow
+
+## Development
+
+```sh
+npm ci
+npm run build
+npm run validate
+```
+
+## Release Lane
+
+Public npm package publication is handled by `.github/workflows/release.yml` with npm provenance.
+
+Required first-publish setup:
+
+1. An npm owner for the `@openpresentation` scope must run the first publish or reserve/grant the `@openpresentation/opf-render` package.
+2. Configure npm Trusted Publishing for GitHub repository `OpenPresentation/opf-render` and workflow `.github/workflows/release.yml`.
+3. Publish by creating a GitHub Release or manually running the Release workflow after CI passes.
+
+This repo does not require an npm automation token when Trusted Publishing is configured.

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export declare const packageName = "@openpresentation/opf-render";
+
+export declare const releaseLane: Readonly<{
+  githubRepository: "OpenPresentation/opf-render";
+  npmPackage: "@openpresentation/opf-render";
+  compatibilityPackage: "@openpresentation/opf";
+}>;
+
+export declare const runtimePolicy: Readonly<{
+  hostedServiceInCriticalPath: false;
+  telemetry: false;
+  commercialSdkInCriticalPath: false;
+  requiredNetworkCalls: false;
+  deterministicLocalExecution: true;
+}>;

package/dist/index.js

@@ -0,0 +1,15 @@
+export const packageName = "@openpresentation/opf-render";
+
+export const releaseLane = Object.freeze({
+  githubRepository: "OpenPresentation/opf-render",
+  npmPackage: "@openpresentation/opf-render",
+  compatibilityPackage: "@openpresentation/opf"
+});
+
+export const runtimePolicy = Object.freeze({
+  hostedServiceInCriticalPath: false,
+  telemetry: false,
+  commercialSdkInCriticalPath: false,
+  requiredNetworkCalls: false,
+  deterministicLocalExecution: true
+});

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@openpresentation/opf-render",
+  "version": "0.0.1",
+  "description": "Deterministic local OPF renderer for SVG, PNG, and PDF output.",
+  "license": "MIT",
+  "type": "module",
+  "private": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/OpenPresentation/opf-render.git"
+  },
+  "bugs": {
+    "url": "https://github.com/OpenPresentation/opf-render/issues"
+  },
+  "homepage": "https://github.com/OpenPresentation/opf-render#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "scripts": {
+    "build": "node scripts/build.mjs",
+    "validate": "node scripts/validate-package.mjs",
+    "prepack": "npm run build"
+  },
+  "dependencies": {
+    "@openpresentation/opf": "^0.2.2"
+  }
+}