@elytracms/core 0.0.6

package/dist/plugins/examples.js

@@ -0,0 +1,205 @@
+import { z } from 'zod';
+import { defineComponent } from '@elytracms/core/component-registry';
+import { jsonValueSchema } from '@elytracms/core/project-graph';
+import { auroraMarketingKit, northwindDocsKit } from '@elytracms/core/starter-kits';
+import { defineFieldType } from './field-types';
+import { defineDataSourceAdapter } from './data-sources';
+import { MemoryAssetStorage } from './asset-storage';
+import { jsonBundleTarget } from './export-targets';
+import { ExtensionRegistry } from './marketplace';
+/**
+ * Reference example extensions (the "example plugin/adapter" deliverable across EC-130–137). Every
+ * one is deterministic — no clocks, no randomness, no network in the defaults — so the studio and
+ * tests can reproduce identical state from these fixtures.
+ */
+// --- Field-type plugins (EC-131) --------------------------------------------
+const HEX = /^#[0-9a-fA-F]{6}$/;
+const SLUG = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+/** A hex color field type. */
+export const colorFieldType = defineFieldType({
+    kind: 'plugin.color',
+    title: 'Color',
+    description: 'A hex color value (#rrggbb).',
+    schema: z.string().regex(HEX),
+    defaultValue: '#5b8cff',
+    control: { kind: 'color' },
+    format: (value) => value.toUpperCase(),
+});
+/** An integer star-rating (0–5) field type. */
+export const ratingFieldType = defineFieldType({
+    kind: 'plugin.rating',
+    title: 'Rating',
+    description: 'An integer star rating from 0 to 5.',
+    schema: z.number().int().min(0).max(5),
+    defaultValue: 0,
+    control: { kind: 'number', placeholder: '0–5' },
+    format: (value) => '★'.repeat(value) + '☆'.repeat(5 - value),
+});
+/** A URL-safe slug field type, with extra format validation. */
+export const slugFieldType = defineFieldType({
+    kind: 'plugin.slug',
+    title: 'Slug',
+    description: 'A URL-safe lowercase slug.',
+    schema: z.string().regex(SLUG),
+    defaultValue: 'untitled',
+    control: { kind: 'text', placeholder: 'my-post-slug' },
+    validate: (value, ctx) => {
+        if (typeof value !== 'string')
+            return [{ code: 'type', message: 'Expected a string.' }];
+        if (value.length === 0)
+            return ctx.required ? [{ code: 'required', message: 'Slug is required.' }] : [];
+        return SLUG.test(value) ? [] : [{ code: 'format', message: 'Use lowercase letters, numbers, and dashes only.' }];
+    },
+});
+// --- Data-source adapters (EC-132) ------------------------------------------
+/** A static inline-JSON source — the simplest possible adapter, fully deterministic. */
+export const staticDataSourceAdapter = defineDataSourceAdapter({
+    kind: 'plugin.static',
+    title: 'Static JSON',
+    description: 'Returns an inline JSON payload — handy for prototypes and fixtures.',
+    configSchema: z.object({ data: jsonValueSchema }),
+    fetch: async (config) => config.data,
+    describe: () => 'inline JSON',
+});
+/**
+ * Build a GraphQL data-source adapter (example, EC-132). The network transport is injected, so the
+ * adapter is deterministic in tests and provider-neutral in production. Its payload resolves
+ * through the shared binding model like any built-in source.
+ */
+export function createGraphqlAdapter(transport) {
+    return defineDataSourceAdapter({
+        kind: 'plugin.graphql',
+        title: 'GraphQL',
+        description: 'Queries a GraphQL endpoint; the response is the source payload.',
+        configSchema: z.object({
+            endpoint: z.string().url(),
+            query: z.string().min(1),
+            variables: z.record(z.string(), jsonValueSchema).optional(),
+        }),
+        fetch: async (config) => transport({ endpoint: config.endpoint, query: config.query, variables: config.variables ?? {} }),
+        describe: (config) => config.endpoint,
+    });
+}
+// --- Component package (EC-130) ---------------------------------------------
+const acmeHero = defineComponent({
+    id: 'project.acme.Hero',
+    namespace: 'project',
+    title: 'Acme Hero',
+    category: 'marketing',
+    props: {
+        headline: { type: 'text', context: 'prop', default: 'Build faster with Acme', form: { label: 'Headline' } },
+        subhead: { type: 'text', context: 'prop', default: 'Drop-in marketing blocks.', form: { label: 'Subhead', control: 'textarea' } },
+    },
+    slots: [{ name: 'children', label: 'Actions' }],
+});
+const acmePricing = defineComponent({
+    id: 'project.acme.PricingTable',
+    namespace: 'project',
+    title: 'Acme Pricing Table',
+    category: 'marketing',
+    props: {
+        highlighted: { type: 'boolean', context: 'prop', default: false, form: { label: 'Highlighted' } },
+    },
+    slots: [{ name: 'children', label: 'Tiers' }],
+});
+/** A conforming component package under the `acme` vendor namespace (EC-130). */
+export const acmeBlocksPackage = {
+    name: '@acme/marketing-blocks',
+    version: '1.2.0',
+    vendor: 'acme',
+    description: 'Marketing blocks (hero, pricing) by Acme.',
+    author: 'Acme Inc.',
+    manifests: [acmeHero, acmePricing],
+};
+const labsSecret = defineComponent({
+    id: 'project.labs.ExperimentBanner',
+    namespace: 'project',
+    title: 'Experiment Banner',
+    category: 'internal',
+    props: { flag: { type: 'text', context: 'prop', default: 'beta', form: { label: 'Flag' } } },
+    slots: [],
+});
+/** A private component package (used by the private-registry example). */
+export const labsInternalPackage = {
+    name: '@labs/internal-blocks',
+    version: '0.3.0',
+    vendor: 'labs',
+    description: 'Internal experiment blocks.',
+    author: 'Acme Labs',
+    manifests: [labsSecret],
+};
+// --- Project templates (EC-136) ---------------------------------------------
+/** A community marketing template wrapping the Aurora starter kit. */
+export const auroraTemplate = {
+    id: 'tmpl.acme.aurora',
+    name: 'Aurora Marketing (community)',
+    version: '1.0.0',
+    author: 'Acme Inc.',
+    source: 'community',
+    tags: ['marketing', 'landing'],
+    kit: auroraMarketingKit,
+};
+/** A community docs template wrapping the Northwind starter kit. */
+export const northwindTemplate = {
+    id: 'tmpl.acme.northwind',
+    name: 'Northwind Docs (community)',
+    version: '1.0.0',
+    author: 'Acme Inc.',
+    source: 'community',
+    tags: ['docs', 'content'],
+    kit: northwindDocsKit,
+};
+// --- Hooks (EC-135) ---------------------------------------------------------
+/** A hook that stamps a notice file onto an export's file set (demonstrates a transform hook). */
+function stampExportNotice(payload) {
+    if (!Array.isArray(payload))
+        return payload;
+    const files = payload;
+    return [...files, { path: 'ACME_NOTICE.txt', contents: 'Bundled with the Acme Extension Suite.' }];
+}
+// --- Composite plugin + marketplace (EC-137) --------------------------------
+/** A sampler plugin touching every extensibility surface. */
+export const acmeSuitePlugin = {
+    id: 'plugin.acme.suite',
+    name: 'Acme Extension Suite',
+    version: '1.0.0',
+    description: 'Marketing blocks, custom field types, a static data source, in-memory storage, a headless export target, templates, and an export hook.',
+    author: 'Acme Inc.',
+    components: acmeBlocksPackage,
+    fieldTypes: [colorFieldType, ratingFieldType, slugFieldType],
+    dataSources: [staticDataSourceAdapter],
+    assetStorage: [new MemoryAssetStorage()],
+    exportTargets: [jsonBundleTarget],
+    templates: [auroraTemplate, northwindTemplate],
+    hooks: [{ point: 'export:afterGenerate', id: 'acme.stamp', order: 10, handler: stampExportNotice }],
+};
+/** A single-surface plugin: just the color field type. */
+export const colorFieldPlugin = {
+    id: 'plugin.color-field',
+    name: 'Color Field',
+    version: '1.0.0',
+    description: 'Adds a hex color field type to the CMS.',
+    author: 'Community',
+    fieldTypes: [colorFieldType],
+};
+/** A private plugin available only behind the private registry token. */
+export const labsInternalPlugin = {
+    id: 'plugin.labs.internal',
+    name: 'Acme Labs Internal Blocks',
+    version: '0.3.0',
+    description: 'Experimental internal components — private.',
+    author: 'Acme Labs',
+    components: labsInternalPackage,
+};
+/** The public marketplace catalogue. */
+export const publicMarketplace = new ExtensionRegistry({ id: 'elytra-public', label: 'Elytra Public Marketplace', mode: 'public' }, [
+    { id: 'plugin.acme.suite', kind: 'plugin', name: 'Acme Extension Suite', version: '1.0.0', description: acmeSuitePlugin.description, author: 'Acme Inc.', tags: ['marketing', 'fields', 'export'], plugin: acmeSuitePlugin },
+    { id: 'plugin.color-field', kind: 'field-type', name: 'Color Field', version: '1.0.0', description: 'A hex color field type.', author: 'Community', tags: ['cms', 'field'], plugin: colorFieldPlugin },
+]);
+/** The token granting access to the private registry. */
+export const PRIVATE_REGISTRY_TOKEN = 'acme-internal-token';
+/** A private registry, gated behind {@link PRIVATE_REGISTRY_TOKEN}. */
+export const privateMarketplace = new ExtensionRegistry({ id: 'acme-private', label: 'Acme Private Registry', mode: 'private', accessTokens: [PRIVATE_REGISTRY_TOKEN] }, [
+    { id: 'plugin.labs.internal', kind: 'component-package', name: 'Acme Labs Internal Blocks', version: '0.3.0', description: 'Internal experiment blocks.', author: 'Acme Labs', tags: ['internal'], plugin: labsInternalPlugin },
+]);
+//# sourceMappingURL=examples.js.map

