@ibgib/core-gib 0.0.4

package/dist/common/form/form-helper.mjs

@@ -0,0 +1,185 @@
+import { getRegExp, UUID_REGEXP } from '@ibgib/helper-gib';
+// import { DynamicForm, FormItemInfo } from '../../ibgib-forms/types/form-items';
+import { GLOBAL_LOG_A_LOT, SAFE_SPECIAL_CHARS } from '../../core-constants.mjs';
+// import { getRegExp } from './utils';
+const logalot = GLOBAL_LOG_A_LOT || false;
+/**
+ * Fluent-style builder helper class.
+ *
+ * I'm making this to share common fields' settings among witness classes.
+ *
+ * Descend from this class for sharing other commonalities.
+ */
+export class DynamicFormBuilder {
+    constructor() {
+        this.lc = `[${DynamicFormBuilder.name}]`;
+        this.items = [];
+        this.what = '';
+        /**
+         * pool of uuids pre-calculated to be passed in to the builder. if this is
+         * falsy, then it will use a Math.random() based approach.
+         */
+        this.idPool = [];
+    }
+    /**
+     * hacky wrapper for this.idPool.pop()
+     */
+    getNewId() {
+        const lc = `${this.lc}[${this.getNewId.name}]`;
+        if (this.idPool?.length > 0) {
+            return this.idPool.pop() ?? '';
+        }
+        else {
+            // weak implementation...
+            let resultArray = [];
+            const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ';
+            const charLength = chars.length;
+            for (let i = 0; i < 32; i++) {
+                let charIndex = Math.floor(Math.random() * charLength);
+                resultArray.push(chars[charIndex]);
+            }
+            let id = resultArray.join('');
+            if (logalot) {
+                console.log(`${lc} id: ${id} (I: c6591ffee6d5bbea79ed19cfa6630422)`);
+            }
+            return id;
+        }
+    }
+    /**
+     * Start fluent calls with this.
+     */
+    forA({ what, }) {
+        this.what = what || 'thingy';
+        return this;
+    }
+    addItem(item) {
+        if (!item.uuid) {
+            item.uuid = this.getNewId();
+        }
+        this.items.push(item);
+    }
+    /**
+     * Empty function simply for more natural looking fluent syntax.
+     *
+     * You can override this for custom form builders that descend from this
+     * class.
+     *
+     * @returns this
+     */
+    with({ idPool, }) {
+        if (idPool) {
+            this.idPool = idPool;
+        }
+        return this;
+    }
+    /**
+     * I'm not a great fluent builder writer for TypeScript,
+     * and this function acts as a caster for which members of
+     * which concrete classes to expose for the proceeding builder lines.
+     *
+     *
+     * Basically, you use this to typecast the builder, possibly redundantly since
+     * I don't have any ordering implemented atow.
+     *
+     * @returns typecasted fluent builder
+     */
+    and() { return this; }
+    name({ of: value, required = true, }) {
+        this.addItem({
+            // witness.data.name
+            name: "name",
+            description: `What to call this ${this.what}. Doesn't have to be unique, no spaces, up to 32 alphanumerics/underscores in length.`,
+            label: "Name",
+            placeholder: `e.g. "bob_the_cool"`,
+            regexp: getRegExp({ min: 1, max: 32, noSpaces: true }),
+            regexpErrorMsg: '1 to 32 characters, no spaces, underscores allowed.',
+            required,
+            dataType: 'text',
+            value,
+        });
+        return this;
+    }
+    description({ of: value, required, defaultValue, }) {
+        this.addItem({
+            // witness.data.description
+            name: "description",
+            description: `Description/notes for this ${this.what}.`,
+            label: "Description",
+            placeholder: `Describe these ${this.what} settings here...`,
+            regexp: getRegExp({ min: 0, max: 155, chars: SAFE_SPECIAL_CHARS }),
+            regexpErrorMsg: `0 to 155 alphanumerics or any of ${SAFE_SPECIAL_CHARS}`,
+            // regexpSource: getRegExp({min: 0, max: 155, chars: SAFE_SPECIAL_CHARS}).source,
+            dataType: 'textarea',
+            required,
+            defaultValue,
+            value,
+        });
+        return this;
+    }
+    classname({ of, required = true, }) {
+        this.addItem({
+            // witness.data.classname
+            name: "classname",
+            description: `Technical setting that is the name of the ${this.what}'s class in computer code.`,
+            label: "Classname",
+            regexp: getRegExp({ min: 1, max: 128, noSpaces: true }),
+            regexpErrorMsg: `1 to 128 alphanumerics or underscores without spaces`,
+            // regexpSource: getRegExp({min: 1, max: 128, noSpaces: true}).source,
+            dataType: 'text',
+            value: of,
+            readonly: true,
+            required,
+        });
+        return this;
+    }
+    uuid({ of, label, required, }) {
+        this.addItem({
+            // witness.data.uuid
+            name: "uuid",
+            description: `Unique(ish) id of the ${this.what}.`,
+            label: label ?? "ID",
+            dataType: 'text',
+            value: of,
+            regexp: UUID_REGEXP,
+            regexpErrorMsg: '1 to 256 alphanumerics, underscores, dots, hyphens allowed.',
+            readonly: true,
+            required,
+        });
+        return this;
+    }
+    version({ of, required, }) {
+        this.addItem({
+            // witness.data.version
+            name: "version",
+            description: `Technical setting indicating the version of the ${this.what}.`,
+            label: "Version",
+            dataType: 'text',
+            value: of || '',
+            readonly: true,
+            required,
+        });
+        return this;
+    }
+    /**
+     * To pass in a completely customized item info.
+     *
+     * @returns `this` for fluent builder
+     */
+    customItem(item) {
+        this.addItem(item);
+        return this;
+    }
+    outputItems() {
+        return this.items;
+    }
+    outputForm({ formName, label, }) {
+        return {
+            name: formName,
+            // description: this.description ?? `This is a form for a ${this.what}`,
+            description: `This is a form for a ${this.what}`,
+            label: label ?? this.what,
+            items: this.items,
+        };
+    }
+}
+//# sourceMappingURL=form-helper.mjs.map

