@alloy-js/python 0.5.0-dev.0 → 0.5.0-dev.1

package/docs/api/components/index.md

@@ -29,6 +29,7 @@
 - [ModuleDoc](ModuleDoc.md) — A component that creates a ModuleDoc block for module-level documentation.
 - [PropertyDeclaration](PropertyDeclaration.md) — Declares a Python property with optional getter, setter, and deleter methods.
 - [PropertyDoc](PropertyDoc.md) — A component that creates a PropertyDoc block for `@property` decorated methods.
+- [PydanticClassDeclaration](PydanticClassDeclaration.md) — Renders a Python class that subclasses Pydantic’s `BaseModel`: `class Name(BaseModel): ...`.
 - [PyDoc](PyDoc.md) — A PyDoc comment.
 - [PyDocExample](PyDocExample.md) — Create a PyDoc example, which is prepended by >>.
 - [PythonBlock](PythonBlock.md) — A Python block component that can be used to render a block of Python code.

package/docs/api/index.md

@@ -1,7 +1,7 @@
 # @alloy-js/python API Reference
 
-- [components](components/index.md) (44 items)
+- [components](components/index.md) (45 items)
 - [contexts](contexts/index.md) (1 items)
 - [functions](functions/index.md) (11 items)
-- [types](types/index.md) (29 items)
-- [variables](variables/index.md) (6 items)
+- [types](types/index.md) (30 items)
+- [variables](variables/index.md) (9 items)

package/docs/api/types/CommonFunctionProps.md

@@ -6,9 +6,10 @@ Shared base interface for function-like components.
 
 Extends [BaseDeclarationProps](../basedeclarationprops/),[CallSignatureProps](../../components/callsignature/)
 
-|       |                  |                                       |
-| ----- | ---------------- | ------------------------------------- |
-| async | optional boolean | Indicates that the function is async. |
+|            |                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| ---------- | ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| async      | optional boolean                                      | Indicates that the function is async.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| decorators | optional [Children](../../../core/types/children/)\[] | Decorators rendered above `def`, in source order — `decorators[0]` is topmost. By Python’s bottom-up application order, the topmost entry is the **outermost** decorator (applied last) and wraps the result of every decorator below it. Each entry should produce a complete decorator line (typically starting with `@`). Falsy entries (other than `0`) are skipped, so conditional decorators can be provided inline when needed. When used through wrappers that emit an intrinsic decorator ([`ClassMethodDeclaration`](../components/ClassMethodDeclaration.md) → `@classmethod`, [`StaticMethodDeclaration`](../components/StaticMethodDeclaration.md) → `@staticmethod`, [`PropertyDeclaration`](../components/PropertyDeclaration.md) → `@property`), these decorators are rendered **above** the intrinsic line — the correct position for Pydantic’s `@field_validator` / `@model_validator` and other wrappers that must see the underlying function, not a descriptor. When used on plain [`MethodDeclaration`](../components/MethodDeclaration.md) / [`FunctionDeclaration`](../components/FunctionDeclaration.md), these decorators are rendered above `@abstractmethod` (if `abstract` is set) and above `def`. Do **not** pass intrinsic decorators here — i.e. `@classmethod`, `@staticmethod`, `@property`, or `@abstractmethod`. Those are emitted by the matching component ([`ClassMethodDeclaration`](../components/ClassMethodDeclaration.md), [`StaticMethodDeclaration`](../components/StaticMethodDeclaration.md), [`PropertyDeclaration`](../components/PropertyDeclaration.md), or the `abstract` flag) and would otherwise be stacked twice in the output, producing invalid Python. |
 
 ## Remarks
 

package/docs/api/types/PydanticModelConfigDictProps.md

