@ethlete/cli 3.0.0-next.21 → 3.0.0-next.22

package/src/lib/design/system/comments/inbox.d.ts

@@ -0,0 +1,49 @@
+import { DesignConfig } from '../../paths';
+import { DesignComment, ThreadState } from './comment';
+export type InboxComment = Omit<DesignComment, 'file'> & {
+    kind: 'comment';
+    file: string;
+    at: string;
+    threadState: ThreadState;
+};
+type DecisionOn = {
+    product: string;
+    target: string;
+    comment?: string;
+    at: string;
+};
+export type InboxDecision = (DecisionOn & {
+    kind: 'pick';
+    variant: string;
+}) | (DecisionOn & {
+    kind: 'discard';
+});
+/** A sketch whose baseline is stale: `changed` names the parts that changed in the product, `[]` when it records no baseline. */
+export type InboxRebase = {
+    kind: 'rebase';
+    product: string;
+    target: string;
+    changed: string[];
+    at: string;
+};
+export type InboxItem = InboxComment | InboxDecision | InboxRebase;
+/**
+ * Everything that waits for the agent, across the named products, oldest first: each open comment thread whose
+ * last word is the user's and each sketch that needs a rebase. `waiting` holds the open threads whose last word is
+ * the agent's and the pick or discard decisions, which the user carries out in Studio. `unreadable` names the files that could not be read.
+ */
+export declare const inboxOf: (options: {
+    target: string;
+    config: DesignConfig;
+    products?: string[];
+}) => {
+    items: InboxItem[];
+    waiting: (InboxComment | InboxDecision)[];
+    unreadable: string[];
+};
+/** The inbox as text, one block per item with the command that settles it, then what waits for the user. */
+export declare const inboxText: (inbox: {
+    items: InboxItem[];
+    waiting: InboxItem[];
+}, invocation: string) => string;
+export {};