package/dist/common/form/form-helper.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-helper.mjs","sourceRoot":"","sources":["../../../src/common/form/form-helper.mts"],"names":[],"mappings":"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"}

package/dist/common/form/form-items.d.mts

@@ -0,0 +1,229 @@
+/**
+ * @module
+ *
+ * Types used in bindings for forms/dynamic forms.
+ *
+ * ## transitioning development
+ *
+ * I am transitioning from a ad hoc field behavior with angular templated forms
+ * to a slightly more powerful dynamic form fields that leverages angular's
+ * reactive forms. So many of the later properties of {@link FormItemInfo} are
+ * optional for backwards compatibility. These may become required in the
+ * future, once I have dynamic forms more fleshed out.
+ */
+/**
+ * For when you want options with both a label and icons.
+ */
+export interface SelectOptionWithIcon {
+    label: string;
+    icon: string;
+    value: string;
+}
+/**
+ * Used in modal forms.
+ */
+export interface FormItemInfo {
+    /**
+     * Property name
+     */
+    name: string;
+    /**
+     *
+     */
+    value?: string | number | boolean;
+    /**
+     * If set, the value will default to this.
+     */
+    defaultValue?: string | number | boolean;
+    /**
+     * Label for the property on a form
+     */
+    label?: string;
+    /**
+     * Optional description for the property. Can bind title/hover/tooltip to this.
+     */
+    description?: string;
+    /**
+     * Placeholder when entering the field's data.
+     */
+    placeholder?: string;
+    /**
+     * Validation regular expression
+     *
+     * If you change this on a field, you should always change
+     * the {@link regexpErrorMsg} !
+  
+     * @see {@link regexpErrorMsg}
+     */
+    regexp?: RegExp;
+    /**
+     * If provided, this tries to give guidance on regexp failures.
+     *
+     * NOTE this can always get out of sync with the regexp!
+     * @see {@link regexp}
+     */
+    regexpErrorMsg?: string;
+    /**
+     * regexp.source
+     */
+    /**
+     * Only required if wanting to do validation beyond regexp/required.
+     */
+    fnValid?: (value: string | number) => boolean;
+    /**
+     * Default error message, often used with {@see fnValid}.
+     *
+     * @see {@link regexpErrorMsg}
+     *
+     * ## in the future, this may be changed to a
+     * `string | {[error: string]: string}` which would be a better
+     * solution probably.
+     */
+    defaultErrorMsg?: string;
+    /**
+     * If the field is required.
+     */
+    required?: boolean;
+    /**
+     * If true, will not log field and will use type='password', unless the field
+     * is {@link unmasked}.
+     */
+    private?: boolean;
+    /**
+     * If true, will reveal a private field.
+     */
+    unmasked?: boolean;
+    /**
+     * If true, then regardless of modal state (adding/editing/viewing), this
+     * field will always be readonly.
+     */
+    readonly?: boolean;
+    /**
+     * If truthy and non-zero, then this is a composite item which contains
+     * other items.
+     *
+     * Basically with angular, this translates to either a `FormGroup` or
+     * `FormArray`.
+     */
+    items?: FormItemInfo[];
+    /**
+     * @see {@link FormItemDataType}
+     *
+     * Only should be set if {@link items} is falsy.
+     */
+    dataType?: FormItemDataType;
+    /**
+     * Options to populate a select drop-down list (valid value list). I believe
+     * this can also be populated after the field info has been created but
+     * before/while the select list is shown to the user.
+     */
+    selectOptions?: string[];
+    /**
+     * If you want your select options to include icons, use this.
+     * @see {@link selectOptions}
+     */
+    selectOptionsWithIcons?: SelectOptionWithIcon[];
+    /**
+     * If set, this will trigger when the item is selected.
+     */
+    onSelect?: (event: any, info: FormItemInfo) => Promise<void>;
+    /**
+     * If given, should be the min of the field for validation.
+     *
+     * If the dataType is some kind of text, then this refers to the length of string.
+     * If the dataType is some kind of number, then this refers to the value of the number.
+     *
+     * ## notes
+     * * there can be the regex also that looks at this value
+     *
+     * @optional
+     */
+    min?: number;
+    /**
+     * If given, should be the max of the field for validation.
+     *
+     * If the dataType is some kind of text, then this refers to the length of string.
+     * If the dataType is some kind of number, then this refers to the value of the number.
+     *
+     * ## notes
+     * * there can be the regex also that looks at this value
+     *
+     * @optional
+     */
+    max?: number;
+    /**
+     * If true, select can select multiple items.
+     *
+     * If not a select, then not sure what's up.
+     */
+    multiple?: boolean;
+    /**
+     * If control is set, then this should be a randomly generated uuid
+     * that can be uniquely associated to the control.
+     */
+    uuid?: string;
+    /**
+     * If true, then the control is errored and contains error information.
+     */
+    errored?: boolean;
+}
+export type FormItemDataType = 'text' | 'textarea' | 'select' | 'toggle' | 'number' | 'form';
+/**
+ * Type of the data, to drive what kind of control will be used for data.
+ *
+ * See individual members for more info.
+ *
+ * For fields that have auto-generated UI.
+ *
+ * ATOW Pretty much mirroring html5 input types.
+ *
+ * @see {@link FormItemDataType.text}
+ * @see {@link textarea}
+ * @see {@link select}
+ * @see {@link toggle}
+ * @see {@link number}
+ */
+export declare const FormItemDataType: {
+    /**
+     * @example name
+     */
+    text: FormItemDataType;
+    /**
+     * @example description
+     */
+    textarea: FormItemDataType;
+    /**
+     * select string(s) from a list.
+     *
+     * @example States e.g. TX, TN, NY, etc.
+     *
+     * @see {@link FormItemInfo.multiple}
+     */
+    select: FormItemDataType;
+    /**
+     * Boolean true/false or on/off, etc.
+     */
+    toggle: FormItemDataType;
+    /**
+     * Number value
+     */
+    number: FormItemDataType;
+    /**
+     * The item is a collection of other items.
+     */
+    form: FormItemDataType;
+};
+/**
+ * syntactic sugar for `Object.values(FormItemDataType)`
+ */
+export declare const FORM_ITEM_DATA_TYPES: FormItemDataType[];
+/**
+ * A form is basically an array of form items.
+ */
+export interface DynamicForm extends FormItemInfo {
+    /**
+     * redeclared here to require children items.
+     */
+    items: FormItemInfo[];
+}
+//# sourceMappingURL=form-items.d.mts.map

