@rizom/site-rizom 0.2.0-alpha.142

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@rizom/site-rizom",
+  "version": "0.2.0-alpha.142",
+  "description": "Shared Rizom site core — structural base for rizom.ai, rizom.foundation, and rizom.work",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "bun scripts/build.ts",
+    "lint": "eslint src scripts/build.ts --max-warnings 0",
+    "lint:fix": "eslint src scripts/build.ts --max-warnings 0 --fix",
+    "postpack": "publish-manifest restore",
+    "prepack": "publish-manifest prepare",
+    "prepublishOnly": "bun scripts/build.ts",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@rizom/site": "0.2.0-alpha.142",
+    "clsx": "^2.1.0",
+    "preact": "^10.27.2",
+    "tailwind-merge": "^3.6.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rizom-ai/brains.git",
+    "directory": "sites/rizom"
+  },
+  "license": "Apache-2.0",
+  "author": "Yeehaa <yeehaa@rizom.ai> (https://rizom.ai)",
+  "homepage": "https://github.com/rizom-ai/brains/tree/main/sites/rizom#readme",
+  "bugs": {
+    "url": "https://github.com/rizom-ai/brains/issues"
+  },
+  "engines": {
+    "bun": ">=1.3.3"
+  },
+  "peerDependencies": {
+    "@rizom/brain": ">=0.2.0-alpha.141 <0.3.0"
+  }
+}

package/src/content.ts

@@ -0,0 +1,9 @@
+import { createSiteContentTemplates as createInternalSiteContentTemplates } from "@brains/site-composition";
+import type { SiteContentDefinition } from "@rizom/site";
+import type { Template } from "./contracts";
+
+export function createSiteContentTemplates(
+  definition: SiteContentDefinition,
+): Record<string, Template> {
+  return createInternalSiteContentTemplates(definition);
+}

package/src/contracts.ts

