tiny-essentials 1.28.19 → 1.29.0

package/dist/v1/regexp/Username/templates/MatrixProtocol.cjs

@@ -0,0 +1,143 @@
+'use strict';
+
+/**
+ * @typedef {import('../jsDoc.mjs').UsernameRegexTemplate} UsernameRegexTemplate
+ */
+
+const domainCharPattern = '[a-zA-Z0-9.-]';
+// Support both literal ':' and encoded '%3A'
+const suffixNormal = '\\:';
+const suffixUri = '(?:\\:|%3A)';
+
+const domainSuffixPattern = `${domainCharPattern}+\\.[a-zA-Z]{2,}`;
+const urlPathAndQueryPattern = '(?:/[\\w=/$+.:%-]+)?(?:\\?[\\w=&%.$+:;-]+)?';
+const matrixToPermalinkBase = '(?:https?://)?(?:www\\.)?matrix\\.to/#/';
+
+const matrixScheme = 'matrix\\:';
+const matrixUriTypePattern = '(?:u/|r/|roomid/|e/)?';
+// Support literal prefixes and their URL-encoded equivalents:
+// @ -> %40, # -> %23, ! -> %21, $ -> %24, + -> %2B
+const matrixIdPrefixPattern = '(?:@|%40|#|%23|!|%21|\\$|%24|\\+|%2B)?';
+
+/**
+ * Matrix Protocol (matrix.org)
+ * Official Documentation: https://spec.matrix.org/latest/appendices/#identifier-grammar
+ */
+const MatrixProtocolRegex = Object.freeze({
+  /**
+   * User ID
+   * Format: @localpart:domain
+   * @type {UsernameRegexTemplate}
+   */
+  userName: {
+    prefix: '@',
+    validValues: '[a-z0-9._=-]',
+    length: [1, 255],
+    domainPattern: `${suffixNormal}${domainSuffixPattern}`,
+  },
+
+  /**
+   * Room Alias (Human-readable alias)
+   * Format: #alias:domain
+   * @type {UsernameRegexTemplate}
+   */
+  roomName: {
+    prefix: '#',
+    validValues: '[a-zA-Z0-9._=-]', // Some servers accept uppercase in aliases
+    length: [1, 255],
+    domainPattern: `${suffixNormal}${domainSuffixPattern}`,
+  },
+
+  /**
+   * Room ID (Internal and immutable ID)
+   * Format: !opaque_id:domain
+   * @type {UsernameRegexTemplate}
+   */
+  roomId: {
+    prefix: '!',
+    validValues: '[a-zA-Z0-9_-]',
+    length: [1, 255],
+    domainPattern: `${suffixNormal}${domainSuffixPattern}`,
+  },
+
+  /**
+   * Event ID (Event/message identifier)
+   * Format v1/v2: $opaque_id:domain
+   * Format v3+: $Base64String (without the domain at the end)
+   * @type {UsernameRegexTemplate}
+   */
+  eventId: {
+    prefix: '$',
+    validValues: '[a-zA-Z0-9_+/=-]', // Supports Base64 and URL-Safe Base64 characters
+    length: [1, 255],
+    // We use (?:...)? here to make the domain group optional,
+    // as Matrix updated the Event ID format in recent versions
+    // to no longer require the ":domain" part at the end of the string.
+    domainPattern: `(?:${suffixNormal}${domainSuffixPattern})?`,
+  },
+
+  /**
+   * Group/Space ID (Legacy/Communities)
+   * Format: +group_id:domain
+   * @type {UsernameRegexTemplate}
+   */
+  groupId: {
+    prefix: '+',
+    validValues: '[a-z0-9._=-]',
+    length: [1, 255],
+    domainPattern: `${suffixNormal}${domainSuffixPattern}`,
+  },
+
+  /**
+   * Matrix.to Permalink
+   * Format: https://matrix.to/#/@user:domain or matrix.to/#/!room:domain
+   * Supports optional event IDs and query parameters (like ?via=server.org)
+   * @type {UsernameRegexTemplate}
+   */
+  matrixToLink: {
+    start: `${matrixToPermalinkBase}${matrixIdPrefixPattern}`,
+    validValues: '[a-zA-Z0-9._=/%+-]',
+    length: [1, 255],
+    domainPattern: `${suffixUri}${domainSuffixPattern}${urlPathAndQueryPattern}`,
+  },
+
+  /**
+   * Matrix URI Scheme (RFC 8922)
+   * Format: matrix:u/user:domain or matrix:roomid/room:domain
+   * @type {UsernameRegexTemplate}
+   */
+  matrixUri: {
+    start: `${matrixScheme}${matrixUriTypePattern}${matrixIdPrefixPattern}`,
+    validValues: '[a-zA-Z0-9._=/%+-]',
+    length: [1, 255],
+    domainPattern: `${suffixUri}${domainSuffixPattern}${urlPathAndQueryPattern}`,
+  },
+
+  /**
+   * HTML Mention
+   * Format: <a href="https://matrix.to/#/@user:domain">User Name</a>
+   * Matches standard formatted mentions sent by Matrix clients inside HTML bodies.
+   * @type {UsernameRegexTemplate}
+   */
+  htmlMention: {
+    start: `<a\\s+[^>]*?href=["\\'](?:${matrixToPermalinkBase}|${matrixScheme})${matrixUriTypePattern}${matrixIdPrefixPattern}`,
+    validValues: '[a-zA-Z0-9._=/%+-]',
+    length: [1, 255],
+    domainPattern: `${suffixUri}${domainSuffixPattern}${urlPathAndQueryPattern}["\\'][^>]*>[\\s\\S]*?</a\\s*>`,
+  },
+
+  /**
+   * Matrix Content URI (Media)
+   * Format: mxc://server-name/media-id
+   * Used for avatars, images, and file attachments in the Matrix network.
+   * @type {UsernameRegexTemplate}
+   */
+  mxcUri: {
+    start: 'mxc://',
+    validValues: '[a-zA-Z0-9.:-]',
+    length: [1, 255],
+    domainPattern: '/[a-zA-Z0-9_=-]+',
+  },
+});
+
+module.exports = MatrixProtocolRegex;

