chapterjs 0.1.4 → 0.2.0

package/dist/messages/phrases.js

@@ -1,5 +1,5 @@
 // What the bot answers by itself, when it can't run what was asked: in
-// English here, and in the languages of `src/messages/` that translate
+// English here, and in the language files that translate
 // them (the `framework` of a language file).
 import { fill, pickLocale, templateOf } from './translate.js';
 /** The phrases of the framework, in English. */

package/dist/messages/translate.d.ts

@@ -18,7 +18,7 @@ export interface PluralTemplate {
     readonly params: readonly string[];
 }
 export type Template = TextTemplate | PluralTemplate;
-/** The languages of `src/messages/`, checked and assembled: what `t` reads. */
+/** The languages of the project, checked and assembled: what `t` reads. */
 export interface LoadedMessages {
     readonly default: Locale;
     /** The texts of each language declared, compiled. */
@@ -31,7 +31,7 @@ export interface LoadedMessages {
      * needed for that.
      */
     readonly commands: ReadonlyMap<Locale, Readonly<Record<string, unknown>>>;
-    /** The file of each language: `src/messages/fr.ts`. */
+    /** The file each language is declared in. */
     readonly files: ReadonlyMap<Locale, string>;
 }
 /** The forms a plural can have, in the order of the docs. */
@@ -82,7 +82,7 @@ export interface Audience {
  * @see https://docs.discord.com/developers/resources/guild#guild-object-guild-structure
  */
 export declare function audienceLocale({ person, guild, ephemeral, }: Audience): string | null;
-/** A `t` for a project without a language in `src/messages/`: it says so when called. */
+/** A `t` for a project without a language: it says so when called. */
 export declare function missingTranslator(locale: string | null): Translator<MessageTexts>;
 /**
  * `t` for what the bot sends, in the language of who will read it. Without
@@ -92,7 +92,7 @@ export declare function missingTranslator(locale: string | null): Translator<Mes
 export declare function translatorOf(ctx: Pick<Context, 'messages'>, audience: Audience): Translator<MessageTexts>;
 /**
  * What a handler receives about translations: `t` in the language asked
- * when the project has a language in `src/messages/`, nothing otherwise. Spread it
+ * when the project has a language, nothing otherwise. Spread it
  * into the context of any handler.
  */
 export declare function translation(ctx: Pick<Context, 'messages'>, locale: string | null): {

package/dist/messages/translate.js

@@ -176,7 +176,7 @@ export function translatorFor(messages, locale) {
             return fill(key, own, params, picked);
         const template = base.get(key);
         if (!template) {
-            throw new TypeError(`There is no message "${key}" in src/messages/. It has: ${[...base.keys()].join(', ')}.`);
+            throw new TypeError(`There is no message "${key}" in your languages. They have: ${[...base.keys()].join(', ')}.`);
         }
         return fill(key, template, params, messages.default);
     });
@@ -208,14 +208,14 @@ export function audienceLocale({ person, guild, ephemeral, }) {
     return guild.features.includes('COMMUNITY') ? guild.preferredLocale : null;
 }
 const missing = new Map();
-/** A `t` for a project without a language in `src/messages/`: it says so when called. */
+/** A `t` for a project without a language: it says so when called. */
 export function missingTranslator(locale) {
     const shown = locale ?? 'en-US';
     const known = missing.get(shown);
     if (known)
         return known;
     const t = (() => {
-        throw new TypeError('This project has no language in src/messages/: add one, like src/messages/en-US.ts, to use t().');
+        throw new TypeError("This project has no language: declare one with language({ locale: 'en-US', texts: { ... } }) to use t().");
     });
     Object.defineProperties(t, {
         locale: { value: shown, enumerable: true },
@@ -241,7 +241,7 @@ export function translatorOf(ctx, audience) {
 }
 /**
  * What a handler receives about translations: `t` in the language asked
- * when the project has a language in `src/messages/`, nothing otherwise. Spread it
+ * when the project has a language, nothing otherwise. Spread it
  * into the context of any handler.
  */
 export function translation(ctx, locale) {

package/dist/presence/declaration.d.ts

@@ -0,0 +1,19 @@
+import type { Declaration } from '../loader/loader.js';
+import { type RawGatewayPresenceUpdate } from '../discord/types/gateway-events.js';
+/** The presence, checked: what the gateway sends. */
+export interface LoadedPresence {
+    /** The Update Presence payload (also sent with Identify). */
+    readonly raw: RawGatewayPresenceUpdate;
+    /** What tells one presence from another: the payload, as text. */
+    readonly key: string;
+}
+/**
+ * What a bot without a presence shows: online, doing nothing. Sent when
+ * the declaration is removed while the bot runs.
+ */
+export declare const DEFAULT_PRESENCE: RawGatewayPresenceUpdate;
+/**
+ * The presence of the bot, declared once anywhere in `src/` with
+ * `presence()` and exported.
+ */
+export declare const presenceDeclaration: Declaration<LoadedPresence>;

package/dist/presence/{convention.js → declaration.js}

@@ -1,9 +1,8 @@
-// `src/presence.ts`: the one file that says what the bot shows under its
-// name. What it declares is checked when it loads and turned into what the
-// gateway sends, so a wrong status or type is explained before the bot
-// connects.
+// What a file declares with `presence()`: what the bot shows under its
+// name. It is checked when it loads and turned into what the gateway
+// sends, so a wrong status or type is explained before the bot connects.
 import { ActivityType, } from '../discord/types/gateway-events.js';
-import { isPresenceFile } from './presence.js';
+import { isPresenceDeclaration } from './presence.js';
 const fail = message => {
     throw new TypeError(message);
 };
@@ -36,8 +35,8 @@ const STREAM_URL = /^https:\/\/(?:www\.)?(?:twitch\.tv|youtube\.com)\//;
 const list = (words) => words.map(word => `'${word}'`).join(', ');
 const EXAMPLE = `presence({ status: 'online', activity: { type: 'watching', name: 'over the server' } })`;
 /**
- * What a bot without a presence file shows: online, doing nothing. Sent
- * when the file is removed while the bot runs.
+ * What a bot without a presence shows: online, doing nothing. Sent when
+ * the declaration is removed while the bot runs.
  */
 export const DEFAULT_PRESENCE = Object.freeze({
     since: null,
@@ -65,30 +64,16 @@ function toRaw(config) {
     };
 }
 /**
- * `src/presence.ts`: the status of the bot and what it is doing. The file
- * exports by default what `presence()` returns:
- *
- * ```ts
- * // src/presence.ts
- * import { presence } from 'chapterjs';
- *
- * export default presence({ activity: { type: 'playing', name: '/help' } });
- * ```
+ * The presence of the bot, declared once anywhere in `src/` with
+ * `presence()` and exported.
  */
-export const presenceConvention = {
-    folder: 'presence',
-    single: true,
+export const presenceDeclaration = {
     one: 'presence',
     many: 'presences',
-    read(exports) {
-        const file = exports.default;
-        const example = `import { presence } from 'chapterjs'; export default ${EXAMPLE}`;
-        if (!isPresenceFile(file)) {
-            return fail('default' in exports
-                ? `The default export of this file must be what presence() returns: ${example}`
-                : `This file has no default export. It should look like: ${example}`);
-        }
-        const config = file.config;
+    is: isPresenceDeclaration,
+    list: false,
+    read(value) {
+        const config = value.config;
         if (!isRecord(config)) {
             return fail(`presence() needs an object: ${EXAMPLE}`);
         }

package/dist/presence/presence.d.ts

@@ -26,22 +26,22 @@ export interface StreamingActivity {
 }
 /** What the bot is doing. */
 export type Activity = PlainActivity | StreamingActivity;
-/** What `src/presence.ts` gives to `presence()`. */
+/** What a file gives to `presence()`. */
 export interface PresenceConfig {
     /** The status of the bot. `'online'` by default. */
     status?: PresenceStatusName;
     /** What the bot is doing. Nothing by default. */
     activity?: Activity;
 }
-/** What `presence()` returns: the default export of `src/presence.ts`. */
-export interface PresenceFile {
+/** What `presence()` returns: a declaration the framework finds in the exports of a file. */
+export interface PresenceDeclaration {
     /** What the file gave to `presence()`, not checked yet. */
     readonly config: unknown;
 }
 /**
  * Declares the presence of the bot: its status and what it is doing, shown
- * under its name. Export the result as the default export of
- * `src/presence.ts`; the bot has it as soon as it is connected.
+ * under its name. Export the result from any file of `src/`, once; the bot
+ * has it as soon as it is connected.
  *
  * ```ts
  * import { presence } from 'chapterjs';
@@ -52,6 +52,6 @@ export interface PresenceFile {
  * });
  * ```
  */
-export declare function presence(config: PresenceConfig): PresenceFile;
+export declare function presence(config: PresenceConfig): PresenceDeclaration;
 /** Whether a value was made by `presence()`. */
-export declare function isPresenceFile(value: unknown): value is PresenceFile;
+export declare function isPresenceDeclaration(value: unknown): value is PresenceDeclaration;

package/dist/presence/presence.js

@@ -1,11 +1,11 @@
-// `presence()`, as `src/presence.ts` imports it from 'chapterjs': what the
-// bot shows under its name, its status and what it is doing.
+// `presence()`, as user files import it from 'chapterjs': what the bot
+// shows under its name, its status and what it is doing.
 // https://docs.discord.com/developers/events/gateway-events#update-presence
 const BRAND = Symbol.for('chapterjs.presence');
 /**
  * Declares the presence of the bot: its status and what it is doing, shown
- * under its name. Export the result as the default export of
- * `src/presence.ts`; the bot has it as soon as it is connected.
+ * under its name. Export the result from any file of `src/`, once; the bot
+ * has it as soon as it is connected.
  *
  * ```ts
  * import { presence } from 'chapterjs';
@@ -20,7 +20,7 @@ export function presence(config) {
     return Object.freeze({ [BRAND]: true, config });
 }
 /** Whether a value was made by `presence()`. */
-export function isPresenceFile(value) {
+export function isPresenceDeclaration(value) {
     return (typeof value === 'object' &&
         value !== null &&
         value[BRAND] === true);

package/dist/structures/context.d.ts

@@ -18,7 +18,7 @@ export interface Context {
         userId: Snowflake;
         applicationId: Snowflake;
     } | null;
-    /** The texts of `src/messages/`; `null` without a language. */
+    /** The texts of the language files; `null` without a language. */
     messages: LoadedMessages | null;
     /** Where the bot is in voice; `null` outside a running bot. */
     voice: VoiceManager | null;

package/dist/structures/interaction.d.ts

@@ -94,7 +94,7 @@ export declare class CommandInteraction extends Interaction {
     });
     /**
      * Opens a form, as the answer: `showModal(report({ userId }))`, with a
-     * form of `src/components/modals/`. It must be the first answer, and the
+     * form declared with `modal()`. It must be the first answer, and the
      * person has as long as they want to fill it in.
      * @see https://docs.discord.com/developers/interactions/receiving-and-responding#interaction-response-object-modal
      */
@@ -128,7 +128,7 @@ export declare class ComponentInteraction extends Interaction {
     deferUpdate(): Promise<void>;
     /**
      * Opens a form, as the answer: `showModal(report({ userId }))`, with a
-     * form of `src/components/modals/`. It must be the first answer.
+     * form declared with `modal()`. It must be the first answer.
      * @see https://docs.discord.com/developers/interactions/receiving-and-responding#interaction-response-object-modal
      */
     showModal(form: ModalComponent): Promise<void>;

package/dist/structures/interaction.js

@@ -75,7 +75,7 @@ export class Interaction extends IdStructure {
         openModal = (interaction, form) => {
             const rendered = renderedOf(form, 'The form given to showModal()');
             if (rendered.kind !== 'modal') {
-                throw new TypeError(`showModal() opens a form of src/components/modals/, got a ${rendered.kind}.`);
+                throw new TypeError(`showModal() opens a form declared with modal(), got a ${rendered.kind}.`);
             }
             return interaction.#run(async () => {
                 if (interaction.#state !== 'waiting') {
@@ -313,7 +313,7 @@ export class CommandInteraction extends Interaction {
     }
     /**
      * Opens a form, as the answer: `showModal(report({ userId }))`, with a
-     * form of `src/components/modals/`. It must be the first answer, and the
+     * form declared with `modal()`. It must be the first answer, and the
      * person has as long as they want to fill it in.
      * @see https://docs.discord.com/developers/interactions/receiving-and-responding#interaction-response-object-modal
      */
@@ -353,7 +353,7 @@ export class ComponentInteraction extends Interaction {
     }
     /**
      * Opens a form, as the answer: `showModal(report({ userId }))`, with a
-     * form of `src/components/modals/`. It must be the first answer.
+     * form declared with `modal()`. It must be the first answer.
      * @see https://docs.discord.com/developers/interactions/receiving-and-responding#interaction-response-object-modal
      */
     showModal(form) {

package/dist/structures/payload.d.ts

@@ -1,5 +1,5 @@
 import { type AssetFile } from '../assets/asset.js';
-import { type EmbedFile } from '../components/embed.js';
+import { type EmbedDeclaration } from '../components/embed.js';
 import type { MessageComponent } from '../components/instance.js';
 import type { Snowflake } from '../discord/types/common.js';
 import { type CreateMessageJSONParams, type RawAllowedMentions, type RawEmbed } from '../discord/types/message.js';
@@ -39,11 +39,11 @@ export interface FileInput {
 export interface MessageOptions {
     /** The text of the message (up to 2000 characters). */
     content?: string;
-    /** Up to 10 embeds: written here, or files of `src/components/embeds/`. */
-    embeds?: (Embed | EmbedFile<[]>)[];
+    /** Up to 10 embeds: written here, or declared with `embed()`. */
+    embeds?: (Embed | EmbedDeclaration<[]>)[];
     /**
      * Buttons, select menus and layout components, made by ChapterJS: the
-     * files of `src/components/` and `row()`, `text()`, `container()`...
+     * components declared with `button()`, `select()`... and `row()`, `text()`, `container()`...
      */
     components?: MessageComponent[];
     /** Up to 10 files to attach: their content, or `asset()` for a file of `public/`. */

package/dist/structures/payload.js

@@ -2,7 +2,7 @@
 // expects. Used by everything that sends a message: channels, replies,
 // webhooks, and later interactions.
 import { isAssetFile, readAsset } from '../assets/asset.js';
-import { isEmbedFile } from '../components/embed.js';
+import { isEmbedDeclaration, } from '../components/embed.js';
 import { renderComponents } from '../components/render.js';
 import { Limits } from '../discord/api.js';
 import { MessageFlags, } from '../discord/types/message.js';
@@ -41,16 +41,16 @@ export function checkEmbed(embed, name) {
     });
     return total;
 }
-/** The embeds of a message, with the files of `src/components/embeds/` called. */
+/** The embeds of a message, with the ones declared with `embed()` called. */
 function resolveEmbeds(embeds) {
     if (!Array.isArray(embeds)) {
         throw new TypeError(`The embeds of a message are a list, got ${typeof embeds}.`);
     }
     return embeds.map((embed, index) => {
-        if (isEmbedFile(embed))
+        if (isEmbedDeclaration(embed))
             return embed();
         if (typeof embed === 'function') {
-            throw new TypeError(`Embed ${index + 1} of the message is a function: an embed is an object like { title: '...' }, or a file of src/components/embeds/.`);
+            throw new TypeError(`Embed ${index + 1} of the message is a function: an embed is an object like { title: '...' }, or one declared with embed().`);
         }
         return embed;
     });

package/dist/tasks/declaration.d.ts

@@ -0,0 +1,16 @@
+import type { Declaration } from '../loader/loader.js';
+import { type Schedule } from './schedule.js';
+import { type TaskContext } from './task.js';
+/** A task, checked: what the scheduler works with. */
+export interface LoadedTask {
+    /** The name of the task: the name of the export that declares it. */
+    readonly name: string;
+    readonly schedule: Schedule;
+    readonly onStart: boolean;
+    readonly run: (context: TaskContext) => unknown;
+}
+/**
+ * A task, declared anywhere in `src/` with `task()` and exported: the name
+ * of the export is the name of the task.
+ */
+export declare const taskDeclaration: Declaration<LoadedTask>;

package/dist/tasks/{convention.js → declaration.js}

@@ -1,49 +1,27 @@
-// `src/tasks/`: one file per task, named after it. What the file declares
-// is checked when it loads, so a wrong duration or cron is explained
-// before the bot waits for it.
+// What a file declares with `task()`, checked when it loads, so a wrong
+// duration or cron is explained before the bot waits for it. The name of
+// the export is the name of the task.
 import { parseCron, parseEvery } from './schedule.js';
-import { isTaskFile } from './task.js';
+import { isTaskDeclaration, } from './task.js';
 const fail = (message) => {
     throw new TypeError(message);
 };
 const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
 const KEYS = ['every', 'cron', 'timezone', 'onStart', 'run'];
+const EXAMPLE = `task({ every: '10m', run() { ... } })`;
 /**
- * `src/tasks/`: each file is a task, named after its path. It exports by
- * default what `task()` returns:
- *
- * ```ts
- * // src/tasks/report.ts
- * import { task } from 'chapterjs';
- *
- * export default task({
- *   cron: '0 9 * * 1',
- *   async run({ guilds }) { ... },
- * });
- * ```
+ * A task, declared anywhere in `src/` with `task()` and exported: the name
+ * of the export is the name of the task.
  */
-export const tasksConvention = {
-    folder: 'tasks',
+export const taskDeclaration = {
     one: 'task',
     many: 'tasks',
-    check(path) {
-        for (const part of path.replace(/\.[^./]+$/, '').split('/')) {
-            if (!/^[A-Za-z0-9_-]+$/.test(part)) {
-                fail(`"${part}" can't be in the name of a task: use letters, digits, - and _ only. The path of the file is the name of the task.`);
-            }
-        }
-    },
-    read(exports, path) {
-        const file = exports.default;
-        const example = `import { task } from 'chapterjs'; export default task({ every: '10m', run() { ... } })`;
-        if (!isTaskFile(file)) {
-            return fail('default' in exports
-                ? `The default export of this file must be what task() returns: ${example}`
-                : `This file has no default export. It should look like: ${example}`);
-        }
-        const config = file.config;
+    is: isTaskDeclaration,
+    list: false,
+    read(value, { name }) {
+        const config = value.config;
         if (!isRecord(config)) {
-            return fail(`task() needs an object: task({ every: '10m', run() { ... } })`);
+            return fail(`task() needs an object: ${EXAMPLE}`);
         }
         for (const key of Object.keys(config)) {
             if (!KEYS.includes(key)) {
@@ -69,7 +47,7 @@ export const tasksConvention = {
             fail(`This task has no "run": the function to run each time, like async run({ guilds }) { ... }`);
         }
         return Object.freeze({
-            name: path.replace(/\.[^./]+$/, ''),
+            name,
             schedule,
             onStart: config.onStart === true,
             run: config.run,

package/dist/tasks/scheduler.d.ts

@@ -1,8 +1,10 @@
 import type { TaskContext } from './task.js';
-import type { LoadedTask } from './convention.js';
+import type { LoadedTask } from './declaration.js';
 /** A task, with the file it comes from (to report its errors). */
 export interface TaskEntry {
     file: string;
+    /** The export it is: its name is the name of the task. */
+    export: string;
     task: LoadedTask;
 }
 /** What runs the tasks. */

package/dist/tasks/scheduler.js

@@ -17,12 +17,12 @@ export class TimerScheduler {
         const started = [];
         for (const entry of entries) {
             const key = scheduleKey(entry.task.schedule);
-            const previous = this.#tasks.get(entry.file);
+            const previous = this.#tasks.get(entry.task.name);
             if (previous && previous.key === key) {
                 // Same timing: the next time stays, only the code changes.
                 previous.entry = entry;
-                kept.set(entry.file, previous);
-                this.#tasks.delete(entry.file);
+                kept.set(entry.task.name, previous);
+                this.#tasks.delete(entry.task.name);
                 continue;
             }
             const scheduled = {
@@ -32,7 +32,7 @@ export class TimerScheduler {
                 timer: null,
                 running: false,
             };
-            kept.set(entry.file, scheduled);
+            kept.set(entry.task.name, scheduled);
             started.push(scheduled);
         }
         // What is left was removed, or changed timing: it starts over.

package/dist/tasks/task.d.ts

@@ -47,22 +47,21 @@ export interface CronTaskConfig extends TaskConfigBase {
     timezone?: string;
     every?: never;
 }
-/** What a task file gives to `task()`: when it runs, and what it does. */
+/** What a file gives to `task()`: when it runs, and what it does. */
 export type TaskConfig = EveryTaskConfig | CronTaskConfig;
-/** What `task()` returns: the default export of a task file. */
-export interface TaskFile {
+/** What `task()` returns: a declaration the framework finds in the exports of a file. */
+export interface TaskDeclaration {
     /** What the file gave to `task()`, not checked yet. */
     readonly config: unknown;
 }
 /**
- * Declares a task: something the bot does by itself. Export the result as
- * the default export of a file of `src/tasks/`: the name of the file is
- * the name of the task.
+ * Declares a task: something the bot does by itself. Export the result
+ * from any file of `src/`: the name of the export is the name of the task.
  *
  * ```ts
  * import { task } from 'chapterjs';
  *
- * export default task({
+ * export const watch = task({
  *   every: '10m',
  *   async run({ guilds }) {
  *     console.log(`Watching ${guilds.size} servers`);
@@ -70,7 +69,7 @@ export interface TaskFile {
  * });
  * ```
  */
-export declare function task(config: TaskConfig): TaskFile;
+export declare function task(config: TaskConfig): TaskDeclaration;
 /** Whether a value was made by `task()`. */
-export declare function isTaskFile(value: unknown): value is TaskFile;
+export declare function isTaskDeclaration(value: unknown): value is TaskDeclaration;
 export {};

package/dist/tasks/task.js

@@ -1,15 +1,14 @@
-// `task()`, as the files of `src/tasks/` import it from 'chapterjs': what
-// the bot does by itself, at intervals or at given times.
+// `task()`, as user files import it from 'chapterjs': what the bot does by
+// itself, at intervals or at given times.
 const BRAND = Symbol.for('chapterjs.task');
 /**
- * Declares a task: something the bot does by itself. Export the result as
- * the default export of a file of `src/tasks/`: the name of the file is
- * the name of the task.
+ * Declares a task: something the bot does by itself. Export the result
+ * from any file of `src/`: the name of the export is the name of the task.
  *
  * ```ts
  * import { task } from 'chapterjs';
  *
- * export default task({
+ * export const watch = task({
  *   every: '10m',
  *   async run({ guilds }) {
  *     console.log(`Watching ${guilds.size} servers`);
@@ -21,7 +20,7 @@ export function task(config) {
     return Object.freeze({ [BRAND]: true, config });
 }
 /** Whether a value was made by `task()`. */
-export function isTaskFile(value) {
+export function isTaskDeclaration(value) {
     return (typeof value === 'object' &&
         value !== null &&
         value[BRAND] === true);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chapterjs",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "description": "The Discord framework",
   "type": "module",
   "license": "MIT",

package/dist/components/convention.d.ts

@@ -1,35 +0,0 @@
-import type { Convention } from '../loader/loader.js';
-import { type LoadedButton } from './button.js';
-import { isEmbedFile } from './embed.js';
-import { type LoadedModal } from './modal.js';
-import { type LoadedSelect } from './select.js';
-/** An embed file, checked (when it is static). */
-export interface LoadedEmbed {
-    readonly kind: 'embed';
-    readonly path: string;
-}
-/** A component file, checked: what the router works with. */
-export type LoadedComponent = LoadedButton | LoadedSelect | LoadedModal | LoadedEmbed;
-/**
- * `src/components/`: one folder per kind of component (`buttons/`,
- * `selects/`, `modals/`, `embeds/`), and in it one file per component,
- * whose path is its id. The file exports by default what `button()`,
- * `select()`, `modal()` or `embed()` returns.
- */
-export declare const componentsConvention: Convention<LoadedComponent>;
-/** The files that are the same component (through `(group)` folders): the later one is left out. */
-export declare function findDuplicates<T extends {
-    file: string;
-    component: {
-        path: string;
-    };
-}>(entries: readonly T[]): {
-    valid: T[];
-    conflicts: {
-        file: string;
-        message: string;
-    }[];
-};
-/** Whether a file holds an embed: nothing to route. */
-export declare const isEmbedLoaded: (component: LoadedComponent) => component is LoadedEmbed;
-export { isEmbedFile };

package/dist/components/file.d.ts

@@ -1,30 +0,0 @@
-import { type PieceKind, type Rendered } from './instance.js';
-/** The kinds of files of `src/components/`, which are its folders. */
-export type ComponentKind = 'button' | 'select' | 'modal' | 'embed';
-export declare const COMPONENT_FOLDERS: Record<string, ComponentKind>;
-/** A file as the loader knows it: what it declared, and once loaded, how to make instances. */
-export interface ComponentFileState {
-    readonly kind: ComponentKind;
-    readonly config: unknown;
-    /** The name of the file for messages, before it is bound: `button()`. */
-    readonly made: string;
-    bound?: {
-        /** The path of the file inside `src/components/`, without extension. */
-        path: string;
-        /** Makes an instance from what the file was called with. */
-        render: (args: readonly unknown[]) => Rendered | object;
-    };
-}
-/** The state of a component file, if the value is one. */
-export declare function fileStateOf(value: unknown): ComponentFileState | undefined;
-/**
- * Makes a component file. `asPiece` says whether the file itself stands
- * for its instance when it carries no data (a button, a menu, a modal: not
- * an embed, which is only a function).
- */
-export declare function createFile(kind: ComponentKind, config: unknown, { asPiece, pieceKind }: {
-    asPiece: boolean;
-    pieceKind?: PieceKind;
-}): (...args: unknown[]) => unknown;
-/** Binds a file to its path and to what makes its instances. */
-export declare function bindFile(file: unknown, bound: NonNullable<ComponentFileState['bound']>): void;