package/dist/plugins/examples.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"examples.js","sourceRoot":"","sources":["../../src/plugins/examples.ts"],"names":[],"mappings":"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"}

package/dist/plugins/export-targets.d.ts

@@ -0,0 +1,47 @@
+import type { ExportInput, GeneratedFile } from '@elytracms/core/export-sync';
+/**
+ * Export-target adapters (EC-134). Export is a pure function from the canonical model to a file set
+ * (`@elytracms/core/export-sync`). A target adapter wraps one such function so the export pipeline can
+ * target more than Next.js. Next.js App Router is the reference adapter; a headless JSON content
+ * bundle is provided as a second target to prove the boundary is real.
+ */
+/** An export-target adapter: a named, pure model → files generator (EC-134). */
+export interface ExportTargetAdapter {
+    /** Stable target id, e.g. `next-app-router`, `json-bundle`. */
+    id: string;
+    title: string;
+    description?: string;
+    /** Pure: the same input always yields the same sorted file set. */
+    generate: (input: ExportInput) => GeneratedFile[];
+}
+/**
+ * The reference export target (EC-134): a native Next.js App Router app. Delegates to
+ * `@elytracms/core/export-sync`'s deterministic generator — readable, diffable, ejectable output with no
+ * builder-only runtime dependencies.
+ */
+export declare const nextAppRouterTarget: ExportTargetAdapter;
+/**
+ * A headless JSON content bundle target (example, EC-134). Emits just the canonical model as
+ * stable JSON plus a manifest — for consumers that render the graph themselves (mobile, edge, a
+ * custom runtime). Demonstrates a non-Next target on the same interface.
+ */
+export declare const jsonBundleTarget: ExportTargetAdapter;
+/** A structured registration issue for the export-target registry. */
+export interface ExportTargetRegistryIssue {
+    code: 'duplicate';
+    message: string;
+    ref: string;
+}
+/** Registry of export-target adapters keyed by id. */
+export declare class ExportTargetRegistry {
+    private readonly byId;
+    readonly issues: ExportTargetRegistryIssue[];
+    constructor(targets?: Iterable<ExportTargetAdapter>);
+    register(target: ExportTargetAdapter): void;
+    has(id: string): boolean;
+    get(id: string): ExportTargetAdapter | undefined;
+    list(): ExportTargetAdapter[];
+    get size(): number;
+}
+/** A registry pre-seeded with the built-in targets (Next.js reference + JSON bundle). */
+export declare function createExportTargetRegistry(): ExportTargetRegistry;

