printingpress

type ActivitySubscription struct {
	// contains filtered or unexported fields
}

type ActivityUpdate struct {
	JobID           string
	JobType         string
	Status          string
	Title           string
	OutputDir       string
	SourceKind      string
	CurrentTask     string
	CompletedTasks  int64
	TotalTasks      int64
	PercentComplete float64
	Elapsed         time.Duration
	TaskDuration    time.Duration
	Error           string
}

type AggregatePathOverride struct {
	Pattern string
	Value   string
}

type AggregatePressStatistics struct {
	BuildMode          string
	Services           int
	Versions           int
	Specs              int
	ChangedSpecs       int
	PoolsUsed          int
	WorkersPerPool     int
	AvailableCores     int
	FilesWritten       int
	BytesWritten       int64
	FileSizes          map[string]int64
	Warnings           []*ppmodel.BuildWarning
	DiscoveryDuration  time.Duration
	GenerationDuration time.Duration
	TotalDuration      time.Duration
}

type AggregatePrintingPress struct {
	// contains filtered or unexported fields
}

type AggregatePrintingPressConfig struct {
	Title                   string
	Description             string
	ScanRoot                string
	OutputDir               string
	BaseURL                 string
	AssetMode               string
	BuildMode               string
	DisableSkippedRendering bool
	Include                 []string
	IgnoreRules             []string
	NoiseSegments           []string
	ServiceOverrides        []AggregatePathOverride
	DisplayNameOverrides    []AggregatePathOverride
	VersionOverrides        []AggregatePathOverride
	StateNamespace          string
	StateSQLitePath         string
	StateStore              SpecStateStore
	EntryConfigFingerprint  string
	Logger                  *slog.Logger
	MaxPools                int
	WorkersPerPool          int
	Footer                  *ppmodel.FooterConfig
	// MaxPatternRepeatBudget limits regex repeat work for generated mock strings.
	// A zero or negative value uses DefaultMaxPatternRepeatBudget.
	MaxPatternRepeatBudget int
	// MaxGeneratedStringBytes limits each generated mock string value.
	// A zero or negative value uses DefaultMaxGeneratedStringBytes.
	MaxGeneratedStringBytes int
	// MaxGeneratedMockBytes limits each serialized generated mock payload.
	// Generated mocks over this cap are omitted with a warning. A zero or negative
	// value uses DefaultMaxGeneratedMockBytes.
	MaxGeneratedMockBytes int
	// MaxMockDepth limits recursive schema depth while building generated mocks.
	// A zero or negative value uses DefaultMaxMockDepth.
	MaxMockDepth int
	// MaxMockNodes limits schema nodes visited while building generated mocks.
	// A zero or negative value uses DefaultMaxMockNodes.
	MaxMockNodes int
	// MaxMockProperties limits object properties rendered while building generated mocks.
	// A zero or negative value uses DefaultMaxMockProperties.
	MaxMockProperties int
	// MaxMockRefExpansions limits $ref schema expansions while building generated mocks.
	// A zero or negative value uses DefaultMaxMockRefExpansions.
	MaxMockRefExpansions int
	// MaxMockBytes limits approximate generated mock structure size before serialization.
	// The default matches MaxGeneratedMockBytes to avoid generating work that the
	// serialized mock cap will discard. A zero or negative value uses DefaultMaxMockBytes.
	MaxMockBytes int
	// LLMAggregateSpecSizeThresholdBytes controls when monolithic LLM aggregate
	// files are generated for each entry. A zero or negative value uses
	// DefaultLLMAggregateSpecSizeThresholdBytes.
	LLMAggregateSpecSizeThresholdBytes int64
	// LLMMaxAggregateFileBytes controls the target maximum size of sharded LLM
	// aggregate files for each entry. A zero or negative value uses
	// DefaultLLMMaxAggregateFileBytes.
	LLMMaxAggregateFileBytes int64
	// LLMGenerateMonoliths controls whether llms-full.txt, llms-operations.txt,
	// and llms-models.txt are generated for each entry. Supported values are
	// "auto", "always", and "never".
	LLMGenerateMonoliths string
}

type AggregateProgressReporter interface {
	ReportAggregateProgress(update AggregateProgressUpdate)
}

type AggregateProgressReporterFunc func(update AggregateProgressUpdate)

type AggregateProgressUpdate struct {
	Kind           string
	PoolID         int
	PoolLabel      string
	Status         string
	CompletedSpecs int
	TotalSpecs     int
	CompletedBytes int64
	TotalBytes     int64
	CurrentSpec    string
	LastSpec       string
	CurrentStage   string
	CurrentPercent float64
	OverallPercent float64
	Error          string
}

type AggregateRenderOptions struct {
	HTML             bool
	LLM              bool
	JSON             bool
	ProgressReporter AggregateProgressReporter
	DeveloperMode    bool
	SpecLintResults  map[string][]*v3.RuleFunctionResult
}

type ArtifactManifest struct {
	Format    string              `json:"format"`
	Artifacts []JSONArtifactEntry `json:"artifacts"`
}