package/src/lib/design/system/comments/inbox.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inboxText = exports.inboxOf = void 0;
+const path_1 = require("path");
+const product_1 = require("../product");
+const baseline_1 = require("../sketch/baseline");
+const cli_args_1 = require("../sketch/cli-args");
+const sketch_1 = require("../sketch/sketch");
+const comment_1 = require("./comment");
+/**
+ * Everything that waits for the agent, across the named products, oldest first: each open comment thread whose
+ * last word is the user's and each sketch that needs a rebase. `waiting` holds the open threads whose last word is
+ * the agent's and the pick or discard decisions, which the user carries out in Studio. `unreadable` names the files that could not be read.
+ */
+const inboxOf = (options) => {
+    var _a, _b, _c, _d;
+    const { target, config } = options;
+    const products = (_a = options.products) !== null && _a !== void 0 ? _a : Object.keys((_b = config.products) !== null && _b !== void 0 ? _b : {});
+    const items = [];
+    const waiting = [];
+    const unreadable = [];
+    for (const product of products) {
+        const productDir = (0, product_1.productDirOf)({ target, product });
+        const comments = (0, comment_1.listComments)({ productDir, product });
+        unreadable.push(...comments.unreadable.map(({ file, problem }) => `${(0, path_1.relative)(target, file)}: ${problem}`));
+        for (const comment of comments.comments) {
+            const item = Object.assign(Object.assign({}, comment), { kind: 'comment', file: (0, path_1.relative)(target, comment.file), at: (_d = (_c = comment.replies[comment.replies.length - 1]) === null || _c === void 0 ? void 0 : _c.createdAt) !== null && _d !== void 0 ? _d : comment.createdAt, threadState: (0, comment_1.threadStateOf)(comment) });
+            ((0, comment_1.lastWordOf)(comment) === 'user' ? items : waiting).push(item);
+        }
+        const sketches = (0, sketch_1.listSketches)({ productDir, product });
+        const resolved = sketches.length > 0 ? (0, cli_args_1.oneProductOf)({ target, config, asked: product }) : null;
+        if (typeof resolved === 'string')
+            unreadable.push(resolved);
+        for (const sketch of sketches) {
+            if (typeof sketch === 'string') {
+                unreadable.push(sketch);
+                continue;
+            }
+            const changed = resolved && typeof resolved !== 'string' ? (0, baseline_1.staleBaselineOf)({ product: resolved, sketch }) : null;
+            if (changed)
+                items.push({ kind: 'rebase', product, target: sketch.target, changed, at: sketch.createdAt });
+            if (!sketch.decision)
+                continue;
+            const { decision } = sketch;
+            const on = Object.assign({ product, target: sketch.target, at: decision.decidedAt }, (decision.comment ? { comment: decision.comment } : {}));
+            waiting.push(decision.kind === 'pick' ? Object.assign(Object.assign({}, on), { kind: 'pick', variant: decision.variant }) : Object.assign(Object.assign({}, on), { kind: 'discard' }));
+        }
+    }
+    const byTime = (a, b) => a.at.localeCompare(b.at);
+    return { items: items.sort(byTime), waiting: waiting.sort(byTime), unreadable };
+};
+exports.inboxOf = inboxOf;
+const quoted = (text) => JSON.stringify(text);
+const indented = (text, by = '    ') => text.split('\n').map((line) => `${by}${line}`);
+const lineOf = (item, invocation) => {
+    const when = item.at.slice(0, 16).replace('T', ' ');
+    if (item.kind === 'comment') {
+        const where = [
+            item.part,
+            item.state,
+            typeof item.size === 'number' ? `${item.size} px` : item.size,
+            ...(item.interaction === comment_1.REST ? [] : [item.interaction]),
+            ...(item.point ? [`at ${item.point.x},${item.point.y}`] : []),
+            ...(item.sketch ? [`sketch ${item.sketch.target} variant ${item.sketch.variant}`] : []),
+        ].join(' · ');
+        return [
+            `${when}  ${item.product}  comment ${item.id}${item.threadState === 'agent' ? '' : ` (${item.threadState})`}  ${where}`,
+            ...indented(item.text),
+            ...item.replies.flatMap((reply) => [
+                `    ${reply.by}${reply.author ? ` ${reply.author}` : ''}${reply.question ? ' asks' : ''}:`,
+                ...indented(reply.text, '      '),
+            ]),
+            `    reply: ${invocation} comment reply ${item.id} --product ${item.product} --by <model id> ${quoted('…')}`,
+            `    done: ${invocation} inbox done ${item.id} --note "…" --by <model id>`,
+        ];
+    }
+    if (item.kind === 'rebase')
+        return [
+            `${when}  ${item.product}  needs rebase ${item.target}: ${item.changed.length > 0 ? `${item.changed.join(', ')} changed in the product` : 'it records no baseline'}`,
+            `    bring each variant up to date, then run: ${invocation} sketch rebase ${item.target} --product ${item.product} --by <model id>`,
+        ];
+    const said = item.comment ? [`    ${item.comment}`] : [];
+    if (item.kind === 'pick')
+        return [
+            `${when}  ${item.product}  pick ${item.target} variant ${item.variant}`,
+            ...said,
+            '    the user merges it in Studio - do not run sketch merge',
+        ];
+    return [`${when}  ${item.product}  discard ${item.target}`, ...said, '    the user discards it in Studio'];
+};
+/** The inbox as text, one block per item with the command that settles it, then what waits for the user. */
+const inboxText = (inbox, invocation) => {
+    const work = inbox.items.length === 0 ? ['inbox empty'] : inbox.items.flatMap((item) => lineOf(item, invocation));
+    const waiting = inbox.waiting.length === 0
+        ? []
+        : ['', 'waiting for the user:', ...inbox.waiting.flatMap((item) => lineOf(item, invocation))];
+    return [...work, ...waiting].join('\n');
+};
+exports.inboxText = inboxText;
+//# sourceMappingURL=inbox.js.map

package/src/lib/design/system/comments/inbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbox.js","sourceRoot":"","sources":["../../../../../../../libs/cli/src/lib/design/system/comments/inbox.ts"],"names":[],"mappings":"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"}

package/src/lib/design/system/css-source.d.ts

@@ -0,0 +1,12 @@
+export type CssBlocks = {
+    selectors: string[];
+    declarations: string[];
+};
+/**
+ * Splits CSS into the text before each `{` (selectors) and the text before each `;` or `}`
+ * (declarations). At-rule preludes are dropped. Text after the last delimiter counts as a
+ * declaration, so an inline `style="…"` attribute reads as one.
+ */
+export declare const cssBlocksOf: (css: string) => CssBlocks;
+export declare const declarationValueOf: (declaration: string) => string | null;
+export declare const classesOf: (selector: string) => string[];