package/dist/v1/regexp/Username/templates/MatrixProtocol.d.mts

@@ -0,0 +1,70 @@
+/**
+ * @typedef {import('../jsDoc.mjs').UsernameRegexTemplate} UsernameRegexTemplate
+ */
+export type UsernameRegexTemplate = import('../jsDoc.mjs').UsernameRegexTemplate;
+/**
+ * Matrix Protocol (matrix.org)
+ * Official Documentation: https://spec.matrix.org/latest/appendices/#identifier-grammar
+ */
+declare const MatrixProtocolRegex: Readonly<{
+    /**
+     * User ID
+     * Format: @localpart:domain
+     * @type {UsernameRegexTemplate}
+     */
+    userName: UsernameRegexTemplate;
+    /**
+     * Room Alias (Human-readable alias)
+     * Format: #alias:domain
+     * @type {UsernameRegexTemplate}
+     */
+    roomName: UsernameRegexTemplate;
+    /**
+     * Room ID (Internal and immutable ID)
+     * Format: !opaque_id:domain
+     * @type {UsernameRegexTemplate}
+     */
+    roomId: UsernameRegexTemplate;
+    /**
+     * Event ID (Event/message identifier)
+     * Format v1/v2: $opaque_id:domain
+     * Format v3+: $Base64String (without the domain at the end)
+     * @type {UsernameRegexTemplate}
+     */
+    eventId: UsernameRegexTemplate;
+    /**
+     * Group/Space ID (Legacy/Communities)
+     * Format: +group_id:domain
+     * @type {UsernameRegexTemplate}
+     */
+    groupId: UsernameRegexTemplate;
+    /**
+     * Matrix.to Permalink
+     * Format: https://matrix.to/#/@user:domain or matrix.to/#/!room:domain
+     * Supports optional event IDs and query parameters (like ?via=server.org)
+     * @type {UsernameRegexTemplate}
+     */
+    matrixToLink: UsernameRegexTemplate;
+    /**
+     * Matrix URI Scheme (RFC 8922)
+     * Format: matrix:u/user:domain or matrix:roomid/room:domain
+     * @type {UsernameRegexTemplate}
+     */
+    matrixUri: UsernameRegexTemplate;
+    /**
+     * HTML Mention
+     * Format: <a href="https://matrix.to/#/@user:domain">User Name</a>
+     * Matches standard formatted mentions sent by Matrix clients inside HTML bodies.
+     * @type {UsernameRegexTemplate}
+     */
+    htmlMention: UsernameRegexTemplate;
+    /**
+     * Matrix Content URI (Media)
+     * Format: mxc://server-name/media-id
+     * Used for avatars, images, and file attachments in the Matrix network.
+     * @type {UsernameRegexTemplate}
+     */
+    mxcUri: UsernameRegexTemplate;
+}>;
+export default MatrixProtocolRegex;
+//# sourceMappingURL=MatrixProtocol.d.mts.map

