bunbraco 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kineco
+
+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/NOTICE

@@ -0,0 +1,69 @@
+bunbraco
+Copyright (c) 2026 Kineco
+
+This product includes third-party software. bunbraco is an independent project.
+It is not affiliated with, endorsed by, or sponsored by Umbraco A/S, which owns
+the Umbraco trademark.
+
+There are three places third-party material is redistributed, rather than merely
+depended on:
+
+  @bunbraco/backoffice-dist   the built Umbraco backoffice and the browser
+                              packages bundled into it, produced by
+                              `bun run vendor:backoffice`
+  @bunbraco/backoffice-dist   three CSS files copied unmodified from the Umbraco
+                              client source tree
+  @bunbraco/contracts         the Umbraco Management API OpenAPI document,
+                              copied unmodified
+
+No Umbraco trademark is redistributed. The Umbraco wordmark, the "U" roundel
+favicon and the installer illustration are deliberately not carried in this
+repository: MIT grants copyright permission and says nothing about trademarks, so
+bunbraco's own marks are served at those paths instead. See `BRANDED_ASSETS` in
+`@bunbraco/backoffice-host`.
+
+The Umbraco backoffice
+----------------------
+@umbraco-cms/backoffice 18.2.0 — MIT — https://github.com/umbraco/Umbraco-CMS
+@umbraco-ui/uui 2.0.2 — MIT — https://github.com/umbraco/Umbraco.UI
+
+Static files from the Umbraco client source tree
+------------------------------------------------
+css/umb-css.css, css/rte-content.css, css/umbraco-blockgridlayout.css
+  — copied unmodified from Umbraco-CMS release-18.2.0 — MIT
+  — https://github.com/umbraco/Umbraco-CMS
+Shipped in @bunbraco/backoffice-dist under `upstream-static/`.
+
+`rte-content.css` itself carries Tiptap's default editor styles, copied from
+tiptap v2.11.7 (MIT); the file records this in its own header.
+
+The Umbraco Management API contract
+-----------------------------------
+OpenApi.json — copied unmodified from Umbraco-CMS release-18.2.0
+  (src/Umbraco.Cms.Api.Management/OpenApi.json) — MIT
+  — https://github.com/umbraco/Umbraco-CMS
+Shipped in @bunbraco/contracts, which also ships the TypeScript types generated
+from it.
+
+Browser runtime dependencies bundled into the backoffice build
+--------------------------------------------------------------
+@heximal/expressions 0.1.5 — BSD-3-Clause
+@microsoft/signalr 10.0.11 — MIT
+@tiptap/* 3.31.3 — MIT
+diff 9.0.0 — BSD-3-Clause
+dompurify 3.4.16 — Apache-2.0, elected from "MPL-2.0 OR Apache-2.0"
+element-internals-polyfill 3.0.2 — MIT
+lit 3.3.3 — BSD-3-Clause
+luxon 3.7.2 — MIT
+marked 18.0.14 — MIT
+monaco-editor 0.57.0 — MIT
+rxjs 7.8.2 — Apache-2.0
+uuid 14.0.2 — MIT
+
+dompurify is offered under either licence; Apache-2.0 is elected here, so no
+MPL-2.0 obligation attaches to the copy bundled into the backoffice build. Of the
+Apache-2.0 packages above, none ships a NOTICE file of its own, so Apache-2.0
+section 4(d) adds nothing to this file.
+
+Each package's own licence text ships inside its npm distribution and applies
+unchanged to the copies bundled here.

package/bin/bunbraco.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env bun
+/**
+ * The `bunbraco` binary a site gets from the umbrella package.
+ *
+ * The command line itself lives in `@bunbraco/cli`, which is installable on its
+ * own. Both packages declare the same bin name; because this file resolves to
+ * the same module the CLI package would have run, whichever one a package
+ * manager links is the same command.
+ */
+import '@bunbraco/cli/bin'

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "bunbraco",
+  "version": "0.3.0",
+  "description": "A CMS on Bun with React-style TSX templates, edited through the Umbraco backoffice.",
+  "license": "MIT",
+  "author": "Kineco",
+  "homepage": "https://github.com/kineco-au/bunbraco-cms#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kineco-au/bunbraco-cms.git",
+    "directory": "packages/bunbraco"
+  },
+  "bugs": {
+    "url": "https://github.com/kineco-au/bunbraco-cms/issues"
+  },
+  "keywords": [
+    "cms",
+    "umbraco",
+    "bun",
+    "content-management",
+    "headless",
+    "tsx",
+    "sqlite",
+    "postgres"
+  ],
+  "engines": {
+    "bun": ">=1.3.0"
+  },
+  "type": "module",
+  "exports": {
+    ".": "./src/index.ts",
+    "./jsx-runtime": "./src/jsx-runtime.ts",
+    "./jsx-dev-runtime": "./src/jsx-runtime.ts"
+  },
+  "bin": {
+    "bunbraco": "./bin/bunbraco.ts"
+  },
+  "files": [
+    "src",
+    "bin",
+    "NOTICE"
+  ],
+  "dependencies": {
+    "@bunbraco/api-management": "0.3.0",
+    "@bunbraco/assistant": "0.3.0",
+    "@bunbraco/auth": "0.3.0",
+    "@bunbraco/backoffice-dist": "18.2.0",
+    "@bunbraco/backoffice-host": "0.3.0",
+    "@bunbraco/cli": "0.3.0",
+    "@bunbraco/contracts": "0.3.0",
+    "@bunbraco/core": "0.3.0",
+    "@bunbraco/data": "0.3.0",
+    "@bunbraco/render": "0.3.0",
+    "@bunbraco/server": "0.3.0",
+    "@bunbraco/schema": "0.3.0",
+    "@bunbraco/transfer": "0.3.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,71 @@
+/**
+ * The umbrella package a site installs.
+ *
+ * A site's `server.ts` is three lines:
+ *
+ *   import { bunbraco } from 'bunbraco'
+ *   import config from './bunbraco.config.ts'
+ *   Bun.serve(await bunbraco(config))
+ */
+import {
+  assertPortAvailable,
+  type BunbracoConfig,
+  createServer,
+  loadConfig,
+  type ServerHandle,
+} from '@bunbraco/server'
+
+export {
+  type AssistantProvider,
+  type BedrockOptions,
+  bedrock,
+  type ConverseInput,
+  type ConverseResult,
+} from '@bunbraco/assistant'
+export type {
+  BlockGridArea,
+  BlockGridItem,
+  BlockItem,
+  InnerHTML,
+  Link,
+  Navigation,
+  PageProps,
+  PublishedContent,
+  PublishedElement,
+  RedirectOptions,
+  RedirectRule,
+  RedirectTo,
+  RequestMember,
+  TypedElement,
+} from '@bunbraco/render'
+export { redirect } from '@bunbraco/render'
+export type { Child } from '@bunbraco/render/jsx-runtime'
+export {
+  type AzureMediaStoreOptions,
+  type AzureSchemaStoreOptions,
+  azureMediaStore,
+  azureSchemaStore,
+  type BunbracoConfig,
+  defineConfig,
+  fileSystemMediaStore,
+  loadConfig,
+  type MediaStore,
+  type S3MediaStoreOptions,
+  type S3SchemaStoreOptions,
+  type SchemaStore,
+  s3MediaStore,
+  s3SchemaStore,
+} from '@bunbraco/server'
+
+/** Boots a site and returns what `Bun.serve` needs, the live-update WebSocket included. */
+export async function bunbraco(
+  overrides: Partial<BunbracoConfig> = {},
+  cwd = process.cwd(),
+): Promise<ServerHandle['serveOptions']> {
+  const config = loadConfig(overrides, cwd)
+  // The caller is about to serve these options, so fail here rather than after a
+  // migration and a seed.
+  await assertPortAvailable(config.port)
+  const server = await createServer(config)
+  return server.serveOptions
+}

package/src/jsx-runtime.ts

@@ -0,0 +1,8 @@
+/**
+ * The JSX runtime a site's views compile against.
+ *
+ * A site depends only on `bunbraco`, so `jsxImportSource` must be `bunbraco` —
+ * pointing it at `@bunbraco/render` would fail to resolve from the site's own
+ * `node_modules`, which is exactly what the 5a exit test caught.
+ */
+export * from '@bunbraco/render/jsx-runtime'