bearminion 0.0.0-stage → 1.0.1

package/CHANGELOG.md

@@ -0,0 +1,19 @@
+# bearminion
+
+## 1.0.1
+
+### Patch Changes
+
+- 0fb0cc9: Published through npm trusted publishing, with a provenance attestation that links the package to its source commit and build. No code changes.
+
+## 1.0.0
+
+First public release.
+
+- Content model: pages and site settings as JSON in the repository, validated with Zod against the site's own `defineSection`, `defineSite` and `defineTheme` definitions, with content migrations (`schemaVersion`).
+- Entry points: `bearminion` (runtime-neutral schemas and helpers), `bearminion/astro` (integration, file store, loaders), `bearminion/content`, `bearminion/rich-text` and `bearminion/marks`. `astro` 7 and `zod` 4 are peer dependencies.
+- Dev-only inline editor: click-to-edit text, rich text (bold, italic, links, lists) on ProseMirror, section toolbar (move, add, duplicate, settings, delete), sidebar tabs for pages, section, navigation, footer, design and site settings, and a palette derived from three seed colors with WCAG contrast checks.
+- Images: an upload library that includes the theme's own images, fit and position controls, and guards against deleting an image that saved content or the unsaved draft still uses.
+- Saving: one transactional `POST /save` for the page and the site, with validation issues reported per file; undo and redo, version history in `.editor/history/`, drafts kept in `localStorage`, and optional local git commits (`bearminion({ git: true })`, never pushes).
+- Security: the dev API answers only local, same-origin requests; uploads are checked by signature; pasted HTML is parsed and reduced to the supported subset.
+- Production: `astro build` ships a static site with nothing from the editor in it.

package/LICENSE

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

@@ -1,3 +1,57 @@
-# Temporary Holding Version
+<p align="center">
+  <img src="https://raw.githubusercontent.com/langehelp-software/bearminion/main/.github/assets/banner.png" alt="BearMinion: a git-based CMS for Astro. Click to edit. Commit to publish." width="100%" />
+</p>
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+<p align="center">
+  A website you edit by clicking on it. No database, no admin panel, no server.<br />
+  Built on <a href="https://astro.build">Astro</a>.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/bearminion"><img src="https://img.shields.io/npm/v/bearminion?color=169717" alt="npm version" /></a>
+  <a href="https://github.com/langehelp-software/bearminion/actions/workflows/ci.yml"><img src="https://github.com/langehelp-software/bearminion/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
+  <a href="https://github.com/langehelp-software/bearminion/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-169717" alt="MIT license" /></a>
+</p>
+
+This package is the engine behind BearMinion. You don't install it on its own: create a site from the template and it comes included.
+
+## Quick start
+
+You need [Node.js](https://nodejs.org) 22.12 or newer.
+
+```bash
+npm create astro@latest -- --template langehelp-software/bearminion/templates/default my-site
+cd my-site
+npm run dev
+```
+
+Open the address it prints, press **Ctrl+E** (**Cmd+E** on a Mac), click any text to change it, and press **Ctrl/Cmd+S** to save. Push the folder to GitHub and import it in Vercel, Netlify or Cloudflare Pages to put it online.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/langehelp-software/bearminion/main/.github/assets/editor.png" alt="The BearMinion editor: a section toolbar on the hero, a heading being edited, and the Pages tab in the sidebar" width="100%" />
+</p>
+
+## What you can change
+
+- **Text** right on the page, with bold, italic, links and lists
+- **Sections**: ten ready-made types, each with three layouts, added from a visual picker
+- **Pages, menus and footer**, with titles and descriptions for search and sharing
+- **Images**: upload, choose how they fill their frame and which part stays in view
+- **Colors**: pick three, and the editor builds a full light and dark palette that stays readable
+
+Content is plain JSON in your project, validated on every save and kept in your git history. The editor only runs during `astro dev`; the published site is static HTML with nothing from the editor in it.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/langehelp-software/bearminion/main/.github/assets/design.png" alt="The Design tab: color mode, brand, neutral and link colors, and a preview of every section tone in light and dark mode" width="100%" />
+</p>
+
+## Learn more
+
+- [Documentation](https://github.com/langehelp-software/bearminion/blob/main/docs/README.md), including [building your own theme](https://github.com/langehelp-software/bearminion/blob/main/docs/themes.md) on this package
+- [Source and issues](https://github.com/langehelp-software/bearminion)
+
+Requires Astro 7 and Zod 4 (peer dependencies, already in the template).
+
+## License
+
+[MIT](https://github.com/langehelp-software/bearminion/blob/main/LICENSE) © Jakub Lange

package/dist/astro.d.ts

@@ -0,0 +1,43 @@
+import { Dt as ContentMigrator, M as SiteDefinition, N as SiteOf, g as SectionRegistry, h as ContentModel, t as Page, u as SectionOf } from "./page-DgQlGree.js";
+import { a as StoreKeyError, c as createFileStore, i as FileStoreOptions, n as EditorContext, o as StoreOperation, r as ContentStore, s as UploadStore, t as BearminionOptions } from "./options-CxRzVfhi.js";
+import { AstroIntegration } from "astro";
+//#region src/integration.d.ts
+interface BearminionIntegration extends AstroIntegration {
+  name: 'bearminion';
+}
+/**
+ * Dev-only Astro integration. `astro build`, `astro preview`, and `astro sync`
+ * return before any plugin, route, or script is registered. `astro:server:setup`
+ * runs only while `astro dev` is serving.
+ */
+export declare function bearminion(options: BearminionOptions): BearminionIntegration;
+//#endregion
+//#region src/load.d.ts
+interface LoadOptions {
+  /** Upgrades files written under an older `schemaVersion`. `loadContent` builds it from the model. */
+  migrator?: ContentMigrator;
+  /**
+   * Keep a page's sections whose `type` the site no longer defines, instead of failing. For config-time
+   * code that does not render sections (the sitemap filter, the `site` URL), so `astro dev` still starts and
+   * the editor can open the page and remove the section. The collections and the build stay strict.
+   */
+  tolerateOrphans?: boolean;
+}
+interface LoadedContent<TModel extends ContentModel = ContentModel> {
+  site: SiteOf<TModel['site']>;
+  pages: Page<SectionOf<TModel['sections']>>[];
+}
+/**
+ * Load `site.json` and `pages/*.json` from a content directory.
+ * Throws {@link ContentReadError} or {@link ContentValidationError} with the file path.
+ */
+export declare function loadContent<TModel extends ContentModel>(contentDir: string, model: TModel, options?: Pick<LoadOptions, 'tolerateOrphans'>): LoadedContent<TModel>;
+/** Validate and return `contentDir/site.json`. */
+export declare function loadSite<TDefinition extends SiteDefinition>(contentDir: string, site: TDefinition, { migrator }?: Pick<LoadOptions, 'migrator'>): SiteOf<TDefinition>;
+/**
+ * Validate every `contentDir/pages/*.json` file.
+ * Pages are returned in filename order. Slugs must be unique.
+ */
+export declare function loadPages<TRegistry extends SectionRegistry>(contentDir: string, registry: TRegistry, { migrator, tolerateOrphans }?: LoadOptions): Page<SectionOf<TRegistry>>[];
+//#endregion
+export { type BearminionIntegration, type BearminionOptions, type ContentStore, type EditorContext, type FileStoreOptions, type LoadOptions, type LoadedContent, StoreKeyError, type StoreOperation, type UploadStore, bearminion as default, createFileStore };