@descryy/adapter-python 0.1.0

package/dist/orm.js.map

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

package/dist/pydantic.d.ts

@@ -0,0 +1,157 @@
+/**
+ * The Pydantic extractor for Python — a `DTO` and the shape it declares.
+ *
+ * **A `DTO` is a transport-boundary claim, and this file is where it is earned.**
+ * DEC-043 declined to emit one from the language adapter and was right to: the
+ * conformance corpus holds three structurally identical classes, one expected to
+ * be a `MODEL` and two `DTO`s, and nothing in Python separates them but their
+ * names. A name rule there is the thing golden pattern 12 exists to punish.
+ *
+ * Pydantic is the evidence that was missing. A class whose base chain reaches
+ * `BaseModel` **imported from `pydantic`** has declared itself a validated
+ * boundary object; the framework enforces the shape at runtime. That is a
+ * declaration, not an inference, and it is the same standard `orm.ts` holds a
+ * `MODEL` to — a declarative base and a mapped column.
+ *
+ * Until now only `adapter-openapi` declared `DTO`, and it needs a published
+ * contract. This is the first *language* adapter to earn one.
+ *
+ * ## What the shape is, measured rather than assumed
+ *
+ * §8 asked for "the validation rules a route enforces", which invites reading
+ * `ge`, `le`, `min_length` and friends. Counted across 515 models on two real
+ * repositories **before this file was written**, those total **18** — two of
+ * them on dispatch's 449 models. Ranked by that number they are not the payload.
+ *
+ * What Pydantic writes down at scale is **presence and type**: 1,409 annotated
+ * fields on dispatch, 874 of them optional. "This field is required" is a
+ * validation rule the route enforces on every request — a POST without it is a
+ * 422 — and it is stated in every model rather than in eighteen of them.
+ *
+ * So constraints are carried **where they are written** and never invented, and
+ * the capability is described by what it actually reads. `attrs.fields` is the
+ * same key `orm.ts` uses and the same key golden pattern 05 compares.
+ *
+ * ## What is deliberately not read
+ *
+ * A `@field_validator` body is arbitrary Python. 76 of them across the two
+ * repositories say something true about what the route accepts, and none of it
+ * is readable without executing the code. They are disclosed as an
+ * unreadable-constraint count on the node rather than silently treated as
+ * absent — the same distinction `orm.ts` draws with `fieldsUndecided`, and the
+ * one `nullable=FLAG` exists to protect.
+ */
+import type { PyAttribute } from "./orm.ts";
+/** Modules whose serializer roots are DRF's own. */
+export declare const DRF_SERIALIZER_MODULES: ReadonlySet<string>;
+export declare const DRF_SERIALIZER_ROOTS: ReadonlySet<string>;
+/** Is this base name, with this origin module, one of DRF's own serializer roots? */
+export declare function isDrfSerializerRoot(baseName: string, originModule: string | undefined): boolean;
+/**
+ * The shape a DRF serializer declares.
+ *
+ * Returns `null` where the class declares no field at all — the same guard
+ * `ormShapeOf` uses to keep a project's own serializer base out of the graph
+ * as a `DTO` of its own.
+ */
+export declare function drfShapeOf(input: {
+    readonly attributes: readonly PyAttribute[];
+}): DtoShape | null;
+/** Modules whose `BaseModel` is Pydantic's. A local class of that name is not. */
+export declare const PYDANTIC_MODULES: ReadonlySet<string>;
+/**
+ * Bases that are Pydantic's own roots.
+ *
+ * `BaseSettings` is included and moved package in Pydantic v2 — it lives in
+ * `pydantic_settings` now and in `pydantic` before that, which is why the module
+ * set carries both. Restricting a rule to one spelling of a library's own move
+ * is the mistake DEC-069 recorded when `collections.abc.Callable` was missed.
+ */
+export declare const PYDANTIC_ROOTS: ReadonlySet<string>;
+/** Constraint keywords Pydantic enforces, as opposed to documents. */
+export declare const CONSTRAINT_KEYWORDS: ReadonlySet<string>;
+/**
+ * Keywords that describe rather than constrain.
+ *
+ * `description` and `title` are 189 of dispatch's 214 `Field(...)` keywords.
+ * Counting them as validation would make the capability look an order of
+ * magnitude larger than it is, which is the reporting failure this project
+ * exists to avoid.
+ */
+export declare const DOCUMENTATION_KEYWORDS: ReadonlySet<string>;
+export interface DtoField {
+    readonly name: string;
+    /** The annotation as written — never evaluated. */
+    readonly type: string | null;
+    /**
+     * Must a request supply this field at all?
+     *
+     * **Distinct from `nullable`, and Pydantic is the reason.** `x: Optional[int]`
+     * with no default is *required and nullable*: the caller must pass it, and may
+     * pass null. `x: int = 5` is *optional and not nullable*. Collapsing the two
+     * into one flag loses exactly the rule a request generator needs — it would
+     * omit a required field, get a 422, and report it as a finding.
+     *
+     * This is the validation rule that is written on every one of 1,694 fields
+     * across two repositories, as against the 18 that carry a range constraint.
+     */
+    readonly required: boolean;
+    /** May the value be null once supplied? `Optional[X]`, `X | None`. */
+    readonly nullable: boolean;
+    /** Constraints the source states, where it states any. Never invented. */
+    readonly constraints?: Readonly<Record<string, unknown>>;
+}
+export interface DtoShape {
+    readonly fields: readonly DtoField[];
+    /**
+     * Fields whose constraint is written in a form this reader cannot evaluate —
+     * `min_length=LIMIT`. Listed rather than dropped, for the same reason
+     * `orm.ts` lists an undecided nullability: the source answered and this
+     * reader failed to read it, which is not the same as the source being silent.
+     */
+    readonly undecided: readonly string[];
+    /** `@field_validator` and friends: real rules, none of them statically readable. */
+    readonly unreadableValidators: number;
+}
+/** Is this base name, with this origin module, one of Pydantic's own roots? */
+export declare function isPydanticRoot(baseName: string, originModule: string | undefined): boolean;
+/**
+ * Does this field have a default, so a request may omit it?
+ *
+ * `x: int = 5` does. `x: int` does not. The case in between is Pydantic's own
+ * spelling and it is the one that was read backwards first:
+ *
+ *     hostname: str = Field(..., min_length=3)
+ *
+ * The `...` is an **explicit "no default"** — Pydantic's documented way of
+ * writing a required field that also carries constraints. Syntactically it is an
+ * assignment, so the naive reading is "has a default", and `hostname: str`
+ * carrying a `min_length` came out **nullable** — a required field reported as
+ * optional. That is the wrong direction to be wrong in: a request generator
+ * would omit it and call the resulting 422 a finding.
+ *
+ * Caught by the field's own type contradicting its verdict — `str`, not
+ * `str | None`, marked nullable — rather than by any check.
+ */
+export declare function hasDefault(annotated: boolean, attribute: PyAttribute | undefined): boolean;
+/** Does an annotation admit absence — `Optional[X]`, `X | None`, `Any`? */
+export declare function annotationIsNullable(annotation: string | null | undefined): boolean;
+/**
+ * The shape a Pydantic class declares.
+ *
+ * `attributes` is every assignment in the class body, as `extract.py` recorded
+ * it — the same input `orm.ts` reads, which is why this extractor cost almost
+ * nothing to add.
+ */
+export declare function dtoShapeOf(input: {
+    readonly attributes: readonly PyAttribute[];
+    readonly annotatedFields: readonly {
+        name: string;
+        annotation: string | null;
+        hasDefault: boolean;
+    }[];
+    readonly validatorCount: number;
+}): DtoShape;
+/** Decorators that declare a validation rule no static reader can evaluate. */
+export declare function isValidatorDecorator(text: string | null): boolean;
+//# sourceMappingURL=pydantic.d.ts.map

