npm - @metamesh/generator-sdk - Versions diffs - 0.19.0 → 0.20.0 - Mend

@metamesh/generator-sdk 0.19.0 → 0.20.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (297) hide show

package/dist/docs/reference/packages/GeneratorPackageValidationError.md CHANGED Viewed

@@ -1,10 +1,11 @@
 # GeneratorPackageValidationError
-GeneratorPackageValidationError exported from @metamesh/generator-sdk/packages.
+Invalid definition, preset, manifest, or descriptor with structured diagnostics.
-Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.20.0).
 ```ts
+/** Invalid definition, preset, manifest, or descriptor with structured diagnostics. */
 export declare class GeneratorPackageValidationError extends Error {
     readonly issues: readonly GeneratorDefinitionIssue[];
     constructor(message: string, issues?: readonly GeneratorDefinitionIssue[]);

package/dist/docs/reference/packages/GeneratorRuntimeReference.md CHANGED Viewed

@@ -1,10 +1,11 @@
 # GeneratorRuntimeReference
-GeneratorRuntimeReference exported from @metamesh/generator-sdk/packages.
+Exact Generator version and the host source from which its executable is loaded.
-Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.20.0).
 ```ts
+/** Exact Generator version and the host source from which its executable is loaded. */
 export type GeneratorRuntimeReference = {
     readonly kind: "bundled";
     readonly version: string;

package/dist/docs/reference/packages/InstalledGenerator.md CHANGED Viewed

@@ -1,10 +1,11 @@
 # InstalledGenerator
-InstalledGenerator exported from @metamesh/generator-sdk/packages.
+Local installation identity, integrity, origin, and installation timestamp.
-Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.20.0).
 ```ts
+/** Local installation identity, integrity, origin, and installation timestamp. */
 export interface InstalledGenerator {
     readonly generatorId: string;
     readonly installedAt: string;

package/dist/docs/reference/packages/MAX_ARRAY_ITEMS.md CHANGED Viewed

@@ -1,8 +1,8 @@
 # MAX_ARRAY_ITEMS
-MAX_ARRAY_ITEMS exported from @metamesh/generator-sdk/packages.
+Maximum items in one array parameter.
-Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.20.0).
 ```ts
 MAX_ARRAY_ITEMS = 1024

package/dist/docs/reference/packages/MAX_CONDITION_BRANCHES.md CHANGED Viewed

@@ -1,8 +1,8 @@
 # MAX_CONDITION_BRANCHES
-MAX_CONDITION_BRANCHES exported from @metamesh/generator-sdk/packages.
+Maximum children in one all or any condition node.
-Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.20.0).
 ```ts
 MAX_CONDITION_BRANCHES = 32

package/dist/docs/reference/packages/MAX_CONDITION_DEPTH.md CHANGED Viewed

@@ -1,8 +1,8 @@
 # MAX_CONDITION_DEPTH
-MAX_CONDITION_DEPTH exported from @metamesh/generator-sdk/packages.
+Maximum nesting of all, any, and not condition nodes above a comparison.
-Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.20.0).
 ```ts
 MAX_CONDITION_DEPTH = 8

package/dist/docs/reference/packages/MAX_DESCRIPTOR_LIST_ITEMS.md CHANGED Viewed

@@ -1,8 +1,8 @@
 # MAX_DESCRIPTOR_LIST_ITEMS
-MAX_DESCRIPTOR_LIST_ITEMS exported from @metamesh/generator-sdk/packages.
+Maximum entries in each descriptor collection or tag list.
-Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.20.0).
 ```ts
 MAX_DESCRIPTOR_LIST_ITEMS = 128

package/dist/docs/reference/packages/MAX_GENERATOR_ID_LENGTH.md CHANGED Viewed

@@ -2,7 +2,7 @@
 Maximum length of portable Generator and parameter identifiers.
-Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.20.0).
 ```ts
 MAX_GENERATOR_ID_LENGTH = 120

package/dist/docs/reference/packages/MAX_GENERATOR_PACKAGE_BYTES.md CHANGED Viewed

@@ -1,8 +1,8 @@
 # MAX_GENERATOR_PACKAGE_BYTES
