#Function: createVersionFromCommit()

createVersionFromCommit(args: { commit: Pick<LixCommit, "id">; id?: string & { __lixGenerated?: true; }; inheritsFrom?: null | LixVersion | Pick<LixVersion, "id">; lix: Lix; name?: LixGenerated<string>; }): Promise<LixVersion>

Creates a new version that starts at a specific commit.

• Points the new version's commit_id to the provided commit.
• Generates a fresh working_commit_id that references an empty change set (global scope).
• Does not modify the active version or any other versions.
• Inheritance lineage is controlled via inheritsFrom and defaults to "global".

#Examples

// Branch from a commit
const v = await createVersionFromCommit({ lix, commit });

// Custom id and name
const v = await createVersionFromCommit({ lix, commit, id: "my-id", name: "My Branch" });

// Inherit from a specific version
const parent = await createVersion({ lix, name: "base" });
const v = await createVersionFromCommit({ lix, commit, inheritsFrom: parent });

// Opt-out of inheritance
const v = await createVersionFromCommit({ lix, commit, inheritsFrom: null });

#Parameters

#Returns

Promise<LixVersion>

#Throws

If the provided commit id does not exist.