linecraft 0.2.4 → 0.2.6

package/LICENSE

@@ -1,21 +1,59 @@
-MIT License
-
-Copyright (c) 2025 Linecraft Contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+Fair Labor License (FLL) v1.2
+
+© 2026 Linecraft Contributors
+
+SPDX-License-Identifier: LicenseRef-FLL-1.2
+
+1. Purpose
+The Fair Labor License exists to ensure that free and open software does not contribute to extreme labor inequality. When organizations compensate their workers fairly, this software is free to use. When they do not, they must purchase a license — ensuring that value created through labor is not taken without accountability.
+
+2. License Grant
+Subject to the conditions in this license, the author(s) grant permission to any individual or organization to use, reproduce, modify, and distribute this software.
+
+3. Evaluation Use Exception
+Anyone may download, install, and use the software solely for evaluation and testing purposes. Evaluation use may not exceed 90 days and may not include operational, commercial, or production use.
+
+4. Fair Compensation Condition (Eligibility for Free Use)
+This software is free to use for any individual or organization that meets at least one of the following conditions at the time of operational use:
+
+a. Individuals
+The individual's net worth is under 5 million USD.
+
+b. Organizations
+The organization is Fair Labor Compliant, defined as:
+- The CEO's (or highest-paid executive's) total annual compensation is no more than fifteen (15) times the total annual compensation of the organization's median employee, and
+- Eligibility is assessed on a consolidated basis, including all parent and subsidiary entities under common control or brand identity.
+
+Definitions
+- "Total annual compensation" includes wages, bonuses, overtime, equity or stock-based compensation, and employer-provided benefits.
+- "Median employee" refers to the worker whose compensation is the exact midpoint of all workers, including part-time and contract labor when they constitute a majority of operational personnel.
+- "Operational use" means deployment or use of the software in any product, system, or service that provides business value, revenue, or ongoing internal operations beyond evaluation, whether used directly or indirectly, including when incorporated as a dependency or component of another product, system, or service.
+
+5. Paid License Requirement
+If an individual or organization does not meet the Fair Compensation Condition at the time of operational use, they must obtain a paid license from the author(s) or an authorized licensing provider such as fllicense.org before such use begins.
+
+Unauthorized operational use constitutes copyright infringement.
+
+6. Self-Attestation and Documentation
+Licensees utilizing the software under the free-use provisions must self-attest compliance and maintain documentation supporting eligibility. Upon request by the author(s) or a licensing provider, documentation must be provided within 30 days.
+
+Failure to provide documentation is considered a material breach of this license.
+
+7. Change in Eligibility / Cure Period
+If a licensee's eligibility changes, they must:
+- Either purchase a paid license within 30 days, or
+- Immediately cease operational use of the software.
+
+Restoring eligibility restores the rights granted under this license.
+
+8. No Misrepresentation
+Licensees may not claim to be Fair Labor Compliant, nor use the Fair Labor License name or abbreviations in sales, marketing, or investor materials, unless they meet the Fair Compensation Condition.
+
+9. No Warranty
+This software is provided "as is", without warranty of any kind, express or implied, including merchantability, fitness for a particular purpose, and noninfringement. Use is at your own risk.
+
+10. Limitation of Liability
+In no event shall the author(s) be liable for any claim, damages, or other liability arising from the software or its use.
+
+11. Governing Law
+This license is governed by the copyright law applicable in the jurisdiction of the author(s).

package/README.md