@@ -0,0 +1,157 @@
+import type {
+  ComponentType,
+  EntityDisplayEntry,
+  RouteDefinitionInput,
+  RuntimeScript,
+  SiteContentDefinition,
+  SiteLayoutInfo,
+  UserPermissionLevel,
+} from "@rizom/site";
+import type { ComponentChildren } from "preact";
+
+export type {
+  ComponentType,
+  EntityDisplayEntry,
+  NavigationItem,
+  NavigationMetadata,
+  NavigationSlot,
+  RizomBrandSuffix,
+  RizomFooterTagline,
+  RizomLayoutProps,
+  RizomLink,
+  RizomSideNavItem,
+  RouteDefinition,
+  RouteDefinitionInput,
+  RuntimeScript,
+  SectionDefinition,
+  SectionDefinitionInput,
+  SiteContentArrayFieldDefinition,
+  SiteContentDefinition,
+  SiteContentEnumFieldDefinition,
+  SiteContentFieldDefinition,
+  SiteContentNumberFieldDefinition,
+  SiteContentObjectFieldDefinition,
+  SiteContentSectionDefinition,
+  SiteContentStringFieldDefinition,
+  SiteDefinition,
+  SiteDefinitionOverrides,
+  SiteLayoutInfo,
+  SiteMetadata,
+  SiteMetadataCTA,
+  SiteMetadataSection,
+  UserPermissionLevel,
+} from "@rizom/site";
+export { NavigationSlots } from "@rizom/site";
+
+export type RizomThemeProfile = "product" | "editorial" | "studio";
+
+export interface RizomRuntimeConfig {
+  themeProfile?: RizomThemeProfile;
+  theme?: string;
+}
+
+export interface RizomPluginCapabilities {
+  tools: [];
+  resources: [];
+}
+
+export interface RizomMessageBus {
+  subscribe(
+    channel: string,
+    handler: () => Promise<{ success: boolean }>,
+  ): unknown;
+  send(message: {
+    type: string;
+    sender: string;
+    payload: Record<string, unknown>;
+  }): Promise<unknown>;
+}
+
+export interface RizomLogger {
+  info(message: string): void;
+}
+
+export interface DataSourceRegistry {
+  register(dataSource: unknown): void;
+}
+
+export interface RizomSiteShell {
+  getMessageBus(): RizomMessageBus;
+  getLogger(): RizomLogger;
+  registerTemplates(
+    templates: Record<string, unknown>,
+    namespace?: string,
+  ): void;
+  getDataSourceRegistry(): DataSourceRegistry;
+}
+
+export interface SiteCompositionPlugin {
+  readonly id: string;
+  readonly version: string;
+  readonly type: "core" | "entity" | "service" | "interface";
+  readonly packageName: string;
+  readonly description?: string | undefined;
+  readonly dependencies?: string[] | undefined;
+  register?(
+    shell: RizomSiteShell,
+    context?: unknown,
+  ): Promise<RizomPluginCapabilities>;
+  ready?(): Promise<void>;
+  shutdown?(): Promise<void>;
+  requiresDaemonStartup?(): boolean;
+}
+
+export interface ContentFormatter<T = unknown> {
+  format(data: T): string;
+  parse(content: string): T;
+}
+
+export interface Template {
+  name: string;
+  description: string;
+  schema: unknown;
+  requiredPermission: UserPermissionLevel;
+  formatter?: ContentFormatter<unknown>;
+  layout?: {
+    component?: ComponentType<unknown>;
+    fullscreen?: boolean;
+  };
+  runtimeScripts?: RuntimeScript[];
+}
+
+export interface DataSource {
+  id: string;
+  name: string;
+  description?: string;
+  fetch?<T>(
+    query: unknown,
+    outputSchema: unknown,
+    context: unknown,
+  ): Promise<T>;
+  generate?<T>(request: unknown, schema: unknown): Promise<T>;
+  transform?<T>(content: unknown, format: string, schema: unknown): Promise<T>;
+}
+
+export interface SitePackage<
+  TPluginConfig = Record<string, unknown>,
+  TPlugin extends SiteCompositionPlugin = SiteCompositionPlugin,
+> {
+  layouts: Record<string, unknown>;
+  routes: RouteDefinitionInput[];
+  plugin?: ((config?: TPluginConfig) => TPlugin) | undefined;
+  content?: SiteContentDefinition | SiteContentDefinition[];
+  themeOverride?: string;
+  headScripts?: string[];
+  entityDisplay: Record<string, EntityDisplayEntry>;
+  staticAssets?: Record<string, string>;
+}
+
+// Keeps this module as the source-owned bridge for the current runtime shape;
+// the author-facing layout props themselves come from @rizom/site.
+export interface RuntimeRizomLayoutProps {
+  sections: ComponentChildren[];
+  title: string;
+  description: string;
+  path: string;
+  siteInfo: SiteLayoutInfo;
+}

package/src/create-site.ts