package/src/lib/design/system/css-source.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.classesOf = exports.declarationValueOf = exports.cssBlocksOf = void 0;
+const withoutComments = (css) => css.replace(/\/\*[\s\S]*?\*\//g, '');
+/**
+ * Splits CSS into the text before each `{` (selectors) and the text before each `;` or `}`
+ * (declarations). At-rule preludes are dropped. Text after the last delimiter counts as a
+ * declaration, so an inline `style="…"` attribute reads as one.
+ */
+const cssBlocksOf = (css) => {
+    const selectors = [];
+    const declarations = [];
+    let buffer = '';
+    const flush = (into) => {
+        const text = buffer.trim();
+        if (text && !text.startsWith('@'))
+            into.push(text);
+        buffer = '';
+    };
+    for (const char of withoutComments(css)) {
+        if (char === '{')
+            flush(selectors);
+        else if (char === ';' || char === '}')
+            flush(declarations);
+        else
+            buffer += char;
+    }
+    flush(declarations);
+    return { selectors, declarations };
+};
+exports.cssBlocksOf = cssBlocksOf;
+const declarationValueOf = (declaration) => {
+    const colon = declaration.indexOf(':');
+    return colon === -1 ? null : declaration.slice(colon + 1);
+};
+exports.declarationValueOf = declarationValueOf;
+const classesOf = (selector) => [...selector.matchAll(/\.(-?[_a-zA-Z][\w-]*)/g)].map((match) => { var _a; return (_a = match[1]) !== null && _a !== void 0 ? _a : ''; });
+exports.classesOf = classesOf;
+//# sourceMappingURL=css-source.js.map

package/src/lib/design/system/css-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"css-source.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/design/system/css-source.ts"],"names":[],"mappings":";;;AAEA,MAAM,eAAe,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;AAE9E;;;;GAIG;AACI,MAAM,WAAW,GAAG,CAAC,GAAW,EAAa,EAAE;IACpD,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,IAAI,MAAM,GAAG,EAAE,CAAC;IAEhB,MAAM,KAAK,GAAG,CAAC,IAAc,EAAE,EAAE;QAC/B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QAE3B,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnD,MAAM,GAAG,EAAE,CAAC;IACd,CAAC,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;QACxC,IAAI,IAAI,KAAK,GAAG;YAAE,KAAK,CAAC,SAAS,CAAC,CAAC;aAC9B,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG;YAAE,KAAK,CAAC,YAAY,CAAC,CAAC;;YACtD,MAAM,IAAI,IAAI,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,CAAC;IAEpB,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;AACrC,CAAC,CAAC;AArBW,QAAA,WAAW,eAqBtB;AAEK,MAAM,kBAAkB,GAAG,CAAC,WAAmB,EAAE,EAAE;IACxD,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAEvC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;AAC5D,CAAC,CAAC;AAJW,QAAA,kBAAkB,sBAI7B;AAEK,MAAM,SAAS,GAAG,CAAC,QAAgB,EAAE,EAAE,CAC5C,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,wBAAwB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,WAAC,OAAA,MAAA,KAAK,CAAC,CAAC,CAAC,mCAAI,EAAE,CAAA,EAAA,CAAC,CAAC;AADrE,QAAA,SAAS,aAC4D"}

package/src/lib/design/system/flows/flow.d.ts