package/dist/v1/regexp/Username/templates/MatrixProtocol.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MatrixProtocol.d.mts","sourceRoot":"","sources":["../../../../../src/v1/regexp/Username/templates/MatrixProtocol.mjs"],"names":[],"mappings":"AAAA;;GAEG;AADA,YAAwD,qBAAqB,GAAnE,OAAO,cAAc,EAAE,qBAAqB,CAAuB;AAkBhF;;;GAGG;AACH,QAAA,MAAM,mBAAmB;IACvB;;;;OAIG;cADO,qBAAqB;IAS/B;;;;OAIG;cADO,qBAAqB;IAS/B;;;;OAIG;YADO,qBAAqB;IAS/B;;;;;OAKG;aADO,qBAAqB;IAY/B;;;;OAIG;aADO,qBAAqB;IAS/B;;;;;OAKG;kBADO,qBAAqB;IAS/B;;;;OAIG;eADO,qBAAqB;IAS/B;;;;;OAKG;iBADO,qBAAqB;IAS/B;;;;;OAKG;YADO,qBAAqB;EAQ/B,CAAC;eAEY,mBAAmB"}

package/dist/v1/regexp/Username/templates/MatrixProtocol.mjs

@@ -0,0 +1,128 @@
+/**
+ * @typedef {import('../jsDoc.mjs').UsernameRegexTemplate} UsernameRegexTemplate
+ */
+const domainCharPattern = '[a-zA-Z0-9.-]';
+// Support both literal ':' and encoded '%3A'
+const suffixNormal = '\\:';
+const suffixUri = '(?:\\:|%3A)';
+const domainSuffixPattern = `${domainCharPattern}+\\.[a-zA-Z]{2,}`;
+const urlPathAndQueryPattern = '(?:/[\\w=/$+.:%-]+)?(?:\\?[\\w=&%.$+:;-]+)?';
+const matrixToPermalinkBase = '(?:https?://)?(?:www\\.)?matrix\\.to/#/';
+const matrixScheme = 'matrix\\:';
+const matrixUriTypePattern = '(?:u/|r/|roomid/|e/)?';
+// Support literal prefixes and their URL-encoded equivalents:
+// @ -> %40, # -> %23, ! -> %21, $ -> %24, + -> %2B
+const matrixIdPrefixPattern = '(?:@|%40|#|%23|!|%21|\\$|%24|\\+|%2B)?';
+/**
+ * Matrix Protocol (matrix.org)
+ * Official Documentation: https://spec.matrix.org/latest/appendices/#identifier-grammar
+ */
+const MatrixProtocolRegex = Object.freeze({
+    /**
+     * User ID
+     * Format: @localpart:domain
+     * @type {UsernameRegexTemplate}
+     */
+    userName: {
+        prefix: '@',
+        validValues: '[a-z0-9._=-]',
+        length: [1, 255],
+        domainPattern: `${suffixNormal}${domainSuffixPattern}`,
+    },
+    /**
+     * Room Alias (Human-readable alias)
+     * Format: #alias:domain
+     * @type {UsernameRegexTemplate}
+     */
+    roomName: {
+        prefix: '#',
+        validValues: '[a-zA-Z0-9._=-]', // Some servers accept uppercase in aliases
+        length: [1, 255],
+        domainPattern: `${suffixNormal}${domainSuffixPattern}`,
+    },
+    /**
+     * Room ID (Internal and immutable ID)
+     * Format: !opaque_id:domain
+     * @type {UsernameRegexTemplate}
+     */
+    roomId: {
+        prefix: '!',
+        validValues: '[a-zA-Z0-9_-]',
+        length: [1, 255],
+        domainPattern: `${suffixNormal}${domainSuffixPattern}`,
+    },
+    /**
+     * Event ID (Event/message identifier)
+     * Format v1/v2: $opaque_id:domain
+     * Format v3+: $Base64String (without the domain at the end)
+     * @type {UsernameRegexTemplate}
+     */
+    eventId: {
+        prefix: '$',
+        validValues: '[a-zA-Z0-9_+/=-]', // Supports Base64 and URL-Safe Base64 characters
+        length: [1, 255],
+        // We use (?:...)? here to make the domain group optional,
+        // as Matrix updated the Event ID format in recent versions
+        // to no longer require the ":domain" part at the end of the string.
+        domainPattern: `(?:${suffixNormal}${domainSuffixPattern})?`,
+    },
+    /**
+     * Group/Space ID (Legacy/Communities)
+     * Format: +group_id:domain
+     * @type {UsernameRegexTemplate}
+     */
+    groupId: {
+        prefix: '+',
+        validValues: '[a-z0-9._=-]',
+        length: [1, 255],
+        domainPattern: `${suffixNormal}${domainSuffixPattern}`,
+    },
+    /**
+     * Matrix.to Permalink
+     * Format: https://matrix.to/#/@user:domain or matrix.to/#/!room:domain
+     * Supports optional event IDs and query parameters (like ?via=server.org)
+     * @type {UsernameRegexTemplate}
+     */
+    matrixToLink: {
+        start: `${matrixToPermalinkBase}${matrixIdPrefixPattern}`,
+        validValues: '[a-zA-Z0-9._=/%+-]',
+        length: [1, 255],
+        domainPattern: `${suffixUri}${domainSuffixPattern}${urlPathAndQueryPattern}`,
+    },
+    /**
+     * Matrix URI Scheme (RFC 8922)
+     * Format: matrix:u/user:domain or matrix:roomid/room:domain
+     * @type {UsernameRegexTemplate}
+     */
+    matrixUri: {
+        start: `${matrixScheme}${matrixUriTypePattern}${matrixIdPrefixPattern}`,
+        validValues: '[a-zA-Z0-9._=/%+-]',
+        length: [1, 255],
+        domainPattern: `${suffixUri}${domainSuffixPattern}${urlPathAndQueryPattern}`,
+    },
+    /**
+     * HTML Mention
+     * Format: <a href="https://matrix.to/#/@user:domain">User Name</a>
+     * Matches standard formatted mentions sent by Matrix clients inside HTML bodies.
+     * @type {UsernameRegexTemplate}
+     */
+    htmlMention: {
+        start: `<a\\s+[^>]*?href=["\\'](?:${matrixToPermalinkBase}|${matrixScheme})${matrixUriTypePattern}${matrixIdPrefixPattern}`,
+        validValues: '[a-zA-Z0-9._=/%+-]',
+        length: [1, 255],
+        domainPattern: `${suffixUri}${domainSuffixPattern}${urlPathAndQueryPattern}["\\'][^>]*>[\\s\\S]*?</a\\s*>`,
+    },
+    /**
+     * Matrix Content URI (Media)
+     * Format: mxc://server-name/media-id
+     * Used for avatars, images, and file attachments in the Matrix network.
+     * @type {UsernameRegexTemplate}
+     */
+    mxcUri: {
+        start: 'mxc://',
+        validValues: '[a-zA-Z0-9.:-]',
+        length: [1, 255],
+        domainPattern: '/[a-zA-Z0-9_=-]+',
+    },
+});
+export default MatrixProtocolRegex;