@@ -0,0 +1,108 @@
+import { extendSite } from "@brains/site-composition";
+import type {
+  RouteDefinitionInput,
+  SiteContentDefinition,
+  SiteDefinition,
+} from "@rizom/site";
+import rizomBaseSite from ".";
+import type {
+  RizomPluginCapabilities,
+  RizomSiteShell,
+  RizomThemeProfile,
+  SitePackage,
+} from "./contracts";
+import { buildRizomHeadScript, RizomRuntimePlugin } from "./runtime/plugin";
+
+interface TemplateGroup {
+  namespace: string;
+  templates: Record<string, unknown>;
+}
+
+export interface RizomRuntimeHooks {
+  contentNamespace: string;
+  templates?: Record<string, unknown>;
+  dataSources?: unknown[];
+}
+
+class RizomVariantPlugin extends RizomRuntimePlugin {
+  private readonly templateGroups: TemplateGroup[];
+  private readonly dataSources: unknown[];
+
+  constructor(
+    packageName: string,
+    config: Record<string, unknown>,
+    templateGroups: TemplateGroup[],
+    dataSources: unknown[] = [],
+  ) {
+    super(packageName, config);
+    this.templateGroups = templateGroups;
+    this.dataSources = dataSources;
+  }
+
+  override async register(
+    shell: RizomSiteShell,
+    _context?: unknown,
+  ): Promise<RizomPluginCapabilities> {
+    for (const group of this.templateGroups) {
+      shell.registerTemplates(group.templates, group.namespace);
+    }
+    for (const dataSource of this.dataSources) {
+      shell.getDataSourceRegistry().register(dataSource);
+    }
+    return { tools: [], resources: [] };
+  }
+}
+
+export interface CreateRizomSiteOptions {
+  packageName: string;
+  themeProfile: RizomThemeProfile;
+  layout: unknown;
+  routes: RouteDefinitionInput[];
+  content?: SiteContentDefinition | SiteContentDefinition[];
+  themeOverride?: string;
+  /** Advanced runtime hooks for in-repo sites that need custom template/data-source wiring. */
+  runtime?: RizomRuntimeHooks;
+}
+
+function buildTemplateGroups(options: CreateRizomSiteOptions): TemplateGroup[] {
+  if (!options.runtime?.templates) {
+    return [];
+  }
+  return [
+    {
+      namespace: options.runtime.contentNamespace,
+      templates: options.runtime.templates,
+    },
+  ];
+}
+
+function createRuntimePlugin(
+  options: CreateRizomSiteOptions,
+): SitePackage["plugin"] {
+  if (!options.runtime?.templates && !options.runtime?.dataSources?.length) {
+    return undefined;
+  }
+
+  return (config?: Record<string, unknown>): RizomRuntimePlugin =>
+    new RizomVariantPlugin(
+      options.packageName,
+      { themeProfile: options.themeProfile, ...(config ?? {}) },
+      buildTemplateGroups(options),
+      options.runtime?.dataSources,
+    );
+}
+
+export function createRizomSite(
+  options: CreateRizomSiteOptions,
+): SiteDefinition {
+  const plugin = createRuntimePlugin(options);
+
+  return extendSite(rizomBaseSite, {
+    layouts: { default: options.layout },
+    routes: options.routes,
+    ...(options.content ? { content: options.content } : {}),
+    headScripts: [buildRizomHeadScript(options.themeProfile)],
+    ...(plugin ? { plugin } : {}),
+    ...(options.themeOverride ? { themeOverride: options.themeOverride } : {}),
+  });
+}

package/src/index.ts

@@ -0,0 +1,63 @@
+/**
+ * Shared Rizom site core.
+ *
+ * This is the structural base that the app-owned Rizom variants
+ * compose from. It re-exports shared Rizom runtime and UI
+ * primitives used by the app-owned site/content layers.
+ */
+export {
+  DefaultRizomLayout,
+  rizomBaseSite,
+  rizomBaseSite as default,
+} from "./runtime";
+
+export { createRizomSite } from "./create-site";
+export type { CreateRizomSiteOptions } from "./create-site";
+export type { RizomThemeProfile } from "./contracts";
+export type {
+  EntityDisplayEntry,
+  RouteDefinitionInput,
+  SectionDefinitionInput,
+  SiteContentArrayFieldDefinition,
+  SiteContentDefinition,
+  SiteContentEnumFieldDefinition,
+  SiteContentFieldDefinition,
+  SiteContentNumberFieldDefinition,
+  SiteContentObjectFieldDefinition,
+  SiteContentSectionDefinition,
+  SiteContentStringFieldDefinition,
+  SiteDefinition,
+  SiteDefinitionOverrides,
+  SiteLayoutInfo,
+} from "@rizom/site";
+export {
+  Badge,
+  Button,
+  Divider,
+  Footer,
+  Header,
+  RizomFrame,
+  Section,
+  SideNav,
+  socialLinksToRizomLinks,
+  renderHighlightedText,
+  GUTTER,
+} from "./ui";
+export type {
+  RizomBrandSuffix,
+  RizomFooterTagline,
+  RizomLayoutProps,
+  RizomLink,
+  RizomSideNavItem,
+} from "./ui";
+export type {
+  BadgeProps,
+  ButtonProps,
+  ButtonSize,
+  ButtonVariant,
+  DividerProps,
+  RizomFrameProps,
+  SectionProps,
+} from "./ui";
+export { Wordmark, Ecosystem } from "@rizom/ui";
+export type { WordmarkProps, EcosystemCard, EcosystemContent } from "@rizom/ui";