package/dist/common/form/form-items.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-items.d.mts","sourceRoot":"","sources":["../../../src/common/form/form-items.mts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAClC;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACzC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;OAEG;IAEH;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,KAAK,OAAO,CAAC;IAC9C;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB;;;OAGG;IACH,sBAAsB,CAAC,EAAE,oBAAoB,EAAE,CAAC;IAChD;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D;;;;;;;;;;OAUG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;;;;;;;OAUG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAGD,MAAM,MAAM,gBAAgB,GAC1B,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAChE;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,gBAAgB;IAC3B;;OAEG;;IAEH;;OAEG;;IAEH;;;;;;OAMG;;IAEH;;OAEG;;IAEH;;OAEG;;IAEH;;OAEG;;CAEJ,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,oBAAkC,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,YAAY;IAC/C;;OAEG;IACH,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB"}

package/dist/common/form/form-items.mjs

@@ -0,0 +1,63 @@
+/**
+ * @module
+ *
+ * Types used in bindings for forms/dynamic forms.
+ *
+ * ## transitioning development
+ *
+ * I am transitioning from a ad hoc field behavior with angular templated forms
+ * to a slightly more powerful dynamic form fields that leverages angular's
+ * reactive forms. So many of the later properties of {@link FormItemInfo} are
+ * optional for backwards compatibility. These may become required in the
+ * future, once I have dynamic forms more fleshed out.
+ */
+/**
+ * Type of the data, to drive what kind of control will be used for data.
+ *
+ * See individual members for more info.
+ *
+ * For fields that have auto-generated UI.
+ *
+ * ATOW Pretty much mirroring html5 input types.
+ *
+ * @see {@link FormItemDataType.text}
+ * @see {@link textarea}
+ * @see {@link select}
+ * @see {@link toggle}
+ * @see {@link number}
+ */
+export const FormItemDataType = {
+    /**
+     * @example name
+     */
+    text: 'text',
+    /**
+     * @example description
+     */
+    textarea: 'textarea',
+    /**
+     * select string(s) from a list.
+     *
+     * @example States e.g. TX, TN, NY, etc.
+     *
+     * @see {@link FormItemInfo.multiple}
+     */
+    select: 'select',
+    /**
+     * Boolean true/false or on/off, etc.
+     */
+    toggle: 'toggle',
+    /**
+     * Number value
+     */
+    number: 'number',
+    /**
+     * The item is a collection of other items.
+     */
+    form: 'form',
+};
+/**
+ * syntactic sugar for `Object.values(FormItemDataType)`
+ */
+export const FORM_ITEM_DATA_TYPES = Object.values(FormItemDataType);
+//# sourceMappingURL=form-items.mjs.map