type ArtifactManifestConfig struct {
	Enabled              bool
	DocumentID           string
	Visibility           string
	WorkspaceID          string
	WorkspaceContentHash string
	AssetVersion         string
	ExpiresAt            string
	Entrypoints          map[string]string
	GzipSidecars         bool
}

type CrossRefIndex struct {
	ComponentToOps       map[string][]*OperationRef // component key → operations using it
	ComponentToComponent map[string][]*ComponentRef // component key → components using it
	ComponentUsesModels  map[string][]*ComponentRef // component key → components it references
}

type HostedArtifactManifest struct {
	ManifestVersion      int                                   `json:"manifestVersion"`
	DocumentID           string                                `json:"documentId"`
	Visibility           string                                `json:"visibility"`
	WorkspaceID          string                                `json:"workspaceId,omitempty"`
	WorkspaceContentHash string                                `json:"workspaceContentHash,omitempty"`
	AssetVersion         string                                `json:"assetVersion,omitempty"`
	ExpiresAt            string                                `json:"expiresAt,omitempty"`
	Entrypoints          map[string]string                     `json:"entrypoints,omitempty"`
	Files                map[string]HostedArtifactManifestFile `json:"files"`
}

type HostedArtifactManifestFile struct {
	Access      string `json:"access"`
	ContentType string `json:"contentType,omitempty"`
	ETag        string `json:"etag"`
	Size        int64  `json:"size"`
	ModTimeUnix int64  `json:"modTimeUnix"`
	Gzip        bool   `json:"gzip,omitempty"`
}

type JSONArtifactEntry struct {
	Kind     string `json:"kind"`
	Path     string `json:"path"`
	Name     string `json:"name,omitempty"`
	Slug     string `json:"slug,omitempty"`
	TypeSlug string `json:"typeSlug,omitempty"`
}

type JSONBuildWarning struct {
	Message string `json:"message"`
	Context string `json:"context,omitempty"`
	Error   string `json:"error,omitempty"`
}

type JSONBundle struct {
	Format         string                                  `json:"format"`
	Root           *JSONRootPage                           `json:"root,omitempty"`
	Source         *ppmodel.SourceRef                      `json:"source,omitempty"`
	Nav            []*ppmodel.NavTag                       `json:"nav,omitempty"`
	ModelGroups    []*ppmodel.NavModelGroup                `json:"modelGroups,omitempty"`
	SchemaRegistry map[string]*ppmodel.SchemaRegistryEntry `json:"schemaRegistry,omitempty"`
	Operations     []JSONArtifactEntry                     `json:"operations,omitempty"`
	Models         map[string][]JSONArtifactEntry          `json:"models,omitempty"`
	Webhooks       []JSONArtifactEntry                     `json:"webhooks,omitempty"`
	Warnings       []JSONBuildWarning                      `json:"warnings,omitempty"`
	SpecFormat     string                                  `json:"specFormat,omitempty"`
	Lite           bool                                    `json:"lite,omitempty"`
}

type JSONContactInfo struct {
	Name  string `json:"name,omitempty"`
	URL   string `json:"url,omitempty"`
	Email string `json:"email,omitempty"`
}

type JSONExternalDocInfo struct {
	URL         string `json:"url,omitempty"`
	Description string `json:"description,omitempty"`
}

type JSONLicenseInfo struct {
	Name string `json:"name,omitempty"`
	URL  string `json:"url,omitempty"`
}

type JSONRootPage struct {
	Title              string                              `json:"title,omitempty"`
	Description        string                              `json:"description,omitempty"`
	DescHTML           string                              `json:"descHtml,omitempty"`
	Version            string                              `json:"version,omitempty"`
	Contact            *JSONContactInfo                    `json:"contact,omitempty"`
	License            *JSONLicenseInfo                    `json:"license,omitempty"`
	Servers            []*JSONServerInfo                   `json:"servers,omitempty"`
	Security           []*ppmodel.SecurityRequirement      `json:"security,omitempty"`
	SecurityGroups     []*ppmodel.SecurityRequirementGroup `json:"securityGroups,omitempty"`
	ExternalDoc        *JSONExternalDocInfo                `json:"externalDoc,omitempty"`
	TagTree            []*ppmodel.NavTag                   `json:"tagTree,omitempty"`
	UntaggedOperations []*ppmodel.NavOperation             `json:"untaggedOperations,omitempty"`
	Webhooks           []*ppmodel.NavOperation             `json:"webhooks,omitempty"`
	Warnings           []JSONBuildWarning                  `json:"warnings,omitempty"`
	Source             *ppmodel.SourceRef                  `json:"source,omitempty"`
}

type JSONServerInfo struct {
	URL         string                    `json:"url,omitempty"`
	Description string                    `json:"description,omitempty"`
	Variables   []*JSONServerVariableInfo `json:"variables,omitempty"`
}

type JSONServerVariableInfo struct {
	Name        string   `json:"name,omitempty"`
	Default     string   `json:"default,omitempty"`
	Enum        []string `json:"enum,omitempty"`
	Description string   `json:"description,omitempty"`
}