@@ -142,6 +142,36 @@ ref.delete(); // Remove it
 r.destroy(true); // Clean up and restore terminal (true = clear first)
 ```
 
+## Semantic Themes
+
+Linecraft includes a built-in semantic theme system that automatically adapts colors based on whether the terminal is in light or dark mode. Instead of hardcoding ANSI colors, you can use semantic tokens:
+
+- `base`: The default text color (gray in both themes)
+- `muted`: Dimmed text for line numbers or separators (dimmed white on dark, dimmed gray on light)
+- `highlight`: Emphasized text (white on dark, bold black on light)
+- `accent`: Primary accent color (bold blue in both themes)
+- `location`: For file paths and locations (magenta in both themes)
+- `success`: Success messages (bright green on dark, green on light)
+- `warning`: Warning messages (bright yellow on dark, bright magenta on light)
+- `error`: Error messages (bright red on dark, red on light)
+- `info`: Informational messages (blue in both themes)
+
+You can use these tokens anywhere a `Color` is expected:
+
+```typescript
+import { Styled } from 'linecraft';
+
+// Automatically uses appropriate color based on terminal theme
+const text = Styled({ color: 'base' }, 'Auto-themed text');
+const error = Styled({ color: 'error' }, 'Error message');
+const path = Styled({ color: 'location' }, '/path/to/file.ts');
+
+// You can also resolve them manually if needed
+import { autoColor, autoStyle } from 'linecraft';
+const color = autoColor('warning'); // Returns just the color
+const style = autoStyle('accent'); // Returns full TextStyle (color, bold, etc.)
+```
+
 ## Components
 
 ### Styled
@@ -193,7 +223,7 @@ r.set(Section(
 
 ### CodeDebug
 
-Display code errors and warnings with line numbers, context, and clickable file paths.
+Display code errors and warnings with line numbers, context, and clickable file paths. Perfect for linters, compilers, and development tools that need to show diagnostic information.
 
 ![CodeDebug Example](https://raw.githubusercontent.com/matthew-dean/linecraft/main/docs/examples/code-debug.gif)
 
@@ -209,6 +239,8 @@ r.set(CodeDebug({
   lineBefore: '  async function load() {',
   lineAfter: '    return process(result);',
   message: 'Type error: fetchData is not defined',
+  errorCode: 'typescript(2304)', // Optional: error code with underline
+  shortMessage: 'not defined', // Optional: short message connected to underline
   filePath: 'src/loaders/data.ts',
   fullPath: '/absolute/path/to/src/loaders/data.ts',
   baseDir: process.cwd(),
@@ -217,12 +249,14 @@ r.set(CodeDebug({
 ```
 
 **Features:**
-- Automatic line number coloring (adapts to dark/light terminals)
-- Responsive truncation with ellipsis
-- Curved underlines for error ranges
-- Message wrapping
-- Clickable file paths (OSC 8 links)
-- Context lines (before/after)
+- **OSC 8 Hyperlinks**: File paths are clickable in modern terminals (VS Code, iTerm2, etc.). Ctrl+Click (or Cmd+Click) opens the file at the correct line and column.
+- **Smart Line Overflow**: Long code lines automatically truncate with ellipsis while keeping the error range visible. Supports ellipsis at start, end, or both sides.
+- **Error Range Highlighting**: The error range (startColumn to endColumn) is highlighted with a brighter color for easy identification.
+- **Context Lines**: Show lines before and after the error for better context (slightly dimmed for visual hierarchy).
+- **Message Wrapping**: Long error messages wrap across multiple lines while preserving ANSI styling and color codes.
+- **Terminal Theme Adaptation**: Line numbers and colors adapt to dark/light terminal themes automatically.
+- **Curved Underlines**: Visual indicators with curved edges (┖─┚) point to the exact error location, with optional T-bar for short messages.
+- **Responsive Layout**: Automatically adjusts to terminal width, truncating paths and code as needed.
 
 ### Spinner
 
@@ -424,6 +458,15 @@ Contributions welcome! Please open an issue or PR.
 
 ## License
 
-This project is licensed under the **MIT License**.
+This project is licensed under the **Fair Labor License (FLL) v1.2**.
+
+- If you are an individual with a net worth under **$5M USD**, or  
+- Your organization is **Fair Labor Compliant** (your CEO or highest-paid executive makes no more than **15×** your median employee's total annual compensation),
+
+then you may use this software **for free**, subject to the terms of the license.
+
+If you do **not** meet these conditions and use this software in production or for business value, you must obtain a **paid license**, for example via [fllicense.org](https://fllicense.org).
+
+You may freely evaluate and test this software for up to **90 days** before deciding.
 
 See the full license text in [`LICENSE`](./LICENSE).

package/lib/components/code-debug.d.ts

@@ -21,6 +21,8 @@ export interface CodeDebugOptions {
     errorCode?: string;
     /** Short message to show connected to underline (optional) */
     shortMessage?: string;
+    /** Placement of short message: 'left' or 'right' (default: 'right', auto: 'left' when target is near end of long line) */
+    shortMessagePlacement?: 'left' | 'right' | 'auto';
     /** Short file path to display */
     filePath: string;
     /** Full resolved file path for clickable link */

package/lib/components/code-debug.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"code-debug.d.ts","sourceRoot":"","sources":["../../src/components/code-debug.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAiB,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAWhE,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEzD,MAAM,WAAW,gBAAgB;IAC/B,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,qHAAqH;IACrH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAiID;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAgT9D"}
+{"version":3,"file":"code-debug.d.ts","sourceRoot":"","sources":["../../src/components/code-debug.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAiB,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAShE,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEzD,MAAM,WAAW,gBAAgB;IAC/B,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,qHAAqH;IACrH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0HAA0H;IAC1H,qBAAqB,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IAClD,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CA8W9D"}