package/dist/common/form/form-items.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-items.mjs","sourceRoot":"","sources":["../../../src/common/form/form-items.mts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAoKH;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B;;OAEG;IACH,IAAI,EAAE,MAA0B;IAChC;;OAEG;IACH,QAAQ,EAAE,UAA8B;IACxC;;;;;;OAMG;IACH,MAAM,EAAE,QAA4B;IACpC;;OAEG;IACH,MAAM,EAAE,QAA4B;IACpC;;OAEG;IACH,MAAM,EAAE,QAA4B;IACpC;;OAEG;IACH,IAAI,EAAE,MAA0B;CACjC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC"}

package/dist/common/import-export/import-export-types.d.mts

@@ -0,0 +1,18 @@
+import { IbGibAddr, IbGibRel8ns } from '@ibgib/ts-gib/dist/types.mjs';
+import { IbGib_V1 } from '@ibgib/ts-gib/dist/V1/index.mjs';
+export interface RawExportData_V1 {
+    dependencyGraphAsString: string;
+    contextIbGibAddr: IbGibAddr;
+    tjpAddr?: IbGibAddr;
+}
+export interface RawExportRel8ns_V1 extends IbGibRel8ns {
+}
+/**
+ * Ibgib that contains an entire export of a given ibgib.
+ *
+ * This could potentially be huge, so I'm naming it "Raw" in hopes
+ * that in the future some type of sharding & compression might happen.
+ */
+export interface RawExportIbGib_V1 extends IbGib_V1<RawExportData_V1, RawExportRel8ns_V1> {
+}
+//# sourceMappingURL=import-export-types.d.mts.map

