@remixmate/cli 0.9.71 → 0.9.73

package/dist/template/constants.d.ts

@@ -1,39 +0,0 @@
-/**
- * Contract constants for `remixmate template` (design §11 K1 / K5 / K6).
- *
- * STARTER_VERSION pins the exact starter release this cli was tested against.
- * Bumping it is a deliberate cli release, never a range — `init` must produce
- * the same project on every machine for a given cli version.
- */
-export declare const STARTER_PACKAGE = "@remixmate/template-starter";
-/**
- * 一个 starter 版本 = 一套本地校验规则版本（.remixmate/）。规则更新的发布顺序：
- * template-library `pnpm publish:sdk --publish` 发新 starter → 改这里 → cli 发版。
- * publish:sdk 会比对这个常量，对不上就拒发。
- */
-export declare const STARTER_VERSION = "0.2.0";
-/**
- * 工程里记录规则版本的文件（starter ≥0.2.0 构建时写入；`template upgrade` 也会写）。
- * 0.1.0 工程没有它，回落读 package.json 的 version（init 时整份复制自 starter）。
- */
-export declare const RULES_VERSION_FILE = ".remixmate/version.json";
-/** `template upgrade` 只替换这个目录；用户的 templates/、src/ 等一律不动。 */
-export declare const RULES_DIR = ".remixmate";
-/** `template upgrade --with-docs` 额外刷新的 agent 指南（旧文件备份为 *.orig）。 */
-export declare const DOC_FILES: readonly string[];
-/** Local tarball override (testing a starter before it is published). */
-export declare const STARTER_TARBALL_ENV = "REMIXMATE_STARTER_TARBALL";
-/** Marker file that identifies a starter project root (K3). */
-export declare const CHECK_ENTRY = ".remixmate/check/index.mjs";
-/** Per-template identity file written by publish (K4). */
-export declare const IDENTITY_FILE = ".remixmate.json";
-export declare const DEFAULT_RENDER_BASE_URL = "https://api-render.remixmate.ai";
-/** Draft preview limits enforced by ab-render /renderDraft (K5). */
-export declare const PREVIEW_MAX_LONG_EDGE = 1280;
-export declare const PREVIEW_MAX_SHORT_EDGE = 720;
-export declare const PREVIEW_MAX_SECONDS = 60;
-/**
- * Same list as template-library `publish-private.mjs` TAR_EXCLUDES. `dsl-example.json`
- * is deliberately kept: it is the reference DSL the registry ships with the template.
- */
-export declare const TAR_EXCLUDES: readonly string[];

package/dist/template/init.d.ts

@@ -1,28 +0,0 @@
-/**
- * `remixmate template init <dir> [--force]` — scaffold a starter project.
- *
- * Only Node + npm are required (requirement 3.1): the starter is fetched with
- * `npm pack` (works with whatever registry/proxy npm is configured for), unpacked
- * with the system `tar` (bsdtar ships with Windows 10+), then `npm install`ed.
- * No login is needed (requirement 3.5).
- */
-import { Output } from './project.js';
-export interface InitOptions {
-    dir: string;
-    force?: boolean;
-    json?: boolean;
-    /** Skip `npm install` (offline tests, or users who want to pick their own installer). */
-    skipInstall?: boolean;
-}
-export interface InitResult {
-    ok: true;
-    dir: string;
-    starter: string;
-    installed: boolean;
-}
-/** Obtain the starter tarball: local override, else `npm pack` into `tmp`. Shared with `upgrade`. */
-export declare function obtainStarterTarball(tmp: string, out: Output): Promise<{
-    file: string;
-    label: string;
-}>;
-export declare function runInit(opts: InitOptions): Promise<InitResult>;

package/dist/template/list.d.ts

@@ -1,23 +0,0 @@
-/**
- * `remixmate template list` — the caller's own (non-builtin) templates.
- *
- * Uses ab-api `/remotionTemplate/myPage` (the "mine" view: user_id = caller,
- * is_builtin = 0, not deleted). The builtin filter is re-applied client side
- * so a backend change can never make this list show platform templates.
- */
-export interface ListOptions {
-    json?: boolean;
-    token?: string;
-    apiBaseUrl?: string;
-}
-export interface PrivateTemplate {
-    templateKey: string;
-    name: string;
-    lifecycleStatus?: string;
-    coreVersion?: string;
-    updateTime?: string;
-}
-export declare function runList(opts: ListOptions): Promise<{
-    ok: true;
-    templates: PrivateTemplate[];
-}>;

