foundrycms 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jonathan Ellis
+
+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,152 @@
+# Foundry CMS
+
+The modern WordPress replacement. TypeScript-native, plugin-based, self-hosted.
+
+## Quick Start
+
+```bash
+npm install @foundrycms/core
+```
+
+```typescript
+import { createFoundryWithDefaults } from '@foundrycms/core';
+
+const foundry = createFoundryWithDefaults();
+
+// 15 elements + 10 templates ready to go
+console.log(foundry.elements.list().length); // 15
+console.log(foundry.templates.list().length); // 10
+```
+
+## What's Included
+
+- **Plugin System** — Register, activate, deactivate plugins with dependency resolution
+- **Hook Engine** — Event emitters and filters with priority ordering
+- **Config Manager** — Dot-notation access with Zod schema validation
+- **Page Builder** — 15 elements across 5 categories (Layout, Content, Media, Data, Interactive)
+- **Template Studio** — 10 starter templates (Hero, About, Services, Pricing, etc.)
+- **Theme System** — 3 built-in presets (Architect, Quantum, Elegant)
+- **Server Renderer** — Render pages to HTML strings
+- **Serializer** — Serialize/deserialize page data with validation
+- **17 Plugins** — Forge, Ledger, Scout, Roster, Depot, Stage, Relay, Oracle, Sentinel, Compass, Beacon, Chronicle, Canvas, Market, Blueprint, Pulse, Atlas
+
+## Elements (15)
+
+| Category | Elements |
+|----------|----------|
+| Layout | Row, Column, Spacer, Divider |
+| Content | Heading, Text Block, Button, Icon |
+| Media | Image, Gallery, Video |
+| Data | Pricing Table, Testimonial |
+| Interactive | Accordion, Call to Action |
+
+## Plugins (17)
+
+| Category | Plugins |
+|----------|---------|
+| Core | Forge (builder), Ledger (invoicing), Compass (CRM), Oracle (AI) |
+| Growth | Scout (prospects), Beacon (SEO), Chronicle (blog), Atlas (analytics) |
+| Operations | Roster (booking), Depot (inventory), Stage (events), Blueprint (projects), Pulse (team) |
+| Communication | Relay (messaging), Canvas (forms), Market (e-commerce), Sentinel (monitoring) |
+
+## Usage
+
+### Create a page
+
+```typescript
+import { createFoundryWithDefaults, type PageData } from '@foundrycms/core';
+
+const foundry = createFoundryWithDefaults();
+
+const page: PageData = {
+  rows: [
+    {
+      id: 'row-1',
+      settings: { layout: 'boxed' },
+      columns: [
+        {
+          id: 'col-1',
+          settings: { width: '1/1' },
+          elements: [
+            {
+              id: 'heading-1',
+              type: 'heading',
+              settings: { text: 'Hello World', level: 'h1', alignment: 'center' },
+            },
+          ],
+        },
+      ],
+    },
+  ],
+  meta: {
+    title: 'Home',
+    description: 'Welcome to my site',
+  },
+};
+```
+
+### Render to HTML
+
+```typescript
+import { renderPage } from '@foundrycms/core';
+
+const html = renderPage(page, foundry.elements);
+// Returns full HTML string
+```
+
+### Register a custom plugin
+
+```typescript
+import { createFoundry, type FoundryPlugin } from '@foundrycms/core';
+
+const myPlugin: FoundryPlugin = {
+  id: 'my-plugin',
+  name: 'My Plugin',
+  version: '1.0.0',
+  description: 'Does something cool',
+  hooks: [
+    {
+      hook: 'page:before_render',
+      handler: async (core, html) => {
+        // Modify HTML before rendering
+        return html;
+      },
+    },
+  ],
+  onActivate: async (core) => {
+    console.log('Plugin activated!');
+  },
+};
+
+const foundry = createFoundry();
+foundry.plugins.register(myPlugin);
+await foundry.plugins.activate('my-plugin');
+```
+
+### Use themes
+
+```typescript
+import { getPresetById, builtInPresets } from '@foundrycms/core';
+
+// List all presets
+console.log(builtInPresets.map(p => p.name)); // ['Architect', 'Quantum', 'Elegant']
+
+// Get a specific preset
+const quantum = getPresetById('quantum');
+console.log(quantum?.tokens.colors.primary); // '#00e640'
+```
+
+## Self-Hosting
+
+Foundry is designed to run on any Node.js server. For the full CMS experience with a visual editor, database, and API:
+
+1. **Cloudflare Pages** (free) — Static + serverless functions
+2. **Vercel** (free tier) — Next.js deployment
+3. **Any Node.js host** — Express/Fastify server
+4. **GoDaddy/cPanel** — Node.js application
+
+See full documentation at [jonathanellis.work/foundry](https://jonathanellis.work/foundry)
+
+## License
+
+MIT - Jonathan Ellis

package/dist/__tests__/foundry.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=foundry.test.d.ts.map

package/dist/__tests__/foundry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"foundry.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/foundry.test.ts"],"names":[],"mappings":""}