package/dist/v1/regexp/Username/templates/deprecated/Discord.cjs

@@ -0,0 +1,24 @@
+'use strict';
+
+/**
+ * @typedef {import('../../jsDoc.mjs').UsernameRegexTemplate} UsernameRegexTemplate
+ */
+
+/**
+ * Discord Protocol
+ */
+const DiscordRegex = Object.freeze({
+  /**
+   * Modern Discord Usernames (Handles)
+   * Format: username
+   * @type {UsernameRegexTemplate}
+   */
+  userName: {
+    start: '(?<!<)',
+    prefix: '@',
+    validValues: '[a-z0-9_.]',
+    length: [2, 32],
+  },
+});
+
+module.exports = DiscordRegex;

package/dist/v1/regexp/Username/templates/deprecated/Discord.d.mts

@@ -0,0 +1,17 @@
+/**
+ * @typedef {import('../../jsDoc.mjs').UsernameRegexTemplate} UsernameRegexTemplate
+ */
+export type UsernameRegexTemplate = import('../../jsDoc.mjs').UsernameRegexTemplate;
+/**
+ * Discord Protocol
+ */
+declare const DiscordRegex: Readonly<{
+    /**
+     * Modern Discord Usernames (Handles)
+     * Format: username
+     * @type {UsernameRegexTemplate}
+     */
+    userName: UsernameRegexTemplate;
+}>;
+export default DiscordRegex;
+//# sourceMappingURL=Discord.d.mts.map