@@ -0,0 +1,32 @@
+# PydanticModelConfigDictProps
+
+Keyword-style options for Pydantic v2 `ConfigDict`, using camelCase prop names that map to snake\_case Python arguments (for example `validateAssignment` → `validate_assignment`).
+
+## Members
+
+|                       |                                                      |                                                                             |
+| --------------------- | ---------------------------------------------------- | --------------------------------------------------------------------------- |
+| aliasGenerator        | optional string                                      | Resolve field aliases from a configured alias generator.                    |
+| arbitraryTypesAllowed | optional boolean                                     | Allow non-pydantic/arbitrary Python types in field annotations.             |
+| coerceNumbersToStr    | optional boolean                                     | Coerce numeric input values to strings for `str` fields.                    |
+| extra                 | optional “allow” \| “forbid” \| “ignore”             | Behavior for unknown input keys: allow, forbid, or ignore.                  |
+| fromAttributes        | optional boolean                                     | Populate models from object attributes (ORM-style) instead of mapping keys. |
+| frozen                | optional boolean                                     | Make models immutable (`frozen=True`).                                      |
+| hideInputInErrors     | optional boolean                                     | Hide input values in validation error messages.                             |
+| jsonSchemaExtra       | optional Record\<string, unknown>                    | Include JSON schema extras via a plain JSON-serializable object.            |
+| locByAlias            | optional boolean                                     | Use aliases in error locations instead of field names.                      |
+| populateByName        | optional boolean                                     | Allow population by field name even when aliases are defined.               |
+| revalidateInstances   | optional “always” \| “never” \| “subclass-instances” | Re-validate model/dataclass instances on assignment boundaries.             |
+| serJsonBytes          | optional “utf8” \| “base64” \| “hex”                 | JSON serialization format for bytes values.                                 |
+| serJsonInfNan         | optional “null” \| “constants” \| “strings”          | JSON serialization behavior for Infinity/NaN values.                        |
+| strict                | optional boolean                                     | Enable strict validation globally for the model.                            |
+| strMaxLength          | optional number                                      | Upper-bound for constrained string lengths at model level.                  |
+| strMinLength          | optional number                                      | Lower-bound for constrained string lengths at model level.                  |
+| strStripWhitespace    | optional boolean                                     | Strip leading/trailing whitespace from all `str` fields.                    |
+| strToLower            | optional boolean                                     | Convert all `str` values to lowercase.                                      |
+| strToUpper            | optional boolean                                     | Convert all `str` values to uppercase.                                      |
+| useEnumValues         | optional boolean                                     | Use enum `.value` instead of enum instances during serialization.           |
+| validateAssignment    | optional boolean                                     | Re-validate when attributes are assigned after model creation.              |
+| validateDefault       | optional boolean                                     | Validate default values in addition to provided input values.               |
+| validateReturn        | optional boolean                                     | Validate return values for call validators.                                 |
+| valJsonBytes          | optional “utf8” \| “base64” \| “hex”                 | JSON validation format for bytes values.                                    |

package/docs/api/types/index.md

@@ -20,6 +20,7 @@
 - [ParameterDescriptor](ParameterDescriptor.md) — Information for a Python function parameter.
 - [ParameterMarker](ParameterMarker.md) — type ParameterMarker = "*" | "/";
 - [PropertyMethodDeclarationProps](PropertyMethodDeclarationProps.md) — Extends Omit<[CommonFunctionProps](../commonfunctionprops/), “name”>
+- [PydanticModelConfigDictProps](PydanticModelConfigDictProps.md) — Keyword-style options for Pydantic v2 `ConfigDict`, using camelCase prop names that map to snake\_case Python arguments
 - [PythonElements](PythonElements.md) — type PythonElements = "class" | "class-member" | "function" | "variable" | "object-member" | "constant" | "parameter" |
 - [PythonLexicalScope](PythonLexicalScope.md) — Extends [OutputScope](../../../core/types/outputscope/)
 - [PythonMemberScope](PythonMemberScope.md) — Extends [OutputScope](../../../core/types/outputscope/)

package/docs/api/variables/index.md