-MAX_GENERATOR_PACKAGE_BYTES exported from @metamesh/generator-sdk/packages.
+Maximum downloaded executable bundle size in bytes.
-Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.20.0).
 ```ts
 MAX_GENERATOR_PACKAGE_BYTES: number

package/dist/docs/reference/packages/MAX_GENERATOR_PRESETS.md CHANGED Viewed

@@ -1,8 +1,8 @@
 # MAX_GENERATOR_PRESETS
-MAX_GENERATOR_PRESETS exported from @metamesh/generator-sdk/packages.
+Maximum presets in one Generator package.
-Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.20.0).
 ```ts
 MAX_GENERATOR_PRESETS = 256

package/dist/docs/reference/packages/MAX_METADATA_TEXT_LENGTH.md CHANGED Viewed

@@ -2,7 +2,7 @@
 Maximum length of shared Generator metadata and choice labels.
-Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.20.0).
 ```ts
 MAX_METADATA_TEXT_LENGTH = 4096

package/dist/docs/reference/packages/MAX_PARAMETERS.md CHANGED Viewed

@@ -1,8 +1,8 @@
 # MAX_PARAMETERS
-MAX_PARAMETERS exported from @metamesh/generator-sdk/packages.
+Maximum parameters in one definition.
-Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.20.0).
 ```ts
 MAX_PARAMETERS = 256

package/dist/docs/reference/packages/MAX_PARAMETER_GROUPS.md CHANGED Viewed

@@ -1,8 +1,8 @@
 # MAX_PARAMETER_GROUPS
-MAX_PARAMETER_GROUPS exported from @metamesh/generator-sdk/packages.
+Maximum presentation groups in one definition.
-Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.20.0).
 ```ts
 MAX_PARAMETER_GROUPS = 64

package/dist/docs/reference/packages/MAX_PARAMETER_OPTIONS.md CHANGED Viewed

@@ -1,8 +1,8 @@
 # MAX_PARAMETER_OPTIONS
-MAX_PARAMETER_OPTIONS exported from @metamesh/generator-sdk/packages.
+Maximum options in one choice or choice-set parameter.
-Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.20.0).
 ```ts
 MAX_PARAMETER_OPTIONS = 512

package/dist/docs/reference/packages/MAX_TEXT_PARAMETER_LENGTH.md CHANGED Viewed

@@ -1,8 +1,8 @@
 # MAX_TEXT_PARAMETER_LENGTH
-Bounds shared by parameter recovery, strict codecs, and definition validation.
+Maximum UTF-16 code units in one text parameter.
-Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.20.0).
 ```ts
 MAX_TEXT_PARAMETER_LENGTH: number

package/dist/docs/reference/packages/METAMESH_RUNTIME_VERSION.md CHANGED Viewed

@@ -1,9 +1,9 @@
 # METAMESH_RUNTIME_VERSION
-METAMESH_RUNTIME_VERSION exported from @metamesh/generator-sdk/packages.
+Modeling runtime compatibility version for this SDK release.
-Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.20.0).
 ```ts
-METAMESH_RUNTIME_VERSION = "12.0.0"
+METAMESH_RUNTIME_VERSION = "13.0.0"
 ```

package/dist/docs/reference/packages/compareSemanticVersions.md CHANGED Viewed

@@ -1,9 +1,14 @@
 # compareSemanticVersions
-compareSemanticVersions exported from @metamesh/generator-sdk/packages.
+Compares canonical `major.minor.patch` versions; other version forms throw.
-Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.20.0).
 ```ts
+/**
+ * Compares canonical `major.minor.patch` versions; other version forms throw.
+ *
+ * @returns -1, 0, or 1 when the left version is earlier, equal, or later.
+ */
 export declare function compareSemanticVersions(left: string, right: string): number;
 ```

package/dist/docs/reference/packages/isRuntimeCompatible.md CHANGED Viewed

@@ -1,9 +1,15 @@
 # isRuntimeCompatible
-isRuntimeCompatible exported from @metamesh/generator-sdk/packages.
+Checks whether the host meets a same-major minimum; invalid versions return false.
-Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.20.0).
 ```ts