@@ -0,0 +1,66 @@
+import { CommentPoint } from '../comments/comment';
+export type FlowState = {
+    part: string;
+    state: string;
+};
+/** `position` is the frame's top-left corner on the flow canvas in CSS pixels; without one Studio lays the frame out. */
+export type FlowFrame = FlowState & {
+    position?: CommentPoint;
+};
+export type FlowLine = {
+    from: FlowState;
+    to: FlowState;
+    label?: string;
+};
+/** A note of the flow itself, such as a heading over a group of frames; `at` is its top-left corner on the flow canvas, and may be negative. */
+export type FlowNote = {
+    id: string;
+    text: string;
+    at?: CommentPoint;
+};
+export type FlowFile = {
+    frames: FlowFrame[];
+    lines?: FlowLine[];
+    notes?: FlowNote[];
+};
+export type DesignFlow = {
+    name: string;
+    file: string;
+    frames: FlowFrame[];
+    lines: FlowLine[];
+    notes: FlowNote[];
+};
+/** What a change sets: a new text, a new place, or `at: null` to let Studio place the note. */
+export type FlowNoteChange = {
+    text?: string;
+    at?: CommentPoint | null;
+};
+export declare const flowsDirOf: (productDir: string) => string;
+export declare const flowStateKeyOf: (state: FlowState) => string;
+/** Every flow of a product, `<product>/flows/<name>.json`, by name; a file that cannot be read answers with its problem. */
+export declare const listFlows: (productDir: string) => {
+    flows: DesignFlow[];
+    unreadable: {
+        file: string;
+        problem: string;
+    }[];
+};
+/** Adds a free note to a flow file. Answers with the note, or with why the flow cannot take it. */
+export declare const addFlowNote: (options: {
+    productDir: string;
+    name: string;
+    note: Omit<FlowNote, "id">;
+}) => FlowNote | string;
+/** Changes the text or the place of a free note in a flow file. Answers with the changed note. */
+export declare const changeFlowNote: (options: {
+    productDir: string;
+    name: string;
+    id: string;
+    change: FlowNoteChange;
+}) => FlowNote | string;
+/** Deletes a free note from a flow file. Answers with the deleted note. */
+export declare const deleteFlowNote: (options: {
+    productDir: string;
+    name: string;
+    id: string;
+}) => FlowNote | string;

package/src/lib/design/system/flows/flow.js