package/dist/common/import-export/import-export-types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-export-types.d.mts","sourceRoot":"","sources":["../../../src/common/import-export/import-export-types.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC7B,uBAAuB,EAAE,MAAM,CAAC;IAChC,gBAAgB,EAAE,SAAS,CAAC;IAC5B,OAAO,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,MAAM,WAAW,kBAAmB,SAAQ,WAAW;CAAI;AAE3D;;;;;GAKG;AACH,MAAM,WAAW,iBAAkB,SAAQ,QAAQ,CAAC,gBAAgB,EAAE,kBAAkB,CAAC;CAAI"}

package/dist/common/import-export/import-export-types.mjs

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=import-export-types.mjs.map

package/dist/common/import-export/import-export-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-export-types.mjs","sourceRoot":"","sources":["../../../src/common/import-export/import-export-types.mts"],"names":[],"mappings":""}

package/dist/common/legacy/legacy-types.d.mts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=legacy-types.d.mts.map

package/dist/common/legacy/legacy-types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-types.d.mts","sourceRoot":"","sources":["../../../src/common/legacy/legacy-types.mts"],"names":[],"mappings":""}

package/dist/common/legacy/legacy-types.mjs

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=legacy-types.mjs.map

package/dist/common/legacy/legacy-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-types.mjs","sourceRoot":"","sources":["../../../src/common/legacy/legacy-types.mts"],"names":[],"mappings":""}

package/dist/common/link/link-constants.d.mts

@@ -0,0 +1,2 @@
+export declare const DEFAULT_LINK_TEXT_IB_SUBSTRING_LENGTH = 20;
+//# sourceMappingURL=link-constants.d.mts.map

package/dist/common/link/link-constants.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-constants.d.mts","sourceRoot":"","sources":["../../../src/common/link/link-constants.mts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qCAAqC,KAAK,CAAC"}

package/dist/common/link/link-constants.mjs

@@ -0,0 +1,2 @@
+export const DEFAULT_LINK_TEXT_IB_SUBSTRING_LENGTH = 20;
+//# sourceMappingURL=link-constants.mjs.map

package/dist/common/link/link-constants.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-constants.mjs","sourceRoot":"","sources":["../../../src/common/link/link-constants.mts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qCAAqC,GAAG,EAAE,CAAC"}

package/dist/common/link/link-helper.d.mts

@@ -0,0 +1,37 @@
+import { IbGib_V1 } from '@ibgib/ts-gib/dist/V1/index.mjs';
+import { TransformResult } from '@ibgib/ts-gib';
+import { IbGibSpaceAny } from '../../witness/space/space-base-v1.mjs';
+import { LinkIbGib_V1 } from './link-types.mjs';
+/**
+ * generates an ib based on the link text.
+ *
+ * Basically this gets a short substring of the link text and replaces
+ * any non alphanumeric characters.
+ *
+ * @param linkText link text
+ * @returns link ib for the given link text
+ */
+export declare function getLinkIb(linkText: string): string;
+/**
+ * creates a link ibgib, returning the transform result,
+ * optionally saving it in a given {@link space}.
+ */
+export declare function createLinkIbGib({ text, saveInSpace, space, }: {
+    /**
+     * link text
+     */
+    text: string;
+    /**
+     * If true, will save the ibgibs created in the given {@link space}.
+     */
+    saveInSpace?: boolean;
+    /**
+     * If {@link saveInSpace}, all ibgibs created in this function will be stored in
+     * this space.
+     */
+    space?: IbGibSpaceAny;
+}): Promise<TransformResult<LinkIbGib_V1>>;
+export declare function isLink({ ibGib, }: {
+    ibGib: IbGib_V1;
+}): boolean;
+//# sourceMappingURL=link-helper.d.mts.map

package/dist/common/link/link-helper.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-helper.d.mts","sourceRoot":"","sources":["../../../src/common/link/link-helper.mts"],"names":[],"mappings":"AACA,OAAO,EAAyB,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAClF,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAMtE,OAAO,EAAe,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAK7D;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAqBlD;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,EACpC,IAAI,EACJ,WAAW,EACX,KAAK,GACN,EAAE;IACD;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB,GAAG,OAAO,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC,CAuCzC;AAED,wBAAgB,MAAM,CAAC,EACrB,KAAK,GACN,EAAE;IACD,KAAK,EAAE,QAAQ,CAAC;CACjB,GAAG,OAAO,CAwCV"}