+/**
+ * Checks whether the host meets a same-major minimum; invalid versions return false.
+ *
+ * @param requiredVersion - Minimum runtime in canonical `major.minor.patch` form.
+ * @param currentVersion - Host runtime; defaults to {@link METAMESH_RUNTIME_VERSION}.
+ */
 export declare function isRuntimeCompatible(requiredVersion: string, currentVersion?: string): boolean;
 ```

package/dist/docs/reference/packages/parseGeneratorDefinition.md CHANGED Viewed

@@ -1,9 +1,10 @@
 # parseGeneratorDefinition
-parseGeneratorDefinition exported from @metamesh/generator-sdk/packages.
+Parses Generator metadata and defaults, throwing GeneratorPackageValidationError on failure.
-Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.20.0).
 ```ts
+/** Parses Generator metadata and defaults, throwing GeneratorPackageValidationError on failure. */
 export declare function parseGeneratorDefinition(value: unknown): GeneratorDefinition;
 ```

package/dist/docs/reference/packages/parseGeneratorDescriptor.md CHANGED Viewed

@@ -1,9 +1,10 @@
 # parseGeneratorDescriptor
-parseGeneratorDescriptor exported from @metamesh/generator-sdk/packages.
+Parses strict catalog metadata; invalid descriptors throw GeneratorPackageValidationError.
-Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.20.0).
 ```ts
+/** Parses strict catalog metadata; invalid descriptors throw GeneratorPackageValidationError. */
 export declare function parseGeneratorDescriptor(value: unknown): GeneratorDescriptor;
 ```

package/dist/docs/reference/packages/parseGeneratorPackageManifest.md CHANGED Viewed

@@ -1,9 +1,15 @@
 # parseGeneratorPackageManifest
-parseGeneratorPackageManifest exported from @metamesh/generator-sdk/packages.
+Parses strict portable manifest data and validates identity, runtime major, and presets. Invalid input throws GeneratorPackageValidationError.
-Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.20.0).
 ```ts
+/**
+ * Parses strict portable manifest data and validates identity, runtime major, and presets.
+ * Invalid input throws GeneratorPackageValidationError.
+ *
+ * @param value - Manifest data; copied before validation without invoking getters.
+ */
 export declare function parseGeneratorPackageManifest(value: unknown): GeneratorPackageManifest;
 ```

package/dist/docs/reference/packages/parseParameterDefinitionDocument.md CHANGED Viewed

@@ -1,9 +1,10 @@
 # parseParameterDefinitionDocument
-parseParameterDefinitionDocument exported from @metamesh/generator-sdk/packages.
+Parses editable groups and parameters, throwing GeneratorPackageValidationError on failure.
-Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.20.0).
 ```ts
+/** Parses editable groups and parameters, throwing GeneratorPackageValidationError on failure. */
 export declare function parseParameterDefinitionDocument(value: unknown): ParameterDefinitionDocument;
 ```

package/dist/docs/reference/packages/safeParseGeneratorDefinition.md CHANGED Viewed

@@ -2,7 +2,7 @@
 Validates untrusted Generator metadata, collecting independent semantic issues.
-Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.20.0).
 ```ts
 /** Validates untrusted Generator metadata, collecting independent semantic issues. */

package/dist/docs/reference/packages/safeParseParameterDefinitionDocument.md CHANGED Viewed

@@ -2,7 +2,7 @@
 Validates the editable groups/parameters document; issue paths are relative to its root.
-Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.20.0).
 ```ts
 /** Validates the editable groups/parameters document; issue paths are relative to its root. */

package/dist/docs/reference/packages/validateGeneratorPresets.md CHANGED Viewed

@@ -1,10 +1,16 @@
 # validateGeneratorPresets
-Validates strict preset metadata, completeness, and canonical parameter normalization.
+Validates strict preset metadata and complete canonical values; invalid presets throw.
-Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/packages` (@metamesh/generator-sdk@0.20.0).
 ```ts
-/** Validates strict preset metadata, completeness, and canonical parameter normalization. */
+/**
+ * Validates strict preset metadata and complete canonical values; invalid presets throw.
+ *
+ * @param definition - Definition whose parameter map every preset must satisfy.
+ * @param presets - Portable presets to validate without changing the input.
+ * @param path - Diagnostic path prefix, including any enclosing manifest field.
+ */
 export declare function validateGeneratorPresets(definition: GeneratorDefinition, presets: readonly GeneratorPreset[], path?: string): void;
 ```

package/dist/docs/reference/parameters/EMPTY_SVG_PARAMETER_DEFAULT.md CHANGED Viewed