package/dist/plugins/export-targets.js

@@ -0,0 +1,78 @@
+import { generateExport, generatedBanner, sortFiles, stableJson } from '@elytracms/core/export-sync';
+/**
+ * The reference export target (EC-134): a native Next.js App Router app. Delegates to
+ * `@elytracms/core/export-sync`'s deterministic generator — readable, diffable, ejectable output with no
+ * builder-only runtime dependencies.
+ */
+export const nextAppRouterTarget = {
+    id: 'next-app-router',
+    title: 'Next.js App Router',
+    description: 'The reference target: a self-contained Next.js App Router app rendering the canonical graph.',
+    generate: (input) => generateExport(input),
+};
+/**
+ * A headless JSON content bundle target (example, EC-134). Emits just the canonical model as
+ * stable JSON plus a manifest — for consumers that render the graph themselves (mobile, edge, a
+ * custom runtime). Demonstrates a non-Next target on the same interface.
+ */
+export const jsonBundleTarget = {
+    id: 'json-bundle',
+    title: 'Headless JSON bundle',
+    description: 'Canonical model as stable JSON (graph, routes, collections, sources, locales) + a manifest.',
+    generate: (input) => sortFiles([
+        { path: 'bundle/graph.json', contents: stableJson(input.graph) },
+        { path: 'bundle/routes.json', contents: stableJson(input.routes) },
+        { path: 'bundle/redirects.json', contents: stableJson(input.redirects) },
+        { path: 'bundle/collections.json', contents: stableJson(input.collections) },
+        { path: 'bundle/sources.json', contents: stableJson(input.sources) },
+        { path: 'bundle/locales.json', contents: stableJson(input.localeConfig) },
+        {
+            path: 'bundle/manifest.json',
+            contents: stableJson({
+                name: input.projectName,
+                slug: input.slug,
+                target: 'json-bundle',
+                layouts: input.graph.layouts.length,
+                collections: input.collections.length,
+                sources: input.sources.length,
+            }),
+        },
+        {
+            path: 'bundle/README.md',
+            contents: `${generatedBanner('bundle/README.md')}\n\n# ${input.projectName} — headless content bundle\n\nThe canonical project model as stable JSON. Render it with the \`@elytracms/runtime-renderer\`, or any client that understands the graph format.\n`,
+        },
+    ]),
+};
+/** Registry of export-target adapters keyed by id. */
+export class ExportTargetRegistry {
+    byId = new Map();
+    issues = [];
+    constructor(targets = []) {
+        for (const target of targets)
+            this.register(target);
+    }
+    register(target) {
+        if (this.byId.has(target.id)) {
+            this.issues.push({ code: 'duplicate', ref: target.id, message: `Duplicate export target "${target.id}" — keeping the first registration.` });
+            return;
+        }
+        this.byId.set(target.id, target);
+    }
+    has(id) {
+        return this.byId.has(id);
+    }
+    get(id) {
+        return this.byId.get(id);
+    }
+    list() {
+        return [...this.byId.values()];
+    }
+    get size() {
+        return this.byId.size;
+    }
+}
+/** A registry pre-seeded with the built-in targets (Next.js reference + JSON bundle). */
+export function createExportTargetRegistry() {
+    return new ExportTargetRegistry([nextAppRouterTarget, jsonBundleTarget]);
+}
+//# sourceMappingURL=export-targets.js.map

