@lvl99dotcom/paintcanvas 0.6.0 → 0.8.0

package/dist/lib/presets/schema.js

@@ -1,18 +1,18 @@
-import { profilePointsSchema } from "../profiles/schema.js";
+import { profileIdSchema, profilePointsSchema } from "../profiles/schema.js";
+import { UUID_PATTERN, authorSchema, collectionSchema, fileSchemaUrlSchema } from "../assets/schema.js";
+import { SCHEMA_DIALECT, schemaUrl } from "../schemas/index.js";
 // src/lib/presets/schema.ts
-/** Matches a lowercase UUID */
-var UUID_PATTERN = "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$";
-/** The `format` of a brush preset file, unless the implementer names their own (see `PaintCanvasNames`) */
-var BRUSH_PRESET_FILE_FORMAT = "paintcanvas-brush-presets";
-/** Formats of brush preset files that are imported by default */
-var BRUSH_PRESET_FILE_FORMATS = [BRUSH_PRESET_FILE_FORMAT];
-/** Longest brush preset file format name (characters) */
-var MAX_PRESET_FILE_FORMAT_LENGTH = 100;
-/** The version of the brush preset file format */
-var BRUSH_PRESET_FILE_VERSION = 1;
+/** Version of the brush preset schema */
+var BRUSH_PRESET_SCHEMA_VERSION = "1.0.0";
+/** `@type` of a brush preset */
+var BRUSH_PRESET_TYPE = "PaintCanvas/BrushConfig";
+/** Version of the brush preset collection schema */
+var BRUSH_PRESET_COLLECTION_SCHEMA_VERSION = "1.0.0";
+/** `@type` of a brush preset collection file */
+var BRUSH_PRESET_COLLECTION_TYPE = "PaintCanvas/BrushConfigCollection";
 /** Most presets in one file */
 var MAX_PRESETS_PER_FILE = 1e3;
-/** Longest preset name, author name or handle (characters) */
+/** Longest preset name (characters) */
 var MAX_PRESET_TEXT_LENGTH = 100;
 /** Longest brush shape data URL (characters): a 2 MB PNG as base64 */
 var MAX_SHAPE_DATA_URL_LENGTH = Math.ceil(2097152 / 3) * 4 + 22;
@@ -39,11 +39,7 @@ var paramConfig = {
 		minTilt: factor,
 		maxTilt: factor,
 		profile: profilePointsSchema,
-		profileId: {
-			type: "string",
-			minLength: 1,
-			maxLength: 100
-		}
+		profileId: profileIdSchema
 	}
 };
 /** A colour value: a number, or a number as text */
