@morphika/webframe 0.1.0

package/package.json

@@ -0,0 +1,212 @@
+{
+  "name": "@morphika/webframe",
+  "version": "0.1.0",
+  "description": "Visual Page Builder — core library. A reusable website builder with visual editing, CMS integration, and asset management.",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MorphikaStudio/Morphika_Webframe.git"
+  },
+  "keywords": [
+    "visual-builder",
+    "website-builder",
+    "cms",
+    "next.js",
+    "sanity",
+    "page-builder",
+    "morphika"
+  ],
+  "files": [
+    "admin/",
+    "app/",
+    "components/",
+    "lib/",
+    "sanity/",
+    "site/",
+    "studio/",
+    "styles/",
+    "tsconfig.json",
+    "LICENSE",
+    "!**/__tests__/",
+    "!**/*.test.ts",
+    "!**/*.test.tsx",
+    "!**/*.spec.ts",
+    "!**/*.spec.tsx",
+    "!**/archive/"
+  ],
+  "scripts": {
+    "prepack": "node scripts/prepack.mjs",
+    "postpack": "node scripts/postpack.mjs",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "lint": "eslint",
+    "typecheck": "tsc --noEmit"
+  },
+  "exports": {
+    "./config": "./lib/config/index.ts",
+    "./config/types": "./lib/config/types.ts",
+
+    "./components/blocks": "./components/blocks/index.ts",
+    "./components/blocks/*": "./components/blocks/*.tsx",
+    "./components/builder": "./components/builder/index.ts",
+    "./components/builder/*": "./components/builder/*.tsx",
+    "./components/builder/editors/*": "./components/builder/editors/*.tsx",
+    "./components/builder/settings-panel": "./components/builder/settings-panel/index.ts",
+    "./components/builder/settings-panel/*": "./components/builder/settings-panel/*.tsx",
+    "./components/builder/asset-browser": "./components/builder/asset-browser/index.ts",
+    "./components/builder/asset-browser/*": "./components/builder/asset-browser/*.tsx",
+    "./components/builder/live-preview": "./components/builder/live-preview/index.ts",
+    "./components/builder/live-preview/*": "./components/builder/live-preview/*.tsx",
+    "./components/admin": "./components/admin/index.ts",
+    "./components/admin/*": "./components/admin/*.tsx",
+    "./components/admin/nav-builder": "./components/admin/nav-builder/index.ts",
+    "./components/admin/nav-builder/*": "./components/admin/nav-builder/*.tsx",
+    "./components/admin/styles": "./components/admin/styles/index.ts",
+    "./components/admin/styles/*": "./components/admin/styles/*.tsx",
+    "./components/ui/*": "./components/ui/*.tsx",
+
+    "./lib/builder": "./lib/builder/index.ts",
+    "./lib/builder/*": "./lib/builder/*.ts",
+    "./lib/sanity/client": "./lib/sanity/client.ts",
+    "./lib/sanity/writeClient": "./lib/sanity/writeClient.ts",
+    "./lib/sanity/queries": "./lib/sanity/queries.ts",
+    "./lib/sanity/types": "./lib/sanity/types.ts",
+    "./lib/animation/*": "./lib/animation/*.ts",
+    "./lib/shader/glsl": "./lib/shader/glsl/index.ts",
+    "./lib/storage": "./lib/storage/index.ts",
+    "./lib/storage/*": "./lib/storage/*.ts",
+    "./lib/contexts/*": "./lib/contexts/*.tsx",
+    "./lib/styles/provider": "./lib/styles/provider.tsx",
+    "./lib/hooks/*": "./lib/hooks/*.ts",
+    "./lib/thumbnails/*": "./lib/thumbnails/*.ts",
+    "./lib/assets": "./lib/assets.ts",
+    "./lib/auth": "./lib/auth.ts",
+    "./lib/auth-token": "./lib/auth-token.ts",
+    "./lib/csrf": "./lib/csrf.ts",
+    "./lib/csrf-client": "./lib/csrf-client.ts",
+    "./lib/security": "./lib/security.ts",
+    "./lib/sanitize": "./lib/sanitize.ts",
+    "./lib/logger": "./lib/logger.ts",
+    "./lib/audit": "./lib/audit.ts",
+    "./lib/revalidate": "./lib/revalidate.ts",
+    "./lib/color-utils": "./lib/color-utils.ts",
+    "./lib/format-utils": "./lib/format-utils.ts",
+    "./lib/utils": "./lib/utils.ts",
+    "./lib/asset-retry": "./lib/asset-retry.ts",
+
+    "./sanity/schemas": "./sanity/schemas/index.ts",
+    "./sanity/schemas/*": "./sanity/schemas/*.ts",
+    "./sanity/schemas/blocks": "./sanity/schemas/blocks/index.ts",
+    "./sanity/schemas/blocks/*": "./sanity/schemas/blocks/*.ts",
+    "./sanity/schemas/objects/*": "./sanity/schemas/objects/*.ts",
+    "./sanity/compose": "./sanity/compose.ts",
+    "./sanity/config": "./sanity/sanity.config.ts",
+
+    "./styles/base.css": "./styles/base.css",
+    "./styles/animations.css": "./styles/animations.css",
+    "./styles/admin.css": "./styles/admin.css",
+    "./styles/globals.css": "./styles/globals.css",
+
+    "./site": "./site/index.ts",
+    "./site/page": "./site/page.ts",
+    "./site/work": "./site/work.ts",
+    "./site/preview": "./site/preview.ts",
+    "./site/not-found": "./site/not-found.ts",
+    "./site/error": "./site/error.ts",
+    "./site/robots": "./site/robots.ts",
+    "./site/sitemap": "./site/sitemap.ts",
+
+    "./admin": "./admin/index.ts",
+    "./admin/login": "./admin/login.ts",
+    "./admin/pages": "./admin/pages.ts",
+    "./admin/pages/editor": "./admin/pages-editor.ts",
+    "./admin/projects": "./admin/projects.ts",
+    "./admin/projects/editor": "./admin/projects-editor.ts",
+    "./admin/styles": "./admin/styles.ts",
+    "./admin/navigation": "./admin/navigation.ts",
+    "./admin/storage": "./admin/storage.ts",
+    "./admin/assets": "./admin/assets.ts",
+    "./admin/database": "./admin/database.ts",
+    "./admin/settings": "./admin/settings.ts",
+    "./admin/setup": "./admin/setup.ts",
+
+    "./components/admin/setup-wizard": "./components/admin/setup-wizard/index.ts",
+    "./components/admin/setup-wizard/*": "./components/admin/setup-wizard/*.tsx",
+
+    "./lib/setup/detect": "./lib/setup/detect.ts",
+
+    "./studio": "./studio/index.ts",
+
+    "./api/admin/auth": "./app/api/admin/auth/route.ts",
+    "./api/admin/pages": "./app/api/admin/pages/route.ts",
+    "./api/admin/pages/slug": "./app/api/admin/pages/[slug]/route.ts",
+    "./api/admin/pages/duplicate": "./app/api/admin/pages/[slug]/duplicate/route.ts",
+    "./api/admin/pages/set-home": "./app/api/admin/pages/[slug]/set-home/route.ts",
+    "./api/admin/assets/scan": "./app/api/admin/assets/scan/route.ts",
+    "./api/admin/assets/registry": "./app/api/admin/assets/registry/route.ts",
+    "./api/admin/assets/relink": "./app/api/admin/assets/relink/route.ts",
+    "./api/admin/assets/relink-confirm": "./app/api/admin/assets/relink/confirm/route.ts",
+    "./api/admin/assets/file": "./app/api/admin/assets/file/route.ts",
+    "./api/admin/assets/register": "./app/api/admin/assets/register/route.ts",
+    "./api/admin/assets/health": "./app/api/admin/assets/health/route.ts",
+    "./api/admin/r2/connect": "./app/api/admin/r2/connect/route.ts",
+    "./api/admin/r2/disconnect": "./app/api/admin/r2/disconnect/route.ts",
+    "./api/admin/r2/status": "./app/api/admin/r2/status/route.ts",
+    "./api/admin/r2/upload-url": "./app/api/admin/r2/upload-url/route.ts",
+    "./api/admin/r2/delete": "./app/api/admin/r2/delete/route.ts",
+    "./api/admin/r2/rename": "./app/api/admin/r2/rename/route.ts",
+    "./api/admin/custom-sections": "./app/api/admin/custom-sections/route.ts",
+    "./api/admin/custom-sections/slug": "./app/api/admin/custom-sections/[slug]/route.ts",
+    "./api/admin/styles": "./app/api/admin/styles/route.ts",
+    "./api/admin/styles/fonts": "./app/api/admin/styles/fonts/route.ts",
+    "./api/admin/settings": "./app/api/admin/settings/route.ts",
+    "./api/admin/database": "./app/api/admin/database/route.ts",
+    "./api/admin/setup": "./app/api/admin/setup/route.ts",
+    "./api/admin/setup/complete": "./app/api/admin/setup/complete/route.ts",
+    "./api/admin/preview": "./app/api/admin/preview/route.ts",
+    "./api/admin/revalidate": "./app/api/admin/revalidate/route.ts",
+    "./api/admin/storage/switch": "./app/api/admin/storage/switch/route.ts",
+    "./api/styles": "./app/api/styles/route.ts",
+    "./api/projects": "./app/api/projects/route.ts",
+    "./api/assets": "./app/api/assets/[...path]/route.ts",
+    "./api/custom-sections": "./app/api/custom-sections/[id]/route.ts",
+    "./api/draft-mode/enable": "./app/api/draft-mode/enable/route.ts",
+    "./api/draft-mode/disable": "./app/api/draft-mode/disable/route.ts"
+  },
+  "peerDependencies": {
+    "next": ">=16.0.0",
+    "react": ">=19.0.0",
+    "react-dom": ">=19.0.0"
+  },
+  "dependencies": {
+    "@aws-sdk/client-s3": "^3.1021.0",
+    "@aws-sdk/s3-request-presigner": "^3.1021.0",
+    "@dnd-kit/core": "^6.3.1",
+    "@dnd-kit/modifiers": "^9.0.0",
+    "@dnd-kit/sortable": "^10.0.0",
+    "@dnd-kit/utilities": "^3.2.2",
+    "next-sanity": "^12.1.5",
+    "sanity": "^5.17.1",
+    "zustand": "^5.0.12",
+    "ogl": "^1.0.8"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "^4",
+    "@types/node": "^20",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "eslint": "^9",
+    "eslint-config-next": "16.2.1",
+    "next": "16.2.1",
+    "react": "19.2.4",
+    "react-dom": "19.2.4",
+    "tailwindcss": "^4",
+    "typescript": "^5",
+    "vitest": "^4.1.2",
+    "@testing-library/react": "^16.3.0",
+    "@testing-library/jest-dom": "^6.6.3",
+    "@testing-library/user-event": "^14.6.1",
+    "jsdom": "^26.1.0"
+  }
+}