package/dist/plugins/export-targets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-targets.js","sourceRoot":"","sources":["../../src/plugins/export-targets.ts"],"names":[],"mappings":"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"}

package/dist/plugins/field-types.d.ts

@@ -0,0 +1,86 @@
+import { z } from 'zod';
+import type { JsonValue } from '@elytracms/core/project-graph';
+/**
+ * Field-type plugins (EC-131). The CMS ships a provider-neutral catalogue of built-in field types
+ * (text/number/boolean/date/select/richText/relation/asset). A field-type plugin adds a *new*
+ * type: a value schema, a default, an editor control descriptor, and optional extra validation and
+ * display formatting. Registration is namespaced (a plugin kind must contain a dot and must not
+ * shadow a built-in), validation is first-class (issues, never throws), and rendering is driven by
+ * a control descriptor the Builder/CMS editor maps to a named control.
+ */
+/** The provider-neutral built-in field types a plugin must not shadow. */
+export declare const BUILTIN_FIELD_TYPES: readonly ["text", "number", "boolean", "date", "select", "richText", "relation", "asset"];
+/** A structured validation issue from a field-type plugin. Never thrown. */
+export interface FieldTypeIssue {
+    code: string;
+    message: string;
+    path?: string;
+}
+/** Context passed to a field-type plugin's `validate`. */
+export interface FieldTypeContext {
+    /** Whether the field is required (a missing value is an error). */
+    required: boolean;
+    /** The field's declarative constraints (min/max/pattern…) when relevant. */
+    constraints?: Record<string, JsonValue>;
+}
+/** How the Builder/CMS editor renders an input for a field-type plugin. */
+export interface FieldControlSpec {
+    /** A known control, or `custom` to defer to a registered component. */
+    kind: 'text' | 'textarea' | 'number' | 'boolean' | 'select' | 'color' | 'json' | 'custom';
+    /** For `custom`: the id of the control component to render. */
+    component?: string;
+    placeholder?: string;
+    /** Static options for `select`-style controls. */
+    options?: {
+        label: string;
+        value: JsonValue;
+    }[];
+}
+/** A field-type plugin (EC-131). */
+export interface FieldTypePlugin<T extends JsonValue = JsonValue> {
+    /** Namespaced field-type key, e.g. `plugin.color`. Must contain a dot; must not shadow a built-in. */
+    kind: string;
+    title: string;
+    description?: string;
+    /** Validates a stored value of this type. */
+    schema: z.ZodType<T>;
+    /** Default value for a new field of this type. */
+    defaultValue: T;
+    /** Editor control descriptor. */
+    control: FieldControlSpec;
+    /** Extra validation beyond the schema (range, format…). Returns issues; never throws. */
+    validate?: (value: unknown, ctx: FieldTypeContext) => FieldTypeIssue[];
+    /** Render a stored value to a short display string (table cells, previews). */
+    format?: (value: T) => string;
+}
+/**
+ * Define a field-type plugin with full type-checking of its `defaultValue`/`validate`/`format`
+ * against the value type `T`, then widen it to the registry's element type. The widening is the
+ * standard heterogeneous-registry erasure: the registry holds plugins of many value types, which
+ * the invariant generic would otherwise reject.
+ */
+export declare function defineFieldType<T extends JsonValue>(plugin: FieldTypePlugin<T>): FieldTypePlugin;
+/** A structured registration/validation issue for the field-type registry. */
+export interface FieldTypeRegistryIssue {
+    code: 'reserved' | 'namespace' | 'duplicate';
+    message: string;
+    ref: string;
+}
+/** True when a field-type kind follows the namespace rules (dotted, not a built-in). */
+export declare function isValidFieldTypeKind(kind: string): boolean;
+/** Registry of field-type plugins. Construction de-duplicates and validates; lookups are O(1). */
+export declare class FieldTypeRegistry {
+    private readonly byKind;
+    readonly issues: FieldTypeRegistryIssue[];
+    constructor(plugins?: Iterable<FieldTypePlugin>);
+    register(plugin: FieldTypePlugin): void;
+    has(kind: string): boolean;
+    get(kind: string): FieldTypePlugin | undefined;
+    list(): FieldTypePlugin[];
+    get size(): number;
+    /**
+     * Validate a value against a registered field type (EC-131): the value schema first, then the
+     * plugin's extra `validate`. An unknown kind is itself an issue. Never throws.
+     */
+    validateValue(kind: string, value: unknown, ctx?: FieldTypeContext): FieldTypeIssue[];
+}