package/dist/v1/regexp/Username/templates/deprecated/Discord.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Discord.d.mts","sourceRoot":"","sources":["../../../../../../src/v1/regexp/Username/templates/deprecated/Discord.mjs"],"names":[],"mappings":"AAAA;;GAEG;AADA,YAA2D,qBAAqB,GAAtE,OAAO,iBAAiB,EAAE,qBAAqB,CAAuB;AAGnF;;GAEG;AACH,QAAA,MAAM,YAAY;IAChB;;;;OAIG;cADO,qBAAqB;EAQ/B,CAAC;eAEY,YAAY"}

package/dist/v1/regexp/Username/templates/deprecated/Discord.mjs

@@ -0,0 +1,20 @@
+/**
+ * @typedef {import('../../jsDoc.mjs').UsernameRegexTemplate} UsernameRegexTemplate
+ */
+/**
+ * Discord Protocol
+ */
+const DiscordRegex = Object.freeze({
+    /**
+     * Modern Discord Usernames (Handles)
+     * Format: username
+     * @type {UsernameRegexTemplate}
+     */
+    userName: {
+        start: '(?<!<)',
+        prefix: '@',
+        validValues: '[a-z0-9_.]',
+        length: [2, 32],
+    },
+});
+export default DiscordRegex;

package/dist/v1/regexp/Username/templates/index.cjs

@@ -0,0 +1,11 @@
+'use strict';
+
+var BlueSky = require('./BlueSky.cjs');
+var Discord = require('./Discord.cjs');
+var MatrixProtocol = require('./MatrixProtocol.cjs');
+
+
+
+exports.BlueSkyRegex = BlueSky;
+exports.DiscordRegex = Discord;
+exports.MatrixProtocolRegex = MatrixProtocol;

package/dist/v1/regexp/Username/templates/index.d.mts

@@ -0,0 +1,5 @@
+import BlueSkyRegex from './BlueSky.mjs';
+import DiscordRegex from './Discord.mjs';
+import MatrixProtocolRegex from './MatrixProtocol.mjs';
+export { BlueSkyRegex, DiscordRegex, MatrixProtocolRegex };
+//# sourceMappingURL=index.d.mts.map

package/dist/v1/regexp/Username/templates/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../../../src/v1/regexp/Username/templates/index.mjs"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,eAAe,CAAC;AACzC,OAAO,YAAY,MAAM,eAAe,CAAC;AACzC,OAAO,mBAAmB,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/v1/regexp/Username/templates/index.mjs

@@ -0,0 +1,4 @@
+import BlueSkyRegex from './BlueSky.mjs';
+import DiscordRegex from './Discord.mjs';
+import MatrixProtocolRegex from './MatrixProtocol.mjs';
+export { BlueSkyRegex, DiscordRegex, MatrixProtocolRegex };

package/dist/v1/regexp/index.cjs