package/dist/pydantic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pydantic.d.ts","sourceRoot":"","sources":["../src/pydantic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAe5C,oDAAoD;AACpD,eAAO,MAAM,sBAAsB,EAAE,WAAW,CAAC,MAAM,CAGrD,CAAC;AAEH,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAKnD,CAAC;AAEH,qFAAqF;AACrF,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAQ/F;AAkBD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE;IAAE,QAAQ,CAAC,UAAU,EAAE,SAAS,WAAW,EAAE,CAAA;CAAE,GAAG,QAAQ,GAAG,IAAI,CA6ClG;AAED,kFAAkF;AAClF,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAO/C,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,MAAM,CAK7C,CAAC;AAEH,sEAAsE;AACtE,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,MAAM,CAclD,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,EAAE,WAAW,CAAC,MAAM,CAOrD,CAAC;AAEH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,0EAA0E;IAC1E,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC1D;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,QAAQ,EAAE,CAAC;IACrC;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,oFAAoF;IACpF,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;CACvC;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAU1F;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,CAc1F;AAED,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAGnF;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE;IAChC,QAAQ,CAAC,UAAU,EAAE,SAAS,WAAW,EAAE,CAAC;IAC5C,QAAQ,CAAC,eAAe,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;IACtG,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC,GAAG,QAAQ,CAgDX;AAED,+EAA+E;AAC/E,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAGjE"}