package/dist/template/preview.d.ts

@@ -1,60 +0,0 @@
-/**
- * `remixmate template preview <name>` — render a draft mp4 on the real ab-render.
- *
- * Ported from template-library `scripts/preview-remote.mjs` (same HTTP contract,
- * same file-enumeration and sample-props rules). It deliberately does NOT
- * reimplement the DSL → TemplateBinding pipeline: preview answers "does this
- * code run in the real renderer"; binding correctness is `render-video`'s job.
- *
- * Sample props are contract-driven: they come from the template's own
- * `dsl-example.json` through the `slotMapping[slot].propExtractors` it declares,
- * plus two global conventions (scene.customPayload → props.templateData,
- * dsl.assets → resolvedAssets). Nothing here knows any specific template.
- */
-export declare const PREVIEW_LIMIT_MESSAGE: string;
-export interface PreviewOptions {
-    name: string;
-    propsJson?: string;
-    durationSec?: number;
-    compositionId?: string;
-    timeoutSec?: number;
-    json?: boolean;
-    token?: string;
-    apiBaseUrl?: string;
-    cwd?: string;
-    /** Poll interval override (tests). */
-    pollIntervalMs?: number;
-}
-type Json = Record<string, any>;
-export declare function collectFiles(root: string, warn?: (m: string) => void): {
-    files: Record<string, string>;
-    bytes: number;
-};
-export interface SampleProps {
-    props: Json | Json[];
-    assets: unknown[];
-    durationSec: number | null;
-    scene?: Json;
-}
-export declare function buildSampleProps(tplDir: string, tpl: Json, compositionId: string, propsJson: string | undefined, warn?: (m: string) => void): SampleProps;
-/** Narration → subtitle segments (exact from items[].atSec, else proportional by sentence). */
-export declare function buildSubtitleSegments(scene: Json | undefined, totalFrames: number): Json[];
-/** Largest even-pixel frame of the given aspect that fits the draft preview limits. */
-export declare function previewDimensions(aspect: string): [number, number];
-export interface PreviewPlan {
-    files: Record<string, string>;
-    inputProps: Json;
-    compositionId: string;
-    totalSeconds: number;
-}
-export declare function buildPreviewPlan(tplDir: string, opts: Pick<PreviewOptions, 'propsJson' | 'durationSec' | 'compositionId'>, warn?: (m: string) => void): PreviewPlan;
-export interface PreviewResult {
-    ok: true;
-    name: string;
-    taskId: string;
-    url: string;
-    compositionId: string;
-    durationSec: number;
-}
-export declare function runPreview(opts: PreviewOptions): Promise<PreviewResult>;
-export {};

package/dist/template/proc.d.ts

@@ -1,26 +0,0 @@
-/**
- * Child-process helpers for `remixmate template`.
- *
- * Every command is spawned with an argv array — never a shell string — so a
- * directory or package spec can't be interpreted by a shell. The one exception
- * is npm on Windows: `npm` is `npm.cmd` there, and since Node's CVE-2024-27980
- * fix a .cmd can only be spawned with `shell: true`. For that path we only ever
- * pass fixed tokens or validated package specs (paths travel via `cwd`), and
- * refuse anything containing shell metacharacters.
- */
-export interface ProcResult {
-    code: number;
-    /** Captured stdout — only populated when stdout is piped. */
-    stdout: string;
-    stderr: string;
-}
-export interface ProcOptions {
-    cwd?: string;
-    /** 'inherit' streams to the terminal; 'pipe' captures. Default: inherit. */
-    stdio?: 'inherit' | 'pipe' | 'stderr';
-    env?: NodeJS.ProcessEnv;
-    shell?: boolean;
-}
-export declare function runProcess(command: string, args: string[], opts?: ProcOptions): Promise<ProcResult>;
-/** Run npm portably. `args` must be plain tokens; paths go through `cwd`. */
-export declare function runNpm(args: string[], opts?: Omit<ProcOptions, 'shell'>): Promise<ProcResult>;