package/dist/plugins/field-types.js

@@ -0,0 +1,93 @@
+import { z } from 'zod';
+/**
+ * Field-type plugins (EC-131). The CMS ships a provider-neutral catalogue of built-in field types
+ * (text/number/boolean/date/select/richText/relation/asset). A field-type plugin adds a *new*
+ * type: a value schema, a default, an editor control descriptor, and optional extra validation and
+ * display formatting. Registration is namespaced (a plugin kind must contain a dot and must not
+ * shadow a built-in), validation is first-class (issues, never throws), and rendering is driven by
+ * a control descriptor the Builder/CMS editor maps to a named control.
+ */
+/** The provider-neutral built-in field types a plugin must not shadow. */
+export const BUILTIN_FIELD_TYPES = [
+    'text',
+    'number',
+    'boolean',
+    'date',
+    'select',
+    'richText',
+    'relation',
+    'asset',
+];
+/**
+ * Define a field-type plugin with full type-checking of its `defaultValue`/`validate`/`format`
+ * against the value type `T`, then widen it to the registry's element type. The widening is the
+ * standard heterogeneous-registry erasure: the registry holds plugins of many value types, which
+ * the invariant generic would otherwise reject.
+ */
+export function defineFieldType(plugin) {
+    return plugin;
+}
+/** True when a field-type kind follows the namespace rules (dotted, not a built-in). */
+export function isValidFieldTypeKind(kind) {
+    if (BUILTIN_FIELD_TYPES.includes(kind))
+        return false;
+    return /^[a-z][a-z0-9]*\.[a-z][a-z0-9]*$/i.test(kind);
+}
+/** Registry of field-type plugins. Construction de-duplicates and validates; lookups are O(1). */
+export class FieldTypeRegistry {
+    byKind = new Map();
+    issues = [];
+    constructor(plugins = []) {
+        for (const plugin of plugins)
+            this.register(plugin);
+    }
+    register(plugin) {
+        if (BUILTIN_FIELD_TYPES.includes(plugin.kind)) {
+            this.issues.push({ code: 'reserved', ref: plugin.kind, message: `Field type "${plugin.kind}" shadows a built-in type.` });
+            return;
+        }
+        if (!isValidFieldTypeKind(plugin.kind)) {
+            this.issues.push({ code: 'namespace', ref: plugin.kind, message: `Field type "${plugin.kind}" must be namespaced (e.g. "plugin.color").` });
+            return;
+        }
+        if (this.byKind.has(plugin.kind)) {
+            this.issues.push({ code: 'duplicate', ref: plugin.kind, message: `Duplicate field type "${plugin.kind}" — keeping the first registration.` });
+            return;
+        }
+        this.byKind.set(plugin.kind, plugin);
+    }
+    has(kind) {
+        return this.byKind.has(kind);
+    }
+    get(kind) {
+        return this.byKind.get(kind);
+    }
+    list() {
+        return [...this.byKind.values()];
+    }
+    get size() {
+        return this.byKind.size;
+    }
+    /**
+     * Validate a value against a registered field type (EC-131): the value schema first, then the
+     * plugin's extra `validate`. An unknown kind is itself an issue. Never throws.
+     */
+    validateValue(kind, value, ctx = { required: false }) {
+        const plugin = this.byKind.get(kind);
+        if (!plugin)
+            return [{ code: 'unknown-field-type', message: `No field type registered for "${kind}".` }];
+        if (value === undefined || value === null) {
+            return ctx.required ? [{ code: 'required', message: `${plugin.title} is required.` }] : [];
+        }
+        const parsed = plugin.schema.safeParse(value);
+        if (!parsed.success) {
+            return parsed.error.issues.map((i) => ({
+                code: 'invalid-value',
+                message: i.message,
+                ...(i.path.length ? { path: i.path.join('.') } : {}),
+            }));
+        }
+        return plugin.validate?.(value, ctx) ?? [];
+    }
+}
+//# sourceMappingURL=field-types.js.map