package/sanity/compose.ts

@@ -0,0 +1,65 @@
+/**
+ * Sanity Schema Composition
+ *
+ * Merges core schemas with optional instance-specific schemas.
+ * Instance schemas with the same `name` as a core schema override the core version.
+ *
+ * Usage:
+ *   import { coreSchemas } from "@morphika/webframe/sanity/schemas";
+ *   import { composeSchemas } from "@morphika/webframe/sanity/compose";
+ *
+ *   // Use core schemas as-is:
+ *   const schemas = composeSchemas(coreSchemas);
+ *
+ *   // Add custom document types:
+ *   import { myCustomType } from "./schemas/myCustomType";
+ *   const schemas = composeSchemas(coreSchemas, [myCustomType]);
+ *
+ *   // Override a core schema:
+ *   import { customPage } from "./schemas/customPage"; // name: "page"
+ *   const schemas = composeSchemas(coreSchemas, [customPage]); // replaces core "page"
+ */
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+type SanitySchemaType = { name: string; [key: string]: any };
+
+/**
+ * Compose Sanity schema arrays with override-by-name deduplication.
+ *
+ * @param core - Base schema array from @morphika/webframe (required)
+ * @param instance - Optional instance-specific schemas to merge in.
+ *   Schemas whose `name` matches a core schema replace the core version.
+ *   Schemas with new names are appended.
+ * @returns Merged schema array ready for Sanity's `schema.types`
+ */
+export function composeSchemas(
+  core: SanitySchemaType[],
+  instance?: SanitySchemaType[],
+): SanitySchemaType[] {
+  if (!instance || instance.length === 0) {
+    return [...core];
+  }
+
+  // Build a map of instance schemas by name for O(1) lookup
+  const instanceByName = new Map<string, SanitySchemaType>();
+  for (const schema of instance) {
+    instanceByName.set(schema.name, schema);
+  }
+
+  // Replace core schemas that have an instance override
+  const merged: SanitySchemaType[] = core.map((coreSchema) => {
+    const override = instanceByName.get(coreSchema.name);
+    if (override) {
+      instanceByName.delete(coreSchema.name); // consumed
+      return override;
+    }
+    return coreSchema;
+  });
+
+  // Append any remaining instance schemas (new types, not overrides)
+  for (const schema of instanceByName.values()) {
+    merged.push(schema);
+  }
+
+  return merged;
+}

