markform 0.1.1 → 0.1.3

package/dist/coreTypes-Dful87E0.mjs

@@ -0,0 +1,537 @@
+import { z } from "zod";
+
+//#region src/engine/coreTypes.ts
+/**
+* Core types and Zod schemas for Markform.
+*
+* This module defines all TypeScript types and their corresponding Zod schemas
+* for forms, fields, values, validation, patches, and session transcripts.
+*/
+const IdSchema = z.string().min(1);
+const OptionIdSchema = z.string().min(1);
+const NoteIdSchema = z.string().min(1);
+const ValidatorRefSchema = z.union([z.string(), z.object({ id: z.string() }).passthrough()]);
+const AnswerStateSchema = z.enum([
+	"unanswered",
+	"answered",
+	"skipped",
+	"aborted"
+]);
+const MultiCheckboxStateSchema = z.enum([
+	"todo",
+	"done",
+	"incomplete",
+	"active",
+	"na"
+]);
+const SimpleCheckboxStateSchema = z.enum(["todo", "done"]);
+const ExplicitCheckboxValueSchema = z.enum([
+	"unfilled",
+	"yes",
+	"no"
+]);
+const CheckboxValueSchema = z.union([MultiCheckboxStateSchema, ExplicitCheckboxValueSchema]);
+const CheckboxModeSchema = z.enum([
+	"multi",
+	"simple",
+	"explicit"
+]);
+const FillModeSchema = z.enum(["continue", "overwrite"]);
+const MockModeSchema = z.enum(["mock", "live"]);
+const ApprovalModeSchema = z.enum(["none", "blocking"]);
+const FieldKindSchema = z.enum([
+	"string",
+	"number",
+	"string_list",
+	"checkboxes",
+	"single_select",
+	"multi_select",
+	"url",
+	"url_list",
+	"date",
+	"year"
+]);
+const FieldPriorityLevelSchema = z.enum([
+	"high",
+	"medium",
+	"low"
+]);
+const OptionSchema = z.object({
+	id: IdSchema,
+	label: z.string()
+});
+const FieldBaseSchemaPartial = {
+	id: IdSchema,
+	label: z.string(),
+	required: z.boolean(),
+	priority: FieldPriorityLevelSchema,
+	role: z.string(),
+	validate: z.array(ValidatorRefSchema).optional()
+};
+const StringFieldSchema = z.object({
+	...FieldBaseSchemaPartial,
+	kind: z.literal("string"),
+	multiline: z.boolean().optional(),
+	pattern: z.string().optional(),
+	minLength: z.number().int().nonnegative().optional(),
+	maxLength: z.number().int().nonnegative().optional()
+});
+const NumberFieldSchema = z.object({
+	...FieldBaseSchemaPartial,
+	kind: z.literal("number"),
+	min: z.number().optional(),
+	max: z.number().optional(),
+	integer: z.boolean().optional()
+});
+const StringListFieldSchema = z.object({
+	...FieldBaseSchemaPartial,
+	kind: z.literal("string_list"),
+	minItems: z.number().int().nonnegative().optional(),
+	maxItems: z.number().int().nonnegative().optional(),
+	itemMinLength: z.number().int().nonnegative().optional(),
+	itemMaxLength: z.number().int().nonnegative().optional(),
+	uniqueItems: z.boolean().optional()
+});
+const CheckboxesFieldSchema = z.object({
+	...FieldBaseSchemaPartial,
+	kind: z.literal("checkboxes"),
+	checkboxMode: CheckboxModeSchema,
+	minDone: z.number().int().optional(),
+	options: z.array(OptionSchema),
+	approvalMode: ApprovalModeSchema
+});
+const SingleSelectFieldSchema = z.object({
+	...FieldBaseSchemaPartial,
+	kind: z.literal("single_select"),
+	options: z.array(OptionSchema)
+});
+const MultiSelectFieldSchema = z.object({
+	...FieldBaseSchemaPartial,
+	kind: z.literal("multi_select"),
+	options: z.array(OptionSchema),
+	minSelections: z.number().int().nonnegative().optional(),
+	maxSelections: z.number().int().nonnegative().optional()
+});
+const UrlFieldSchema = z.object({
+	...FieldBaseSchemaPartial,
+	kind: z.literal("url")
+});
+const UrlListFieldSchema = z.object({
+	...FieldBaseSchemaPartial,
+	kind: z.literal("url_list"),
+	minItems: z.number().int().nonnegative().optional(),
+	maxItems: z.number().int().nonnegative().optional(),
+	uniqueItems: z.boolean().optional()
+});
+const DateFieldSchema = z.object({
+	...FieldBaseSchemaPartial,
+	kind: z.literal("date"),
+	min: z.string().optional(),
+	max: z.string().optional()
+});
+const YearFieldSchema = z.object({
+	...FieldBaseSchemaPartial,
+	kind: z.literal("year"),
+	min: z.number().int().optional(),
+	max: z.number().int().optional()
+});
+const FieldSchema = z.discriminatedUnion("kind", [
+	StringFieldSchema,
+	NumberFieldSchema,
+	StringListFieldSchema,
+	CheckboxesFieldSchema,
+	SingleSelectFieldSchema,
+	MultiSelectFieldSchema,
+	UrlFieldSchema,
+	UrlListFieldSchema,
+	DateFieldSchema,
+	YearFieldSchema
+]);
+const FieldGroupSchema = z.object({
+	id: IdSchema,
+	title: z.string().optional(),
+	validate: z.array(ValidatorRefSchema).optional(),
+	children: z.array(FieldSchema)
+});
+const FormSchemaSchema = z.object({
+	id: IdSchema,
+	title: z.string().optional(),
+	groups: z.array(FieldGroupSchema)
+});
+const StringValueSchema = z.object({
+	kind: z.literal("string"),
+	value: z.string().nullable()
+});
+const NumberValueSchema = z.object({
+	kind: z.literal("number"),
+	value: z.number().nullable()
+});
+const StringListValueSchema = z.object({
+	kind: z.literal("string_list"),
+	items: z.array(z.string())
+});
+const CheckboxesValueSchema = z.object({
+	kind: z.literal("checkboxes"),
+	values: z.record(OptionIdSchema, CheckboxValueSchema)
+});
+const SingleSelectValueSchema = z.object({
+	kind: z.literal("single_select"),
+	selected: OptionIdSchema.nullable()
+});
+const MultiSelectValueSchema = z.object({
+	kind: z.literal("multi_select"),
+	selected: z.array(OptionIdSchema)
+});
+const UrlValueSchema = z.object({
+	kind: z.literal("url"),
+	value: z.string().nullable()
+});
+const UrlListValueSchema = z.object({
+	kind: z.literal("url_list"),
+	items: z.array(z.string())
+});
+const DateValueSchema = z.object({
+	kind: z.literal("date"),
+	value: z.string().nullable()
+});
+const YearValueSchema = z.object({
+	kind: z.literal("year"),
+	value: z.number().int().nullable()
+});
+const FieldValueSchema = z.discriminatedUnion("kind", [
+	StringValueSchema,
+	NumberValueSchema,
+	StringListValueSchema,
+	CheckboxesValueSchema,
+	SingleSelectValueSchema,
+	MultiSelectValueSchema,
+	UrlValueSchema,
+	UrlListValueSchema,
+	DateValueSchema,
+	YearValueSchema
+]);
+const FieldResponseSchema = z.object({
+	state: AnswerStateSchema,
+	value: FieldValueSchema.optional(),
+	reason: z.string().optional()
+});
+const NoteSchema = z.object({
+	id: NoteIdSchema,
+	ref: IdSchema,
+	role: z.string(),
+	text: z.string()
+});
+const DocumentationTagSchema = z.enum([
+	"description",
+	"instructions",
+	"documentation"
+]);
+const DocumentationBlockSchema = z.object({
+	tag: DocumentationTagSchema,
+	ref: z.string(),
+	bodyMarkdown: z.string()
+});
+const FrontmatterHarnessConfigSchema = z.object({
+	maxTurns: z.number().int().positive().optional(),
+	maxPatchesPerTurn: z.number().int().positive().optional(),
+	maxIssuesPerTurn: z.number().int().positive().optional()
+});
+const FormMetadataSchema = z.object({
+	markformVersion: z.string(),
+	roles: z.array(z.string()).min(1),
+	roleInstructions: z.record(z.string(), z.string()),
+	harnessConfig: FrontmatterHarnessConfigSchema.optional()
+});
+const SeveritySchema = z.enum([
+	"error",
+	"warning",
+	"info"
+]);
+const SourcePositionSchema = z.object({
+	line: z.number().int().positive(),
+	col: z.number().int().positive()
+});
+const SourceRangeSchema = z.object({
+	start: SourcePositionSchema,
+	end: SourcePositionSchema
+});
+const ValidationIssueSchema = z.object({
+	severity: SeveritySchema,
+	message: z.string(),
+	code: z.string().optional(),
+	ref: IdSchema.optional(),
+	path: z.string().optional(),
+	range: SourceRangeSchema.optional(),
+	validatorId: z.string().optional(),
+	source: z.enum([
+		"builtin",
+		"code",
+		"llm"
+	])
+});
+const ErrorLocationSchema = z.object({
+	line: z.number().int().positive().optional(),
+	column: z.number().int().positive().optional(),
+	fieldId: IdSchema.optional(),
+	noteId: NoteIdSchema.optional()
+});
+const ParseErrorSchema = z.object({
+	type: z.literal("parse"),
+	message: z.string(),
+	location: ErrorLocationSchema.optional()
+});
+const MarkformValidationErrorSchema = z.object({
+	type: z.literal("validation"),
+	message: z.string(),
+	location: ErrorLocationSchema.optional()
+});
+const MarkformErrorSchema = z.discriminatedUnion("type", [ParseErrorSchema, MarkformValidationErrorSchema]);
+const IssueReasonSchema = z.enum([
+	"validation_error",
+	"required_missing",
+	"checkbox_incomplete",
+	"min_items_not_met",
+	"optional_empty"
+]);
+const IssueScopeSchema = z.enum([
+	"form",
+	"group",
+	"field",
+	"option"
+]);
+const InspectIssueSchema = z.object({
+	ref: z.union([IdSchema, z.string()]),
+	scope: IssueScopeSchema,
+	reason: IssueReasonSchema,
+	message: z.string(),
+	severity: z.enum(["required", "recommended"]),
+	priority: z.number().int().positive(),
+	blockedBy: IdSchema.optional()
+});
+const ProgressStateSchema = z.enum([
+	"empty",
+	"incomplete",
+	"invalid",
+	"complete"
+]);
+const CheckboxProgressCountsSchema = z.object({
+	total: z.number().int().nonnegative(),
+	todo: z.number().int().nonnegative(),
+	done: z.number().int().nonnegative(),
+	incomplete: z.number().int().nonnegative(),
+	active: z.number().int().nonnegative(),
+	na: z.number().int().nonnegative(),
+	unfilled: z.number().int().nonnegative(),
+	yes: z.number().int().nonnegative(),
+	no: z.number().int().nonnegative()
+});
+const FieldProgressSchema = z.object({
+	kind: FieldKindSchema,
+	required: z.boolean(),
+	answerState: AnswerStateSchema,
+	hasNotes: z.boolean(),
+	noteCount: z.number().int().nonnegative(),
+	empty: z.boolean(),
+	valid: z.boolean(),
+	issueCount: z.number().int().nonnegative(),
+	checkboxProgress: CheckboxProgressCountsSchema.optional()
+});
+const ProgressCountsSchema = z.object({
+	totalFields: z.number().int().nonnegative(),
+	requiredFields: z.number().int().nonnegative(),
+	unansweredFields: z.number().int().nonnegative(),
+	answeredFields: z.number().int().nonnegative(),
+	skippedFields: z.number().int().nonnegative(),
+	abortedFields: z.number().int().nonnegative(),
+	validFields: z.number().int().nonnegative(),
+	invalidFields: z.number().int().nonnegative(),
+	emptyFields: z.number().int().nonnegative(),
+	filledFields: z.number().int().nonnegative(),
+	emptyRequiredFields: z.number().int().nonnegative(),
+	totalNotes: z.number().int().nonnegative()
+});
+const ProgressSummarySchema = z.object({
+	counts: ProgressCountsSchema,
+	fields: z.record(IdSchema, FieldProgressSchema)
+});
+const StructureSummarySchema = z.object({
+	groupCount: z.number().int().nonnegative(),
+	fieldCount: z.number().int().nonnegative(),
+	optionCount: z.number().int().nonnegative(),
+	fieldCountByKind: z.record(FieldKindSchema, z.number().int().nonnegative()),
+	groupsById: z.record(IdSchema, z.literal("field_group")),
+	fieldsById: z.record(IdSchema, FieldKindSchema),
+	optionsById: z.record(z.string(), z.object({
+		parentFieldId: IdSchema,
+		parentFieldKind: FieldKindSchema
+	}))
+});
+const InspectResultSchema = z.object({
+	structureSummary: StructureSummarySchema,
+	progressSummary: ProgressSummarySchema,
+	issues: z.array(InspectIssueSchema),
+	isComplete: z.boolean(),
+	formState: ProgressStateSchema
+});
+const ApplyResultSchema = z.object({
+	applyStatus: z.enum(["applied", "rejected"]),
+	structureSummary: StructureSummarySchema,
+	progressSummary: ProgressSummarySchema,
+	issues: z.array(InspectIssueSchema),
+	isComplete: z.boolean(),
+	formState: ProgressStateSchema
+});
+const SetStringPatchSchema = z.object({
+	op: z.literal("set_string"),
+	fieldId: IdSchema,
+	value: z.string().nullable()
+});
+const SetNumberPatchSchema = z.object({
+	op: z.literal("set_number"),
+	fieldId: IdSchema,
+	value: z.number().nullable()
+});
+const SetStringListPatchSchema = z.object({
+	op: z.literal("set_string_list"),
+	fieldId: IdSchema,
+	items: z.array(z.string())
+});
+const SetCheckboxesPatchSchema = z.object({
+	op: z.literal("set_checkboxes"),
+	fieldId: IdSchema,
+	values: z.record(OptionIdSchema, CheckboxValueSchema)
+});
+const SetSingleSelectPatchSchema = z.object({
+	op: z.literal("set_single_select"),
+	fieldId: IdSchema,
+	selected: OptionIdSchema.nullable()
+});
+const SetMultiSelectPatchSchema = z.object({
+	op: z.literal("set_multi_select"),
+	fieldId: IdSchema,
+	selected: z.array(OptionIdSchema)
+});
+const SetUrlPatchSchema = z.object({
+	op: z.literal("set_url"),
+	fieldId: IdSchema,
+	value: z.string().nullable()
+});
+const SetUrlListPatchSchema = z.object({
+	op: z.literal("set_url_list"),
+	fieldId: IdSchema,
+	items: z.array(z.string())
+});
+const SetDatePatchSchema = z.object({
+	op: z.literal("set_date"),
+	fieldId: IdSchema,
+	value: z.string().nullable()
+});
+const SetYearPatchSchema = z.object({
+	op: z.literal("set_year"),
+	fieldId: IdSchema,
+	value: z.number().int().nullable()
+});
+const ClearFieldPatchSchema = z.object({
+	op: z.literal("clear_field"),
+	fieldId: IdSchema
+});
+const SkipFieldPatchSchema = z.object({
+	op: z.literal("skip_field"),
+	fieldId: IdSchema,
+	role: z.string(),
+	reason: z.string().optional()
+});
+const AbortFieldPatchSchema = z.object({
+	op: z.literal("abort_field"),
+	fieldId: IdSchema,
+	role: z.string(),
+	reason: z.string().optional()
+});
+const AddNotePatchSchema = z.object({
+	op: z.literal("add_note"),
+	ref: IdSchema,
+	role: z.string(),
+	text: z.string()
+});
+const RemoveNotePatchSchema = z.object({
+	op: z.literal("remove_note"),
+	noteId: NoteIdSchema
+});
+const PatchSchema = z.discriminatedUnion("op", [
+	SetStringPatchSchema,
+	SetNumberPatchSchema,
+	SetStringListPatchSchema,
+	SetCheckboxesPatchSchema,
+	SetSingleSelectPatchSchema,
+	SetMultiSelectPatchSchema,
+	SetUrlPatchSchema,
+	SetUrlListPatchSchema,
+	SetDatePatchSchema,
+	SetYearPatchSchema,
+	ClearFieldPatchSchema,
+	SkipFieldPatchSchema,
+	AbortFieldPatchSchema,
+	AddNotePatchSchema,
+	RemoveNotePatchSchema
+]);
+const StepResultSchema = z.object({
+	structureSummary: StructureSummarySchema,
+	progressSummary: ProgressSummarySchema,
+	issues: z.array(InspectIssueSchema),
+	stepBudget: z.number().int().nonnegative(),
+	isComplete: z.boolean(),
+	turnNumber: z.number().int().positive()
+});
+const HarnessConfigSchema = z.object({
+	maxIssuesPerTurn: z.number().int().positive(),
+	maxPatchesPerTurn: z.number().int().positive(),
+	maxTurns: z.number().int().positive(),
+	maxFieldsPerTurn: z.number().int().positive().optional(),
+	maxGroupsPerTurn: z.number().int().positive().optional(),
+	targetRoles: z.array(z.string()).optional(),
+	fillMode: FillModeSchema.optional()
+});
+const SessionTurnStatsSchema = z.object({
+	inputTokens: z.number().int().nonnegative().optional(),
+	outputTokens: z.number().int().nonnegative().optional(),
+	toolCalls: z.array(z.object({
+		name: z.string(),
+		count: z.number().int().positive()
+	})).optional()
+});
+const SessionTurnSchema = z.object({
+	turn: z.number().int().positive(),
+	inspect: z.object({ issues: z.array(InspectIssueSchema) }),
+	apply: z.object({ patches: z.array(PatchSchema) }),
+	after: z.object({
+		requiredIssueCount: z.number().int().nonnegative(),
+		markdownSha256: z.string(),
+		answeredFieldCount: z.number().int().nonnegative(),
+		skippedFieldCount: z.number().int().nonnegative()
+	}),
+	llm: SessionTurnStatsSchema.optional()
+});
+const SessionFinalSchema = z.object({
+	expectComplete: z.boolean(),
+	expectedCompletedForm: z.string()
+});
+const SessionTranscriptSchema = z.object({
+	sessionVersion: z.string(),
+	mode: MockModeSchema,
+	form: z.object({ path: z.string() }),
+	validators: z.object({ code: z.string().optional() }).optional(),
+	mock: z.object({ completedMock: z.string() }).optional(),
+	live: z.object({ modelId: z.string() }).optional(),
+	harness: HarnessConfigSchema,
+	turns: z.array(SessionTurnSchema),
+	final: SessionFinalSchema
+});
+const MarkformFrontmatterSchema = z.object({
+	markformVersion: z.string(),
+	formSummary: StructureSummarySchema,
+	formProgress: ProgressSummarySchema,
+	formState: ProgressStateSchema
+});
+
+//#endregion
+export { StringFieldSchema as $, NumberValueSchema as A, SetCheckboxesPatchSchema as B, IssueReasonSchema as C, MultiSelectFieldSchema as D, MultiCheckboxStateSchema as E, ProgressStateSchema as F, SetStringPatchSchema as G, SetNumberPatchSchema as H, ProgressSummarySchema as I, SingleSelectFieldSchema as J, SeveritySchema as K, SessionFinalSchema as L, OptionSchema as M, PatchSchema as N, MultiSelectValueSchema as O, ProgressCountsSchema as P, StepResultSchema as Q, SessionTranscriptSchema as R, InspectResultSchema as S, MarkformFrontmatterSchema as T, SetSingleSelectPatchSchema as U, SetMultiSelectPatchSchema as V, SetStringListPatchSchema as W, SourcePositionSchema as X, SingleSelectValueSchema as Y, SourceRangeSchema as Z, FieldValueSchema as _, CheckboxValueSchema as a, ValidatorRefSchema as at, IdSchema as b, ClearFieldPatchSchema as c, ExplicitCheckboxValueSchema as d, StringListFieldSchema as et, FieldGroupSchema as f, FieldSchema as g, FieldResponseSchema as h, CheckboxProgressCountsSchema as i, ValidationIssueSchema as it, OptionIdSchema as j, NumberFieldSchema as k, DocumentationBlockSchema as l, FieldProgressSchema as m, ApplyResultSchema as n, StringValueSchema as nt, CheckboxesFieldSchema as o, FieldKindSchema as p, SimpleCheckboxStateSchema as q, CheckboxModeSchema as r, StructureSummarySchema as rt, CheckboxesValueSchema as s, AnswerStateSchema as t, StringListValueSchema as tt, DocumentationTagSchema as u, FormSchemaSchema as v, IssueScopeSchema as w, InspectIssueSchema as x, HarnessConfigSchema as y, SessionTurnSchema as z };