type ManifestEntry = JSONArtifactEntry

type MemorySpecStateStore struct {
	// contains filtered or unexported fields
}

type PressStatistics struct {
	JobID              string
	JobType            string
	Pages              int
	Models             int
	Operations         int
	ClassDiagrams      int
	DependencyGraphs   int
	FilesWritten       int
	BytesWritten       int64
	FileSizes          map[string]int64
	Warnings           []*ppmodel.BuildWarning
	ModelBuildDuration time.Duration
	GenerationDuration time.Duration
	TotalDuration      time.Duration
}

type PrintingPress struct {
	// contains filtered or unexported fields
}

type PrintingPressConfig struct {
	Title            string
	BaseURL          string
	BasePath         string
	SpecPath         string
	SpecURL          string
	OutputDir        string
	AssetMode        string
	Embedded         bool
	DeveloperMode    bool
	ExpiresAt        *time.Time
	ArchiveExportURL string
	LintResults      []*v3.RuleFunctionResult
	Footer           *ppmodel.FooterConfig
	Artifact         *ArtifactManifestConfig

	// MaxPatternRepeatBudget limits regex repeat work for generated mock strings.
	// A zero or negative value uses DefaultMaxPatternRepeatBudget.
	MaxPatternRepeatBudget int
	// MaxGeneratedStringBytes limits each generated mock string value.
	// A zero or negative value uses DefaultMaxGeneratedStringBytes.
	MaxGeneratedStringBytes int
	// MaxGeneratedMockBytes limits each serialized generated mock payload.
	// Generated mocks over this cap are omitted with a warning. A zero or negative
	// value uses DefaultMaxGeneratedMockBytes.
	MaxGeneratedMockBytes int
	// MaxMockDepth limits recursive schema depth while building generated mocks.
	// A zero or negative value uses DefaultMaxMockDepth.
	MaxMockDepth int
	// MaxMockNodes limits schema nodes visited while building generated mocks.
	// A zero or negative value uses DefaultMaxMockNodes.
	MaxMockNodes int
	// MaxMockProperties limits object properties rendered while building generated mocks.
	// A zero or negative value uses DefaultMaxMockProperties.
	MaxMockProperties int
	// MaxMockRefExpansions limits $ref schema expansions while building generated mocks.
	// A zero or negative value uses DefaultMaxMockRefExpansions.
	MaxMockRefExpansions int
	// MaxMockBytes limits approximate generated mock structure size before serialization.
	// The default matches MaxGeneratedMockBytes to avoid generating work that the
	// serialized mock cap will discard. A zero or negative value uses DefaultMaxMockBytes.
	MaxMockBytes int
	// LLMAggregateSpecSizeThresholdBytes controls when monolithic LLM aggregate
	// files are skipped in auto mode. A zero or negative value uses
	// DefaultLLMAggregateSpecSizeThresholdBytes.
	LLMAggregateSpecSizeThresholdBytes int64
	// LLMMaxAggregateFileBytes controls the target maximum size of sharded LLM
	// aggregate files. A zero or negative value uses DefaultLLMMaxAggregateFileBytes.
	LLMMaxAggregateFileBytes int64
	// LLMGenerateMonoliths controls whether llms-full.txt, llms-operations.txt,
	// and llms-models.txt are generated. Supported values are auto, always, and never.
	LLMGenerateMonoliths string

	// SharedAssetBaseURL, when set, instructs the renderer to:
	//   1. skip writing embedded shared assets (JS bundle, CSS, fonts, icons)
	//      into OutputDir
	//   2. emit references to those assets at this URL prefix in generated HTML
	//
	// Per-artifact files (HTML, page-data JSON, page-viz JSON, the nav cache
	// JSON under data/) continue to be written into OutputDir and referenced
	// via BaseURL.
	//
	// Use case: a host application mounts the renderer's SharedAssets FS at a
	// known URL (e.g. /ppress/static/{contentVersion}) and wants every artifact
	// to share that one copy instead of duplicating the bundle per generation.
	SharedAssetBaseURL string
}

type SiteManifest = ArtifactManifest

type SpecStateRecord struct {
	RelativePath    string
	Hash            string
	ConfigHash      string
	MetadataVersion int
	Title           string
	Summary         string
	ContactName     string
	ContactEmail    string
	ServiceKey      string
	DisplayName     string
	Version         string
	Format          string
	OutputSubdir    string
	UpdatedAt       time.Time
}

type SpecStateStore interface {
	Load(namespace string) (map[string]*SpecStateRecord, error)
	Upsert(namespace string, records []*SpecStateRecord) error
	Delete(namespace string, paths []string) error
	Close() error
}

type SyntheticTagFallbackConfig struct {
	Enabled         bool
	MaxDistinctTags int
	MinOperations   int
}

type ValidationError struct {
	Issues []ValidationIssue
}

type ValidationIssue struct {
	Field   string
	Err     error
	Message string
}