package/dist/pydantic.js

@@ -0,0 +1,318 @@
+/**
+ * The Pydantic extractor for Python — a `DTO` and the shape it declares.
+ *
+ * **A `DTO` is a transport-boundary claim, and this file is where it is earned.**
+ * DEC-043 declined to emit one from the language adapter and was right to: the
+ * conformance corpus holds three structurally identical classes, one expected to
+ * be a `MODEL` and two `DTO`s, and nothing in Python separates them but their
+ * names. A name rule there is the thing golden pattern 12 exists to punish.
+ *
+ * Pydantic is the evidence that was missing. A class whose base chain reaches
+ * `BaseModel` **imported from `pydantic`** has declared itself a validated
+ * boundary object; the framework enforces the shape at runtime. That is a
+ * declaration, not an inference, and it is the same standard `orm.ts` holds a
+ * `MODEL` to — a declarative base and a mapped column.
+ *
+ * Until now only `adapter-openapi` declared `DTO`, and it needs a published
+ * contract. This is the first *language* adapter to earn one.
+ *
+ * ## What the shape is, measured rather than assumed
+ *
+ * §8 asked for "the validation rules a route enforces", which invites reading
+ * `ge`, `le`, `min_length` and friends. Counted across 515 models on two real
+ * repositories **before this file was written**, those total **18** — two of
+ * them on dispatch's 449 models. Ranked by that number they are not the payload.
+ *
+ * What Pydantic writes down at scale is **presence and type**: 1,409 annotated
+ * fields on dispatch, 874 of them optional. "This field is required" is a
+ * validation rule the route enforces on every request — a POST without it is a
+ * 422 — and it is stated in every model rather than in eighteen of them.
+ *
+ * So constraints are carried **where they are written** and never invented, and
+ * the capability is described by what it actually reads. `attrs.fields` is the
+ * same key `orm.ts` uses and the same key golden pattern 05 compares.
+ *
+ * ## What is deliberately not read
+ *
+ * A `@field_validator` body is arbitrary Python. 76 of them across the two
+ * repositories say something true about what the route accepts, and none of it
+ * is readable without executing the code. They are disclosed as an
+ * unreadable-constraint count on the node rather than silently treated as
+ * absent — the same distinction `orm.ts` draws with `fieldsUndecided`, and the
+ * one `nullable=FLAG` exists to protect.
+ */
+// ---------------------------------------------------------------------------
+// DRF's `serializers.Serializer`/`ModelSerializer` — a second, structurally
+// different producer of the same `DtoShape` this file already earns for
+// Pydantic.
+//
+// **Not an annotation shape.** Pydantic fields are `AnnAssign` —
+// `name: str` — which is why `dtoShapeOf` reads `annotatedFields`. DRF
+// fields are field-CONSTRUCTOR assignments — `email =
+// serializers.EmailField()` — the same shape `orm.ts` already reads for
+// Django's own ORM columns, and for the same reason: neither framework
+// spells a field as a type annotation.
+// ---------------------------------------------------------------------------
+/** Modules whose serializer roots are DRF's own. */
+export const DRF_SERIALIZER_MODULES = new Set([
+    "rest_framework.serializers",
+    "rest_framework.fields",
+]);
+export const DRF_SERIALIZER_ROOTS = new Set([
+    "Serializer",
+    "ModelSerializer",
+    "HyperlinkedModelSerializer",
+    "ListSerializer",
+]);
+/** Is this base name, with this origin module, one of DRF's own serializer roots? */
+export function isDrfSerializerRoot(baseName, originModule) {
+    const leaf = baseName.includes(".") ? baseName.slice(baseName.lastIndexOf(".") + 1) : baseName;
+    const bare = leaf.split("[")[0];
+    if (!DRF_SERIALIZER_ROOTS.has(bare))
+        return false;
+    if (originModule === undefined)
+        return false;
+    return [...DRF_SERIALIZER_MODULES].some((module) => originModule === module || originModule.startsWith(`${module}.`));
+}
+/**
+ * Is this attribute a DRF field, shape-based like Django's own ORM fields —
+ * every field class DRF ships ends in `Field`, and third-party field classes
+ * follow the same convention. A closed list would miss every custom field a
+ * project writes, the same gap `isColumnCall` avoids for Django's ORM.
+ */
+function isDrfFieldCall(attribute) {
+    if (attribute.callee === null)
+        return false;
+    const leaf = attribute.callee.includes(".")
+        ? attribute.callee.slice(attribute.callee.lastIndexOf(".") + 1)
+        : attribute.callee;
+    return leaf.endsWith("Field") && leaf.length > "Field".length;
+}
+const DRF_NOT_A_FIELD = new Set(["Meta"]);
+/**
+ * The shape a DRF serializer declares.
+ *
+ * Returns `null` where the class declares no field at all — the same guard
+ * `ormShapeOf` uses to keep a project's own serializer base out of the graph
+ * as a `DTO` of its own.
+ */
+export function drfShapeOf(input) {
+    const fields = [];
+    const undecided = [];
+    for (const attribute of input.attributes) {
+        if (DRF_NOT_A_FIELD.has(attribute.name) || attribute.name.startsWith("__"))
+            continue;
+        if (!isDrfFieldCall(attribute))
+            continue;
+        const constraints = {};
+        let sawUnreadable = false;
+        for (const [key, value] of Object.entries(attribute.keywords)) {
+            if (CONSTRAINT_KEYWORDS.has(key))
+                constraints[key] = value;
+        }
+        for (const key of attribute.opaqueKeywords) {
+            if (CONSTRAINT_KEYWORDS.has(key))
+                sawUnreadable = true;
+        }
+        if (sawUnreadable)
+            undecided.push(attribute.name);
+        // DRF's own default: a field is required unless the source says
+        // otherwise, either with `required=False` directly or by supplying a
+        // `default=` — the mirror image of Pydantic's "has a default" trigger,
+        // read the way DRF's own field constructor documents it.
+        let required = true;
+        if (!attribute.opaqueKeywords.includes("required") && typeof attribute.keywords["required"] === "boolean") {
+            required = attribute.keywords["required"];
+        }
+        else if (attribute.keywords["default"] !== undefined || attribute.opaqueKeywords.includes("default")) {
+            required = false;
+        }
+        fields.push({
+            name: attribute.name,
+            type: attribute.callee,
+            required,
+            nullable: attribute.keywords["allow_null"] === true,
+            ...(Object.keys(constraints).length > 0 ? { constraints } : {}),
+        });
+    }
+    if (fields.length === 0 && undecided.length === 0)
+        return null;
+    return {
+        fields: fields.sort((a, b) => a.name.localeCompare(b.name)),
+        undecided: undecided.sort(),
+        unreadableValidators: 0,
+    };
+}
+/** Modules whose `BaseModel` is Pydantic's. A local class of that name is not. */
+export const PYDANTIC_MODULES = new Set([
+    "pydantic",
+    "pydantic.main",
+    "pydantic.v1",
+    "pydantic.v1.main",
+    "pydantic.generics",
+    "pydantic_settings",
+]);
+/**
+ * Bases that are Pydantic's own roots.
+ *
+ * `BaseSettings` is included and moved package in Pydantic v2 — it lives in
+ * `pydantic_settings` now and in `pydantic` before that, which is why the module
+ * set carries both. Restricting a rule to one spelling of a library's own move
+ * is the mistake DEC-069 recorded when `collections.abc.Callable` was missed.
+ */
+export const PYDANTIC_ROOTS = new Set([
+    "BaseModel",
+    "BaseSettings",
+    "RootModel",
+    "GenericModel",
+]);
+/** Constraint keywords Pydantic enforces, as opposed to documents. */
+export const CONSTRAINT_KEYWORDS = new Set([
+    "gt",
+    "ge",
+    "lt",
+    "le",
+    "min_length",
+    "max_length",
+    "min_items",
+    "max_items",
+    "multiple_of",
+    "pattern",
+    "regex",
+    "max_digits",
+    "decimal_places",
+]);
+/**
+ * Keywords that describe rather than constrain.
+ *
+ * `description` and `title` are 189 of dispatch's 214 `Field(...)` keywords.
+ * Counting them as validation would make the capability look an order of
+ * magnitude larger than it is, which is the reporting failure this project
+ * exists to avoid.
+ */
+export const DOCUMENTATION_KEYWORDS = new Set([
+    "description",
+    "title",
+    "examples",
+    "example",
+    "deprecated",
+    "json_schema_extra",
+]);
+/** Is this base name, with this origin module, one of Pydantic's own roots? */
+export function isPydanticRoot(baseName, originModule) {
+    const leaf = baseName.includes(".") ? baseName.slice(baseName.lastIndexOf(".") + 1) : baseName;
+    const bare = leaf.split("[")[0];
+    if (!PYDANTIC_ROOTS.has(bare))
+        return false;
+    // The module check is the whole precision control. A repository's own
+    // `BaseModel` is not Pydantic's, and matching the bare name would admit it.
+    if (originModule === undefined)
+        return false;
+    return [...PYDANTIC_MODULES].some((module) => originModule === module || originModule.startsWith(`${module}.`));
+}
+/**
+ * Does this field have a default, so a request may omit it?
+ *
+ * `x: int = 5` does. `x: int` does not. The case in between is Pydantic's own
+ * spelling and it is the one that was read backwards first:
+ *
+ *     hostname: str = Field(..., min_length=3)
+ *
+ * The `...` is an **explicit "no default"** — Pydantic's documented way of
+ * writing a required field that also carries constraints. Syntactically it is an
+ * assignment, so the naive reading is "has a default", and `hostname: str`
+ * carrying a `min_length` came out **nullable** — a required field reported as
+ * optional. That is the wrong direction to be wrong in: a request generator
+ * would omit it and call the resulting 422 a finding.
+ *
+ * Caught by the field's own type contradicting its verdict — `str`, not
+ * `str | None`, marked nullable — rather than by any check.
+ */
+export function hasDefault(annotated, attribute) {
+    if (!annotated)
+        return false;
+    if (attribute === undefined || attribute.callee === null)
+        return true;
+    const callee = attribute.callee.slice(attribute.callee.lastIndexOf(".") + 1);
+    if (callee !== "Field")
+        return true; // some other call — its result is the default
+    if (attribute.keywords["default"] !== undefined)
+        return true;
+    if (attribute.opaqueKeywords.includes("default"))
+        return true;
+    if (attribute.keywords["default_factory"] !== undefined)
+        return true;
+    if (attribute.opaqueKeywords.includes("default_factory"))
+        return true;
+    const positional = attribute.args[0];
+    if (positional === undefined)
+        return false; // `Field(min_length=3)` — required
+    return positional.trim() !== "..."; // `Field(...)` — explicitly required
+}
+/** Does an annotation admit absence — `Optional[X]`, `X | None`, `Any`? */
+export function annotationIsNullable(annotation) {
+    if (annotation === null || annotation === undefined)
+        return false;
+    return /\bOptional\s*\[/.test(annotation) || /\bNone\b/.test(annotation);
+}
+/**
+ * The shape a Pydantic class declares.
+ *
+ * `attributes` is every assignment in the class body, as `extract.py` recorded
+ * it — the same input `orm.ts` reads, which is why this extractor cost almost
+ * nothing to add.
+ */
+export function dtoShapeOf(input) {
+    const byName = new Map();
+    for (const attribute of input.attributes)
+        byName.set(attribute.name, attribute);
+    const fields = [];
+    const undecided = [];
+    for (const declared of input.annotatedFields) {
+        // `model_config = ConfigDict(...)` is configuration, not a field, and it is
+        // the one class-body assignment Pydantic treats specially.
+        if (declared.name === "model_config" || declared.name.startsWith("__"))
+            continue;
+        const attribute = byName.get(declared.name);
+        const constraints = {};
+        let sawUnreadable = false;
+        if (attribute !== undefined && attribute.callee !== null) {
+            const callee = attribute.callee.slice(attribute.callee.lastIndexOf(".") + 1);
+            if (callee === "Field") {
+                for (const [key, value] of Object.entries(attribute.keywords)) {
+                    if (CONSTRAINT_KEYWORDS.has(key))
+                        constraints[key] = value;
+                }
+                for (const key of attribute.opaqueKeywords) {
+                    // A constraint written in a form this reader cannot evaluate is the
+                    // `nullable=FLAG` case: the source stated a rule and letting silence
+                    // stand in for it would report the opposite of the source as fact.
+                    if (CONSTRAINT_KEYWORDS.has(key))
+                        sawUnreadable = true;
+                }
+            }
+        }
+        if (sawUnreadable)
+            undecided.push(declared.name);
+        const defaulted = hasDefault(declared.hasDefault, attribute);
+        fields.push({
+            name: declared.name,
+            type: declared.annotation,
+            required: !defaulted,
+            nullable: annotationIsNullable(declared.annotation),
+            ...(Object.keys(constraints).length > 0 ? { constraints } : {}),
+        });
+    }
+    return {
+        fields: fields.sort((a, b) => a.name.localeCompare(b.name)),
+        undecided: undecided.sort(),
+        unreadableValidators: input.validatorCount,
+    };
+}
+/** Decorators that declare a validation rule no static reader can evaluate. */
+export function isValidatorDecorator(text) {
+    if (text === null)
+        return false;
+    return /\b(field_validator|model_validator|root_validator|validator)\b/.test(text);
+}
+//# sourceMappingURL=pydantic.js.map

package/dist/pydantic.js.map

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

package/dist/pytest-config.d.ts

@@ -0,0 +1,60 @@
+/**
+ * The project's own test-collection rules, read rather than assumed.
+ *
+ * ## Why this exists
+ *
+ * `test_*.py`, `Test*`, `test_*` are pytest's **defaults**, and a project can
+ * change all three. Hard-coding them is the same mistake as matching a class
+ * name to decide it is a test suite: approximating a framework's rule when the
+ * framework will state it. The standing rule is *if the framework will tell you,
+ * never infer it* — and here it will, in a file already sitting in the
+ * repository.
+ *
+ * Not hypothetical: `threeclouds-ai` declares `[tool.pytest.ini_options]` with
+ * `testpaths`, and nothing read it.
+ *
+ * ## What is read, and what is deliberately not
+ *
+ * Only the three keys that decide **what is a test**: `python_files`,
+ * `python_classes`, `python_functions`. `testpaths` is *not* read: it narrows
+ * where pytest looks, and narrowing what Descry analyses on the strength of a
+ * test-runner setting would silently shrink the graph for a reason that has
+ * nothing to do with the graph.
+ *
+ * ## Precedence
+ *
+ * pytest's own order for choosing its config file, and only the first one that
+ * carries a section counts — a `pytest.ini` wins outright even when empty of
+ * these keys, exactly as it does for pytest.
+ *
+ * ## The parsing, and its honest limit
+ *
+ * Zero runtime dependencies, so there is no TOML parser here. This reads one
+ * known section and three known keys whose values are a string or an array of
+ * strings, which is the whole of what these keys can be. A key it cannot parse
+ * leaves the default in place — the failure direction is "behaves as before",
+ * never "collects something strange".
+ */
+export interface PytestConfig {
+    /** Globs a test file must match. pytest's default is `test_*.py`, `*_test.py`. */
+    readonly filePatterns: readonly string[];
+    /** Prefixes a collected class must carry. Default `Test`. */
+    readonly classPrefixes: readonly string[];
+    /** Prefixes a collected function must carry. Default `test`. */
+    readonly functionPrefixes: readonly string[];
+    /** Where the values came from, for the capability report. */
+    readonly source: string;
+}
+export declare const PYTEST_DEFAULTS: PytestConfig;
+/** `test_*.py` -> a regex anchored at both ends. Only `*` and `?` are glob here. */
+export declare function globToRegExp(glob: string): RegExp;
+/**
+ * Read the collection rules a repository declares, or pytest's defaults.
+ *
+ * Order is pytest's: `pytest.ini`, then `pyproject.toml`, then `tox.ini`, then
+ * `setup.cfg`. The first file carrying the section wins outright, whether or not
+ * it sets any of the three keys — narrowing to "the first file that happens to
+ * set the key I want" would silently blend two projects' configurations.
+ */
+export declare function readPytestConfig(absoluteRoot: string): PytestConfig;
+//# sourceMappingURL=pytest-config.d.ts.map

package/dist/pytest-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pytest-config.d.ts","sourceRoot":"","sources":["../src/pytest-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAKH,MAAM,WAAW,YAAY;IAC3B,kFAAkF;IAClF,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,6DAA6D;IAC7D,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,gEAAgE;IAChE,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,eAAe,EAAE,YAK7B,CAAC;AAEF,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGjD;AAiDD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,YAAY,CA0CnE"}