@@ -1,8 +1,8 @@
 # EMPTY_SVG_PARAMETER_DEFAULT
-EMPTY_SVG_PARAMETER_DEFAULT exported from @metamesh/generator-sdk/parameters.
+Empty 100 mm square SVG document, centered on the origin.
-Import from `@metamesh/generator-sdk/parameters` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/parameters` (@metamesh/generator-sdk@0.20.0).
 ```ts
 EMPTY_SVG_PARAMETER_DEFAULT = "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"100mm\" height=\"100mm\" viewBox=\"-50 -50 100 100\"></svg>"

package/dist/docs/reference/parameters/MAX_PARAMETER_ISSUES.md CHANGED Viewed

@@ -1,8 +1,8 @@
 # MAX_PARAMETER_ISSUES
-MAX_PARAMETER_ISSUES exported from @metamesh/generator-sdk/parameters.
+Maximum retained issues from parameter validation or strict decoding.
-Import from `@metamesh/generator-sdk/parameters` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/parameters` (@metamesh/generator-sdk@0.20.0).
 ```ts
 MAX_PARAMETER_ISSUES = 100

package/dist/docs/reference/parameters/MAX_PARAMETER_ISSUE_MESSAGE_LENGTH.md CHANGED Viewed

@@ -1,8 +1,8 @@
 # MAX_PARAMETER_ISSUE_MESSAGE_LENGTH
-MAX_PARAMETER_ISSUE_MESSAGE_LENGTH exported from @metamesh/generator-sdk/parameters.
+Maximum UTF-16 code units in a parsed parameter issue message.
-Import from `@metamesh/generator-sdk/parameters` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/parameters` (@metamesh/generator-sdk@0.20.0).
 ```ts
 MAX_PARAMETER_ISSUE_MESSAGE_LENGTH = 1000

package/dist/docs/reference/parameters/MAX_PROJECT_SVG_PARAMETER_BYTES.md CHANGED Viewed

@@ -1,8 +1,8 @@
 # MAX_PROJECT_SVG_PARAMETER_BYTES
-MAX_PROJECT_SVG_PARAMETER_BYTES exported from @metamesh/generator-sdk/parameters.
+Maximum combined UTF-8 bytes across a Generator's SVG parameters.
-Import from `@metamesh/generator-sdk/parameters` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/parameters` (@metamesh/generator-sdk@0.20.0).
 ```ts
 MAX_PROJECT_SVG_PARAMETER_BYTES: number

package/dist/docs/reference/parameters/MAX_SVG_PARAMETER_BYTES.md CHANGED Viewed

@@ -1,8 +1,8 @@
 # MAX_SVG_PARAMETER_BYTES
-MAX_SVG_PARAMETER_BYTES exported from @metamesh/generator-sdk/parameters.
+Maximum UTF-8 bytes in one SVG parameter.
-Import from `@metamesh/generator-sdk/parameters` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/parameters` (@metamesh/generator-sdk@0.20.0).
 ```ts
 MAX_SVG_PARAMETER_BYTES: number

package/dist/docs/reference/parameters/ParamCodec.md CHANGED Viewed

@@ -1,10 +1,11 @@
 # ParamCodec
-ParamCodec exported from @metamesh/generator-sdk/parameters.
+Strict decoder for a definition's complete, canonical parameter map.
-Import from `@metamesh/generator-sdk/parameters` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/parameters` (@metamesh/generator-sdk@0.20.0).
 ```ts
