//title: Cast-On Sampler (javascript with knitout module)
// Creates several sheets, all with different cast-ons.

//include knitout module:
const knitout = require('knitout'); //include knitout module
const K = new knitout.Writer({ carriers:['1', '2', '3', '4', '5', '6'] });
K.addHeader('Machine', 'Kniterate');

//Parameters:
let carrier = "3"; //carrier name
let min = 1; //needle number of left edge
let max = 20; //needle number of right edge
let rows = 20; //rows of knitting in each sample
let cordWidth = 4; //cord width (for I-cord cast-on)

// === Alternating Tucks === 
//Bring in carrier:
K.in(carrier);

//On Kniterate machines, carriers start on the left,
//so will start tucking onto needles left-to-right,
//and will be sure to tuck the leftmost needle in the first pass:
for (let n = min; n <= max; n += 1) {
	//tuck alternating needles, making sure to do the left edge:
	if ((n - min) % 2 === 0) {
		K.tuck("+", 'f' + n, carrier);
	}
}
//now, moving right-to-left, tuck the needles that were not tucked on the first pass:
for (let n = max; n >= min; n -= 1) {
	if ((n - min) % 2 !== 0) {
		K.tuck("-", 'f' + n, carrier);
	}
}

//knit three plain rows to allow cast-on stitches to relax:
// three isn't set in stone here -- it's just convenient
// for this example code to have the carrier end up on the right.
for (let n = min; n <= max; n += 1) {
	K.knit("+", 'f' + n, carrier);
}
for (let n = max; n >= min; n -= 1) {
	K.knit("-", 'f' + n, carrier);
}
for (let n = min; n <= max; n += 1) {
	K.knit("+", 'f' + n, carrier);
}
// ---- single jersey sheet ----
for (let r = 0; r <= rows; r += 1) {
	if (r % 2 === 0) {
		//left-going row:
		for (let n = max; n >= min; n -= 1) {
			K.knit("-", 'f' + n, carrier);
		}
	} else {
		//right-going row:
		for (let n = min; n <= max; n += 1) {
			K.knit("+", 'f' + n, carrier);
		}
	}
}

// ---- take carrier out and drop remaining loops ----
//Send carrier back to its parking location:
K.out(carrier);

//drop loops:
for (let n = min; n <= max; n += 1) {
	K.drop('f' + n);
}

// === All-Needle Welt === 
//Bring in carrier:
K.in(carrier);

//On Kniterate machines, carriers start on the left,
//so will start by tucking all needles left-to-right,
//and will be sure to tuck the rightmost back-bed needle last.

//Need to use quarter-pitch racking to tuck all needles in one pass:
K.rack(0.5);

for (let n = min; n <= max; n += 1) {
	K.tuck("+", 'f' + n, carrier);
	K.tuck("+", 'b' + n, carrier);
}

//Return to aligned racking:
K.rack(0);

//Do a row of plain knitting on the front and back:
for (let n = max; n >= min; n -= 1) {
	K.knit("-", 'f' + n, carrier);
}
for (let n = min; n <= max; n += 1) {
	K.knit("+", 'b' + n, carrier);
}
//One can knit more on the front or back beds here to make a larger "welt" at the edge.

//Stack back-bed stitches with front-bed stitches:
for (let n = min; n <= max; n += 1) {
	K.xfer('b' + n, 'f' + n);
}

//knit two plain rows through the stacked stitches to return carrier to the right edge:
for (let n = max; n >= min; n -= 1) {
	K.knit("-", 'f' + n, carrier);
}
for (let n = min; n <= max; n += 1) {
	K.knit("+", 'f' + n, carrier);
}

// ---- single jersey sheet ----
for (let r = 0; r <= rows; r += 1) {
	if (r % 2 === 0) {
		//left-going row:
		for (let n = max; n >= min; n -= 1) {
			K.knit("-", 'f' + n, carrier);
		}
	} else {
		//right-going row:
		for (let n = min; n <= max; n += 1) {
			K.knit("+", 'f' + n, carrier);
		}
	}
}

// ---- take carrier out and drop remaining loops ----
//Send carrier back to its parking location:
K.out(carrier);

//drop loops:
for (let n = min; n <= max; n += 1) {
	K.drop('f' + n);
}

// === Twisted Tucks === 
//Bring in carrier:
K.in(carrier);

//Use a twisted tuck to cast on every stitch.
//Note: this requires a new pass for every stitch, so is pretty slow!
//There are both faster and fancier cast-ons.
//On Kniterate machines, carriers start on the left, so will start with leftmost needle.
for (let n = min; n <= max; n += 1) {
	//tuck alternating needles, making sure to do the left edge:
	K.tuck("-", 'f' + n, carrier);
}

//knit two plain rows to allow cast-on stitches to relax and bring carrier to the right:
for (let n = max; n >= min; n -= 1) {
	K.knit("-", 'f' + n, carrier);
}
for (let n = min; n <= max; n += 1) {
	K.knit("+", 'f' + n, carrier);
}
// ---- single jersey sheet ----
for (let r = 0; r <= rows; r += 1) {
	if (r % 2 === 0) {
		//left-going row:
		for (let n = max; n >= min; n -= 1) {
			K.knit("-", 'f' + n, carrier);
		}
	} else {
		//right-going row:
		for (let n = min; n <= max; n += 1) {
			K.knit("+", 'f' + n, carrier);
		}
	}
}

// ---- take carrier out and drop remaining loops ----
//Send carrier back to its parking location:
K.out(carrier);

//drop loops:
for (let n = min; n <= max; n += 1) {
	K.drop('f' + n);
}

// === I-Cord === 
//; not supported at full guage on kniterate


K.write('cast-on-sampler.kniterate.k');