@@ -5,4 +5,7 @@
 - [dataclassDecoratorKeySet](dataclassDecoratorKeySet.md) — dataclassDecoratorKeySet: Set<string>
 - [dataclassesModule](dataclassesModule.md) — dataclassesModule: import("../create-module.js").ModuleRefkeys<{
 - [enumModule](enumModule.md) — enumModule: import("../create-module.js").ModuleRefkeys<{
+- [pydanticModule](pydanticModule.md) — pydanticModule: import("../create-module.js").ModuleRefkeys<{
+- [pydanticSettingsModule](pydanticSettingsModule.md) — pydanticSettingsModule: import("../create-module.js").ModuleRefkeys<{
 - [requestsModule](requestsModule.md) — requestsModule: import("../create-module.js").ModuleRefkeys<{
+- [typingModule](typingModule.md) — `typing` stdlib symbols used heavily with Pydantic generics and annotations.

package/docs/api/variables/pydanticModule.md

@@ -0,0 +1,27 @@
+# pydanticModule
+
+```ts
+pydanticModule: import("../create-module.js").ModuleRefkeys<{
+    readonly ".": ["AfterValidator", "AliasChoices", "AliasGenerator", "AliasPath", "AllowInfNan", "AmqpDsn", "AnyHttpUrl", "AnyUrl", "AnyWebsocketUrl", "AwareDatetime", "Base64Bytes", "Base64Encoder", "Base64Str", "Base64UrlBytes", "Base64UrlStr", "BaseModel", "BeforeValidator", "ByteSize", "ClickHouseDsn", "CockroachDsn", "ConfigDict", "DirectoryPath", "Discriminator", "EmailStr", "EncodedBytes", "EncodedStr", "EncoderProtocol", "Extra", "FailFast", "Field", "FieldSerializationInfo", "FilePath", "FileUrl", "FiniteFloat", "FtpUrl", "FutureDate", "FutureDatetime", "GetCoreSchemaHandler", "GetJsonSchemaHandler", "GetPydanticSchema", "HttpUrl", "IPvAnyAddress", "IPvAnyInterface", "IPvAnyNetwork", "ImportString", "InstanceOf", "Json", "JsonValue", "KafkaDsn", "MariaDBDsn", "ModelWrapValidatorHandler", "MongoDsn", "MySQLDsn", "NaiveDatetime", "NameEmail", "NatsDsn", "NegativeFloat", "NegativeInt", "NewPath", "NonNegativeFloat", "NonNegativeInt", "NonPositiveFloat", "NonPositiveInt", "OnErrorOmit", "PastDate", "PastDatetime", "PaymentCardNumber", "PlainSerializer", "PlainValidator", "PositiveFloat", "PositiveInt", "PostgresDsn", "PrivateAttr", "PydanticDeprecatedSince20", "PydanticDeprecatedSince210", "PydanticDeprecatedSince211", "PydanticDeprecatedSince212", "PydanticDeprecatedSince26", "PydanticDeprecatedSince29", "PydanticDeprecationWarning", "PydanticErrorCodes", "PydanticExperimentalWarning", "PydanticForbiddenQualifier", "PydanticImportError", "PydanticInvalidForJsonSchema", "PydanticSchemaGenerationError", "PydanticUndefinedAnnotation", "PydanticUserError", "RedisDsn", "RootModel", "Secret", "SecretBytes", "SecretStr", "SerializationInfo", "SerializeAsAny", "SerializerFunctionWrapHandler", "SkipValidation", "SnowflakeDsn", "SocketPath", "Strict", "StrictBool", "StrictBytes", "StrictFloat", "StrictInt", "StrictStr", "StringConstraints", "Tag", "TypeAdapter", "UUID1", "UUID3", "UUID4", "UUID5", "UUID6", "UUID7", "UUID8", "UrlConstraints", "VERSION", "ValidateAs", "ValidationError", "ValidationInfo", "ValidatorFunctionWrapHandler", "WebsocketUrl", "WithJsonSchema", "WrapSerializer", "WrapValidator", "__version__", "computed_field", "conbytes", "condate", "condecimal", "confloat", "confrozenset", "conint", "conlist", "conset", "constr", "create_model", "dataclasses", "field_serializer", "field_validator", "model_serializer", "model_validator", "validate_call", "validate_email", "with_config"];
+    readonly alias_generators: ["to_camel", "to_pascal", "to_snake"];
+    readonly aliases: ["AliasChoices", "AliasGenerator", "AliasPath"];
+    readonly annotated_handlers: ["GetCoreSchemaHandler", "GetJsonSchemaHandler"];
+    readonly color: ["Any", "COLORS_BY_NAME", "COLORS_BY_VALUE", "Callable", "Color", "ColorTuple", "ColorType", "CoreSchema", "HslColorTuple", "JsonSchemaValue", "Optional", "PydanticCustomError", "PydanticDeprecatedSince20", "RGBA", "Union", "cast", "core_schema", "deprecated", "float_to_255", "hls_to_rgb", "ints_to_rgba", "math", "parse_color_value", "parse_float_alpha", "parse_hsl", "parse_str", "parse_tuple", "r_hex_long", "r_hex_short", "r_hsl", "r_hsl_v4_style", "r_rgb", "r_rgb_v4_style", "rads", "re", "repeat_colors", "rgb_to_hls"];
+    readonly config: ["ConfigDict", "with_config"];
+    readonly dataclasses: ["dataclass", "rebuild_dataclass"];
+    readonly errors: ["PydanticErrorCodes", "PydanticForbiddenQualifier", "PydanticImportError", "PydanticInvalidForJsonSchema", "PydanticSchemaGenerationError", "PydanticUndefinedAnnotation", "PydanticUserError"];
+    readonly fields: ["Field", "FieldInfo", "PrivateAttr", "computed_field"];
+    readonly functional_serializers: ["Annotated", "Any", "AnyType", "Callable", "GetCoreSchemaHandler", "Literal", "PlainSerializer", "PydanticUndefined", "PydanticUndefinedAnnotation", "PydanticUserError", "SerializationInfo", "SerializeAsAny", "SerializerFunctionWrapHandler", "TYPE_CHECKING", "TypeAlias", "TypeVar", "WhenUsed", "WrapSerializer", "annotations", "core_schema", "dataclasses", "field_serializer", "model_serializer", "overload", "partial", "partialmethod"];
+    readonly functional_validators: ["AfterValidator", "Annotated", "Any", "AnyType", "ArbitraryTypeWarning", "BeforeValidator", "Callable", "FieldValidatorModes", "FreeModelBeforeValidator", "FreeModelBeforeValidatorWithoutInfo", "GetCoreSchemaHandler", "InstanceOf", "Literal", "ModelAfterValidator", "ModelAfterValidatorWithoutInfo", "ModelBeforeValidator", "ModelBeforeValidatorWithoutInfo", "ModelWrapValidator", "ModelWrapValidatorHandler", "ModelWrapValidatorWithoutInfo", "PlainValidator", "Protocol", "PydanticDeprecatedSince212", "PydanticUndefined", "PydanticUserError", "Self", "SkipValidation", "TYPE_CHECKING", "TypeAlias", "TypeVar", "Union", "ValidateAs", "WrapValidator", "cast", "core_schema", "dataclasses", "field_validator", "model_validator", "overload", "partialmethod", "sys", "version_short", "warnings"];
+    readonly json_schema: ["Annotated", "Any", "AnyType", "Callable", "ComputedField", "CoreModeRef", "CoreRef", "CoreSchema", "CoreSchemaOrFieldType", "Counter", "DEFAULT_REF_TEMPLATE", "DefsRef", "Enum", "Examples", "GenerateJsonSchema", "GetJsonSchemaHandler", "Hashable", "Iterable", "JsonDict", "JsonRef", "JsonSchemaKeyT", "JsonSchemaMode", "JsonSchemaValue", "JsonSchemaWarningKind", "JsonValue", "Literal", "MISSING", "NewType", "NoDefault", "Pattern", "PydanticDeprecatedSince26", "PydanticDeprecatedSince29", "PydanticInvalidForJsonSchema", "PydanticJsonSchemaWarning", "PydanticOmit", "PydanticSchemaGenerationError", "PydanticUserError", "Sequence", "SkipJsonSchema", "TYPE_CHECKING", "TypeAlias", "TypeVar", "Union", "WithJsonSchema", "assert_never", "cast", "collections", "core_schema", "dataclasses", "deepcopy", "defaultdict", "deprecated", "final", "get_literal_values", "inspect", "math", "model_json_schema", "models_json_schema", "os", "overload", "pydantic_core", "re", "to_jsonable_python", "warnings"];
+    readonly main: ["BaseModel", "create_model"];
+    readonly networks: ["AmqpDsn", "AnyHttpUrl", "AnyUrl", "AnyWebsocketUrl", "ClickHouseDsn", "CockroachDsn", "EmailStr", "FileUrl", "FtpUrl", "HttpUrl", "IPvAnyAddress", "IPvAnyInterface", "IPvAnyNetwork", "KafkaDsn", "MariaDBDsn", "MongoDsn", "MySQLDsn", "NameEmail", "NatsDsn", "PostgresDsn", "RedisDsn", "SnowflakeDsn", "UrlConstraints", "WebsocketUrl", "validate_email"];
+    readonly plugin: ["BaseValidateHandlerProtocol", "NewSchemaReturns", "PydanticPluginProtocol", "SchemaKind", "SchemaTypePath", "ValidateJsonHandlerProtocol", "ValidatePythonHandlerProtocol", "ValidateStringsHandlerProtocol"];
+    readonly root_model: ["RootModel"];
+    readonly type_adapter: ["Any", "BaseModel", "Callable", "ConfigDict", "CoreSchema", "DEFAULT_REF_TEMPLATE", "ExtraValues", "FrameType", "GenerateJsonSchema", "Generic", "IncEx", "Iterable", "JsonSchemaKeyT", "JsonSchemaMode", "JsonSchemaValue", "Literal", "P", "ParamSpec", "PluggableSchemaValidator", "PydanticUndefinedAnnotation", "PydanticUserError", "R", "SchemaSerializer", "SchemaValidator", "Some", "T", "TypeAdapter", "TypeAdapterT", "TypeVar", "cast", "create_schema_validator", "final", "is_dataclass", "is_typeddict", "overload", "sys", "types"];
+    readonly types: ["AllowInfNan", "AwareDatetime", "Base64Bytes", "Base64Encoder", "Base64Str", "Base64UrlBytes", "Base64UrlStr", "ByteSize", "DirectoryPath", "Discriminator", "EncodedBytes", "EncodedStr", "EncoderProtocol", "FailFast", "FilePath", "FiniteFloat", "FutureDate", "FutureDatetime", "GetPydanticSchema", "ImportString", "Json", "JsonValue", "NaiveDatetime", "NegativeFloat", "NegativeInt", "NewPath", "NonNegativeFloat", "NonNegativeInt", "NonPositiveFloat", "NonPositiveInt", "OnErrorOmit", "PastDate", "PastDatetime", "PaymentCardNumber", "PositiveFloat", "PositiveInt", "Secret", "SecretBytes", "SecretStr", "SocketPath", "Strict", "StrictBool", "StrictBytes", "StrictFloat", "StrictInt", "StrictStr", "StringConstraints", "Tag", "UUID1", "UUID3", "UUID4", "UUID5", "UUID6", "UUID7", "UUID8", "conbytes", "condate", "condecimal", "confloat", "confrozenset", "conint", "conlist", "conset", "constr"];
+    readonly validate_call_decorator: ["validate_call"];
+    readonly version: ["VERSION", "version_info"];
+    readonly warnings: ["ArbitraryTypeWarning", "PydanticDeprecatedSince20", "PydanticDeprecatedSince210", "PydanticDeprecatedSince211", "PydanticDeprecatedSince212", "PydanticDeprecatedSince26", "PydanticDeprecatedSince29", "PydanticDeprecationWarning", "PydanticExperimentalWarning", "TypedDictExtraConfigWarning", "UnsupportedFieldAttributeWarning"];
+}> & SymbolCreator
+```

package/docs/api/variables/pydanticSettingsModule.md

@@ -0,0 +1,7 @@
+# pydanticSettingsModule
+
+```ts
+pydanticSettingsModule: import("../create-module.js").ModuleRefkeys<{
+    readonly ".": ["BaseSettings", "SettingsConfigDict"];
+}> & SymbolCreator
+```

package/docs/api/variables/typingModule.md

@@ -0,0 +1,9 @@
+# typingModule
+
+`typing` stdlib symbols used heavily with Pydantic generics and annotations.
+
+```ts
+typingModule: import("../create-module.js").ModuleRefkeys<{
+    readonly ".": ["Annotated", "Any", "ClassVar", "Generic", "Literal", "Optional", "Protocol", "TypeVar", "Union", "final", "override", "runtime_checkable"];
+}> & SymbolCreator
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alloy-js/python",
-  "version": "0.5.0-dev.0",
+  "version": "0.5.0-dev.1",
   "description": "Python bindings for Alloy",
   "repository": {
     "type": "git",
@@ -20,13 +20,13 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "@alloy-js/core": "~0.23.0 || >= 0.24.0-dev.1",
+    "@alloy-js/core": "~0.23.1 || >= 0.24.0-dev.6",
     "change-case": "^5.4.4",
     "pathe": "^2.0.3"
   },
   "devDependencies": {
-    "@alloy-js/cli": "~0.23.0 || >= 0.24.0-dev.0",
-    "@alloy-js/rollup-plugin": "~0.1.1 || >= 0.1.2-dev.1",
+    "@alloy-js/cli": "~0.23.0 || >= 0.24.0-dev.1",
+    "@alloy-js/rollup-plugin": "~0.1.1 || >= 0.1.2-dev.2",
     "@microsoft/api-extractor": "~7.52.8",
     "@rollup/plugin-typescript": "^12.1.2",
     "concurrently": "^9.2.0",