@@ -0,0 +1,41 @@
+'use strict';
+
+var Ipv4 = require('./Ipv4.cjs');
+var Ipv6 = require('./Ipv6.cjs');
+var index = require('./Username/index.cjs');
+var SegmentExtractor = require('./SegmentExtractor.cjs');
+var UrlDetector = require('./UrlDetector.cjs');
+var Email = require('./Email.cjs');
+var Glob = require('./Glob.cjs');
+
+
+
+exports.extractIPsV4 = Ipv4.extractIPsV4;
+exports.findIPv4Regex = Ipv4.findIPv4Regex;
+exports.ipv4Regex = Ipv4.ipv4Regex;
+exports.isValidIPv4 = Ipv4.isValidIPv4;
+exports.extractIPsV6 = Ipv6.extractIPsV6;
+exports.findIPv6Regex = Ipv6.findIPv6Regex;
+exports.ipv6Regex = Ipv6.ipv6Regex;
+exports.isValidIPv6 = Ipv6.isValidIPv6;
+exports.extractUsernames = index.extractUsernames;
+exports.findUsernameRegex = index.findUsernameRegex;
+exports.isValidUsername = index.isValidUsername;
+exports.usernameRegex = index.usernameRegex;
+exports.usernameStringRegexBuilder = index.usernameStringRegexBuilder;
+exports.makeSegmentExtractor = SegmentExtractor.makeSegmentExtractor;
+exports.segmentExtractorV1 = SegmentExtractor.segmentExtractorV1;
+exports.extractUrls = UrlDetector.extractUrls;
+exports.findUrlRegex = UrlDetector.findUrlRegex;
+exports.isValidUrl = UrlDetector.isValidUrl;
+exports.urlRegex = UrlDetector.urlRegex;
+exports.urlStringRegexBuilder = UrlDetector.urlStringRegexBuilder;
+exports.emailRegex = Email.emailRegex;
+exports.emailStringRegexBuilder = Email.emailStringRegexBuilder;
+exports.extractEmails = Email.extractEmails;
+exports.findEmailRegex = Email.findEmailRegex;
+exports.isValidEmail = Email.isValidEmail;
+exports.compileGlob = Glob.compileGlob;
+exports.compileGlobRegExp = Glob.compileGlobRegExp;
+exports.decompileGlob = Glob.decompileGlob;
+exports.isValidGlob = Glob.isValidGlob;

package/dist/v1/regexp/index.d.mts

@@ -0,0 +1,9 @@
+import { ipv4Regex, isValidIPv4, findIPv4Regex, extractIPsV4 } from './Ipv4.mjs';
+import { extractIPsV6, findIPv6Regex, ipv6Regex, isValidIPv6 } from './Ipv6.mjs';
+import { usernameStringRegexBuilder, usernameRegex, isValidUsername, findUsernameRegex, extractUsernames } from './Username/index.mjs';
+import { makeSegmentExtractor, segmentExtractorV1 } from './SegmentExtractor.mjs';
+import { extractUrls, findUrlRegex, isValidUrl, urlRegex, urlStringRegexBuilder } from './UrlDetector.mjs';
+import { emailStringRegexBuilder, emailRegex, isValidEmail, findEmailRegex, extractEmails } from './Email.mjs';
+import { compileGlob, compileGlobRegExp, decompileGlob, isValidGlob } from './Glob.mjs';
+export { isValidGlob, compileGlob, compileGlobRegExp, decompileGlob, emailStringRegexBuilder, emailRegex, isValidEmail, findEmailRegex, extractEmails, usernameStringRegexBuilder, usernameRegex, isValidUsername, findUsernameRegex, extractUsernames, urlStringRegexBuilder, urlRegex, isValidUrl, findUrlRegex, extractUrls, makeSegmentExtractor, segmentExtractorV1, ipv4Regex, isValidIPv4, findIPv4Regex, extractIPsV4, ipv6Regex, isValidIPv6, findIPv6Regex, extractIPsV6, };
+//# sourceMappingURL=index.d.mts.map

package/dist/v1/regexp/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/v1/regexp/index.mjs"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,EACL,0BAA0B,EAC1B,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAClF,OAAO,EACL,WAAW,EACX,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,qBAAqB,EACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,uBAAuB,EACvB,UAAU,EACV,YAAY,EACZ,cAAc,EACd,aAAa,EACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAExF,OAAO,EACL,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,uBAAuB,EACvB,UAAU,EACV,YAAY,EACZ,cAAc,EACd,aAAa,EACb,0BAA0B,EAC1B,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,kBAAkB,EAClB,SAAS,EACT,WAAW,EACX,aAAa,EACb,YAAY,EACZ,SAAS,EACT,WAAW,EACX,aAAa,EACb,YAAY,GACb,CAAC"}