+/** Strict decoder for a definition's complete, canonical parameter map. */
 export interface ParamCodec<D extends GeneratorDefinition> {
     /** Returns a frozen parameter map or throws {@link ParamDecodeError} for validation failures. */
     readonly parse: (input: unknown) => GeneratorParams<D>;

package/dist/docs/reference/parameters/ParamDecodeCode.md CHANGED Viewed

@@ -1,9 +1,10 @@
 # ParamDecodeCode
-ParamDecodeCode exported from @metamesh/generator-sdk/parameters.
+Stable category reported by a strict parameter codec.
-Import from `@metamesh/generator-sdk/parameters` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/parameters` (@metamesh/generator-sdk@0.20.0).
 ```ts
+/** Stable category reported by a strict parameter codec. */
 export type ParamDecodeCode = ParameterIssueCode;
 ```

package/dist/docs/reference/parameters/ParamDecodeError.md CHANGED Viewed

@@ -1,10 +1,11 @@
 # ParamDecodeError
-ParamDecodeError exported from @metamesh/generator-sdk/parameters.
+Parameter decoding failure with the retained validation issues.
-Import from `@metamesh/generator-sdk/parameters` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/parameters` (@metamesh/generator-sdk@0.20.0).
 ```ts
+/** Parameter decoding failure with the retained validation issues. */
 export declare class ParamDecodeError extends TypeError {
     readonly issues: readonly ParamDecodeIssue[];
     constructor(issues: readonly ParamDecodeIssue[]);

package/dist/docs/reference/parameters/ParamDecodeIssue.md CHANGED Viewed

@@ -1,10 +1,11 @@
 # ParamDecodeIssue
-ParamDecodeIssue exported from @metamesh/generator-sdk/parameters.
+Strict decoding error tied to a parameter or the complete input map.
-Import from `@metamesh/generator-sdk/parameters` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/parameters` (@metamesh/generator-sdk@0.20.0).
 ```ts
+/** Strict decoding error tied to a parameter or the complete input map. */
 export interface ParamDecodeIssue extends ParameterIssue {
     readonly severity: "error";
     readonly code: ParamDecodeCode;

package/dist/docs/reference/parameters/ParamParseResult.md CHANGED Viewed

@@ -1,10 +1,11 @@
 # ParamParseResult
-ParamParseResult exported from @metamesh/generator-sdk/parameters.
+Strict decoding outcome; failures contain issues without substitute values.
-Import from `@metamesh/generator-sdk/parameters` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/parameters` (@metamesh/generator-sdk@0.20.0).
 ```ts
+/** Strict decoding outcome; failures contain issues without substitute values. */
 export type ParamParseResult<P> = {
     readonly success: true;
     readonly data: P;

package/dist/docs/reference/parameters/aggregateParameterIssues.md CHANGED Viewed

@@ -2,9 +2,13 @@
 Caps reported issues, prioritizing errors while preserving the retained issues' input order.
-Import from `@metamesh/generator-sdk/parameters` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/parameters` (@metamesh/generator-sdk@0.20.0).
 ```ts
-/** Caps reported issues, prioritizing errors while preserving the retained issues' input order. */
+/**
+ * Caps reported issues, prioritizing errors while preserving the retained issues' input order.
+ *
+ * @param issueSets - Validated issue lists, concatenated in the supplied order.
+ */
 export declare function aggregateParameterIssues(...issueSets: readonly (readonly ParameterIssue[])[]): ParameterValidationResult;
 ```

package/dist/docs/reference/parameters/createParamCodec.md CHANGED Viewed

@@ -2,12 +2,14 @@
 Creates a strict decoder for a definition's exact normalized parameter map. Decoding never fills, drops, clamps, or canonicalizes values.
-Import from `@metamesh/generator-sdk/parameters` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/parameters` (@metamesh/generator-sdk@0.20.0).
 ```ts
 /**
  * Creates a strict decoder for a definition's exact normalized parameter map.
  * Decoding never fills, drops, clamps, or canonicalizes values.
+ *
+ * @param definition - Validated definition; keep it unchanged while using the codec.
  */
 export declare function createParamCodec<const D extends GeneratorDefinition>(definition: D): ParamCodec<D>;
 ```

package/dist/docs/reference/parameters/getDefaultParameters.md CHANGED Viewed

@@ -1,9 +1,10 @@
 # getDefaultParameters
-getDefaultParameters exported from @metamesh/generator-sdk/parameters.
+Returns a fresh, frozen map of the definition's canonical defaults.
-Import from `@metamesh/generator-sdk/parameters` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/parameters` (@metamesh/generator-sdk@0.20.0).
 ```ts
+/** Returns a fresh, frozen map of the definition's canonical defaults. */
 export declare function getDefaultParameters<const D extends GeneratorDefinition>(definition: D): GeneratorParams<D>;
 ```

package/dist/docs/reference/parameters/normalizeParameters.md CHANGED Viewed

@@ -2,12 +2,14 @@
 Returns one value per declared parameter. Unknown input keys are discarded, missing/invalid values fall back to defaults, and numbers are clamped.
-Import from `@metamesh/generator-sdk/parameters` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/parameters` (@metamesh/generator-sdk@0.20.0).
 ```ts
 /**
  * Returns one value per declared parameter. Unknown input keys are discarded,
  * missing/invalid values fall back to defaults, and numbers are clamped.
+ *
+ * @param input - Saved or partial values; null or omission uses defaults.
  */
 export declare function normalizeParameters<const D extends GeneratorDefinition>(definition: D, input?: Readonly<Record<string, unknown>> | null): GeneratorParams<D>;
 ```

package/dist/docs/reference/parameters/parameterValueEquals.md CHANGED Viewed

@@ -1,9 +1,10 @@
 # parameterValueEquals
-parameterValueEquals exported from @metamesh/generator-sdk/parameters.
+Compares parameter content, including curve editing intent and font identity, using Object.is.
-Import from `@metamesh/generator-sdk/parameters` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/parameters` (@metamesh/generator-sdk@0.20.0).
 ```ts
+/** Compares parameter content, including curve editing intent and font identity, using Object.is. */
 export declare function parameterValueEquals(previous: ParameterValue | undefined, next: ParameterValue | undefined): boolean;
 ```

package/dist/docs/reference/parameters/parseParameterIssues.md CHANGED Viewed

@@ -1,15 +1,15 @@
 # parseParameterIssues
-Parses validator output at the executable-code boundary.
+Validates and freezes issue data returned by Generator code.
-Import from `@metamesh/generator-sdk/parameters` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/parameters` (@metamesh/generator-sdk@0.20.0).
 ```ts
 /**
- * Parses validator output at the executable-code boundary.
+ * Validates and freezes issue data returned by Generator code.
  *
- * Strict, bounded checks protect against authored and installed Generator code
- * returning values that did not pass TypeScript.
+ * @param definition - Defines the parameter IDs that issues may reference.
+ * @param value - Untrusted issue list; malformed or oversized data throws TypeError.
  */
 export declare function parseParameterIssues(definition: GeneratorDefinition, value: unknown): readonly ParameterIssue[];
 ```

package/dist/docs/reference/parameters/svgParameterBytes.md CHANGED Viewed

@@ -1,9 +1,10 @@
 # svgParameterBytes
-svgParameterBytes exported from @metamesh/generator-sdk/parameters.
+Counts UTF-8 bytes without parsing or validating the SVG document.
-Import from `@metamesh/generator-sdk/parameters` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/parameters` (@metamesh/generator-sdk@0.20.0).
 ```ts
+/** Counts UTF-8 bytes without parsing or validating the SVG document. */
 export declare function svgParameterBytes(value: string): number;
 ```

package/dist/docs/reference/runtime/ExecuteGeneratorOptions.md CHANGED Viewed

@@ -1,12 +1,14 @@
 # ExecuteGeneratorOptions
-ExecuteGeneratorOptions exported from @metamesh/generator-sdk/runtime.
+Strict input validation and the host callback used to execute one Generator request.
-Import from `@metamesh/generator-sdk/runtime` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/runtime` (@metamesh/generator-sdk@0.20.0).
 ```ts
+/** Strict input validation and the host callback used to execute one Generator request. */
 export interface ExecuteGeneratorOptions<D extends GeneratorDefinition, Program extends GeneratorProgram, Output> {
     readonly definition: D;
+    /** Complete parameter map; missing, unknown, or noncanonical values reject before execution. */
     readonly parameters: Readonly<Record<string, unknown>>;
     readonly module: GeneratorModule<D> & Program;
     readonly services: GeneratorServices;

package/dist/docs/reference/runtime/GenerateRequest.md CHANGED Viewed

@@ -1,10 +1,11 @@
 # GenerateRequest
-GenerateRequest exported from @metamesh/generator-sdk/runtime.
+Requests generation from one exact Generator version and complete parameter map.
-Import from `@metamesh/generator-sdk/runtime` (@metamesh/generator-sdk@0.19.0).
+Import from `@metamesh/generator-sdk/runtime` (@metamesh/generator-sdk@0.20.0).
 ```ts
+/** Requests generation from one exact Generator version and complete parameter map. */
 export interface GenerateRequest {
     readonly type: "generate";
     readonly requestId: number;