package/sanity/sanity.config.ts

@@ -0,0 +1,126 @@
+import { defineConfig } from "sanity";
+import { structureTool } from "sanity/structure";
+import { presentationTool } from "sanity/presentation";
+import { schemaTypes } from "./schemas";
+import type { StructureBuilder } from "sanity/structure";
+import { getSiteConfig } from "../lib/config";
+
+// siteSettings is the only true singleton (one document, fixed ID)
+const SINGLETON_TYPES = new Set(["siteSettings", "siteStyles", "assetRegistry"]);
+
+const cfg = getSiteConfig();
+
+// Labels for Sanity Studio sidebar — instance can override via site.config.ts
+const labels = {
+  content: "Content",
+  masterPages: "Master Pages",
+  projects: "Projects",
+  allPages: "All Pages",
+  siteSettings: "Site Settings",
+  assetRegistry: "Asset Registry",
+  ...cfg.sanity.studioLabels,
+};
+
+// Custom sidebar structure
+const structure = (S: StructureBuilder) =>
+  S.list()
+    .title(labels.content)
+    .items([
+      // === MASTER PAGES ===
+      // These are `page` documents filtered by page_type (not separate schema types)
+      S.listItem()
+        .title(labels.masterPages)
+        .child(
+          S.list()
+            .title(labels.masterPages)
+            .items([
+              S.listItem()
+                .title("Home")
+                .child(
+                  S.documentList()
+                    .title("Home")
+                    .schemaType("page")
+                    .filter('_type == "page" && page_type == "home"')
+                ),
+              S.listItem()
+                .title("Archive")
+                .child(
+                  S.documentList()
+                    .title("Archive")
+                    .schemaType("page")
+                    .filter('_type == "page" && page_type == "archive"')
+                ),
+              S.listItem()
+                .title("About")
+                .child(
+                  S.documentList()
+                    .title("About")
+                    .schemaType("page")
+                    .filter('_type == "page" && page_type == "about"')
+                ),
+              S.listItem()
+                .title("Contact")
+                .child(
+                  S.documentList()
+                    .title("Contact")
+                    .schemaType("page")
+                    .filter('_type == "page" && page_type == "contact"')
+                ),
+              S.divider(),
+              S.listItem()
+                .title(labels.siteSettings)
+                .child(S.document().schemaType("siteSettings").documentId("siteSettings")),
+              S.listItem()
+                .title(labels.assetRegistry)
+                .child(S.document().schemaType("assetRegistry").documentId("assetRegistry")),
+            ])
+        ),
+
+      S.divider(),
+
+      // === PROJECTS ===
+      // Projects are `page` documents with page_type == "project"
+      S.listItem()
+        .title(labels.projects)
+        .child(
+          S.documentList()
+            .title(labels.projects)
+            .schemaType("page")
+            .filter('_type == "page" && page_type == "project"')
+        ),
+
+      S.divider(),
+
+      // === ALL PAGES ===
+      S.listItem()
+        .title(labels.allPages)
+        .schemaType("page")
+        .child(S.documentTypeList("page").title(labels.allPages)),
+    ]);
+
+export default defineConfig({
+  name: cfg.sanity.projectName,
+  title: cfg.sanity.studioTitle,
+
+  projectId: process.env.NEXT_PUBLIC_SANITY_PROJECT_ID || "",
+  dataset: process.env.NEXT_PUBLIC_SANITY_DATASET || "production",
+
+  basePath: "/studio",
+
+  plugins: [
+    structureTool({ structure }),
+    presentationTool({
+      previewUrl: {
+        previewMode: {
+          enable: "/api/draft-mode/enable",
+        },
+      },
+    }),
+  ],
+  schema: {
+    types: schemaTypes,
+    // Prevent singletons from being created via the "New document" button
+    templates: (templates) =>
+      templates.filter(({ schemaType }) => !SINGLETON_TYPES.has(schemaType)),
+  },
+});