package/src/runtime/base-site.ts

@@ -0,0 +1,13 @@
+import type { SiteDefinition } from "@rizom/site";
+import { DefaultRizomLayout } from "./default-layout";
+import { buildRizomHeadScript, rizomRuntimeStaticAssets } from "./plugin";
+
+export const rizomBaseSite: SiteDefinition = {
+  layouts: {
+    default: DefaultRizomLayout,
+  },
+  routes: [],
+  headScripts: [buildRizomHeadScript()],
+  entityDisplay: {},
+  staticAssets: rizomRuntimeStaticAssets,
+};

package/src/runtime/boot/boot.boot.d.ts

@@ -0,0 +1,2 @@
+declare const content: string;
+export default content;

package/src/runtime/boot/boot.boot.js

@@ -0,0 +1,83 @@
+/**
+ * Rizom site boot script.
+ *
+ * Runs once at page load and wires up:
+ *   1. Scroll-reveal IntersectionObserver → toggles `.visible` on `.reveal`
+ *   2. Side-nav active-dot tracker (home route only)
+ *   3. #themeToggle label sync on click (delegates theme flip to
+ *      window.toggleTheme, which is defined by site-builder's inline
+ *      FOUC-prevention script — see plugins/site-builder html-generator.ts)
+ *
+ * Shipped as a static asset at /boot.js and loaded with <script defer>.
+ * Theme profile selection is applied separately via a tiny inline head
+ * script that writes `data-theme-profile` onto <html> before this file runs.
+ */
+(function () {
+  function init() {
+    // Scroll reveal — toggle .visible on .reveal elements as they enter view
+    var io = new IntersectionObserver(
+      function (entries) {
+        entries.forEach(function (e) {
+          if (e.isIntersecting) {
+            e.target.classList.add("visible");
+          }
+        });
+      },
+      { threshold: 0.1, rootMargin: "0px 0px -40px 0px" },
+    );
+    document.querySelectorAll(".reveal").forEach(function (el) {
+      io.observe(el);
+    });
+
+    // Side nav active-dot tracker (skipped on routes without SideNav).
+    // The dot → section mapping is derived from the rendered dots'
+    // href attributes, so SideNav.tsx stays the single source of truth.
+    var dots = document.querySelectorAll(".side-nav-dot");
+    if (dots.length > 0) {
+      var ids = Array.prototype.map.call(dots, function (d) {
+        return (d.getAttribute("href") || "").replace(/^#/, "");
+      });
+      var so = new IntersectionObserver(
+        function (entries) {
+          entries.forEach(function (e) {
+            if (!e.isIntersecting) return;
+            var idx = ids.indexOf(e.target.id);
+            if (idx < 0 || dots[idx].classList.contains("active")) return;
+            dots.forEach(function (d) {
+              d.classList.remove("active");
+            });
+            dots[idx].classList.add("active");
+          });
+        },
+        { threshold: 0.4 },
+      );
+      ids.forEach(function (id) {
+        if (!id) return;
+        var el = document.getElementById(id);
+        if (el) so.observe(el);
+      });
+    }
+
+    // Theme toggle — delegate actual flip to window.toggleTheme (injected
+    // by site-builder), we just keep the button label in sync.
+    var toggle = document.getElementById("themeToggle");
+    if (toggle) {
+      var syncLabel = function () {
+        var isLight =
+          document.documentElement.getAttribute("data-theme") === "light";
+        toggle.textContent = isLight ? "\u263e Dark" : "\u2600 Light";
+      };
+      syncLabel();
+      toggle.addEventListener("click", function () {
+        if (typeof window.toggleTheme === "function") window.toggleTheme();
+        syncLabel();
+      });
+    }
+  }
+
+  if (document.readyState === "loading") {
+    document.addEventListener("DOMContentLoaded", init);
+  } else {
+    init();
+  }
+})();

package/src/runtime/canvases/constellation.canvas.d.ts

@@ -0,0 +1,2 @@
+declare const content: string;
+export default content;