@@ -0,0 +1,157 @@
+"use strict";
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deleteFlowNote = exports.changeFlowNote = exports.addFlowNote = exports.listFlows = exports.flowStateKeyOf = exports.flowsDirOf = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const comment_1 = require("../comments/comment");
+const note_1 = require("../notes/note");
+const flowsDirOf = (productDir) => (0, path_1.resolve)(productDir, 'flows');
+exports.flowsDirOf = flowsDirOf;
+const flowStateKeyOf = (state) => `${state.part}#${state.state}`;
+exports.flowStateKeyOf = flowStateKeyOf;
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const isText = (value) => typeof value === 'string' && value.trim() !== '';
+const FLOW_NAME = /^[A-Za-z0-9][A-Za-z0-9._-]*$/u;
+const isCanvasPoint = (value) => isRecord(value) && Number.isFinite(value['x']) && Number.isFinite(value['y']);
+const isState = (value) => isRecord(value) && isText(value['part']) && isText(value['state']);
+const frameProblemOf = (frame, index) => {
+    if (!isState(frame))
+        return `frames[${index}] must be { part: "<layer>/<name>", state, position? }`;
+    const { position } = frame;
+    return position !== undefined && !(0, comment_1.isPoint)(position)
+        ? `frames[${index}].position must be { x, y } in CSS pixels, both >= 0`
+        : null;
+};
+const lineProblemOf = (line, index) => isRecord(line) &&
+    isState(line['from']) &&
+    isState(line['to']) &&
+    (line['label'] === undefined || isText(line['label']))
+    ? null
+    : `lines[${index}] must be { from: { part, state }, to: { part, state }, label? }`;
+const noteProblemOf = (note, index) => isRecord(note) &&
+    isText(note['id']) &&
+    isText(note['text']) &&
+    (note['at'] === undefined || isCanvasPoint(note['at']))
+    ? null
+    : `notes[${index}] must be { id, text, at?: { x, y } }, at in CSS pixels on the flow canvas`;
+const shapeProblemOf = (value) => {
+    var _a, _b, _c, _d;
+    if (!isRecord(value))
+        return 'must be a JSON object { frames, lines?, notes? }';
+    if (!Array.isArray(value['frames']))
+        return 'frames must be a list';
+    if (value['lines'] !== undefined && !Array.isArray(value['lines']))
+        return 'lines must be a list';
+    if (value['notes'] !== undefined && !Array.isArray(value['notes']))
+        return 'notes must be a list';
+    const problem = (_c = (_a = value['frames'].map(frameProblemOf).find((found) => found !== null)) !== null && _a !== void 0 ? _a : ((_b = value['lines']) !== null && _b !== void 0 ? _b : []).map(lineProblemOf).find((found) => found !== null)) !== null && _c !== void 0 ? _c : ((_d = value['notes']) !== null && _d !== void 0 ? _d : []).map(noteProblemOf).find((found) => found !== null);
+    return problem !== null && problem !== void 0 ? problem : null;
+};
+const flowOf = ({ parsed, name, file }) => {
+    var _a, _b;
+    return ({
+        name,
+        file,
+        frames: parsed.frames.map(({ part, state, position }) => (Object.assign({ part, state }, (position ? { position } : {})))),
+        lines: ((_a = parsed.lines) !== null && _a !== void 0 ? _a : []).map(({ from, to, label }) => (Object.assign({ from: { part: from.part, state: from.state }, to: { part: to.part, state: to.state } }, (label ? { label } : {})))),
+        notes: ((_b = parsed.notes) !== null && _b !== void 0 ? _b : []).map(({ id, text, at }) => (Object.assign({ id, text }, (at ? { at } : {})))),
+    });
+};
+/** Every flow of a product, `<product>/flows/<name>.json`, by name; a file that cannot be read answers with its problem. */
+const listFlows = (productDir) => {
+    const dir = (0, exports.flowsDirOf)(productDir);
+    const files = (0, fs_1.existsSync)(dir) ? (0, fs_1.readdirSync)(dir).filter((name) => name.endsWith('.json')) : [];
+    const read = files.sort().map((name) => {
+        const file = (0, path_1.resolve)(dir, name);
+        try {
+            const parsed = JSON.parse((0, fs_1.readFileSync)(file, 'utf8'));
+            const problem = shapeProblemOf(parsed);
+            return problem
+                ? { file, problem }
+                : flowOf({ parsed: parsed, name: name.slice(0, -'.json'.length), file });
+        }
+        catch (error) {
+            return { file, problem: `is no JSON: ${error instanceof Error ? error.message : String(error)}` };
+        }
+    });
+    return {
+        flows: read.filter((entry) => !('problem' in entry)),
+        unreadable: read.filter((entry) => 'problem' in entry),
+    };
+};
+exports.listFlows = listFlows;
+const readFlowFile = (productDir, name) => {
+    if (!FLOW_NAME.test(name))
+        return `"${name}" is no flow name`;
+    const file = (0, path_1.resolve)((0, exports.flowsDirOf)(productDir), `${name}.json`);
+    if (!(0, fs_1.existsSync)(file))
+        return `no flow "${name}"`;
+    try {
+        const parsed = JSON.parse((0, fs_1.readFileSync)(file, 'utf8'));
+        const problem = shapeProblemOf(parsed);
+        return problem ? `flows/${name}.json ${problem} - fix it first` : { file, parsed: parsed };
+    }
+    catch (error) {
+        return `flows/${name}.json is no JSON - fix it first: ${error instanceof Error ? error.message : String(error)}`;
+    }
+};
+/** Rewrites only the `notes` of a readable flow file; every other key, unknown ones too, stays as it was. */
+const withFlowNotes = (options) => {
+    var _a;
+    const read = readFlowFile(options.productDir, options.name);
+    if (typeof read === 'string')
+        return read;
+    const updated = options.update((_a = read.parsed.notes) !== null && _a !== void 0 ? _a : []);
+    if (typeof updated === 'string')
+        return updated;
+    const problem = updated.notes.map(noteProblemOf).find((found) => found !== null);
+    if (problem)
+        return problem;
+    const written = Object.fromEntries(Object.entries(Object.assign(Object.assign({}, read.parsed), { notes: updated.notes })).filter(([key, value]) => key !== 'notes' || value.length > 0));
+    (0, fs_1.writeFileSync)(read.file, `${JSON.stringify(written, null, 2)}\n`);
+    return updated.answer;
+};
+const noNoteIn = (name, id) => `flow "${name}" has no note "${id}"`;
+/** Adds a free note to a flow file. Answers with the note, or with why the flow cannot take it. */
+const addFlowNote = (options) => {
+    const { text, at } = options.note;
+    const note = Object.assign({ id: (0, note_1.newNoteId)(), text }, (at === undefined ? {} : { at }));
+    return withFlowNotes(Object.assign(Object.assign({}, options), { update: (notes) => ({ notes: [...notes, note], answer: note }) }));
+};
+exports.addFlowNote = addFlowNote;
+/** Changes the text or the place of a free note in a flow file. Answers with the changed note. */
+const changeFlowNote = (options) => {
+    const { name, id, change } = options;
+    return withFlowNotes(Object.assign(Object.assign({}, options), { update: (notes) => {
+            var _a, _b;
+            const found = notes.find((note) => note.id === id);
+            if (!found)
+                return noNoteIn(name, id);
+            const { at: before } = found, rest = __rest(found, ["at"]);
+            const at = change.at === undefined ? before : ((_a = change.at) !== null && _a !== void 0 ? _a : undefined);
+            const changed = Object.assign(Object.assign(Object.assign({}, rest), { text: (_b = change.text) !== null && _b !== void 0 ? _b : found.text }), (at ? { at } : {}));
+            return { notes: notes.map((note) => (note.id === id ? changed : note)), answer: changed };
+        } }));
+};
+exports.changeFlowNote = changeFlowNote;
+/** Deletes a free note from a flow file. Answers with the deleted note. */
+const deleteFlowNote = (options) => {
+    const { name, id } = options;
+    return withFlowNotes(Object.assign(Object.assign({}, options), { update: (notes) => {
+            const found = notes.find((note) => note.id === id);
+            return found ? { notes: notes.filter((note) => note !== found), answer: found } : noNoteIn(name, id);
+        } }));
+};
+exports.deleteFlowNote = deleteFlowNote;
+//# sourceMappingURL=flow.js.map