package/dist/plugins/field-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-types.js","sourceRoot":"","sources":["../../src/plugins/field-types.ts"],"names":[],"mappings":"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"}

package/dist/plugins/hooks.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Hook system (EC-135). A deterministic, extensible lifecycle bus: plugins register handlers at
+ * named points, and the host runs each point as a transform chain — every handler receives the
+ * current payload and may return a replacement, threading the result to the next handler. Ordering
+ * is fully deterministic: handlers run by ascending `order`, ties broken by registration sequence
+ * (never insertion-hash or wall-clock), so a given set of plugins always produces the same result.
+ */
+/**
+ * A hook handler observes or transforms a payload. Returning a value replaces the threaded
+ * payload for downstream handlers; returning `undefined`/`void` leaves it unchanged. Handlers may
+ * be async — use {@link HookBus.runAsync} to await them.
+ */
+export type HookHandler<T> = (payload: T) => T | void | Promise<T | void>;
+/** Well-known lifecycle points the studio and packages fire. Plugins may also define their own. */
+export declare const HOOK_POINTS: readonly ["graph:beforeValidate", "graph:afterValidate", "document:beforeSave", "document:afterSave", "export:beforeGenerate", "export:afterGenerate", "plugin:installed"];
+export type HookPoint = (typeof HOOK_POINTS)[number];
+/** Options when registering a handler. */
+export interface HookOptions {
+    /** Lower runs first. Defaults to `0`. */
+    order?: number;
+    /** Optional stable id, for traceability and targeted removal. */
+    id?: string;
+    /** The plugin that registered the handler (set by the host). */
+    plugin?: string;
+}
+/** A registered tap, as surfaced for inspection (e.g. the Extensions UI). */
+export interface HookTapInfo {
+    point: string;
+    order: number;
+    id?: string;
+    plugin?: string;
+}
+/**
+ * A deterministic hook bus. Synchronous (`run`) and async (`runAsync`) execution both thread the
+ * payload through handlers ordered by `(order, registration-sequence)`. Never throws on an empty
+ * point — running an unregistered point returns the payload unchanged.
+ */
+export declare class HookBus {
+    private readonly taps;
+    private seq;
+    /** Register a handler at a point. Returns an unsubscribe function. */
+    on<T>(point: string, handler: HookHandler<T>, opts?: HookOptions): () => void;
+    /** Handlers at a point in deterministic run order. */
+    private ordered;
+    /**
+     * Run a point synchronously, threading `payload` through each handler. A handler that returns a
+     * Promise is skipped for threading (use {@link runAsync} for async handlers) but still fires.
+     */
+    run<T>(point: string, payload: T): T;
+    /** Run a point asynchronously, awaiting each handler in deterministic order. */
+    runAsync<T>(point: string, payload: T): Promise<T>;
+    /** All points that have at least one handler, sorted. */
+    points(): string[];
+    /** Number of handlers registered at a point. */
+    count(point: string): number;
+    /** Inspect registered taps at a point (deterministic order). */
+    list(point: string): HookTapInfo[];
+    /** Inspect every registered tap across all points (deterministic order). */
+    all(): HookTapInfo[];
+}