sfiledl 2.0.0 → 2.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (9) hide show
  1. package/build/lib.cjs +94 -117
  2. package/build/lib.cjs.map +1 -14
  3. package/build/lib.d.ts +23 -31
  4. package/build/lib.mjs +87 -118
  5. package/build/lib.mjs.map +1 -12
  6. package/changelog +593 -0
  7. package/license +661 -0
  8. package/package.json +6 -3
  9. package/readme +3 -0
package/build/lib.cjs CHANGED
@@ -1,137 +1,114 @@
1
- 'use strict'
1
+ 'use strict';
2
2
 
3
- Object.defineProperty(exports, '__esModule', { value: true })
3
+ Object.defineProperty(exports, '__esModule', { value: true });
4
4
 
5
5
  const COLORS = {
6
- RESET: '\x1b[0m',
7
- BRIGHT: '\x1b[1m',
8
- YELLOW: '\x1b[33m',
9
- RED: '\x1b[31m',
10
- CYAN: '\x1b[36m',
11
- GRAY: '\x1b[90m',
12
- }
13
- exports.LibraryStatus = void 0
14
- ;(function (LibraryStatus) {
15
- LibraryStatus['UNDER_CONSTRUCTION'] = 'UNDER_CONSTRUCTION'
16
- LibraryStatus['STABLE'] = 'STABLE'
17
- LibraryStatus['DEPRECATED'] = 'DEPRECATED'
18
- })(exports.LibraryStatus || (exports.LibraryStatus = {}))
6
+ RESET: "\x1b[0m",
7
+ BRIGHT: "\x1b[1m",
8
+ YELLOW: "\x1b[33m",
9
+ RED: "\x1b[31m",
10
+ CYAN: "\x1b[36m",
11
+ GRAY: "\x1b[90m",
12
+ };
13
+ exports.LibraryStatus = void 0;
14
+ (function (LibraryStatus) {
15
+ LibraryStatus["UNDER_CONSTRUCTION"] = "UNDER_CONSTRUCTION";
16
+ LibraryStatus["STABLE"] = "STABLE";
17
+ LibraryStatus["DEPRECATED"] = "DEPRECATED";
18
+ })(exports.LibraryStatus || (exports.LibraryStatus = {}));
19
19
  const LIB_INFO = {
20
- name: 'MySuperFramework',
21
- currentVersion: '2.0.0-dev',
22
- previousVersion: '1.0.2',
23
- status: exports.LibraryStatus.UNDER_CONSTRUCTION,
24
- isDeprecated: true,
25
- message:
26
- 'This version represents a complete architectural refactor from CLI to framework. Not stable.',
27
- }
28
- let warningDisplayed = false
20
+ name: "MySuperFramework",
21
+ currentVersion: "2.0.1-dev",
22
+ previousVersion: "1.0.2",
23
+ status: exports.LibraryStatus.UNDER_CONSTRUCTION,
24
+ isDeprecated: true,
25
+ message: "This version represents a complete architectural refactor from CLI to framework. Not stable.",
26
+ };
27
+ let warningDisplayed = false;
29
28
  function stripAnsi(text) {
30
- return text.replace(/\x1b\[[0-9;]*[a-zA-Z]/g, '')
29
+ return text.replace(/\x1b\[[0-9;]*[a-zA-Z]/g, "");
31
30
  }
32
31
  function isDevelopmentVersion() {
33
- return LIB_INFO.status === exports.LibraryStatus.UNDER_CONSTRUCTION
32
+ return LIB_INFO.status === exports.LibraryStatus.UNDER_CONSTRUCTION;
34
33
  }
35
34
  class LibStatus {
36
- static instance
37
- constructor() {
38
- this.displayDeveloperWarning()
39
- }
40
- static getInstance() {
41
- if (!LibStatus.instance) {
42
- LibStatus.instance = new LibStatus()
43
- }
44
- return LibStatus.instance
45
- }
46
- displayDeveloperWarning() {
47
- if (typeof console === 'undefined' || typeof console.warn !== 'function') {
48
- return
49
- }
50
- if (warningDisplayed) {
51
- return
52
- }
53
- if (
54
- typeof process !== 'undefined' &&
55
- process.env &&
56
- process.env['MY_SUPER_FRAMEWORK_SUPPRESS_WARNING'] === 'true'
57
- ) {
58
- return
59
- }
60
- const border = `${COLORS.GRAY}${'='.repeat(80)}${COLORS.RESET}`
61
- const label = `${COLORS.YELLOW}${COLORS.BRIGHT}[WARNING]${COLORS.RESET}`
62
- const highlight = `${COLORS.CYAN}`
63
- console.warn(`\n${border}`)
64
- console.warn(`${label} DEVELOPMENT VERSION IN USE`)
65
- console.warn(
66
- `${COLORS.GRAY}Library: ${COLORS.RESET}${highlight}${LIB_INFO.name}${COLORS.RESET}`,
67
- )
68
- console.warn(
69
- `${COLORS.GRAY}Current Version: ${COLORS.RESET}${highlight}${LIB_INFO.currentVersion}${COLORS.RESET}`,
70
- )
71
- console.warn(
72
- `${COLORS.GRAY}Previous Version: ${COLORS.RESET}${highlight}${LIB_INFO.previousVersion}${COLORS.RESET}`,
73
- )
74
- console.warn(
75
- `${COLORS.GRAY}Architecture: ${COLORS.RESET}${highlight}CLI -> Framework (Full Refactor)${COLORS.RESET}`,
76
- )
77
- console.warn(
78
- `\n${COLORS.RED}${COLORS.BRIGHT}DO NOT USE IN PRODUCTION ENVIRONMENTS${COLORS.RESET}`,
79
- )
80
- console.warn(
81
- `${COLORS.GRAY}API stability is not guaranteed. Breaking changes may occur without notice.${COLORS.RESET}`,
82
- )
83
- console.warn(
84
- `${COLORS.GRAY}To suppress this warning, set env MY_SUPER_FRAMEWORK_SUPPRESS_WARNING=true${COLORS.RESET}`,
85
- )
86
- console.warn(`${border}\n`)
87
- warningDisplayed = true
88
- }
89
- suppressWarning() {
90
- warningDisplayed = true
91
- }
92
- ensureStable() {
93
- if (LIB_INFO.status === exports.LibraryStatus.UNDER_CONSTRUCTION) {
94
- const errorMessage =
95
- `${COLORS.RED}${COLORS.BRIGHT}[${LIB_INFO.name}] Stability Check Failed${COLORS.RESET}\n` +
96
- `${COLORS.GRAY}Library version ${LIB_INFO.currentVersion} is under active development.${COLORS.RESET}\n` +
97
- `${COLORS.GRAY}Current status: ${LIB_INFO.status}${COLORS.RESET}`
98
- throw new Error(stripAnsi(errorMessage))
99
- }
100
- }
101
- getVersion() {
102
- return LIB_INFO.currentVersion
103
- }
104
- getInfo() {
105
- return LIB_INFO
106
- }
35
+ static instance;
36
+ constructor() {
37
+ this.displayDeveloperWarning();
38
+ }
39
+ static getInstance() {
40
+ if (!LibStatus.instance) {
41
+ LibStatus.instance = new LibStatus();
42
+ }
43
+ return LibStatus.instance;
44
+ }
45
+ displayDeveloperWarning() {
46
+ if (typeof console === "undefined" || typeof console.warn !== "function") {
47
+ return;
48
+ }
49
+ if (warningDisplayed) {
50
+ return;
51
+ }
52
+ if (typeof process !== "undefined" && process.env && process.env['MY_SUPER_FRAMEWORK_SUPPRESS_WARNING'] === "true") {
53
+ return;
54
+ }
55
+ const border = `${COLORS.GRAY}${"=".repeat(80)}${COLORS.RESET}`;
56
+ const label = `${COLORS.YELLOW}${COLORS.BRIGHT}[WARNING]${COLORS.RESET}`;
57
+ const highlight = `${COLORS.CYAN}`;
58
+ console.warn(`\n${border}`);
59
+ console.warn(`${label} DEVELOPMENT VERSION IN USE`);
60
+ console.warn(`${COLORS.GRAY}Library: ${COLORS.RESET}${highlight}${LIB_INFO.name}${COLORS.RESET}`);
61
+ console.warn(`${COLORS.GRAY}Current Version: ${COLORS.RESET}${highlight}${LIB_INFO.currentVersion}${COLORS.RESET}`);
62
+ console.warn(`${COLORS.GRAY}Previous Version: ${COLORS.RESET}${highlight}${LIB_INFO.previousVersion}${COLORS.RESET}`);
63
+ console.warn(`${COLORS.GRAY}Architecture: ${COLORS.RESET}${highlight}CLI -> Framework (Full Refactor)${COLORS.RESET}`);
64
+ console.warn(`\n${COLORS.RED}${COLORS.BRIGHT}DO NOT USE IN PRODUCTION ENVIRONMENTS${COLORS.RESET}`);
65
+ console.warn(`${COLORS.GRAY}API stability is not guaranteed. Breaking changes may occur without notice.${COLORS.RESET}`);
66
+ console.warn(`${COLORS.GRAY}To suppress this warning, set env MY_SUPER_FRAMEWORK_SUPPRESS_WARNING=true${COLORS.RESET}`);
67
+ console.warn(`${border}\n`);
68
+ warningDisplayed = true;
69
+ }
70
+ suppressWarning() {
71
+ warningDisplayed = true;
72
+ }
73
+ ensureStable() {
74
+ if (LIB_INFO.status === exports.LibraryStatus.UNDER_CONSTRUCTION) {
75
+ const errorMessage = `${COLORS.RED}${COLORS.BRIGHT}[${LIB_INFO.name}] Stability Check Failed${COLORS.RESET}\n` +
76
+ `${COLORS.GRAY}Library version ${LIB_INFO.currentVersion} is under active development.${COLORS.RESET}\n` +
77
+ `${COLORS.GRAY}Current status: ${LIB_INFO.status}${COLORS.RESET}`;
78
+ throw new Error(stripAnsi(errorMessage));
79
+ }
80
+ }
81
+ getVersion() {
82
+ return LIB_INFO.currentVersion;
83
+ }
84
+ getInfo() {
85
+ return LIB_INFO;
86
+ }
107
87
  }
108
88
  function initFramework() {
109
- const message =
110
- `${COLORS.RED}${COLORS.BRIGHT}[${LIB_INFO.name}] Initialization Blocked${COLORS.RESET}\n` +
111
- `${COLORS.GRAY}Framework is undergoing complete architectural refactor.${COLORS.RESET}\n` +
112
- `${COLORS.GRAY}Migration path: v${LIB_INFO.previousVersion} (CLI) -> v${LIB_INFO.currentVersion} (Framework)${COLORS.RESET}\n` +
113
- `${COLORS.GRAY}Status: ${LIB_INFO.status}${COLORS.RESET}`
114
- throw new Error(stripAnsi(message))
89
+ const message = `${COLORS.RED}${COLORS.BRIGHT}[${LIB_INFO.name}] Initialization Blocked${COLORS.RESET}\n` +
90
+ `${COLORS.GRAY}Framework is undergoing complete architectural refactor.${COLORS.RESET}\n` +
91
+ `${COLORS.GRAY}Migration path: v${LIB_INFO.previousVersion} (CLI) -> v${LIB_INFO.currentVersion} (Framework)${COLORS.RESET}\n` +
92
+ `${COLORS.GRAY}Status: ${LIB_INFO.status}${COLORS.RESET}`;
93
+ throw new Error(stripAnsi(message));
115
94
  }
116
95
  function isStable() {
117
- return LIB_INFO.status !== exports.LibraryStatus.UNDER_CONSTRUCTION
96
+ return LIB_INFO.status !== exports.LibraryStatus.UNDER_CONSTRUCTION;
118
97
  }
119
98
  function assertStable() {
120
- if (LIB_INFO.status === exports.LibraryStatus.UNDER_CONSTRUCTION) {
121
- throw new Error(
122
- `[${LIB_INFO.name}] Cannot use unstable version ${LIB_INFO.currentVersion} in production. ` +
123
- `Status: ${LIB_INFO.status}`,
124
- )
125
- }
99
+ if (LIB_INFO.status === exports.LibraryStatus.UNDER_CONSTRUCTION) {
100
+ throw new Error(`[${LIB_INFO.name}] Cannot use unstable version ${LIB_INFO.currentVersion} in production. ` +
101
+ `Status: ${LIB_INFO.status}`);
102
+ }
126
103
  }
127
104
  if (isDevelopmentVersion()) {
128
- LibStatus.getInstance()
105
+ LibStatus.getInstance();
129
106
  }
130
107
 
131
- exports.LIB_INFO = LIB_INFO
132
- exports.LibStatus = LibStatus
133
- exports.assertStable = assertStable
134
- exports.initFramework = initFramework
135
- exports.isDevelopmentVersion = isDevelopmentVersion
136
- exports.isStable = isStable
108
+ exports.LIB_INFO = LIB_INFO;
109
+ exports.LibStatus = LibStatus;
110
+ exports.assertStable = assertStable;
111
+ exports.initFramework = initFramework;
112
+ exports.isDevelopmentVersion = isDevelopmentVersion;
113
+ exports.isStable = isStable;
137
114
  //# sourceMappingURL=lib.cjs.map
package/build/lib.cjs.map CHANGED
@@ -1,14 +1 @@
1
- {
2
- "version": 3,
3
- "file": "lib.cjs",
4
- "sources": [
5
- "../lib/lib.ts"
6
- ],
7
- "sourcesContent": [
8
- "const COLORS = {\n\tRESET: '\\x1b[0m',\n\tBRIGHT: '\\x1b[1m',\n\tYELLOW: '\\x1b[33m',\n\tRED: '\\x1b[31m',\n\tCYAN: '\\x1b[36m',\n\tGRAY: '\\x1b[90m',\n} as const\nexport enum LibraryStatus {\n\tUNDER_CONSTRUCTION = 'UNDER_CONSTRUCTION',\n\tSTABLE = 'STABLE',\n\tDEPRECATED = 'DEPRECATED',\n}\nexport const LIB_INFO = {\n\tname: 'MySuperFramework',\n\tcurrentVersion: '2.0.0-dev',\n\tpreviousVersion: '1.0.2',\n\tstatus: LibraryStatus.UNDER_CONSTRUCTION,\n\tisDeprecated: true,\n\tmessage:\n\t\t'This version represents a complete architectural refactor from CLI to framework. Not stable.',\n} as const\nlet warningDisplayed = false\nfunction stripAnsi(text: string): string {\n\treturn text.replace(/\\x1b\\[[0-9;]*[a-zA-Z]/g, '')\n}\nexport function isDevelopmentVersion(): boolean {\n\treturn LIB_INFO.status === LibraryStatus.UNDER_CONSTRUCTION\n}\nexport class LibStatus {\n\tprivate static instance: LibStatus | undefined\n\tprivate constructor() {\n\t\tthis.displayDeveloperWarning()\n\t}\n\tpublic static getInstance(): LibStatus {\n\t\tif (!LibStatus.instance) {\n\t\t\tLibStatus.instance = new LibStatus()\n\t\t}\n\t\treturn LibStatus.instance\n\t}\n\tprivate displayDeveloperWarning(): void {\n\t\tif (typeof console === 'undefined' || typeof console.warn !== 'function') {\n\t\t\treturn\n\t\t}\n\t\tif (warningDisplayed) {\n\t\t\treturn\n\t\t}\n\t\tif (\n\t\t\ttypeof process !== 'undefined' &&\n\t\t\tprocess.env &&\n\t\t\tprocess.env['MY_SUPER_FRAMEWORK_SUPPRESS_WARNING'] === 'true'\n\t\t) {\n\t\t\treturn\n\t\t}\n\t\tconst border = `${COLORS.GRAY}${'='.repeat(80)}${COLORS.RESET}`\n\t\tconst label = `${COLORS.YELLOW}${COLORS.BRIGHT}[WARNING]${COLORS.RESET}`\n\t\tconst highlight = `${COLORS.CYAN}`\n\t\tconsole.warn(`\\n${border}`)\n\t\tconsole.warn(`${label} DEVELOPMENT VERSION IN USE`)\n\t\tconsole.warn(\n\t\t\t`${COLORS.GRAY}Library: ${COLORS.RESET}${highlight}${LIB_INFO.name}${COLORS.RESET}`,\n\t\t)\n\t\tconsole.warn(\n\t\t\t`${COLORS.GRAY}Current Version: ${COLORS.RESET}${highlight}${LIB_INFO.currentVersion}${COLORS.RESET}`,\n\t\t)\n\t\tconsole.warn(\n\t\t\t`${COLORS.GRAY}Previous Version: ${COLORS.RESET}${highlight}${LIB_INFO.previousVersion}${COLORS.RESET}`,\n\t\t)\n\t\tconsole.warn(\n\t\t\t`${COLORS.GRAY}Architecture: ${COLORS.RESET}${highlight}CLI -> Framework (Full Refactor)${COLORS.RESET}`,\n\t\t)\n\t\tconsole.warn(\n\t\t\t`\\n${COLORS.RED}${COLORS.BRIGHT}DO NOT USE IN PRODUCTION ENVIRONMENTS${COLORS.RESET}`,\n\t\t)\n\t\tconsole.warn(\n\t\t\t`${COLORS.GRAY}API stability is not guaranteed. Breaking changes may occur without notice.${COLORS.RESET}`,\n\t\t)\n\t\tconsole.warn(\n\t\t\t`${COLORS.GRAY}To suppress this warning, set env MY_SUPER_FRAMEWORK_SUPPRESS_WARNING=true${COLORS.RESET}`,\n\t\t)\n\t\tconsole.warn(`${border}\\n`)\n\t\twarningDisplayed = true\n\t}\n\tpublic suppressWarning(): void {\n\t\twarningDisplayed = true\n\t}\n\tpublic ensureStable(): void {\n\t\tif (LIB_INFO.status === LibraryStatus.UNDER_CONSTRUCTION) {\n\t\t\tconst errorMessage =\n\t\t\t\t`${COLORS.RED}${COLORS.BRIGHT}[${LIB_INFO.name}] Stability Check Failed${COLORS.RESET}\\n` +\n\t\t\t\t`${COLORS.GRAY}Library version ${LIB_INFO.currentVersion} is under active development.${COLORS.RESET}\\n` +\n\t\t\t\t`${COLORS.GRAY}Current status: ${LIB_INFO.status}${COLORS.RESET}`\n\t\t\tthrow new Error(stripAnsi(errorMessage))\n\t\t}\n\t}\n\tpublic getVersion(): string {\n\t\treturn LIB_INFO.currentVersion\n\t}\n\tpublic getInfo(): Readonly<typeof LIB_INFO> {\n\t\treturn LIB_INFO\n\t}\n}\nexport function initFramework(): never {\n\tconst message =\n\t\t`${COLORS.RED}${COLORS.BRIGHT}[${LIB_INFO.name}] Initialization Blocked${COLORS.RESET}\\n` +\n\t\t`${COLORS.GRAY}Framework is undergoing complete architectural refactor.${COLORS.RESET}\\n` +\n\t\t`${COLORS.GRAY}Migration path: v${LIB_INFO.previousVersion} (CLI) -> v${LIB_INFO.currentVersion} (Framework)${COLORS.RESET}\\n` +\n\t\t`${COLORS.GRAY}Status: ${LIB_INFO.status}${COLORS.RESET}`\n\tthrow new Error(stripAnsi(message))\n}\nexport function isStable(): boolean {\n\treturn LIB_INFO.status !== LibraryStatus.UNDER_CONSTRUCTION\n}\nexport function assertStable(): void {\n\tif (LIB_INFO.status === LibraryStatus.UNDER_CONSTRUCTION) {\n\t\tthrow new Error(\n\t\t\t`[${LIB_INFO.name}] Cannot use unstable version ${LIB_INFO.currentVersion} in production. ` +\n\t\t\t\t`Status: ${LIB_INFO.status}`,\n\t\t)\n\t}\n}\nif (isDevelopmentVersion()) {\n\tLibStatus.getInstance()\n}\n"
9
- ],
10
- "names": [
11
- "LibraryStatus"
12
- ],
13
- "mappings": "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"
14
- }
1
+ {"version":3,"file":"lib.cjs","sources":["../lib/lib.ts"],"sourcesContent":["/**\n * ====================================================================================================\n * WARNING: LIBRARY UNDER ACTIVE DEVELOPMENT - NOT FOR PRODUCTION USE\n * ====================================================================================================\n * \n * Status: DEPRECATED / UNSTABLE\n * Previous Version: 1.0.2 (CLI-based architecture)\n * Target Version: 2.0.1 (Full framework architecture)\n * \n * BREAKING CHANGES NOTICE:\n * - This library is undergoing a complete rewrite and architectural refactor.\n * - Legacy CLI-based implementation has been entirely removed.\n * - New framework-based architecture is currently under active development.\n * \n * PRODUCTION USE PROHIBITED:\n * - API surface is subject to change without notice.\n * - No backward compatibility guarantees.\n * - Use exclusively for development and testing purposes.\n * \n * ====================================================================================================\n */\n\n// ANSI color codes for terminal output\nconst COLORS = {\n RESET: \"\\x1b[0m\",\n BRIGHT: \"\\x1b[1m\",\n YELLOW: \"\\x1b[33m\",\n RED: \"\\x1b[31m\",\n CYAN: \"\\x1b[36m\",\n GRAY: \"\\x1b[90m\",\n} as const;\n\n/**\n * Development status of the library.\n */\nexport enum LibraryStatus {\n /** Library is under active construction, not ready for production. */\n UNDER_CONSTRUCTION = \"UNDER_CONSTRUCTION\",\n /** Library is stable and ready for production. (Future use) */\n STABLE = \"STABLE\",\n /** Library is deprecated. (Future use) */\n DEPRECATED = \"DEPRECATED\",\n}\n\n/**\n * Library metadata.\n */\nexport const LIB_INFO = {\n name: \"MySuperFramework\",\n currentVersion: \"2.0.1-dev\",\n previousVersion: \"1.0.2\",\n status: LibraryStatus.UNDER_CONSTRUCTION,\n isDeprecated: true,\n message: \"This version represents a complete architectural refactor from CLI to framework. Not stable.\",\n} as const;\n\n// Flag to ensure warning is displayed only once\nlet warningDisplayed = false;\n\n/**\n * Utility function to strip ANSI escape codes from a string.\n * Supports common ANSI sequences (colors, styles, etc.).\n * @param text - Text containing ANSI escape sequences.\n * @returns Plain text without ANSI formatting.\n */\nfunction stripAnsi(text: string): string {\n // Matches ANSI escape sequences: \\x1b[ (or \\u001b[) followed by any number of parameters and ending with a letter\n return text.replace(/\\x1b\\[[0-9;]*[a-zA-Z]/g, \"\");\n}\n\n/**\n * Checks if the library is currently in development mode.\n * @returns `true` if the library status is `UNDER_CONSTRUCTION`.\n */\nexport function isDevelopmentVersion(): boolean {\n return LIB_INFO.status === LibraryStatus.UNDER_CONSTRUCTION;\n}\n\n/**\n * Primary class for library status management and developer notifications.\n * Provides programmatic access to version information and stability checks.\n */\nexport class LibStatus {\n private static instance: LibStatus | undefined;\n\n private constructor() {\n this.displayDeveloperWarning();\n }\n\n /**\n * Gets the singleton instance of LibStatus.\n * @returns The LibStatus instance.\n */\n public static getInstance(): LibStatus {\n if (!LibStatus.instance) {\n LibStatus.instance = new LibStatus();\n }\n return LibStatus.instance;\n }\n\n /**\n * Outputs formatted warning message to console upon library initialization.\n * Uses ANSI color codes for enhanced visibility in terminal environments.\n * The warning is displayed only once per process, unless suppressed.\n */\n private displayDeveloperWarning(): void {\n // Skip if console is not available or warning already displayed\n if (typeof console === \"undefined\" || typeof console.warn !== \"function\") {\n return;\n }\n if (warningDisplayed) {\n return;\n }\n // Check environment variable to suppress warning (e.g., for testing)\n // Use bracket notation to avoid TypeScript index signature error\n if (typeof process !== \"undefined\" && process.env && process.env['MY_SUPER_FRAMEWORK_SUPPRESS_WARNING'] === \"true\") {\n return;\n }\n\n const border = `${COLORS.GRAY}${\"=\".repeat(80)}${COLORS.RESET}`;\n const label = `${COLORS.YELLOW}${COLORS.BRIGHT}[WARNING]${COLORS.RESET}`;\n const highlight = `${COLORS.CYAN}`;\n\n console.warn(`\\n${border}`);\n console.warn(`${label} DEVELOPMENT VERSION IN USE`);\n console.warn(`${COLORS.GRAY}Library: ${COLORS.RESET}${highlight}${LIB_INFO.name}${COLORS.RESET}`);\n console.warn(`${COLORS.GRAY}Current Version: ${COLORS.RESET}${highlight}${LIB_INFO.currentVersion}${COLORS.RESET}`);\n console.warn(`${COLORS.GRAY}Previous Version: ${COLORS.RESET}${highlight}${LIB_INFO.previousVersion}${COLORS.RESET}`);\n console.warn(`${COLORS.GRAY}Architecture: ${COLORS.RESET}${highlight}CLI -> Framework (Full Refactor)${COLORS.RESET}`);\n console.warn(`\\n${COLORS.RED}${COLORS.BRIGHT}DO NOT USE IN PRODUCTION ENVIRONMENTS${COLORS.RESET}`);\n console.warn(`${COLORS.GRAY}API stability is not guaranteed. Breaking changes may occur without notice.${COLORS.RESET}`);\n console.warn(`${COLORS.GRAY}To suppress this warning, set env MY_SUPER_FRAMEWORK_SUPPRESS_WARNING=true${COLORS.RESET}`);\n console.warn(`${border}\\n`);\n\n warningDisplayed = true;\n }\n\n /**\n * Suppresses the development warning for this instance.\n * Useful when you need to programmatically disable the warning (e.g., in tests).\n */\n public suppressWarning(): void {\n warningDisplayed = true;\n }\n\n /**\n * Validates library stability status.\n * @throws Error if library is marked as unstable or under construction.\n */\n public ensureStable(): void {\n if (LIB_INFO.status === LibraryStatus.UNDER_CONSTRUCTION) {\n const errorMessage = `${COLORS.RED}${COLORS.BRIGHT}[${LIB_INFO.name}] Stability Check Failed${COLORS.RESET}\\n` +\n `${COLORS.GRAY}Library version ${LIB_INFO.currentVersion} is under active development.${COLORS.RESET}\\n` +\n `${COLORS.GRAY}Current status: ${LIB_INFO.status}${COLORS.RESET}`;\n\n throw new Error(stripAnsi(errorMessage));\n }\n }\n\n /**\n * Returns the current library version string.\n * @returns Version identifier in semver format.\n */\n public getVersion(): string {\n return LIB_INFO.currentVersion;\n }\n\n /**\n * Returns detailed library metadata.\n * @returns Readonly object containing library information.\n */\n public getInfo(): Readonly<typeof LIB_INFO> {\n return LIB_INFO;\n }\n}\n\n/**\n * Placeholder entry point for framework initialization.\n * Intentionally throws error to prevent usage during development phase.\n * @throws Error indicating framework is not ready for use.\n */\nexport function initFramework(): never {\n const message = `${COLORS.RED}${COLORS.BRIGHT}[${LIB_INFO.name}] Initialization Blocked${COLORS.RESET}\\n` +\n `${COLORS.GRAY}Framework is undergoing complete architectural refactor.${COLORS.RESET}\\n` +\n `${COLORS.GRAY}Migration path: v${LIB_INFO.previousVersion} (CLI) -> v${LIB_INFO.currentVersion} (Framework)${COLORS.RESET}\\n` +\n `${COLORS.GRAY}Status: ${LIB_INFO.status}${COLORS.RESET}`;\n\n throw new Error(stripAnsi(message));\n}\n\n/**\n * Type guard to check if current version is stable.\n * @returns `false` if library is under construction, `true` otherwise.\n */\nexport function isStable(): boolean {\n return LIB_INFO.status !== LibraryStatus.UNDER_CONSTRUCTION;\n}\n\n/**\n * Throws an error if the library is not stable.\n * Use this at the start of your application to ensure you're not using an unstable version.\n * @throws Error when library is under construction.\n */\nexport function assertStable(): void {\n if (LIB_INFO.status === LibraryStatus.UNDER_CONSTRUCTION) {\n throw new Error(\n `[${LIB_INFO.name}] Cannot use unstable version ${LIB_INFO.currentVersion} in production. ` +\n `Status: ${LIB_INFO.status}`\n );\n }\n}\n\n// Immediate execution block: displays warning upon module import (only once)\n// Does not throw to allow type-checking and development workflows\nif (isDevelopmentVersion()) {\n // Trigger singleton instantiation which displays the warning\n LibStatus.getInstance();\n}"],"names":["LibraryStatus"],"mappings":"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"}
package/build/lib.d.ts CHANGED
@@ -1,37 +1,29 @@
1
1
  declare enum LibraryStatus {
2
- UNDER_CONSTRUCTION = 'UNDER_CONSTRUCTION',
3
- STABLE = 'STABLE',
4
- DEPRECATED = 'DEPRECATED',
2
+ UNDER_CONSTRUCTION = "UNDER_CONSTRUCTION",
3
+ STABLE = "STABLE",
4
+ DEPRECATED = "DEPRECATED"
5
5
  }
6
6
  declare const LIB_INFO: {
7
- readonly name: 'MySuperFramework'
8
- readonly currentVersion: '2.0.0-dev'
9
- readonly previousVersion: '1.0.2'
10
- readonly status: LibraryStatus.UNDER_CONSTRUCTION
11
- readonly isDeprecated: true
12
- readonly message: 'This version represents a complete architectural refactor from CLI to framework. Not stable.'
13
- }
14
- declare function isDevelopmentVersion(): boolean
7
+ readonly name: "MySuperFramework";
8
+ readonly currentVersion: "2.0.1-dev";
9
+ readonly previousVersion: "1.0.2";
10
+ readonly status: LibraryStatus.UNDER_CONSTRUCTION;
11
+ readonly isDeprecated: true;
12
+ readonly message: "This version represents a complete architectural refactor from CLI to framework. Not stable.";
13
+ };
14
+ declare function isDevelopmentVersion(): boolean;
15
15
  declare class LibStatus {
16
- private static instance
17
- private constructor()
18
- static getInstance(): LibStatus
19
- private displayDeveloperWarning
20
- suppressWarning(): void
21
- ensureStable(): void
22
- getVersion(): string
23
- getInfo(): Readonly<typeof LIB_INFO>
16
+ private static instance;
17
+ private constructor();
18
+ static getInstance(): LibStatus;
19
+ private displayDeveloperWarning;
20
+ suppressWarning(): void;
21
+ ensureStable(): void;
22
+ getVersion(): string;
23
+ getInfo(): Readonly<typeof LIB_INFO>;
24
24
  }
25
- declare function initFramework(): never
26
- declare function isStable(): boolean
27
- declare function assertStable(): void
25
+ declare function initFramework(): never;
26
+ declare function isStable(): boolean;
27
+ declare function assertStable(): void;
28
28
 
29
- export {
30
- LIB_INFO,
31
- LibStatus,
32
- LibraryStatus,
33
- assertStable,
34
- initFramework,
35
- isDevelopmentVersion,
36
- isStable,
37
- }
29
+ export { LIB_INFO, LibStatus, LibraryStatus, assertStable, initFramework, isDevelopmentVersion, isStable };
package/build/lib.mjs CHANGED
@@ -1,136 +1,105 @@
1
1
  const COLORS = {
2
- RESET: '\x1b[0m',
3
- BRIGHT: '\x1b[1m',
4
- YELLOW: '\x1b[33m',
5
- RED: '\x1b[31m',
6
- CYAN: '\x1b[36m',
7
- GRAY: '\x1b[90m',
8
- }
9
- var LibraryStatus
10
- ;(function (LibraryStatus) {
11
- LibraryStatus['UNDER_CONSTRUCTION'] = 'UNDER_CONSTRUCTION'
12
- LibraryStatus['STABLE'] = 'STABLE'
13
- LibraryStatus['DEPRECATED'] = 'DEPRECATED'
14
- })(LibraryStatus || (LibraryStatus = {}))
2
+ RESET: "\x1b[0m",
3
+ BRIGHT: "\x1b[1m",
4
+ YELLOW: "\x1b[33m",
5
+ RED: "\x1b[31m",
6
+ CYAN: "\x1b[36m",
7
+ GRAY: "\x1b[90m",
8
+ };
9
+ var LibraryStatus;
10
+ (function (LibraryStatus) {
11
+ LibraryStatus["UNDER_CONSTRUCTION"] = "UNDER_CONSTRUCTION";
12
+ LibraryStatus["STABLE"] = "STABLE";
13
+ LibraryStatus["DEPRECATED"] = "DEPRECATED";
14
+ })(LibraryStatus || (LibraryStatus = {}));
15
15
  const LIB_INFO = {
16
- name: 'MySuperFramework',
17
- currentVersion: '2.0.0-dev',
18
- previousVersion: '1.0.2',
19
- status: LibraryStatus.UNDER_CONSTRUCTION,
20
- isDeprecated: true,
21
- message:
22
- 'This version represents a complete architectural refactor from CLI to framework. Not stable.',
23
- }
24
- let warningDisplayed = false
16
+ name: "MySuperFramework",
17
+ currentVersion: "2.0.1-dev",
18
+ previousVersion: "1.0.2",
19
+ status: LibraryStatus.UNDER_CONSTRUCTION,
20
+ isDeprecated: true,
21
+ message: "This version represents a complete architectural refactor from CLI to framework. Not stable.",
22
+ };
23
+ let warningDisplayed = false;
25
24
  function stripAnsi(text) {
26
- return text.replace(/\x1b\[[0-9;]*[a-zA-Z]/g, '')
25
+ return text.replace(/\x1b\[[0-9;]*[a-zA-Z]/g, "");
27
26
  }
28
27
  function isDevelopmentVersion() {
29
- return LIB_INFO.status === LibraryStatus.UNDER_CONSTRUCTION
28
+ return LIB_INFO.status === LibraryStatus.UNDER_CONSTRUCTION;
30
29
  }
31
30
  class LibStatus {
32
- static instance
33
- constructor() {
34
- this.displayDeveloperWarning()
35
- }
36
- static getInstance() {
37
- if (!LibStatus.instance) {
38
- LibStatus.instance = new LibStatus()
39
- }
40
- return LibStatus.instance
41
- }
42
- displayDeveloperWarning() {
43
- if (typeof console === 'undefined' || typeof console.warn !== 'function') {
44
- return
45
- }
46
- if (warningDisplayed) {
47
- return
48
- }
49
- if (
50
- typeof process !== 'undefined' &&
51
- process.env &&
52
- process.env['MY_SUPER_FRAMEWORK_SUPPRESS_WARNING'] === 'true'
53
- ) {
54
- return
55
- }
56
- const border = `${COLORS.GRAY}${'='.repeat(80)}${COLORS.RESET}`
57
- const label = `${COLORS.YELLOW}${COLORS.BRIGHT}[WARNING]${COLORS.RESET}`
58
- const highlight = `${COLORS.CYAN}`
59
- console.warn(`\n${border}`)
60
- console.warn(`${label} DEVELOPMENT VERSION IN USE`)
61
- console.warn(
62
- `${COLORS.GRAY}Library: ${COLORS.RESET}${highlight}${LIB_INFO.name}${COLORS.RESET}`,
63
- )
64
- console.warn(
65
- `${COLORS.GRAY}Current Version: ${COLORS.RESET}${highlight}${LIB_INFO.currentVersion}${COLORS.RESET}`,
66
- )
67
- console.warn(
68
- `${COLORS.GRAY}Previous Version: ${COLORS.RESET}${highlight}${LIB_INFO.previousVersion}${COLORS.RESET}`,
69
- )
70
- console.warn(
71
- `${COLORS.GRAY}Architecture: ${COLORS.RESET}${highlight}CLI -> Framework (Full Refactor)${COLORS.RESET}`,
72
- )
73
- console.warn(
74
- `\n${COLORS.RED}${COLORS.BRIGHT}DO NOT USE IN PRODUCTION ENVIRONMENTS${COLORS.RESET}`,
75
- )
76
- console.warn(
77
- `${COLORS.GRAY}API stability is not guaranteed. Breaking changes may occur without notice.${COLORS.RESET}`,
78
- )
79
- console.warn(
80
- `${COLORS.GRAY}To suppress this warning, set env MY_SUPER_FRAMEWORK_SUPPRESS_WARNING=true${COLORS.RESET}`,
81
- )
82
- console.warn(`${border}\n`)
83
- warningDisplayed = true
84
- }
85
- suppressWarning() {
86
- warningDisplayed = true
87
- }
88
- ensureStable() {
89
- if (LIB_INFO.status === LibraryStatus.UNDER_CONSTRUCTION) {
90
- const errorMessage =
91
- `${COLORS.RED}${COLORS.BRIGHT}[${LIB_INFO.name}] Stability Check Failed${COLORS.RESET}\n` +
92
- `${COLORS.GRAY}Library version ${LIB_INFO.currentVersion} is under active development.${COLORS.RESET}\n` +
93
- `${COLORS.GRAY}Current status: ${LIB_INFO.status}${COLORS.RESET}`
94
- throw new Error(stripAnsi(errorMessage))
95
- }
96
- }
97
- getVersion() {
98
- return LIB_INFO.currentVersion
99
- }
100
- getInfo() {
101
- return LIB_INFO
102
- }
31
+ static instance;
32
+ constructor() {
33
+ this.displayDeveloperWarning();
34
+ }
35
+ static getInstance() {
36
+ if (!LibStatus.instance) {
37
+ LibStatus.instance = new LibStatus();
38
+ }
39
+ return LibStatus.instance;
40
+ }
41
+ displayDeveloperWarning() {
42
+ if (typeof console === "undefined" || typeof console.warn !== "function") {
43
+ return;
44
+ }
45
+ if (warningDisplayed) {
46
+ return;
47
+ }
48
+ if (typeof process !== "undefined" && process.env && process.env['MY_SUPER_FRAMEWORK_SUPPRESS_WARNING'] === "true") {
49
+ return;
50
+ }
51
+ const border = `${COLORS.GRAY}${"=".repeat(80)}${COLORS.RESET}`;
52
+ const label = `${COLORS.YELLOW}${COLORS.BRIGHT}[WARNING]${COLORS.RESET}`;
53
+ const highlight = `${COLORS.CYAN}`;
54
+ console.warn(`\n${border}`);
55
+ console.warn(`${label} DEVELOPMENT VERSION IN USE`);
56
+ console.warn(`${COLORS.GRAY}Library: ${COLORS.RESET}${highlight}${LIB_INFO.name}${COLORS.RESET}`);
57
+ console.warn(`${COLORS.GRAY}Current Version: ${COLORS.RESET}${highlight}${LIB_INFO.currentVersion}${COLORS.RESET}`);
58
+ console.warn(`${COLORS.GRAY}Previous Version: ${COLORS.RESET}${highlight}${LIB_INFO.previousVersion}${COLORS.RESET}`);
59
+ console.warn(`${COLORS.GRAY}Architecture: ${COLORS.RESET}${highlight}CLI -> Framework (Full Refactor)${COLORS.RESET}`);
60
+ console.warn(`\n${COLORS.RED}${COLORS.BRIGHT}DO NOT USE IN PRODUCTION ENVIRONMENTS${COLORS.RESET}`);
61
+ console.warn(`${COLORS.GRAY}API stability is not guaranteed. Breaking changes may occur without notice.${COLORS.RESET}`);
62
+ console.warn(`${COLORS.GRAY}To suppress this warning, set env MY_SUPER_FRAMEWORK_SUPPRESS_WARNING=true${COLORS.RESET}`);
63
+ console.warn(`${border}\n`);
64
+ warningDisplayed = true;
65
+ }
66
+ suppressWarning() {
67
+ warningDisplayed = true;
68
+ }
69
+ ensureStable() {
70
+ if (LIB_INFO.status === LibraryStatus.UNDER_CONSTRUCTION) {
71
+ const errorMessage = `${COLORS.RED}${COLORS.BRIGHT}[${LIB_INFO.name}] Stability Check Failed${COLORS.RESET}\n` +
72
+ `${COLORS.GRAY}Library version ${LIB_INFO.currentVersion} is under active development.${COLORS.RESET}\n` +
73
+ `${COLORS.GRAY}Current status: ${LIB_INFO.status}${COLORS.RESET}`;
74
+ throw new Error(stripAnsi(errorMessage));
75
+ }
76
+ }
77
+ getVersion() {
78
+ return LIB_INFO.currentVersion;
79
+ }
80
+ getInfo() {
81
+ return LIB_INFO;
82
+ }
103
83
  }
104
84
  function initFramework() {
105
- const message =
106
- `${COLORS.RED}${COLORS.BRIGHT}[${LIB_INFO.name}] Initialization Blocked${COLORS.RESET}\n` +
107
- `${COLORS.GRAY}Framework is undergoing complete architectural refactor.${COLORS.RESET}\n` +
108
- `${COLORS.GRAY}Migration path: v${LIB_INFO.previousVersion} (CLI) -> v${LIB_INFO.currentVersion} (Framework)${COLORS.RESET}\n` +
109
- `${COLORS.GRAY}Status: ${LIB_INFO.status}${COLORS.RESET}`
110
- throw new Error(stripAnsi(message))
85
+ const message = `${COLORS.RED}${COLORS.BRIGHT}[${LIB_INFO.name}] Initialization Blocked${COLORS.RESET}\n` +
86
+ `${COLORS.GRAY}Framework is undergoing complete architectural refactor.${COLORS.RESET}\n` +
87
+ `${COLORS.GRAY}Migration path: v${LIB_INFO.previousVersion} (CLI) -> v${LIB_INFO.currentVersion} (Framework)${COLORS.RESET}\n` +
88
+ `${COLORS.GRAY}Status: ${LIB_INFO.status}${COLORS.RESET}`;
89
+ throw new Error(stripAnsi(message));
111
90
  }
112
91
  function isStable() {
113
- return LIB_INFO.status !== LibraryStatus.UNDER_CONSTRUCTION
92
+ return LIB_INFO.status !== LibraryStatus.UNDER_CONSTRUCTION;
114
93
  }
115
94
  function assertStable() {
116
- if (LIB_INFO.status === LibraryStatus.UNDER_CONSTRUCTION) {
117
- throw new Error(
118
- `[${LIB_INFO.name}] Cannot use unstable version ${LIB_INFO.currentVersion} in production. ` +
119
- `Status: ${LIB_INFO.status}`,
120
- )
121
- }
95
+ if (LIB_INFO.status === LibraryStatus.UNDER_CONSTRUCTION) {
96
+ throw new Error(`[${LIB_INFO.name}] Cannot use unstable version ${LIB_INFO.currentVersion} in production. ` +
97
+ `Status: ${LIB_INFO.status}`);
98
+ }
122
99
  }
123
100
  if (isDevelopmentVersion()) {
124
- LibStatus.getInstance()
101
+ LibStatus.getInstance();
125
102
  }
126
103
 
127
- export {
128
- LIB_INFO,
129
- LibStatus,
130
- LibraryStatus,
131
- assertStable,
132
- initFramework,
133
- isDevelopmentVersion,
134
- isStable,
135
- }
104
+ export { LIB_INFO, LibStatus, LibraryStatus, assertStable, initFramework, isDevelopmentVersion, isStable };
136
105
  //# sourceMappingURL=lib.mjs.map