@createcms/core 0.2.0 → 0.2.1

package/dist/index.d.cts

@@ -3856,6 +3856,14 @@ type BlockDefinition<TProps extends Record<string, BlockProperty> = Record<strin
     label: string;
     description?: string;
     previewImageUrl?: string;
+    /**
+     * Editor hint: the block-picker category this block is shown under (e.g.
+     * `'Forms'`, `'Layout'`). Purely presentational — the editor groups blocks by
+     * this label; the package never acts on it. Free-form by design; for
+     * consistent, autocompleted group names across blocks, reference a shared
+     * `as const` object (e.g. `group: BLOCK_GROUPS.forms`).
+     */
+    group?: string;
     /** Events this (functional) block can emit — see {@link EventDeclaration}. */
     events?: TEvents;
 } & ({

package/dist/index.d.ts

@@ -3856,6 +3856,14 @@ type BlockDefinition<TProps extends Record<string, BlockProperty> = Record<strin
     label: string;
     description?: string;
     previewImageUrl?: string;
+    /**
+     * Editor hint: the block-picker category this block is shown under (e.g.
+     * `'Forms'`, `'Layout'`). Purely presentational — the editor groups blocks by
+     * this label; the package never acts on it. Free-form by design; for
+     * consistent, autocompleted group names across blocks, reference a shared
+     * `as const` object (e.g. `group: BLOCK_GROUPS.forms`).
+     */
+    group?: string;
     /** Events this (functional) block can emit — see {@link EventDeclaration}. */
     events?: TEvents;
 } & ({

package/dist/next/index.d.cts

@@ -62,6 +62,14 @@ type BlockDefinition<TProps extends Record<string, BlockProperty> = Record<strin
     label: string;
     description?: string;
     previewImageUrl?: string;
+    /**
+     * Editor hint: the block-picker category this block is shown under (e.g.
+     * `'Forms'`, `'Layout'`). Purely presentational — the editor groups blocks by
+     * this label; the package never acts on it. Free-form by design; for
+     * consistent, autocompleted group names across blocks, reference a shared
+     * `as const` object (e.g. `group: BLOCK_GROUPS.forms`).
+     */
+    group?: string;
     /** Events this (functional) block can emit — see {@link EventDeclaration}. */
     events?: TEvents;
 } & ({

package/dist/next/index.d.ts

@@ -62,6 +62,14 @@ type BlockDefinition<TProps extends Record<string, BlockProperty> = Record<strin
     label: string;
     description?: string;
     previewImageUrl?: string;
+    /**
+     * Editor hint: the block-picker category this block is shown under (e.g.
+     * `'Forms'`, `'Layout'`). Purely presentational — the editor groups blocks by
+     * this label; the package never acts on it. Free-form by design; for
+     * consistent, autocompleted group names across blocks, reference a shared
+     * `as const` object (e.g. `group: BLOCK_GROUPS.forms`).
+     */
+    group?: string;
     /** Events this (functional) block can emit — see {@link EventDeclaration}. */
     events?: TEvents;
 } & ({

package/dist/plugins/ab-test/index.d.cts

@@ -323,6 +323,14 @@ type BlockDefinition<TProps extends Record<string, BlockProperty> = Record<strin
     label: string;
     description?: string;
     previewImageUrl?: string;
+    /**
+     * Editor hint: the block-picker category this block is shown under (e.g.
+     * `'Forms'`, `'Layout'`). Purely presentational — the editor groups blocks by
+     * this label; the package never acts on it. Free-form by design; for
+     * consistent, autocompleted group names across blocks, reference a shared
+     * `as const` object (e.g. `group: BLOCK_GROUPS.forms`).
+     */
+    group?: string;
     /** Events this (functional) block can emit — see {@link EventDeclaration}. */
     events?: TEvents;
 } & ({

package/dist/plugins/ab-test/index.d.ts

@@ -323,6 +323,14 @@ type BlockDefinition<TProps extends Record<string, BlockProperty> = Record<strin
     label: string;
     description?: string;
     previewImageUrl?: string;
+    /**
+     * Editor hint: the block-picker category this block is shown under (e.g.
+     * `'Forms'`, `'Layout'`). Purely presentational — the editor groups blocks by
+     * this label; the package never acts on it. Free-form by design; for
+     * consistent, autocompleted group names across blocks, reference a shared
+     * `as const` object (e.g. `group: BLOCK_GROUPS.forms`).
+     */
+    group?: string;
     /** Events this (functional) block can emit — see {@link EventDeclaration}. */
     events?: TEvents;
 } & ({

package/dist/plugins/consent/index.d.cts

@@ -226,6 +226,14 @@ type BlockDefinition<TProps extends Record<string, BlockProperty> = Record<strin
     label: string;
     description?: string;
     previewImageUrl?: string;
+    /**
+     * Editor hint: the block-picker category this block is shown under (e.g.
+     * `'Forms'`, `'Layout'`). Purely presentational — the editor groups blocks by
+     * this label; the package never acts on it. Free-form by design; for
+     * consistent, autocompleted group names across blocks, reference a shared
+     * `as const` object (e.g. `group: BLOCK_GROUPS.forms`).
+     */
+    group?: string;
     /** Events this (functional) block can emit — see {@link EventDeclaration}. */
     events?: TEvents;
 } & ({

package/dist/plugins/consent/index.d.ts

@@ -226,6 +226,14 @@ type BlockDefinition<TProps extends Record<string, BlockProperty> = Record<strin
     label: string;
     description?: string;
     previewImageUrl?: string;
+    /**
+     * Editor hint: the block-picker category this block is shown under (e.g.
+     * `'Forms'`, `'Layout'`). Purely presentational — the editor groups blocks by
+     * this label; the package never acts on it. Free-form by design; for
+     * consistent, autocompleted group names across blocks, reference a shared
+     * `as const` object (e.g. `group: BLOCK_GROUPS.forms`).
+     */
+    group?: string;
     /** Events this (functional) block can emit — see {@link EventDeclaration}. */
     events?: TEvents;
 } & ({

package/dist/plugins/i18n/index.d.cts

@@ -227,6 +227,14 @@ type BlockDefinition<TProps extends Record<string, BlockProperty> = Record<strin
     label: string;
     description?: string;
     previewImageUrl?: string;
+    /**
+     * Editor hint: the block-picker category this block is shown under (e.g.
+     * `'Forms'`, `'Layout'`). Purely presentational — the editor groups blocks by
+     * this label; the package never acts on it. Free-form by design; for
+     * consistent, autocompleted group names across blocks, reference a shared
+     * `as const` object (e.g. `group: BLOCK_GROUPS.forms`).
+     */
+    group?: string;
     /** Events this (functional) block can emit — see {@link EventDeclaration}. */
     events?: TEvents;
 } & ({

package/dist/plugins/i18n/index.d.ts

@@ -227,6 +227,14 @@ type BlockDefinition<TProps extends Record<string, BlockProperty> = Record<strin
     label: string;
     description?: string;
     previewImageUrl?: string;
+    /**
+     * Editor hint: the block-picker category this block is shown under (e.g.
+     * `'Forms'`, `'Layout'`). Purely presentational — the editor groups blocks by
+     * this label; the package never acts on it. Free-form by design; for
+     * consistent, autocompleted group names across blocks, reference a shared
+     * `as const` object (e.g. `group: BLOCK_GROUPS.forms`).
+     */
+    group?: string;
     /** Events this (functional) block can emit — see {@link EventDeclaration}. */
     events?: TEvents;
 } & ({

package/dist/plugins/multi-tenant/index.d.cts

@@ -225,6 +225,14 @@ type BlockDefinition<TProps extends Record<string, BlockProperty> = Record<strin
     label: string;
     description?: string;
     previewImageUrl?: string;
+    /**
+     * Editor hint: the block-picker category this block is shown under (e.g.
+     * `'Forms'`, `'Layout'`). Purely presentational — the editor groups blocks by
+     * this label; the package never acts on it. Free-form by design; for
+     * consistent, autocompleted group names across blocks, reference a shared
+     * `as const` object (e.g. `group: BLOCK_GROUPS.forms`).
+     */
+    group?: string;
     /** Events this (functional) block can emit — see {@link EventDeclaration}. */
     events?: TEvents;
 } & ({

package/dist/plugins/multi-tenant/index.d.ts

@@ -225,6 +225,14 @@ type BlockDefinition<TProps extends Record<string, BlockProperty> = Record<strin
     label: string;
     description?: string;
     previewImageUrl?: string;
+    /**
+     * Editor hint: the block-picker category this block is shown under (e.g.
+     * `'Forms'`, `'Layout'`). Purely presentational — the editor groups blocks by
+     * this label; the package never acts on it. Free-form by design; for
+     * consistent, autocompleted group names across blocks, reference a shared
+     * `as const` object (e.g. `group: BLOCK_GROUPS.forms`).
+     */
+    group?: string;
     /** Events this (functional) block can emit — see {@link EventDeclaration}. */
     events?: TEvents;
 } & ({

package/dist/react/blocks.cjs

@@ -52,7 +52,8 @@ function isResolvedReference(value) {
     return {
         __brand: 'BlocksMap',
         _components: components,
-        _events: extractBlockEvents(collection.blocks)
+        _events: extractBlockEvents(collection.blocks),
+        _collection: collection
     };
 }
 // ============================================================================

package/dist/react/blocks.d.cts

@@ -133,6 +133,14 @@ type BlockDefinition<TProps extends Record<string, BlockProperty> = Record<strin
     label: string;
     description?: string;
     previewImageUrl?: string;
+    /**
+     * Editor hint: the block-picker category this block is shown under (e.g.
+     * `'Forms'`, `'Layout'`). Purely presentational — the editor groups blocks by
+     * this label; the package never acts on it. Free-form by design; for
+     * consistent, autocompleted group names across blocks, reference a shared
+     * `as const` object (e.g. `group: BLOCK_GROUPS.forms`).
+     */
+    group?: string;
     /** Events this (functional) block can emit — see {@link EventDeclaration}. */
     events?: TEvents;
 } & ({
@@ -233,24 +241,33 @@ type BlockComponentProps<TProps extends Record<string, BlockProperty> = Record<s
     blockId: string;
     node: BlockTreeNode;
 };
-/** Shorthand to derive block component props from a collection definition. */
+/** Shorthand to derive block component props from a collection definition.
+ *  `blocks` is optional on `CollectionDefinition`, so the constraint accepts the
+ *  optional shape and `NonNullable` resolves it — passing `typeof myCollection`
+ *  directly works, and `TBlock` autocompletes the collection's block names. */
 type BlockProps<TCollection extends {
-    blocks: Record<string, AnyBlockDefinition>;
-}, TBlock extends keyof TCollection['blocks'] & string> = BlockComponentProps<TCollection['blocks'][TBlock]['properties']>;
+    blocks?: Record<string, AnyBlockDefinition>;
+}, TBlock extends keyof NonNullable<TCollection['blocks']> & string> = BlockComponentProps<NonNullable<TCollection['blocks']>[TBlock]['properties']>;
 type BlockComponentMap<TBlocks extends Record<string, AnyBlockDefinition>> = {
     [K in keyof TBlocks & string]: (props: BlockComponentProps<TBlocks[K]['properties']>) => ReactNode;
 };
 declare function isResolvedReference(value: unknown): value is ResolvedReference;
 /**
  * Opaque handle returned by `createBlocksMap`. Pass it to `<BlocksRenderer>`.
- * Carries the React component map AND the per-block-type event declarations
- * (the runtime half of the M2a typed-events seam) so the renderer can tell a
- * functional block (one that declared `events`) from a presentational one.
+ * Carries the React component map, the per-block-type event declarations (the
+ * runtime half of the M2a typed-events seam, so the renderer can tell a
+ * functional block from a presentational one), AND the collection definition
+ * itself. Bundling the collection means an editor can consume a single object
+ * for both rendering (`_components`) and schema/placement/grouping
+ * (`_collection`) — no separate `collection` handoff. The type parameter is
+ * preserved so that consumption stays typed; it defaults to the erased
+ * `AnyCollectionDefinition` for plain `BlocksMap` annotations.
  */
-type BlocksMap = {
+type BlocksMap<TCollection = AnyCollectionDefinition> = {
     readonly __brand: 'BlocksMap';
     readonly _components: Record<string, (props: any) => ReactNode>;
     readonly _events: Record<string, Record<string, EventDeclaration>>;
+    readonly _collection: TCollection;
 };
 /**
  * Extracts the per-block-type event declarations from a collection definition —
@@ -282,7 +299,7 @@ declare function extractBlockEvents(blocks: Record<string, AnyBlockDefinition> |
  * });
  * ```
  */
-declare function createBlocksMap<TProps extends Record<string, BlockProperty>, TBlocks extends Record<string, AnyBlockDefinition>>(collection: CollectionDefinition<TProps, TBlocks>, components: BlockComponentMap<TBlocks>): BlocksMap;
+declare function createBlocksMap<TProps extends Record<string, BlockProperty>, TBlocks extends Record<string, AnyBlockDefinition>>(collection: CollectionDefinition<TProps, TBlocks>, components: BlockComponentMap<TBlocks>): BlocksMap<CollectionDefinition<TProps, TBlocks>>;
 /**
  * Renders a `BlockTreeNode` tree using a block component map.
  *

package/dist/react/blocks.d.ts

@@ -133,6 +133,14 @@ type BlockDefinition<TProps extends Record<string, BlockProperty> = Record<strin
     label: string;
     description?: string;
     previewImageUrl?: string;
+    /**
+     * Editor hint: the block-picker category this block is shown under (e.g.
+     * `'Forms'`, `'Layout'`). Purely presentational — the editor groups blocks by
+     * this label; the package never acts on it. Free-form by design; for
+     * consistent, autocompleted group names across blocks, reference a shared
+     * `as const` object (e.g. `group: BLOCK_GROUPS.forms`).
+     */
+    group?: string;
     /** Events this (functional) block can emit — see {@link EventDeclaration}. */
     events?: TEvents;
 } & ({
@@ -233,24 +241,33 @@ type BlockComponentProps<TProps extends Record<string, BlockProperty> = Record<s
     blockId: string;
     node: BlockTreeNode;
 };
-/** Shorthand to derive block component props from a collection definition. */
+/** Shorthand to derive block component props from a collection definition.
+ *  `blocks` is optional on `CollectionDefinition`, so the constraint accepts the
+ *  optional shape and `NonNullable` resolves it — passing `typeof myCollection`
+ *  directly works, and `TBlock` autocompletes the collection's block names. */
 type BlockProps<TCollection extends {
-    blocks: Record<string, AnyBlockDefinition>;
-}, TBlock extends keyof TCollection['blocks'] & string> = BlockComponentProps<TCollection['blocks'][TBlock]['properties']>;
+    blocks?: Record<string, AnyBlockDefinition>;
+}, TBlock extends keyof NonNullable<TCollection['blocks']> & string> = BlockComponentProps<NonNullable<TCollection['blocks']>[TBlock]['properties']>;
 type BlockComponentMap<TBlocks extends Record<string, AnyBlockDefinition>> = {
     [K in keyof TBlocks & string]: (props: BlockComponentProps<TBlocks[K]['properties']>) => ReactNode;
 };
 declare function isResolvedReference(value: unknown): value is ResolvedReference;
 /**
  * Opaque handle returned by `createBlocksMap`. Pass it to `<BlocksRenderer>`.
- * Carries the React component map AND the per-block-type event declarations
- * (the runtime half of the M2a typed-events seam) so the renderer can tell a
- * functional block (one that declared `events`) from a presentational one.
+ * Carries the React component map, the per-block-type event declarations (the
+ * runtime half of the M2a typed-events seam, so the renderer can tell a
+ * functional block from a presentational one), AND the collection definition
+ * itself. Bundling the collection means an editor can consume a single object
+ * for both rendering (`_components`) and schema/placement/grouping
+ * (`_collection`) — no separate `collection` handoff. The type parameter is
+ * preserved so that consumption stays typed; it defaults to the erased
+ * `AnyCollectionDefinition` for plain `BlocksMap` annotations.
  */
-type BlocksMap = {
+type BlocksMap<TCollection = AnyCollectionDefinition> = {
     readonly __brand: 'BlocksMap';
     readonly _components: Record<string, (props: any) => ReactNode>;
     readonly _events: Record<string, Record<string, EventDeclaration>>;
+    readonly _collection: TCollection;
 };
 /**
  * Extracts the per-block-type event declarations from a collection definition —
@@ -282,7 +299,7 @@ declare function extractBlockEvents(blocks: Record<string, AnyBlockDefinition> |
  * });
  * ```
  */
-declare function createBlocksMap<TProps extends Record<string, BlockProperty>, TBlocks extends Record<string, AnyBlockDefinition>>(collection: CollectionDefinition<TProps, TBlocks>, components: BlockComponentMap<TBlocks>): BlocksMap;
+declare function createBlocksMap<TProps extends Record<string, BlockProperty>, TBlocks extends Record<string, AnyBlockDefinition>>(collection: CollectionDefinition<TProps, TBlocks>, components: BlockComponentMap<TBlocks>): BlocksMap<CollectionDefinition<TProps, TBlocks>>;
 /**
  * Renders a `BlockTreeNode` tree using a block component map.
  *

package/dist/react/blocks.js

@@ -50,7 +50,8 @@ function isResolvedReference(value) {
     return {
         __brand: 'BlocksMap',
         _components: components,
-        _events: extractBlockEvents(collection.blocks)
+        _events: extractBlockEvents(collection.blocks),
+        _collection: collection
     };
 }
 // ============================================================================

package/dist/react/index.d.cts

@@ -229,6 +229,14 @@ type BlockDefinition<TProps extends Record<string, BlockProperty> = Record<strin
     label: string;
     description?: string;
     previewImageUrl?: string;
+    /**
+     * Editor hint: the block-picker category this block is shown under (e.g.
+     * `'Forms'`, `'Layout'`). Purely presentational — the editor groups blocks by
+     * this label; the package never acts on it. Free-form by design; for
+     * consistent, autocompleted group names across blocks, reference a shared
+     * `as const` object (e.g. `group: BLOCK_GROUPS.forms`).
+     */
+    group?: string;
     /** Events this (functional) block can emit — see {@link EventDeclaration}. */
     events?: TEvents;
 } & ({

package/dist/react/index.d.ts

@@ -229,6 +229,14 @@ type BlockDefinition<TProps extends Record<string, BlockProperty> = Record<strin
     label: string;
     description?: string;
     previewImageUrl?: string;
+    /**
+     * Editor hint: the block-picker category this block is shown under (e.g.
+     * `'Forms'`, `'Layout'`). Purely presentational — the editor groups blocks by
+     * this label; the package never acts on it. Free-form by design; for
+     * consistent, autocompleted group names across blocks, reference a shared
+     * `as const` object (e.g. `group: BLOCK_GROUPS.forms`).
+     */
+    group?: string;
     /** Events this (functional) block can emit — see {@link EventDeclaration}. */
     events?: TEvents;
 } & ({

package/dist/react/tracking.d.cts

@@ -147,6 +147,14 @@ type BlockDefinition<TProps extends Record<string, BlockProperty> = Record<strin
     label: string;
     description?: string;
     previewImageUrl?: string;
+    /**
+     * Editor hint: the block-picker category this block is shown under (e.g.
+     * `'Forms'`, `'Layout'`). Purely presentational — the editor groups blocks by
+     * this label; the package never acts on it. Free-form by design; for
+     * consistent, autocompleted group names across blocks, reference a shared
+     * `as const` object (e.g. `group: BLOCK_GROUPS.forms`).
+     */
+    group?: string;
     /** Events this (functional) block can emit — see {@link EventDeclaration}. */
     events?: TEvents;
 } & ({

package/dist/react/tracking.d.ts

@@ -147,6 +147,14 @@ type BlockDefinition<TProps extends Record<string, BlockProperty> = Record<strin
     label: string;
     description?: string;
     previewImageUrl?: string;
+    /**
+     * Editor hint: the block-picker category this block is shown under (e.g.
+     * `'Forms'`, `'Layout'`). Purely presentational — the editor groups blocks by
+     * this label; the package never acts on it. Free-form by design; for
+     * consistent, autocompleted group names across blocks, reference a shared
+     * `as const` object (e.g. `group: BLOCK_GROUPS.forms`).
+     */
+    group?: string;
     /** Events this (functional) block can emit — see {@link EventDeclaration}. */
     events?: TEvents;
 } & ({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@createcms/core",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "[Work in progress · pre-1.0 · not production-ready] Composable, block-based headless CMS powered by better-call and Drizzle ORM (Postgres). Database-native versioning with Git-like branches, copy-on-write drafts, visual diffs, merges, reusable blocks, nested pages, and a fully type-safe API.",
   "license": "MIT",
   "homepage": "https://github.com/weepaho3/createCMS#readme",