studiocms 0.1.0-beta.21 → 0.1.0-beta.22

package/CHANGELOG.md

@@ -1,5 +1,42 @@
 # studiocms
 
+## 0.1.0-beta.22
+
+### Patch Changes
+
+- [#649](https://github.com/withstudiocms/studiocms/pull/649) [`336397f`](https://github.com/withstudiocms/studiocms/commit/336397f31a63bdb05a17a6a7e9a0ab22601bbb61) Thanks [@Adammatthiesen](https://github.com/Adammatthiesen)! - Remove deprecated `@astrojs/web-vitals` support in favor of new `@studiocms/web-vitals` package
+
+- [#644](https://github.com/withstudiocms/studiocms/pull/644) [`83a47ff`](https://github.com/withstudiocms/studiocms/commit/83a47ff1912f30bae20461b2bfd994efe3f35749) Thanks [@Adammatthiesen](https://github.com/Adammatthiesen)! - Add support for the SDK folder getter to get by name or ID instead of just ID, and add jsdoc comments to missing functions for the SDK
+
+- [#629](https://github.com/withstudiocms/studiocms/pull/629) [`356791d`](https://github.com/withstudiocms/studiocms/commit/356791d80aa8a33cbb77e2c83ca8fc70eaf3b5dd) Thanks [@Adammatthiesen](https://github.com/Adammatthiesen)! - Refactor component registry into new custom handler for reading component props during initialization for usage within StudioCMS Dashboard editors
+
+  #### Breaking Changes
+
+  - `studiocms:component-proxy` has been replaced by `studiocms:component-registry`
+  - Added `studiocms:component-registry/runtime` virtual module which exports types, and the following helpers, `getRegistryComponents` and `getRendererComponents` used for getting Components with props, and the renderer components respectively.
+  - `importComponentKeys` has been carried over but deprecated in favor for the new `getRendererComponents` function.
+
+- [#642](https://github.com/withstudiocms/studiocms/pull/642) [`e9be97d`](https://github.com/withstudiocms/studiocms/commit/e9be97dabcd8e479f929a43919332e5deb187900) Thanks [@Adammatthiesen](https://github.com/Adammatthiesen)! - Fix: Correct exports for components, layouts, and add export for styles
+
+- [#650](https://github.com/withstudiocms/studiocms/pull/650) [`3e7f7ca`](https://github.com/withstudiocms/studiocms/commit/3e7f7ca6ea2a304fe66eac95496542cc50169eb2) Thanks [@Adammatthiesen](https://github.com/Adammatthiesen)! - Update various deps and lint repo with updated biome version
+
+- [#643](https://github.com/withstudiocms/studiocms/pull/643) [`9cfba9a`](https://github.com/withstudiocms/studiocms/commit/9cfba9ad57f8fb1b2a10081fbe5f9dfc26bed57d) Thanks [@Adammatthiesen](https://github.com/Adammatthiesen)! - Moved MD and HTML pagetypes into their own plugins
+
+- [#656](https://github.com/withstudiocms/studiocms/pull/656) [`3233abe`](https://github.com/withstudiocms/studiocms/commit/3233abe727ac9ba6f1886ef5a931db81f0da4326) Thanks [@Adammatthiesen](https://github.com/Adammatthiesen)! - Update dependencies
+
+- [#637](https://github.com/withstudiocms/studiocms/pull/637) [`7511f47`](https://github.com/withstudiocms/studiocms/commit/7511f47042104bed83f985c336c7d62cc1fd3b2f) Thanks [@Adammatthiesen](https://github.com/Adammatthiesen)! - Remove Deprecated SDK functions and refactor SDK to make it easier to modify/read
+
+- [#643](https://github.com/withstudiocms/studiocms/pull/643) [`9cfba9a`](https://github.com/withstudiocms/studiocms/commit/9cfba9ad57f8fb1b2a10081fbe5f9dfc26bed57d) Thanks [@Adammatthiesen](https://github.com/Adammatthiesen)! - All internal base included pagetypes have been removed, allowing even more flexibility when it comes to how studiocms works for the user. This change also means that you will be required to install at least one rendering plugin for studiocms
+
+- [#640](https://github.com/withstudiocms/studiocms/pull/640) [`fe3fa26`](https://github.com/withstudiocms/studiocms/commit/fe3fa262b80a17ea2d89d8f09e4c3ac97f64ca5f) Thanks [@Adammatthiesen](https://github.com/Adammatthiesen)! - Remove previously deprected functions and old hashing system
+
+- [#635](https://github.com/withstudiocms/studiocms/pull/635) [`54da8e7`](https://github.com/withstudiocms/studiocms/commit/54da8e7ff080f44a02ca8139c8ddade37f1d32f4) Thanks [@Adammatthiesen](https://github.com/Adammatthiesen)! - Refactor oAuth endpoints into two dynamic endpoints with a provider param in the route and cleanup all auth endpoints code.
+
+- [#657](https://github.com/withstudiocms/studiocms/pull/657) [`a05bb16`](https://github.com/withstudiocms/studiocms/commit/a05bb16d3dd0d1a429558b4dce316ad7fb80b049) Thanks [@Adammatthiesen](https://github.com/Adammatthiesen)! - Migrate to using new config utils package that contains generic config helpers instead of relying on specific ones built-in to studiocms
+
+- Updated dependencies [[`a05bb16`](https://github.com/withstudiocms/studiocms/commit/a05bb16d3dd0d1a429558b4dce316ad7fb80b049)]:
+  - @withstudiocms/config-utils@0.1.0-beta.1
+
 ## 0.1.0-beta.21
 
 ### Patch Changes

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 StudioCMS - Adam Matthiesen, Jacob Jenkins, Paul Valladares
+Copyright (c) 2025-present StudioCMS - withstudiocms (https://github.com/withstudiocms)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/dist/cli/add/index.js

@@ -1,11 +1,11 @@
-import { promises as fs, existsSync } from "node:fs";
+import { existsSync, promises as fs } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { Args, Command } from "@effect/cli";
 import { cancelled, success } from "@withstudiocms/cli-kit/messages";
 import { exists, pathToFileURL, resolveRoot } from "@withstudiocms/cli-kit/utils";
 import { builders, loadFile } from "magicast";
 import { getDefaultExportOptions } from "magicast/helpers";
-import { Console, Effect, genLogger } from "../../effect.js";
+import { Console, Effect, genLogger, Layer } from "../../effect.js";
 import { CliContext, genContext } from "../utils/context.js";
 import { logger } from "../utils/logger.js";
 import { TryToInstallPlugins } from "./tryToInstallPlugins.js";
@@ -13,8 +13,11 @@ import { UpdateStudioCMSConfig } from "./updateStudioCMSConfig.js";
 import { ValidatePlugins } from "./validatePlugins.js";
 const ALIASES = /* @__PURE__ */ new Map([
   ["blog", "@studiocms/blog"],
-  ["mdx", "@studiocms/mdx"],
+  ["cloudinary", "@studiocms/cloudinary-image-service"],
+  ["html", "@studiocms/html"],
   ["markdoc", "@studiocms/markdoc"],
+  ["md", "@studiocms/md"],
+  ["mdx", "@studiocms/mdx"],
   ["wysiwyg", "@studiocms/wysiwyg"]
 ]);
 const StudioCMSScopes = ["@studiocms", "@withstudiocms"];
@@ -112,6 +115,11 @@ const loadConfigModule = (configURL, validatedPlugins) => genLogger("studiocms/c
   }
   return mod;
 });
+const addPluginDeps = Layer.mergeAll(
+  ValidatePlugins.Default,
+  TryToInstallPlugins.Default,
+  UpdateStudioCMSConfig.Default
+);
 const addPlugin = Command.make(
   "add",
   {
@@ -203,11 +211,7 @@ const addPlugin = Command.make(
         );
       }
     }
-  }).pipe(
-    Effect.provide(ValidatePlugins.Default),
-    Effect.provide(TryToInstallPlugins.Default),
-    Effect.provide(UpdateStudioCMSConfig.Default)
-  )
+  }).pipe(Effect.provide(addPluginDeps))
 ).pipe(Command.withDescription("Add StudioCMS plugin(s) to your project"));
 export {
   ALIASES,

package/dist/cli/crypto/genJWT/index.js

@@ -78,7 +78,7 @@ const genJWT = Command.make(
       let privateKey;
       try {
         privateKey = yield* Effect.tryPromise(() => importPKCS8(keyString, alg));
-      } catch (e) {
+      } catch (_e) {
         spinner.stop("Invalid or unsupported private key");
         return yield* Effect.fail(new Error("Invalid or unsupported private key"));
       }

package/dist/cli/init/steps/env.js

@@ -16,7 +16,7 @@ import {
   runShellCommand
 } from "@withstudiocms/cli-kit/utils";
 import { logger } from "../../utils/logger.js";
-import { ExampleEnv, buildEnvFile } from "../../utils/studiocmsEnv.js";
+import { buildEnvFile, ExampleEnv } from "../../utils/studiocmsEnv.js";
 var EnvBuilderAction = /* @__PURE__ */ ((EnvBuilderAction2) => {
   EnvBuilderAction2["builder"] = "builder";
   EnvBuilderAction2["example"] = "example";

package/dist/cli/users/steps/libsqlCreateUsers.js

@@ -1,7 +1,7 @@
 import { StudioCMSColorwayError, StudioCMSColorwayInfo } from "@withstudiocms/cli-kit/colors";
 import { z } from "astro/zod";
 import dotenv from "dotenv";
-import { Effect, convertToVanilla } from "../../../effect.js";
+import { convertToVanilla, Effect } from "../../../effect.js";
 import { CheckIfUnsafe } from "../../../lib/auth/utils/unsafeCheck.js";
 import { checkRequiredEnvVars } from "../../utils/checkRequiredEnvVars.js";
 import { createUserAvatar } from "../../utils/createUserAvatar.js";

package/dist/cli/users/steps/libsqlModifyUsers.js

@@ -1,7 +1,7 @@
 import { StudioCMSColorwayError, StudioCMSColorwayInfo } from "@withstudiocms/cli-kit/colors";
 import dotenv from "dotenv";
 import { eq } from "drizzle-orm";
-import { Effect, convertToVanilla } from "../../../effect.js";
+import { convertToVanilla, Effect } from "../../../effect.js";
 import { CheckIfUnsafe } from "../../../lib/auth/utils/unsafeCheck.js";
 import { checkRequiredEnvVars } from "../../utils/checkRequiredEnvVars.js";
 import { logger } from "../../utils/logger.js";

package/dist/cli/utils/context.js

@@ -2,7 +2,7 @@ import * as prompts from "@clack/prompts";
 import { detectPackageManager } from "@withstudiocms/cli-kit/context";
 import { cancelMessage, getName } from "@withstudiocms/cli-kit/messages";
 import chalk from "chalk";
-import { Context, Effect, Layer, genLogger } from "../../effect.js";
+import { Context, Effect, genLogger, Layer } from "../../effect.js";
 class CliContext extends Context.Tag("CliContext")() {
   static makeLayer = (context) => Layer.succeed(this, this.of(context));
   static makeProvide = (context) => Effect.provide(this.makeLayer(context));

package/dist/cli/utils/user-utils.js

@@ -1,13 +1,12 @@
-import crypto from "node:crypto";
-import { scrypt } from "node:crypto";
+import crypto, { scrypt } from "node:crypto";
 import {
   Brand,
   Context,
   Data,
   Effect,
-  Layer,
   errorTap,
   genLogger,
+  Layer,
   pipeLogger
 } from "../../effect.js";
 const parsedN = Number.parseInt(process.env.SCRYPT_N ?? "", 10);

package/dist/componentRegistry/PropsParser.d.ts

@@ -0,0 +1,15 @@
+import { Effect } from '../effect.js';
+import { ComponentRegistryError, FileParseError } from './errors.js';
+import type { AstroComponentProps } from './types.js';
+declare const PropsParser_base: Effect.Service.Class<PropsParser, "PropsParser", {
+    readonly effect: Effect.Effect<{
+        parseComponentProps: (sourceCode: string) => Effect.Effect<AstroComponentProps[], ComponentRegistryError, never>;
+        extractPropsFromAstroFile: (astroFileContent: string) => Effect.Effect<string, FileParseError, never>;
+    }, never, never>;
+}>;
+/**
+ * Service for parsing component props from TypeScript source code and extracting prop definitions from Astro files.
+ */
+export declare class PropsParser extends PropsParser_base {
+}
+export {};

package/dist/componentRegistry/PropsParser.js

@@ -0,0 +1,214 @@
+import { Project, SyntaxKind } from "ts-morph";
+import { Effect, genLogger, pipeLogger } from "../effect.js";
+import { ComponentRegistryError, FileParseError } from "./errors.js";
+class PropsParser extends Effect.Service()("PropsParser", {
+  effect: genLogger("studiocms/componentRegistry/PropsParser")(function* () {
+    return {
+      parseComponentProps: (sourceCode) => pipeLogger("studiocms/componentRegistry/PropsParser.parseComponentProps")(
+        Effect.try({
+          try: () => {
+            const project = new Project();
+            const sourceFile = project.createSourceFile("temp.ts", sourceCode);
+            const results = [];
+            const extractJSDocInfo = (node) => {
+              const jsDocComments = node.getJsDocs();
+              let description;
+              let defaultValue;
+              const jsDocTags = [];
+              if (jsDocComments.length > 0) {
+                description = jsDocComments[0].getDescription().trim();
+                for (const jsDoc of jsDocComments) {
+                  const tags = jsDoc.getTags();
+                  for (const tag of tags) {
+                    const tagName = tag.getTagName();
+                    const commentText = tag.getCommentText();
+                    switch (tagName) {
+                      case "param": {
+                        const paramInfo = tag.getStructure();
+                        jsDocTags.push({
+                          tagName,
+                          text: commentText,
+                          name: paramInfo.tagName,
+                          type: typeof paramInfo.text === "string" ? paramInfo.text : void 0
+                        });
+                        break;
+                      }
+                      case "default": {
+                        defaultValue = commentText;
+                        jsDocTags.push({
+                          tagName,
+                          text: commentText
+                        });
+                        break;
+                      }
+                      case "example":
+                      case "since":
+                      case "deprecated":
+                      case "see":
+                      case "author":
+                      case "version":
+                      case "throws":
+                      case "returns":
+                      case "readonly":
+                      case "internal":
+                      case "beta":
+                      case "alpha":
+                      case "experimental": {
+                        jsDocTags.push({
+                          tagName,
+                          text: commentText
+                        });
+                        break;
+                      }
+                      default: {
+                        jsDocTags.push({
+                          tagName,
+                          text: commentText
+                        });
+                      }
+                    }
+                  }
+                }
+              }
+              return { description, defaultValue, jsDocTags };
+            };
+            const interfaces = sourceFile.getInterfaces();
+            for (const interfaceDecl of interfaces) {
+              const interfaceName = interfaceDecl.getName();
+              const props = [];
+              const properties = interfaceDecl.getProperties();
+              for (const property of properties) {
+                const propName = property.getName();
+                const propType = property.getTypeNode()?.getText() || "unknown";
+                const isOptional = property.hasQuestionToken();
+                const { description, defaultValue, jsDocTags } = extractJSDocInfo(property);
+                props.push({
+                  name: propName,
+                  type: propType,
+                  optional: isOptional,
+                  description,
+                  defaultValue,
+                  jsDocTags: jsDocTags.length > 0 ? jsDocTags : void 0
+                });
+              }
+              results.push({ name: interfaceName, props });
+            }
+            const typeAliases = sourceFile.getTypeAliases();
+            for (const typeAlias of typeAliases) {
+              const typeName = typeAlias.getName();
+              const typeNode = typeAlias.getTypeNode();
+              if (typeNode && typeNode.getKind() === SyntaxKind.TypeLiteral) {
+                const props = [];
+                const typeLiteral = typeNode.asKindOrThrow(SyntaxKind.TypeLiteral);
+                const members = typeLiteral.getMembers();
+                for (const member of members) {
+                  if (member.getKind() === SyntaxKind.PropertySignature) {
+                    const propSig = member.asKindOrThrow(SyntaxKind.PropertySignature);
+                    const propName = propSig.getName();
+                    const propType = propSig.getTypeNode()?.getText() || "unknown";
+                    const isOptional = propSig.hasQuestionToken();
+                    const { description, defaultValue, jsDocTags } = extractJSDocInfo(propSig);
+                    props.push({
+                      name: propName,
+                      type: propType,
+                      optional: isOptional,
+                      description,
+                      defaultValue,
+                      jsDocTags: jsDocTags.length > 0 ? jsDocTags : void 0
+                    });
+                  }
+                }
+                results.push({ name: typeName, props });
+              } else {
+                console.log(
+                  `Type alias ${typeName} is not a type literal, kind: ${typeNode?.getKindName()}`
+                );
+              }
+            }
+            return results;
+          },
+          catch: (error) => {
+            console.error("Error parsing component props:", error);
+            return new ComponentRegistryError({
+              message: "Failed to parse component props",
+              cause: error
+            });
+          }
+        })
+      ),
+      extractPropsFromAstroFile: (astroFileContent) => pipeLogger("studiocms/componentRegistry/PropsParser.extractPropsFromAstroFile")(
+        Effect.try({
+          try: () => {
+            const frontmatterMatch = astroFileContent.match(/^---\s*\n([\s\S]*?)\n---/m);
+            if (!frontmatterMatch) {
+              throw new Error("No frontmatter found in Astro file");
+            }
+            const frontmatter = frontmatterMatch[1];
+            const interfaceMatch = frontmatter.match(
+              /((?:export\s+)?interface\s+Props\s*\{[\s\S]*?\n\})/m
+            );
+            if (interfaceMatch) {
+              const propsDefinition2 = interfaceMatch[0].replace(/^export\s+/, "");
+              return propsDefinition2;
+            }
+            const typeMatch = frontmatter.match(
+              /((?:export\s+)?type\s+Props\s*=\s*\{[\s\S]*?\n\})/m
+            );
+            if (typeMatch) {
+              const propsDefinition2 = typeMatch[0].replace(/^export\s+/, "");
+              return propsDefinition2;
+            }
+            const propsStart = frontmatter.search(
+              /(?:export\s+)?(?:interface|type)\s+Props\s*[={]/
+            );
+            if (propsStart === -1) {
+              throw new Error("No Props interface or type found in frontmatter");
+            }
+            const propsSubstring = frontmatter.substring(propsStart);
+            let braceCount = 0;
+            let inString = false;
+            let stringChar = "";
+            let i = 0;
+            for (i = 0; i < propsSubstring.length; i++) {
+              const char = propsSubstring[i];
+              const prevChar = i > 0 ? propsSubstring[i - 1] : "";
+              if ((char === '"' || char === "'" || char === "`") && prevChar !== "\\") {
+                if (!inString) {
+                  inString = true;
+                  stringChar = char;
+                } else if (char === stringChar) {
+                  inString = false;
+                  stringChar = "";
+                }
+              }
+              if (!inString) {
+                if (char === "{") {
+                  braceCount++;
+                } else if (char === "}") {
+                  braceCount--;
+                  if (braceCount === 0) {
+                    break;
+                  }
+                }
+              }
+            }
+            const propsDefinition = propsSubstring.substring(0, i + 1).replace(/^export\s+/, "");
+            return propsDefinition;
+          },
+          catch: (error) => {
+            console.error("Error extracting props from Astro file:", error);
+            return new FileParseError({
+              filePath: "astro-content",
+              message: error instanceof Error ? error.message : "Failed to extract props from Astro file",
+              cause: error
+            });
+          }
+        })
+      )
+    };
+  })
+}) {
+}
+export {
+  PropsParser
+};

package/dist/componentRegistry/Registry.d.ts

@@ -0,0 +1,46 @@
+import * as FileSystem from '@effect/platform/FileSystem';
+import * as Path from '@effect/platform/Path';
+import { Effect } from '../effect.js';
+import { ComponentNotFoundError, ComponentRegistryError, FileParseError } from './errors.js';
+import { PropsParser } from './PropsParser.js';
+import type { AstroComponentProps } from './types.js';
+declare const ComponentRegistry_base: Effect.Service.Class<ComponentRegistry, "ComponentRegistry", {
+    readonly dependencies: readonly [import("effect/Layer").Layer<PropsParser, never, never>, import("effect/Layer").Layer<Path.Path, never, never>, import("effect/Layer").Layer<FileSystem.FileSystem, never, never>];
+    readonly effect: Effect.Effect<{
+        registerComponentFromFile: (filePath: string, componentName?: string) => Effect.Effect<void, ComponentRegistryError | FileParseError | import("@effect/platform/Error").PlatformError, never>;
+        getAllComponents: () => Effect.Effect<Map<string, AstroComponentProps>, never, never>;
+        getComponentProps: (componentName: string) => Effect.Effect<AstroComponentProps | undefined, ComponentNotFoundError, never>;
+        validateProps: (componentName: string, props: Record<string, unknown>) => Effect.Effect<{
+            valid: boolean;
+            errors: string[];
+        }, ComponentNotFoundError, never>;
+    }, never, never>;
+}>;
+/**
+ * A service class for registering, retrieving, and validating Astro component props.
+ *
+ * The `ComponentRegistry` provides methods to:
+ * - Register a component and its props from an Astro file.
+ * - Retrieve the props definition for a registered component.
+ * - List all registered components and their props.
+ * - Validate a set of props against a registered component's prop definition.
+ *
+ * Dependencies:
+ * - `PropsParser.Default`: Used to extract and parse props from Astro files.
+ * - `Path.layer`: Used for file path operations.
+ * - `NodeFileSystem.layer`: Used for reading files from the filesystem.
+ *
+ * Methods:
+ * - `registerComponentFromFile(filePath: string, componentName?: string)`: Registers a component by reading and parsing its props from the specified Astro file.
+ * - `getComponentProps(componentName: string)`: Retrieves the props definition for the specified component.
+ * - `getAllComponents()`: Returns a map of all registered components and their props.
+ * - `validateProps(componentName: string, props: Record<string, unknown>)`: Validates the provided props against the registered component's prop definition, checking for missing required props and unknown props.
+ *
+ * Errors:
+ * - Throws `FileParseError` if the Astro file cannot be parsed.
+ * - Throws `ComponentRegistryError` if registration fails.
+ * - Throws `ComponentNotFoundError` if a requested component is not registered.
+ */
+export declare class ComponentRegistry extends ComponentRegistry_base {
+}
+export {};

package/dist/componentRegistry/Registry.js

@@ -0,0 +1,79 @@
+import * as FileSystem from "@effect/platform/FileSystem";
+import * as Path from "@effect/platform/Path";
+import * as NodeFileSystem from "@effect/platform-node/NodeFileSystem";
+import { Effect, genLogger } from "../effect.js";
+import { ComponentNotFoundError, ComponentRegistryError, FileParseError } from "./errors.js";
+import { PropsParser } from "./PropsParser.js";
+class ComponentRegistry extends Effect.Service()("ComponentRegistry", {
+  dependencies: [PropsParser.Default, Path.layer, NodeFileSystem.layer],
+  effect: genLogger("studiocms/componentRegistry/Registry")(function* () {
+    const parser = yield* PropsParser;
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const components = /* @__PURE__ */ new Map();
+    return {
+      registerComponentFromFile: (filePath, componentName) => genLogger("studiocms/componentRegistry/Registry.registerComponentFromFile")(function* () {
+        const fileContent = yield* fs.readFileString(filePath);
+        const propsDefinition = yield* parser.extractPropsFromAstroFile(fileContent).pipe(
+          Effect.mapError(
+            (error) => new FileParseError({
+              filePath,
+              message: error.message,
+              cause: error.cause
+            })
+          )
+        );
+        const name = componentName || path.basename(filePath, path.extname(filePath));
+        const parsed = yield* parser.parseComponentProps(propsDefinition).pipe(
+          Effect.mapError(
+            (error) => new ComponentRegistryError({
+              message: `Failed to register component ${name}`,
+              cause: error
+            })
+          )
+        );
+        if (parsed.length > 0) {
+          components.set(name, parsed[0]);
+        }
+      }),
+      getAllComponents: () => Effect.succeed(new Map(components)),
+      getComponentProps: (componentName) => genLogger("studiocms/componentRegistry/Registry.getComponentProps")(function* () {
+        const component = components.get(componentName);
+        if (!component) {
+          yield* Effect.fail(new ComponentNotFoundError({ componentName }));
+        }
+        return component;
+      }),
+      validateProps: (componentName, props) => genLogger("studiocms/componentRegistry/Registry.validateProps")(function* () {
+        const component = components.get(componentName);
+        if (!component) {
+          yield* Effect.fail(new ComponentNotFoundError({ componentName }));
+        }
+        const errors = [];
+        const providedProps = new Set(Object.keys(props));
+        if (component) {
+          for (const prop of component.props) {
+            if (!prop.optional && !providedProps.has(prop.name)) {
+              errors.push(`Required prop "${prop.name}" is missing`);
+            }
+          }
+          const validPropNames = new Set(component.props.map((p) => p.name));
+          for (const propName of providedProps) {
+            if (!validPropNames.has(propName)) {
+              errors.push(`Unknown prop "${propName}"`);
+            }
+          }
+        }
+        return { valid: errors.length === 0, errors };
+      })
+    };
+  }).pipe(
+    Effect.provide(PropsParser.Default),
+    Effect.provide(Path.layer),
+    Effect.provide(NodeFileSystem.layer)
+  )
+}) {
+}
+export {
+  ComponentRegistry
+};

package/dist/componentRegistry/errors.d.ts

@@ -0,0 +1,67 @@
+declare const ComponentRegistryError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+    readonly _tag: "ComponentRegistryError";
+} & Readonly<A>;
+/**
+ * Error class representing issues related to the component registry.
+ *
+ * @remarks
+ * This error extends a tagged error type with the tag `'ComponentRegistryError'`.
+ *
+ * @example
+ * ```typescript
+ * throw new ComponentRegistryError({ message: "Component not found" });
+ * ```
+ *
+ * @property message - A descriptive error message.
+ * @property cause - (Optional) The underlying cause of the error, if any.
+ */
+export declare class ComponentRegistryError extends ComponentRegistryError_base<{
+    readonly message: string;
+    readonly cause?: unknown;
+}> {
+}
+declare const FileParseError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+    readonly _tag: "FileParseError";
+} & Readonly<A>;
+/**
+ * Error thrown when a file fails to parse.
+ *
+ * @remarks
+ * This error extends a tagged error type with the tag 'FileParseError'.
+ *
+ * @example
+ * ```typescript
+ * throw new FileParseError({ filePath: '/path/to/file', message: 'Invalid format' });
+ * ```
+ *
+ * @property filePath - The path of the file that failed to parse.
+ * @property message - A descriptive error message.
+ * @property cause - (Optional) The underlying cause of the error, if available.
+ */
+export declare class FileParseError extends FileParseError_base<{
+    readonly filePath: string;
+    readonly message: string;
+    readonly cause?: unknown;
+}> {
+}
+declare const ComponentNotFoundError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+    readonly _tag: "ComponentNotFoundError";
+} & Readonly<A>;
+/**
+ * Error thrown when a requested component cannot be found in the registry.
+ *
+ * @remarks
+ * This error extends a tagged error type with the tag 'ComponentNotFoundError'.
+ *
+ * @example
+ * ```typescript
+ * throw new ComponentNotFoundError({ componentName: 'MyComponent' });
+ * ```
+ *
+ * @property componentName - The name of the component that was not found.
+ */
+export declare class ComponentNotFoundError extends ComponentNotFoundError_base<{
+    readonly componentName: string;
+}> {
+}
+export {};

package/dist/componentRegistry/errors.js

@@ -0,0 +1,12 @@
+import { Data } from "../effect.js";
+class ComponentRegistryError extends Data.TaggedError("ComponentRegistryError") {
+}
+class FileParseError extends Data.TaggedError("FileParseError") {
+}
+class ComponentNotFoundError extends Data.TaggedError("ComponentNotFoundError") {
+}
+export {
+  ComponentNotFoundError,
+  ComponentRegistryError,
+  FileParseError
+};

package/dist/componentRegistry/handler.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Options for the component registry handler.
+ *
+ * @property verbose - Enables verbose logging when set to true.
+ * @property name - The name associated with the registry handler.
+ * @property componentRegistry - An optional record mapping component names to their string identifiers.
+ */
+type componentRegistryHandlerOptions = {
+    verbose: boolean;
+    name: string;
+    componentRegistry: Record<string, string> | undefined;
+    builtInComponents?: Record<string, string>;
+};
+/**
+ * Handles the setup and registration of components in the StudioCMS component registry during the Astro config setup phase.
+ *
+ * This utility:
+ * - Logs the start and progress of the registry setup.
+ * - Iterates over the provided component registry, validating and resolving component paths.
+ * - Registers valid `.astro` components in the registry.
+ * - Extracts and maps component props for all registered components.
+ * - Adds virtual imports for component keys, props, and runtime exports.
+ *
+ * @param params - The Astro integration setup parameters, including logger and config.
+ * @param options - Options for the handler, including the component registry, verbosity, and registry name.
+ * @returns An asynchronous effect that sets up the component registry and provides virtual imports for use in the project.
+ *
+ * @remarks
+ * - Only components with string values ending in `.astro` are registered.
+ * - Component keys are normalized to lowercase and hyphens are converted to underscores for safe usage.
+ * - Virtual imports are added for both the registry and its runtime.
+ */
+export declare const componentRegistryHandler: import("astro-integration-kit").HookUtility<"astro:config:setup", [componentRegistryHandlerOptions], Promise<void>>;
+export {};