​

Dynamic Cheat Sheet

​

Mental Model

• Structure is runtime state: { data: array, schema: Schema }
• Shape is always defined by Schema (use SchemaBuilder / SchemaFactory)
• Structure is immutable (set() / withData() return new instances)

​

Quick Start

use Cognesy\Dynamic\Structure;
use Cognesy\Schema\SchemaBuilder;

$schema = SchemaBuilder::define('payload')
    ->string('name')
    ->bool('active', required: false)
    ->schema();

$payload = Structure::fromSchema($schema, ['name' => 'Ada']);
$payload = $payload->set('active', true);
$data = $payload->toArray();

​

Structure API

• Structure::fromSchema(Schema $schema, array $data = []): Structure

• schema(): Schema
• name(): string
• description(): string
• toSchema(): Schema
• data(): array
• toArray(): array
• toJsonSchema(): array
• has(string $name): bool
• get(string $name): mixed

• isset($structure->field) is true only when runtime data contains a non-null value or the schema provides a non-null default

• withData(array $data): Structure
• set(string $name, mixed $value): Structure
• clone(): Structure
• fromArray(array $data): static

• validate(): ValidationResult
• normalizeRecord(array $values): array
• transform(): mixed
• withValidation(callable $validator): Structure — compatibility no-op, returns a clone

​

StructureFactory API

• fromCallable(callable $callable, ?string $name = null, ?string $description = null): Structure
• fromFunctionName(string $function, ?string $name = null, ?string $description = null): Structure
• fromMethodName(string $class, string $method, ?string $name = null, ?string $description = null): Structure
• fromClass(string $class, ?string $name = null, ?string $description = null): Structure
• fromSchema(string $name, Schema $schema, string $description = ''): Structure
• fromJsonSchema(array $jsonSchema): Structure
• fromArrayKeyValues(string $name, array $data, string $description = ''): Structure
• fromString(string $name, string $typeString, string $description = ''): Structure

​

Schema Authoring

• SchemaBuilder for fluent authoring
• SchemaFactory for type/class driven schemas
• CallableSchemaFactory for function/method signatures