package/dist/v1/regexp/index.mjs

@@ -0,0 +1,8 @@
+import { ipv4Regex, isValidIPv4, findIPv4Regex, extractIPsV4 } from './Ipv4.mjs';
+import { extractIPsV6, findIPv6Regex, ipv6Regex, isValidIPv6 } from './Ipv6.mjs';
+import { usernameStringRegexBuilder, usernameRegex, isValidUsername, findUsernameRegex, extractUsernames, } from './Username/index.mjs';
+import { makeSegmentExtractor, segmentExtractorV1 } from './SegmentExtractor.mjs';
+import { extractUrls, findUrlRegex, isValidUrl, urlRegex, urlStringRegexBuilder, } from './UrlDetector.mjs';
+import { emailStringRegexBuilder, emailRegex, isValidEmail, findEmailRegex, extractEmails, } from './Email.mjs';
+import { compileGlob, compileGlobRegExp, decompileGlob, isValidGlob } from './Glob.mjs';
+export { isValidGlob, compileGlob, compileGlobRegExp, decompileGlob, emailStringRegexBuilder, emailRegex, isValidEmail, findEmailRegex, extractEmails, usernameStringRegexBuilder, usernameRegex, isValidUsername, findUsernameRegex, extractUsernames, urlStringRegexBuilder, urlRegex, isValidUrl, findUrlRegex, extractUrls, makeSegmentExtractor, segmentExtractorV1, ipv4Regex, isValidIPv4, findIPv4Regex, extractIPsV4, ipv6Regex, isValidIPv6, findIPv6Regex, extractIPsV6, };

package/dist/v1/webTemplates/ag-psd/31.0/ProcessSolidFilters/Browser.cjs

@@ -0,0 +1,64 @@
+'use strict';
+
+var agPsd = require('ag-psd');
+var Template = require('./Template.cjs');
+
+/**
+ * Creates a native browser Canvas element.
+ * @param {number} width - The width to assign to the new canvas, in pixels.
+ * @param {number} height - The height to assign to the new canvas, in pixels.
+ * @returns {HTMLCanvasElement} A new detached HTMLCanvasElement with the requested dimensions.
+ */
+const createBrowserCanvas = (width, height) => {
+  const canvas = document.createElement('canvas');
+  canvas.width = width;
+  canvas.height = height;
+  return canvas;
+};
+
+/**
+ * Extracts solid colors and calculates the area of each claimed filter in the PSD.
+ * @param {Blob} psdInput - The absolute path, URL, or Blob file of the PSD.
+ * @param {HTMLCanvasElement[]} filters - The configurations to capture specific layers.
+ * @param {import('./Template.mjs').DefaultConfig} defaultConfig - The fallback configuration for the remaining layers.
+ * @returns {Promise<import('./Template.mjs').ProcessedPsdResult<Blob>>} Results of the separated and reconstructed images, and pixel statistics.
+ * @throws {Error|TypeError} If the parameters or the file are invalid.
+ * @beta
+ */
+const processPsdSolidFilters = Template.createProcessPsdSolidFilters(
+  async (psdInput) => {
+    // Allows fetching from a remote URL
+    if (typeof psdInput === 'string') {
+      const response = await fetch(psdInput);
+      if (!response.ok) {
+        throw new Error(`Failed to load the PSD file from the provided URL: ${psdInput}`);
+      }
+      return response.arrayBuffer();
+    }
+    // Allows reading files passed via File / Drag-and-drop inputs
+    else if (psdInput instanceof Blob) {
+      return psdInput.arrayBuffer();
+    }
+
+    throw new TypeError(
+      "In the Browser environment, 'psdInput' must be a URL (string) or a File/Blob object.",
+    );
+  },
+  createBrowserCanvas,
+  agPsd.readPsd,
+  (canvas) => {
+    // The browser natively exports images with toBlob, based on callbacks.
+    // This encapsulates the callback into a clean Promise.
+    return new Promise((resolve, reject) => {
+      canvas.toBlob((blob) => {
+        if (blob) {
+          resolve(blob);
+        } else {
+          reject(new Error('Failed to export the image from the browser Canvas element.'));
+        }
+      }, 'image/png');
+    });
+  },
+);
+
+exports.processPsdSolidFilters = processPsdSolidFilters;