package/dist/template/project.d.ts

@@ -1,47 +0,0 @@
-/**
- * Starter-project discovery, template identity (K4) and the shared output helper.
- */
-/** Walk up from `start` to the directory holding `.remixmate/check/index.mjs`. */
-export declare function findProjectRoot(start?: string): string | null;
-export declare function requireProjectRoot(start?: string): string;
-/** A template name is a single directory under templates/ — never a path. */
-export declare function validateTemplateName(name: string | undefined): string;
-export declare function requireTemplateDir(root: string, name: string): string;
-export declare function readJsonFile<T = Record<string, unknown>>(file: string): T;
-export interface TemplateIdentity {
-    templateKey: string;
-    version: number;
-}
-/** kebab-case slug of a directory name; falls back to `template` when nothing survives. */
-export declare function kebabSlug(input: string): string;
-/** First-publish key: `my-<slug>-<6 hex>`. */
-export declare function generateTemplateKey(dirName: string, hex?: string): string;
-export declare function readIdentity(templateDir: string): TemplateIdentity | null;
-/** Stable key: the identity file wins, so renaming the directory never forks a template. */
-export declare function resolveTemplateKey(templateDir: string): {
-    templateKey: string;
-    existing: boolean;
-};
-export declare function writeIdentity(templateDir: string, identity: TemplateIdentity): void;
-/** Numeric dotted compare (prerelease tags ignored): <0 / 0 / >0. */
-export declare function compareVersions(a: string, b: string): number;
-/**
- * The starter version whose rules this project's `.remixmate/` holds.
- * `.remixmate/version.json` wins; 0.1.0 projects fall back to package.json
- * (copied verbatim from the starter at init). null = unknown.
- */
-export declare function readRulesVersion(root: string): string | null;
-/** Hint line when the project's rules are older than what this cli ships with, else null. */
-export declare function staleRulesHint(root: string): string | null;
-/**
- * Human text goes to stdout by default. With --json it moves to stderr so the
- * last stdout line is the JSON result (progress lines still go to stdout —
- * hosts parse them by their `__progress__` marker).
- */
-export declare class Output {
-    readonly json: boolean;
-    constructor(json: boolean);
-    info(line?: string): void;
-    warn(line: string): void;
-    result(obj: Record<string, unknown>): void;
-}

package/dist/template/publish.d.ts

@@ -1,43 +0,0 @@
-/**
- * `remixmate template publish <name> [--name <displayName>] [--dry-run]`
- *
- * Ported from template-library `scripts/publish-private.mjs` — same ab-api
- * contract (prepareSave → presignUpload → PUT → save, isBuiltin=false), same
- * tar excludes. Differences, all from the spec:
- *   - the key is stable per template directory (K4 `.remixmate.json`), so a
- *     re-publish updates instead of forking, and renaming the dir is harmless;
- *   - the starter's own `check` runs first (requirement 6.2);
- *   - the project files stay read-only except for `.remixmate.json` — server
- *     normalization only touches a staging copy.
- *
- * Never printed: the token and the presigned upload URL.
- */
-import { type CoreSurface } from './render-client.js';
-export interface PublishOptions {
-    name: string;
-    displayName?: string;
-    dryRun?: boolean;
-    json?: boolean;
-    token?: string;
-    apiBaseUrl?: string;
-    cwd?: string;
-}
-export interface PublishResult {
-    ok: true;
-    name: string;
-    templateKey: string;
-    version: number | null;
-    dryRun: boolean;
-    created: boolean;
-}
-type Json = Record<string, any>;
-/** tar argv with the shared exclude list — exported for tests. */
-export declare function tarArgs(srcDir: string, outFile: string): string[];
-/**
- * Core preflight: the template's declared coreExports must all exist on the
- * target ab-render (the tar never carries core). Returns a block reason or null.
- * "Couldn't check" is a block, not a pass.
- */
-export declare function evaluateCoreSurface(manifest: Json, surface: CoreSurface | null, warn?: (m: string) => void): string | null;
-export declare function runPublish(opts: PublishOptions): Promise<PublishResult>;
-export {};

