spectra-cli 4.1.1 → 4.2.0

package/dist/panoramic/docs-bundle-types.d.ts

@@ -0,0 +1,94 @@
+/**
+ * docs bundle 共享类型
+ *
+ * 055 只负责“把既有文档组织成交付包”，不重新生成事实。
+ * 这些类型因此聚焦于文档清单、profile 和导航，而不包含站点框架实现细节。
+ */
+export declare const DOCS_BUNDLE_VERSION: 1;
+export declare const DOCS_BUNDLE_MANIFEST_FILE: "docs-bundle.yaml";
+export declare const DOCS_BUNDLE_ROOT_DIR: "bundles";
+export type SourceDocumentKind = 'project-doc' | 'index-spec';
+export type BundleDocumentKind = 'landing' | 'project-doc' | 'index-spec' | 'module-spec';
+export type BundleProfileId = 'developer-onboarding' | 'architecture-review' | 'api-consumer' | 'ops-handover';
+export interface SourceDocument {
+    id: string;
+    title: string;
+    kind: SourceDocumentKind;
+    generatorId?: string;
+    sourcePath: string;
+    relativePath: string;
+    description?: string;
+}
+export interface ModuleSpecDocument {
+    moduleName: string;
+    title: string;
+    sourcePath: string;
+    relativePath: string;
+    bundlePath: string;
+}
+export interface DocsBundleInput {
+    projectRoot: string;
+    outputDir: string;
+    projectDocs: SourceDocument[];
+    moduleSpecs: ModuleSpecDocument[];
+    indexSpec?: SourceDocument;
+}
+export interface BundleProfileDefinition {
+    id: BundleProfileId;
+    title: string;
+    description: string;
+    coreDocumentIds: string[];
+    includeModuleSpecs: boolean;
+    moduleSpecsSectionTitle?: string;
+}
+export interface BundleDocument {
+    sourceId: string;
+    title: string;
+    sourcePath: string;
+    outputPath: string;
+    navPath: string;
+    order: number;
+    kind: BundleDocumentKind;
+    optional: boolean;
+    description?: string;
+}
+export interface BundleNavItem {
+    title: string;
+    path?: string;
+    children?: BundleNavItem[];
+}
+export interface BundleProfileManifest {
+    id: BundleProfileId;
+    title: string;
+    description: string;
+    rootDir: string;
+    docsRoot: string;
+    mkdocsConfigPath: string;
+    landingPagePath: string;
+    documents: BundleDocument[];
+    navigation: BundleNavItem[];
+    warnings: string[];
+}
+export interface DocsBundleManifest {
+    version: typeof DOCS_BUNDLE_VERSION;
+    generatedAt: string;
+    outputDir: string;
+    profiles: BundleProfileManifest[];
+    sourceInventory: SourceDocument[];
+    moduleSpecCount: number;
+}
+export interface DocsBundleProfileSummary {
+    id: BundleProfileId;
+    title: string;
+    rootDir: string;
+    documentCount: number;
+    warningCount: number;
+}
+export interface DocsBundleResult {
+    manifestPath: string;
+    manifest: DocsBundleManifest;
+    profileRoots: string[];
+    profiles: DocsBundleProfileSummary[];
+    warnings: string[];
+}
+//# sourceMappingURL=docs-bundle-types.d.ts.map

package/dist/panoramic/docs-bundle-types.d.ts.map

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

package/dist/panoramic/docs-bundle-types.js

@@ -0,0 +1,10 @@
+/**
+ * docs bundle 共享类型
+ *
+ * 055 只负责“把既有文档组织成交付包”，不重新生成事实。
+ * 这些类型因此聚焦于文档清单、profile 和导航，而不包含站点框架实现细节。
+ */
+export const DOCS_BUNDLE_VERSION = 1;
+export const DOCS_BUNDLE_MANIFEST_FILE = 'docs-bundle.yaml';
+export const DOCS_BUNDLE_ROOT_DIR = 'bundles';
+//# sourceMappingURL=docs-bundle-types.js.map

package/dist/panoramic/docs-bundle-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-bundle-types.js","sourceRoot":"","sources":["../../src/panoramic/docs-bundle-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAU,CAAC;AAC9C,MAAM,CAAC,MAAM,yBAAyB,GAAG,kBAA2B,CAAC;AACrE,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAkB,CAAC"}

package/dist/panoramic/docs-quality-evaluator.d.ts

@@ -0,0 +1,31 @@
+import type { ProjectContext } from './interfaces.js';
+import type { ArchitectureNarrativeOutput, BatchGeneratedDocSummary } from './architecture-narrative.js';
+import type { ArchitectureOverviewOutput } from './architecture-overview-generator.js';
+import type { PatternHintsOutput } from './pattern-hints-model.js';
+import type { ComponentViewOutput, DynamicScenariosOutput } from './component-view-model.js';
+import type { RuntimeTopologyOutput } from './runtime-topology-generator.js';
+import type { AdrIndexOutput } from './adr-decision-pipeline.js';
+import type { FeatureBriefIndexOutput, ProductOverviewOutput, UserJourneysOutput } from './product-ux-docs.js';
+import type { DocsBundleManifestReference } from './docs-bundle-manifest-reader.js';
+import { type DocsQualityReport } from './docs-quality-model.js';
+export interface EvaluateDocsQualityOptions {
+    projectRoot: string;
+    outputDir: string;
+    projectContext?: ProjectContext;
+    generatedDocs: BatchGeneratedDocSummary[];
+    architectureNarrative: ArchitectureNarrativeOutput;
+    architectureOverview?: ArchitectureOverviewOutput;
+    patternHints?: PatternHintsOutput;
+    componentView?: ComponentViewOutput;
+    dynamicScenarios?: DynamicScenariosOutput;
+    runtimeTopology?: RuntimeTopologyOutput;
+    adrIndex?: AdrIndexOutput;
+    productOverview?: ProductOverviewOutput;
+    userJourneys?: UserJourneysOutput;
+    featureBriefIndex?: FeatureBriefIndexOutput;
+    docsBundleManifest?: DocsBundleManifestReference;
+    dependencyWarnings?: string[];
+}
+export declare function evaluateDocsQuality(options: EvaluateDocsQualityOptions): DocsQualityReport;
+export declare function renderDocsQualityReport(report: DocsQualityReport): string;
+//# sourceMappingURL=docs-quality-evaluator.d.ts.map

package/dist/panoramic/docs-quality-evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-quality-evaluator.d.ts","sourceRoot":"","sources":["../../src/panoramic/docs-quality-evaluator.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,2BAA2B,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACzG,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AACvF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAC7F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,KAAK,EAAY,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AACpF,OAAO,EASL,KAAK,iBAAiB,EAMvB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,0BAA0B;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,aAAa,EAAE,wBAAwB,EAAE,CAAC;IAC1C,qBAAqB,EAAE,2BAA2B,CAAC;IACnD,oBAAoB,CAAC,EAAE,0BAA0B,CAAC;IAClD,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAC1C,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,iBAAiB,CAAC,EAAE,uBAAuB,CAAC;IAC5C,kBAAkB,CAAC,EAAE,2BAA2B,CAAC;IACjD,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAiOD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,iBAAiB,CAqD1F;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAGzE"}