package/dist/v1/webTemplates/ag-psd/31.0/ProcessSolidFilters/Browser.d.mts

@@ -0,0 +1,11 @@
+/**
+ * Extracts solid colors and calculates the area of each claimed filter in the PSD.
+ * @param {Blob} psdInput - The absolute path, URL, or Blob file of the PSD.
+ * @param {HTMLCanvasElement[]} filters - The configurations to capture specific layers.
+ * @param {import('./Template.mjs').DefaultConfig} defaultConfig - The fallback configuration for the remaining layers.
+ * @returns {Promise<import('./Template.mjs').ProcessedPsdResult<Blob>>} Results of the separated and reconstructed images, and pixel statistics.
+ * @throws {Error|TypeError} If the parameters or the file are invalid.
+ * @beta
+ */
+export declare const processPsdSolidFilters: (psdInput: string | Blob | HTMLInputElement, filters: import("./Template.mjs").FilterConfig[], defaultConfig: import("./Template.mjs").DefaultConfig) => Promise<import("./Template.mjs").ProcessedPsdResult<any>>;
+//# sourceMappingURL=Browser.d.mts.map

package/dist/v1/webTemplates/ag-psd/31.0/ProcessSolidFilters/Browser.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Browser.d.mts","sourceRoot":"","sources":["../../../../../../src/v1/webTemplates/ag-psd/31.0/ProcessSolidFilters/Browser.mjs"],"names":[],"mappings":"AAgBA;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,oNAkClC,CAAC"}

package/dist/v1/webTemplates/ag-psd/31.0/ProcessSolidFilters/Browser.mjs

@@ -0,0 +1,51 @@
+import { readPsd } from 'ag-psd';
+import { createProcessPsdSolidFilters } from './Template.mjs';
+/**
+ * Creates a native browser Canvas element.
+ * @param {number} width - The width to assign to the new canvas, in pixels.
+ * @param {number} height - The height to assign to the new canvas, in pixels.
+ * @returns {HTMLCanvasElement} A new detached HTMLCanvasElement with the requested dimensions.
+ */
+const createBrowserCanvas = (width, height) => {
+    const canvas = document.createElement('canvas');
+    canvas.width = width;
+    canvas.height = height;
+    return canvas;
+};
+/**
+ * Extracts solid colors and calculates the area of each claimed filter in the PSD.
+ * @param {Blob} psdInput - The absolute path, URL, or Blob file of the PSD.
+ * @param {HTMLCanvasElement[]} filters - The configurations to capture specific layers.
+ * @param {import('./Template.mjs').DefaultConfig} defaultConfig - The fallback configuration for the remaining layers.
+ * @returns {Promise<import('./Template.mjs').ProcessedPsdResult<Blob>>} Results of the separated and reconstructed images, and pixel statistics.
+ * @throws {Error|TypeError} If the parameters or the file are invalid.
+ * @beta
+ */
+export const processPsdSolidFilters = createProcessPsdSolidFilters(async (psdInput) => {
+    // Allows fetching from a remote URL
+    if (typeof psdInput === 'string') {
+        const response = await fetch(psdInput);
+        if (!response.ok) {
+            throw new Error(`Failed to load the PSD file from the provided URL: ${psdInput}`);
+        }
+        return response.arrayBuffer();
+    }
+    // Allows reading files passed via File / Drag-and-drop inputs
+    else if (psdInput instanceof Blob) {
+        return psdInput.arrayBuffer();
+    }
+    throw new TypeError("In the Browser environment, 'psdInput' must be a URL (string) or a File/Blob object.");
+}, createBrowserCanvas, readPsd, (canvas) => {
+    // The browser natively exports images with toBlob, based on callbacks.
+    // This encapsulates the callback into a clean Promise.
+    return new Promise((resolve, reject) => {
+        canvas.toBlob((blob) => {
+            if (blob) {
+                resolve(blob);
+            }
+            else {
+                reject(new Error('Failed to export the image from the browser Canvas element.'));
+            }
+        }, 'image/png');
+    });
+});