@@ -59,11 +55,15 @@ var text = {
 };
 /** JSON schema for a brush preset a user made or imported (see `BrushConfig` in the app) */
 var brushPresetSchema = {
-	$id: "paintcanvas/brush-preset",
+	$schema: SCHEMA_DIALECT,
+	$id: schemaUrl("brush-preset", BRUSH_PRESET_SCHEMA_VERSION),
+	"@type": BRUSH_PRESET_TYPE,
 	type: "object",
 	additionalProperties: false,
 	required: ["id"],
 	properties: {
+		$schema: fileSchemaUrlSchema,
+		"@type": { const: BRUSH_PRESET_TYPE },
 		id: {
 			type: "string",
 			pattern: UUID_PATTERN
@@ -74,23 +74,7 @@ var brushPresetSchema = {
 			type: "string",
 			maxLength: 20
 		},
-		author: { anyOf: [text, {
-			type: "object",
-			additionalProperties: false,
-			required: ["name"],
-			properties: {
-				name: text,
-				handle: text,
-				email: {
-					type: "string",
-					maxLength: 254
-				},
-				website: {
-					type: "string",
-					maxLength: 2048
-				}
-			}
-		}] },
+		author: authorSchema,
 		image: {
 			type: "string",
 			pattern: PNG_DATA_URL_PATTERN,
@@ -161,28 +145,12 @@ var brushPresetSchema = {
 		snapToPixelGrid: { type: "boolean" }
 	}
 };
-/** JSON schema for a brush preset file */
-var brushPresetFileSchema = {
-	$id: "paintcanvas/brush-preset-file",
-	type: "object",
-	additionalProperties: false,
-	required: [
-		"format",
-		"version",
-		"presets"
-	],
-	properties: {
-		format: {
-			type: "string",
-			minLength: 1,
-			maxLength: 100
-		},
-		version: { const: 1 },
-		presets: {
-			type: "array",
-			maxItems: MAX_PRESETS_PER_FILE,
-			items: { $ref: "brush-preset" }
-		}
-	}
-};
-export { BRUSH_PRESET_FILE_FORMAT, BRUSH_PRESET_FILE_FORMATS, BRUSH_PRESET_FILE_VERSION, MAX_PRESETS_PER_FILE, MAX_PRESET_FILE_FORMAT_LENGTH, MAX_PRESET_TEXT_LENGTH, MAX_SHAPE_DATA_URL_LENGTH, PNG_DATA_URL_PATTERN, UUID_PATTERN, brushPresetFileSchema, brushPresetSchema };
+/** JSON schema for a brush preset collection file */
+var brushPresetCollectionSchema = collectionSchema({
+	name: "brush-preset-collection",
+	version: BRUSH_PRESET_COLLECTION_SCHEMA_VERSION,
+	type: BRUSH_PRESET_COLLECTION_TYPE,
+	item: brushPresetSchema.$id,
+	maxItems: MAX_PRESETS_PER_FILE
+});
+export { BRUSH_PRESET_COLLECTION_SCHEMA_VERSION, BRUSH_PRESET_COLLECTION_TYPE, BRUSH_PRESET_SCHEMA_VERSION, BRUSH_PRESET_TYPE, MAX_PRESETS_PER_FILE, MAX_PRESET_TEXT_LENGTH, MAX_SHAPE_DATA_URL_LENGTH, PNG_DATA_URL_PATTERN, UUID_PATTERN, brushPresetCollectionSchema, brushPresetSchema };

package/dist/lib/profiles/profileFile/index.d.ts

@@ -0,0 +1,10 @@
+import AssetFile from "../../assets";
+import type { ProfileGraph } from "..";
+/**
+ * Reads and writes profile graph collection files.
+ *
+ * @example
+ * const graphs = profileGraphFile.parse(await file.text()); // throws AssetFileError
+ * const json = profileGraphFile.write(app.profiles.graphs);
+ */
+export declare const profileGraphFile: AssetFile<ProfileGraph>;

package/dist/lib/profiles/profileFile/index.js

@@ -0,0 +1,19 @@
+import AssetFile from "../../assets/index.js";
+import { validateProfileGraphCollection } from "../../validation/validators.generated.js";
+import { PROFILE_GRAPH_COLLECTION_SCHEMA_VERSION, PROFILE_GRAPH_COLLECTION_TYPE } from "../schema.js";
+// src/lib/profiles/profileFile/index.ts
+/**
+* Reads and writes profile graph collection files.
+*
+* @example
+* const graphs = profileGraphFile.parse(await file.text()); // throws AssetFileError
+* const json = profileGraphFile.write(app.profiles.graphs);
+*/
+var profileGraphFile = new AssetFile({
+	schema: "profile-graph-collection",
+	version: PROFILE_GRAPH_COLLECTION_SCHEMA_VERSION,
+	type: PROFILE_GRAPH_COLLECTION_TYPE,
+	validate: validateProfileGraphCollection,
+	fileName: "profile-graphs"
+});
+export { profileGraphFile };

package/dist/lib/profiles/schema.d.ts

@@ -1,7 +1,24 @@
 /** Longest profile graph ID or name (characters) */
 export declare const MAX_PROFILE_TEXT_LENGTH = 100;
-/** Most profile graphs a user can keep */
+/** Most profile graphs a user can keep (and in one file) */
 export declare const MAX_SAVED_PROFILES = 100;
+/** Version of the profile graph schema */
+export declare const PROFILE_GRAPH_SCHEMA_VERSION = "1.0.0";
+/** `@type` of a profile graph */
+export declare const PROFILE_GRAPH_TYPE = "PaintCanvas/ProfileGraph";
+/** Version of the profile graph collection schema */
+export declare const PROFILE_GRAPH_COLLECTION_SCHEMA_VERSION = "1.0.0";
+/** `@type` of a profile graph collection file */
+export declare const PROFILE_GRAPH_COLLECTION_TYPE = "PaintCanvas/ProfileGraphCollection";
+/** Schema of a profile graph's ID: a UUID for the user's own, or a built-in graph's ID */
+export declare const profileIdSchema: {
+    readonly anyOf: readonly [{
+        readonly type: "string";
+        readonly pattern: "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$";
+    }, {
+        readonly enum: string[];
+    }];
+};
 /** Schema of a profile graph's points, from left to right */
 export declare const profilePointsSchema: {
     readonly type: "array";
@@ -30,20 +47,70 @@ export declare const profilePointsSchema: {
 };
 /** Schema of a named profile graph */
 export declare const profileGraphSchema: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $id: string;
+    readonly "@type": "PaintCanvas/ProfileGraph";
     readonly type: "object";
     readonly additionalProperties: false;
     readonly required: readonly ["id", "name", "points"];
     readonly properties: {
-        readonly id: {
+        readonly $schema: {
             readonly type: "string";
             readonly minLength: 1;
-            readonly maxLength: 100;
+            readonly maxLength: 2048;
+        };
+        readonly "@type": {
+            readonly const: "PaintCanvas/ProfileGraph";
+        };
+        readonly id: {
+            readonly anyOf: readonly [{
+                readonly type: "string";
+                readonly pattern: "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$";
+            }, {
+                readonly enum: string[];
+            }];
         };
         readonly name: {
             readonly type: "string";
             readonly minLength: 1;
             readonly maxLength: 100;
         };
+        readonly author: {
+            readonly anyOf: readonly [{
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 100;
+            }, {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["name"];
+                readonly properties: {
+                    readonly did: {
+                        readonly type: "string";
+                        readonly maxLength: 2048;
+                        readonly pattern: "^did:[a-z]+:[a-zA-Z0-9._:%-]+$";
+                    };
+                    readonly name: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 100;
+                    };
+                    readonly handle: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 100;
+                    };
+                    readonly email: {
+                        readonly type: "string";
+                        readonly maxLength: 254;
+                    };
+                    readonly homepage: {
+                        readonly type: "string";
+                        readonly maxLength: 2048;
+                    };
+                };
+            }];
+        };
         readonly points: {
             readonly type: "array";
             readonly minItems: 2;
@@ -71,3 +138,29 @@ export declare const profileGraphSchema: {
         };
     };
 };
+/** Schema of a profile graph collection file */
+export declare const profileGraphCollectionSchema: {
+    $schema: string;
+    $id: string;
+    "@type": string;
+    type: string;
+    additionalProperties: boolean;
+    required: string[];
+    properties: {
+        $schema: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 2048;
+        };
+        "@type": {
+            const: string;
+        };
+        items: {
+            type: string;
+            maxItems: number;
+            items: {
+                $ref: string;
+            };
+        };
+    };
+};

package/dist/lib/profiles/schema.js

@@ -1,4 +1,19 @@
-import { Interpolation } from "./index.js";
+import { Interpolation, PROFILE_PRESETS } from "./index.js";
+import { UUID_PATTERN, authorSchema, collectionSchema, fileSchemaUrlSchema } from "../assets/schema.js";
+import { SCHEMA_DIALECT, schemaUrl } from "../schemas/index.js";
+/** Version of the profile graph schema */
+var PROFILE_GRAPH_SCHEMA_VERSION = "1.0.0";
+/** `@type` of a profile graph */
+var PROFILE_GRAPH_TYPE = "PaintCanvas/ProfileGraph";
+/** Version of the profile graph collection schema */
+var PROFILE_GRAPH_COLLECTION_SCHEMA_VERSION = "1.0.0";
+/** `@type` of a profile graph collection file */
+var PROFILE_GRAPH_COLLECTION_TYPE = "PaintCanvas/ProfileGraphCollection";
+/** Schema of a profile graph's ID: a UUID for the user's own, or a built-in graph's ID */
+var profileIdSchema = { anyOf: [{
+	type: "string",
+	pattern: UUID_PATTERN
+}, { enum: PROFILE_PRESETS.map((preset) => preset.id) }] };
 /** Schema of a profile graph's points, from left to right */
 var profilePointsSchema = {
 	type: "array",
@@ -29,6 +44,9 @@ var profilePointsSchema = {
 };
 /** Schema of a named profile graph */
 var profileGraphSchema = {
+	$schema: SCHEMA_DIALECT,
+	$id: schemaUrl("profile-graph", PROFILE_GRAPH_SCHEMA_VERSION),
+	"@type": PROFILE_GRAPH_TYPE,
 	type: "object",
 	additionalProperties: false,
 	required: [
@@ -37,17 +55,23 @@ var profileGraphSchema = {
 		"points"
 	],
 	properties: {
-		id: {
-			type: "string",
-			minLength: 1,
-			maxLength: 100
-		},
+		$schema: fileSchemaUrlSchema,
+		"@type": { const: PROFILE_GRAPH_TYPE },
+		id: profileIdSchema,
 		name: {
 			type: "string",
 			minLength: 1,
 			maxLength: 100
 		},
+		author: authorSchema,
 		points: profilePointsSchema
 	}
 };
-export { profileGraphSchema, profilePointsSchema };
+collectionSchema({
+	name: "profile-graph-collection",
+	version: PROFILE_GRAPH_COLLECTION_SCHEMA_VERSION,
+	type: PROFILE_GRAPH_COLLECTION_TYPE,
+	item: profileGraphSchema.$id,
+	maxItems: 100
+});
+export { PROFILE_GRAPH_COLLECTION_SCHEMA_VERSION, PROFILE_GRAPH_COLLECTION_TYPE, PROFILE_GRAPH_SCHEMA_VERSION, PROFILE_GRAPH_TYPE, profileGraphSchema, profileIdSchema, profilePointsSchema };

package/dist/lib/schemas/index.d.ts

@@ -0,0 +1,42 @@
+/** Where PaintCanvas's JSON schemas are published */
+export declare const SCHEMA_BASE_URL = "https://lvl99.github.io/paintcanvas/schemas/";
+/** The JSON Schema dialect PaintCanvas's schemas are written in */
+export declare const SCHEMA_DIALECT = "https://json-schema.org/draft/2020-12/schema";
+/** A schema's name and version, read from its URL */
+export interface SchemaName {
+    /** e.g. `brush-preset` */
+    name: string;
+    /** e.g. `1.0.0` */
+    version: string;
+}
+/**
+ * The URL a schema is published at: its `$id`.
+ *
+ * @example
+ * schemaUrl("brush-preset", "1.0.0"); // "https://lvl99.github.io/paintcanvas/schemas/brush-preset-1.0.0.json"
+ */
+export declare const schemaUrl: (name: string, version: string) => string;
+/**
+ * The name and version of a schema from its URL, or undefined if it isn't one of PaintCanvas's published schemas.
+ *
+ * @example
+ * parseSchemaUrl("https://lvl99.github.io/paintcanvas/schemas/brush-preset-1.0.0.json"); // { name: "brush-preset", version: "1.0.0" }
+ * parseSchemaUrl("https://example.com/other.json"); // undefined
+ */
+export declare const parseSchemaUrl: (url: unknown) => SchemaName | undefined;
+/**
+ * Compare two `major.minor.patch` versions: negative when `a` is older, positive when newer, 0 when the same. Versions
+ * that can't be read sort first.
+ *
+ * @example
+ * compareVersions("1.2.0", "1.10.0"); // negative
+ */
+export declare const compareVersions: (a: string, b: string) => number;
+/**
+ * The major part of a `major.minor.patch` version. Files whose schema has the same major version as the app's are
+ * read without migrating (later minor versions only add optional properties).
+ *
+ * @example
+ * majorVersion("1.2.3"); // 1
+ */
+export declare const majorVersion: (version: string) => number;

package/dist/lib/schemas/index.js

@@ -0,0 +1,60 @@
+// src/lib/schemas/index.ts
+/** Where PaintCanvas's JSON schemas are published */
+var SCHEMA_BASE_URL = "https://lvl99.github.io/paintcanvas/schemas/";
+/** The JSON Schema dialect PaintCanvas's schemas are written in */
+var SCHEMA_DIALECT = "https://json-schema.org/draft/2020-12/schema";
+/** Matches a semver version without pre-release or build parts, e.g. `1.0.0` */
+var VERSION_PATTERN = /^(\d+)\.(\d+)\.(\d+)$/;
+/** Matches a published schema URL, capturing its name and version */
+var SCHEMA_URL_PATTERN = /^(.+)-(\d+\.\d+\.\d+)\.json$/;
+/**
+* The URL a schema is published at: its `$id`.
+*
+* @example
+* schemaUrl("brush-preset", "1.0.0"); // "https://lvl99.github.io/paintcanvas/schemas/brush-preset-1.0.0.json"
+*/
+var schemaUrl = (name, version) => `${SCHEMA_BASE_URL}${name}-${version}.json`;
+/**
+* The name and version of a schema from its URL, or undefined if it isn't one of PaintCanvas's published schemas.
+*
+* @example
+* parseSchemaUrl("https://lvl99.github.io/paintcanvas/schemas/brush-preset-1.0.0.json"); // { name: "brush-preset", version: "1.0.0" }
+* parseSchemaUrl("https://example.com/other.json"); // undefined
+*/
+var parseSchemaUrl = (url) => {
+	if (typeof url !== "string" || !url.startsWith("https://lvl99.github.io/paintcanvas/schemas/")) return void 0;
+	const match = SCHEMA_URL_PATTERN.exec(url.slice(44));
+	return match ? {
+		name: match[1],
+		version: match[2]
+	} : void 0;
+};
+/**
+* Compare two `major.minor.patch` versions: negative when `a` is older, positive when newer, 0 when the same. Versions
+* that can't be read sort first.
+*
+* @example
+* compareVersions("1.2.0", "1.10.0"); // negative
+*/
+var compareVersions = (a, b) => {
+	const parts = (version) => (VERSION_PATTERN.exec(version)?.slice(1) ?? [
+		"-1",
+		"0",
+		"0"
+	]).map(Number);
+	const [x, y] = [parts(a), parts(b)];
+	for (let i = 0; i < 3; i++) {
+		const difference = x[i] - y[i];
+		if (difference !== 0) return difference;
+	}
+	return 0;
+};
+/**
+* The major part of a `major.minor.patch` version. Files whose schema has the same major version as the app's are
+* read without migrating (later minor versions only add optional properties).
+*
+* @example
+* majorVersion("1.2.3"); // 1
+*/
+var majorVersion = (version) => Number(VERSION_PATTERN.exec(version)?.[1] ?? NaN);
+export { SCHEMA_BASE_URL, SCHEMA_DIALECT, compareVersions, majorVersion, parseSchemaUrl, schemaUrl };

package/dist/lib/settings/index.d.ts

@@ -1,14 +1,6 @@
 import type PaintCanvas from "../classes/PaintCanvas";
 import { type AppSettings } from "./schema";
 export * from "./schema";
-/** Messages shown when importing settings fails */
-export declare const SETTINGS_FILE_ERRORS: {
-    readonly incompatible: "Settings JSON file not compatible";
-    readonly read: "Failed to read settings JSON file";
-};
-/** Importing settings failed, with a message for the user */
-export declare class SettingsFileError extends Error {
-}
 /** Result of checking settings */
 export type SettingsValidationResult = {
     valid: true;
@@ -24,22 +16,44 @@ export type SettingsValidationResult = {
  * isValidSettings({ palette: ["#ff0000"] }).valid; // true
  */
 export declare const isValidSettings: (input: unknown) => SettingsValidationResult;
+/** Assets that app settings can hold */
+export type SettingsAsset = "brushes" | "palettes" | "profiles";
+/** What `collectSettings` leaves out */
+export interface CollectSettingsOptions {
+    /** Assets to leave out, e.g. ones kept in stores of their own */
+    without?: readonly SettingsAsset[];
+}
+/**
+ * The app settings of a canvas: its input settings, keyboard shortcuts, colours, the user's colour palettes, profile
+ * graphs and brush presets, theme and language, and settings wrapper apps added (see `SettingsExtension`).
+ *
+ * @example
+ * collectSettings(canvas).palettes; // the user's own palettes
+ * collectSettings(canvas, { without: ["profiles"] }).profiles; // undefined
+ */
+export declare const collectSettings: (app: PaintCanvas, { without }?: CollectSettingsOptions) => AppSettings;
+/** Name of the palette that colours saved in PaintCanvas's palette by older versions are moved to */
+export declare const OLDER_PALETTE_NAME = "My colours";
 /**
- * The app settings of a canvas: its input settings, keyboard shortcuts, colour palette, colours, profile graphs, theme
- * and language.
+ * Keep colours that older versions saved in PaintCanvas's palette (which can no longer be changed) in a palette of the
+ * user's own, named `OLDER_PALETTE_NAME`: unless they're PaintCanvas's colours, or one of the user's palettes already has
+ * them.
  *
  * @example
- * collectSettings(canvas).palette; // ["#2c6bff", ...]
+ * keepOlderPalette(canvas, ["#123456"]); // the user now has a "My colours" palette with #123456
  */
-export declare const collectSettings: (app: PaintCanvas) => AppSettings;
+export declare const keepOlderPalette: (app: PaintCanvas, colours: readonly string[]) => void;
 /**
  * Use app settings on a canvas, e.g. ones kept in the browser or imported. Parts left out stay as they are; invalid
- * values within a part are left out (see each part's sanitising).
+ * values within a part are left out (see each part's sanitising). Colour palettes, profile graphs and brush presets are
+ * added to the user's own, replacing those with the same IDs. Colours older versions saved in PaintCanvas's palette are
+ * moved to one of the user's own (see `keepOlderPalette`). Other parts go to the settings extensions (see
+ * `SettingsExtensions.apply`).
  *
  * @example
- * applySettings(canvas, { colours: { foreground: "#ff0000", background: "#ffffff" } });
+ * await applySettings(canvas, { colours: { foreground: "#ff0000", background: "#ffffff" } });
  */
-export declare const applySettings: (app: PaintCanvas, settings: AppSettings) => void;
+export declare const applySettings: (app: PaintCanvas, settings: AppSettings) => Promise<void>;
 /**
  * The file name settings are exported to on a day, starting with a prefix (see `PaintCanvasNames.filePrefix`).
  *
@@ -48,17 +62,18 @@ export declare const applySettings: (app: PaintCanvas, settings: AppSettings) =>
  */
 export declare const settingsFileName: (date?: Date, prefix?: string) => string;
 /**
- * Write app settings to a settings file (JSON) of a format (see `PaintCanvasNames.settingsFileFormat`).
+ * Write app settings to an app settings file (JSON). Colours older versions saved in PaintCanvas's palette are left out.
  *
  * @example
- * exportSettingsFile(collectSettings(canvas)); // '{ "format": "paintcanvas-settings", "version": 1, "settings": {...} }'
+ * exportSettingsFile(collectSettings(canvas)); // '{ "$schema": ".../app-settings-1.0.0.json", "@type": "PaintCanvas/AppSettings", ... }'
  */
-export declare const exportSettingsFile: (settings: AppSettings, format?: string) => string;
+export declare const exportSettingsFile: (settings: AppSettings) => string;
 /**
- * Read the app settings in a settings file of one of the given formats (PaintCanvas's by default). Throws a
- * `SettingsFileError` if it isn't valid JSON or a compatible file.
+ * Read the app settings in an app settings file. Settings files from before versioned schemas (`format`, `version: 1`
+ * and `settings`, of any format name) are read too. Throws an `AssetFileError`: `read` if it isn't JSON, `invalid` if it
+ * isn't a settings file or doesn't match its schema, `unsupported` if it's a version the app can't read.
  *
  * @example
- * applySettings(canvas, parseSettingsFile(text));
+ * await applySettings(canvas, parseSettingsFile(text));
  */
-export declare const parseSettingsFile: (text: string, formats?: readonly string[]) => AppSettings;
+export declare const parseSettingsFile: (text: string) => AppSettings;