import type { CommerceCodeContext, CommerceFramework, FileOutput } from './types.js'; import { type RegisteredCommerceStep } from './registry.js'; import { type OptionalFeatureDeclaration } from './nextjs/storefront-ui.js'; import { type NextVerificationEvidence } from './nextjs/verification-evidence.js'; import { type FeatureModule } from './features/index.js'; export declare const STOREFRONT_BASELINE_DOC_PATH = "commerce/storefront-baseline"; export declare const VERIFY_SCRIPT = "scripts/verify-generated-next.ts"; /** 검증 기록 지문을 만들 때 쓰는 고정 컨텍스트. 사용자 키·쇼핑몰 이름과 무관하게 같은 생성기 버전이면 같은 지문이다. */ export declare const VERIFICATION_FIXTURE_CONTEXT: CommerceCodeContext; export declare const VERIFICATION_FIXTURE_ENV_MODE = "development"; /** complete 의 근거가 되는 실행 검증 항목. verify 스크립트가 같은 id 로 결과를 기록한다. */ export declare const REQUIRED_VERIFICATION_CHECKS: { id: string; title: string; }[]; export type RequirementKind = 'route' | 'action' | 'state' | 'boundary' | 'integrity'; export interface StorefrontRequirement { id: string; kind: RequirementKind; title: string; /** Next.js 산출물 검사 — 문제 목록(빈 배열이면 충족) */ check: (ix: FileIndex) => string[]; /** 다른 프레임워크: 모든 패턴이 어떤 파일에든 있어야 충족. 없으면 이 프레임워크 산출물에 구현이 없다고 본다 */ generic?: RegExp[]; } export declare class FileIndex { readonly byPath: Map; constructor(files: FileOutput[]); has(path: string): boolean; text(path: string): string; paths(): string[]; /** 화면 코드 — 컴포넌트와 App Router 페이지/레이아웃 */ uiFiles(): string[]; clientFiles(): string[]; pageRoutes(): string[][]; apiRoutes(): string[][]; } export declare function findEmptyHandlers(ix: FileIndex): string[]; export declare function findPlaceholders(ix: FileIndex): string[]; export declare function findDeadHrefs(ix: FileIndex): string[]; /** 화면 코드의 앱 내부 경로 문자열(href·router·fetch 대상)이 실제 생성 라우트를 가리키는지 */ export declare function findUnresolvedLinks(ix: FileIndex): string[]; /** '@/…'·상대 import 가 생성 파일로 풀리는지, 외부 패키지는 생성 package.json 에 있는지 */ export declare function findUnresolvedImports(ix: FileIndex): string[]; export declare const STOREFRONT_REQUIREMENTS: StorefrontRequirement[]; /** 산출물 지문 — 변경 감지용(보안 해시 아님). 경로 정렬 후 경로·내용을 모두 반영한다. */ export declare function fingerprintFiles(files: FileOutput[]): string; /** 검증 기록과 비교할 현재 생성기 지문(nextjs, all, 고정 컨텍스트) */ export declare function currentNextFingerprint(): string; /** 선택 기능 검증 기록과 비교할 지문 — 등록된 모든 선택 기능을 얹은 생성물(부분 선택도 이 기록으로 판정한다) */ export declare function currentNextFeatureFingerprint(): string; export interface StorefrontAssessment { status: 'complete' | 'incomplete'; missing_requirements: string[]; optional_features: { id: string; label: string; state: string; reason: string; }[]; verification: { basis: string; script: string; guide: string; current_fingerprint: string | null; recorded: { fingerprint: string; verified_at: string; matches: boolean; passed: string[]; failed: string[]; } | null; /** 선택 기능을 켰을 때만 — 모든 선택 기능을 얹은 생성물의 빌드·브라우저 시나리오 기록 */ features?: { basis: string; current_fingerprint: string | null; recorded: { fingerprint: string; verified_at: string; matches: boolean; passed: string[]; failed: string[]; } | null; }; }; } export interface AssessInput { framework: CommerceFramework; step: RegisteredCommerceStep; files: FileOutput[]; conflicts?: string[]; /** 테스트 주입용. 생략하면 현재 생성기 지문·저장된 기록·선언된 선택 기능을 쓴다 */ fingerprint?: string | null; evidence?: NextVerificationEvidence | null; optionalFeatures?: OptionalFeatureDeclaration[]; /** 켠 선택 기능 모듈(nextjs). 정적 검사·선언·선택 기능 검증 기록 판정에 쓴다 */ features?: readonly FeatureModule[]; featureFingerprint?: string | null; featureEvidence?: (NextVerificationEvidence & { features?: string[]; }) | null; } export declare function assessGeneratedStorefront(input: AssessInput): StorefrontAssessment; //# sourceMappingURL=requirements.d.ts.map