package/dist/template/render-client.d.ts

@@ -1,39 +0,0 @@
-/**
- * Minimal ab-render client for preview (/renderDraft) and publish preflight (/health).
- *
- * ab-render is a different origin from ab-api but verifies the same PrivToken,
- * so the token is resolved against the ab-api base (where `remixmate login`
- * stored it) and sent to ab-render as X-Priv-Token. All routes are POST.
- */
-import { SkillError } from '../errors.js';
-export declare function resolveRenderBaseUrl(): string;
-/** Business error from ab-render (`code != 0`), payload kept for issue rendering. */
-export declare class RenderBusinessError extends SkillError {
-    readonly code: number;
-    readonly payload: {
-        code?: number;
-        msg?: string;
-        data?: unknown;
-    };
-    constructor(message: string, code: number, payload: {
-        code?: number;
-        msg?: string;
-        data?: unknown;
-    });
-}
-export declare function renderPost<T = Record<string, unknown>>(base: string, route: string, body: unknown, opts: {
-    token?: string;
-    skillName: string;
-    timeoutMs?: number;
-}): Promise<T>;
-export interface CoreSurface {
-    available: boolean;
-    exports: string[];
-    digest?: string;
-    packageVersion?: string | null;
-    /** K5 addition; older ab-render instances omit it. */
-    versions?: string[];
-    error?: string | null;
-}
-/** /health → coreSurface, or null when the instance predates the core contract. */
-export declare function fetchCoreSurface(base: string): Promise<CoreSurface | null>;

package/dist/template/upgrade.d.ts

@@ -1,44 +0,0 @@
-/**
- * `remixmate template upgrade [--dry-run] [--with-docs] [--force] [--json]`
- *
- * 只更新工程里的本地校验规则（`.remixmate/`：check 脚本、template.schema.json、
- * template-security-policy.json），来源是本 cli 钉死的 starter 版本（STARTER_VERSION）。
- *
- * 为什么需要：starter 在 init 时整份复制进用户工程，之后平台收紧规则，老工程的
- * 本地 check 还是旧规则 —— 本地通过、服务端拒绝。一个 starter 版本 = 一套规则版本，
- * 所以升级 cli 后跑一次 upgrade 就能对齐。
- *
- * 刻意不动的东西：templates/（用户的模板）、src/、package.json 与依赖、examples/。
- * core 版本变化只提示不自动改 —— 升 core 可能影响模板渲染，必须是用户的决定。
- * `--with-docs` 额外刷新 AGENTS.md / CLAUDE.md（内容不同时旧文件备份为 *.orig）。
- */
-export interface UpgradeOptions {
-    dryRun?: boolean;
-    withDocs?: boolean;
-    /** Re-apply even when the project is already at (or above) this cli's starter version. */
-    force?: boolean;
-    json?: boolean;
-    cwd?: string;
-}
-export interface UpgradeResult {
-    ok: true;
-    from: string | null;
-    to: string;
-    upgraded: boolean;
-    dryRun: boolean;
-    docs: string[];
-    /** Dependency versions the new starter pins that differ from the project's (hint only). */
-    dependencyHints: Array<{
-        name: string;
-        project: string | null;
-        starter: string;
-    }>;
-}
-type Pkg = {
-    dependencies?: Record<string, string>;
-    devDependencies?: Record<string, string>;
-};
-/** Dependencies whose pinned version the starter changed — reported, never auto-applied. */
-export declare function diffDependencies(project: Pkg, starter: Pkg): UpgradeResult['dependencyHints'];
-export declare function runUpgrade(opts?: UpgradeOptions): Promise<UpgradeResult>;
-export {};

package/dist/text.d.ts

@@ -1,8 +0,0 @@
-/**
- * Terminal text helpers shared by the human-facing commands.
- */
-/**
- * Pad to a target terminal width. CJK characters occupy two columns but count as
- * one code unit, so String.padEnd misaligns any column that contains them.
- */
-export declare function padDisplay(text: string, width: number): string;