package/src/lib/design/system/flows/flow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow.js","sourceRoot":"","sources":["../../../../../../../libs/cli/src/lib/design/system/flows/flow.ts"],"names":[],"mappings":"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"}

package/src/lib/design/system/imports.d.ts

@@ -0,0 +1,70 @@
+import { Problem } from './problem';
+import { ResolvedPart, ResolvedProduct } from './resolve-product';
+export declare const FIXTURES_SPECIFIER = "@system/fixtures";
+export declare const SHARED_PREFIX = "@shared/";
+export type PartImport = {
+    kind: 'part';
+    layer: string;
+    name: string;
+    specifier: string;
+    stylesheet?: true;
+} | {
+    kind: 'fixtures';
+    specifier: string;
+} | {
+    kind: 'shared';
+    path: string;
+    specifier: string;
+} | {
+    kind: 'asset';
+    path: string;
+    specifier: string;
+} | {
+    kind: 'relative';
+    specifier: string;
+} | {
+    kind: 'other';
+    specifier: string;
+};
+export declare const partSpecifierOf: (part: {
+    layer: string;
+    name: string;
+}) => string;
+export declare const classifyImport: (specifier: string) => PartImport;
+export declare const importsOfPart: (part: ResolvedPart) => PartImport[];
+/** The modules of the part's own folder its file imports, directly or through another such module. */
+export declare const folderModulesOf: (part: ResolvedPart) => {
+    file: string;
+    source: string;
+}[];
+/** The parts a part imports, from its file or from a plain module of its own folder that the file imports. */
+export declare const partDependenciesOf: (part: ResolvedPart) => {
+    kind: "part";
+    layer: string;
+    name: string;
+    specifier: string;
+    stylesheet?: true;
+}[];
+export type SharedDirs = {
+    sharedDir?: string;
+    variantSharedDir?: string;
+};
+/** The folders `@shared/<path>` looks in, the variant's own `shared/` first. */
+export declare const sharedDirsOf: (product: SharedDirs) => string[];
+/** The file `@shared/<path>` resolves to, the variant's own copy first; `null` when no folder holds it. */
+export declare const sharedFileOf: (options: {
+    dirs: string[];
+    path: string;
+}) => string | null;
+/**
+ * Imports and stylesheet `url(@assets/...)` that name no part, fixture set or asset file, `@shared/` imports outside a sketch variant (`sharedDir` is the
+ * sketch's `shared/` folder, `assetsDir` the variant's `assets/`), and relative imports that reach into another part.
+ */
+export declare const importProblemsOf: (product: ResolvedProduct & SharedDirs & {
+    assetsDir?: string;
+}) => Problem[];
+/** The parts `from` imports, directly or through another part, as the product resolves them. */
+export declare const partsReachedFrom: (options: {
+    product: ResolvedProduct;
+    from: ResolvedPart;
+}) => ResolvedPart[];