@mapples/inlang 1.0.1 → 1.1.0

package/README.md

@@ -1,454 +1,146 @@
-# @mapples/types
+# @mapples/inlang
 
-TypeScript type definitions for the Mapples Open Kit. This package provides all the core type definitions used across the Mapples ecosystem, including component registration, form configurations, and asset management.
+Internal language utilities for the Mapples Open Kit. This package provides parsing and evaluation helpers for "this" references, dimension strings, and condition strings used across the Mapples ecosystem (e.g. data bindings, visibility conditions, layout).
+
+## Features
+
+- **This references** – Parse and detect `"this"` and `"this::n"` style action/context references
+- **Data this** – Parse `(this)` and dot-separated paths for data binding
+- **Dimensions** – Parse dimension strings (e.g. `"w::50"`, `"height::100"`) for width/height
+- **Conditions** – Parse and evaluate condition strings (`dataProp::condition::value`) for visibility and logic
+- **TypeScript** – Full type definitions and TSDoc
 
 ## Installation
 
 ```bash
-npm install @mapples/types
+npm install @mapples/inlang
 # or
-yarn add @mapples/types
+yarn add @mapples/inlang
 ```
 
 ## Overview
 
-The `@mapples/types` package contains essential TypeScript interfaces and types that define the structure and behavior of components, forms, and assets in the Mapples system. These types ensure type safety and provide clear contracts for developers working with the Mapples Open Kit.
-
-## Core Types
-
-### Action Types
-
-#### `Action`
-
-Represents a user action that occurred in the application. Actions are used for tracking user interactions, analytics, and state management.
-
-```typescript
-interface Action {
-  time: number; // Timestamp when the action occurred (in milliseconds since epoch)
-  type?: string; // Optional string identifier for the type of action
-  payload?: ActionPayload; // Optional payload containing additional data about the action
-}
-```
-
-#### `ActionPayload`
-
-Represents the payload data that can be attached to an action.
-
-```typescript
-interface ActionPayload {
-  originalEventData?: any[]; // Original event data from the source event
-  data?: any; // Custom data payload specific to the action
-}
-```
-
-**Example:**
-
-```typescript
-import { Action, ActionPayload } from '@mapples/types';
-
-const userAction: Action = {
-  time: Date.now(),
-  type: 'BUTTON_PRESSED',
-  payload: {
-    data: { buttonId: 'submit', userId: '123' },
-    originalEventData: ['button', 'press', { x: 100, y: 200 }],
-  },
-};
-```
-
-### Mapplet Types
-
-#### `MappletType<State>`
-
-Represents the configuration interface for a Mapplet application. A Mapplet is a self-contained application that can be embedded or run standalone.
-
-```typescript
-interface MappletType<State extends object = object> {
-  state?: State; // Optional initial state object for the Mapplet
-  onAction?: (action: Action) => void; // Optional callback function to handle actions
-}
-```
-
-**Example:**
-
-```typescript
-import { MappletType, Action } from '@mapples/types';
-
-interface MyAppState {
-  user: { name: string; email: string };
-  settings: { theme: string };
-}
-
-const myMapplet: MappletType<MyAppState> = {
-  state: {
-    user: { name: 'John', email: 'john@example.com' },
-    settings: { theme: 'dark' },
-  },
-  onAction: (action: Action) => {
-    console.log('Mapplet action:', action);
-    // Handle analytics, logging, etc.
-  },
-};
-```
-
-### Asset Types
-
-#### `AssetType`
-
-Represents the different types of assets that can be used in the Mapples system.
-
-```typescript
-type AssetType = 'image' | 'video' | 'icon' | 'font' | 'json';
-```
-
-**Example:**
-
-```typescript
-import { AssetType } from '@mapples/types';
-
-const imageAsset: AssetType = 'image';
-const videoAsset: AssetType = 'video';
-```
-
-### Component Types
-
-#### `RegisteredComponent<T>`
-
-Defines the structure for registering components in the Mapples component system. This interface contains all the metadata needed to make a component available in the visual editor.
-
-```typescript
-interface RegisteredComponent<T extends object = object> {
-  type: string; // Unique component identifier
-  groupId: string; // Group this component belongs to
-  label: string; // Display name
-  Component: ComponentType<PropsWithChildren<T>>; // React component
-  Icon: ComponentType<SvgProps>; // Icon for component palette
-  initialProps: T; // Default props
-  styleKeys: StyleKey[]; // Available style properties
-  props: PropsFormField[]; // Property form fields
-  actionProps: string[]; // Action-triggering properties
-  hidden?: boolean; // Hide from palette
-  hasChildren?: boolean; // Can contain children
-}
-```
-
-**Example:**
-
-```typescript
-import { RegisteredComponent } from '@mapples/types';
-
-interface ButtonProps {
-  text: string;
-  disabled?: boolean;
-  onPress?: () => void;
-}
-
-const buttonComponent: RegisteredComponent<ButtonProps> = {
-  type: 'Button',
-  groupId: 'inputs',
-  label: 'Button',
-  Component: Button,
-  Icon: ButtonIcon,
-  initialProps: { text: 'Click me' },
-  styleKeys: [backgroundColorStyle, textColorStyle],
-  props: [textField, disabledField],
-  actionProps: ['onPress'],
-};
-```
-
-#### `RegisteredComponentsGroup`
+`@mapples/inlang` is used by other Mapples packages (e.g. render, form, ui) to interpret configuration strings. It does not depend on React or React Native.
 
-Represents a group of components in the component palette.
+## API Reference
 
-```typescript
-interface RegisteredComponentsGroup {
-  id: string; // Unique group identifier
-  label: string; // Display name
-  Icon: ComponentType<SvgProps>; // Group icon
-}
-```
+### Constants
 
-#### `RegisteredComponents`
+- **`FN_SEPARATOR`** – `'::'` – Separator used in "this", dim, and condition strings
+- **`DATA_THIS`** – `'(this)'` – Prefix for data-context reference (entire state)
+- **`DOT_SEPARATOR`** – `'.'` – Separator for object paths (e.g. `user.name`)
 
-A registry mapping component types to their definitions.
+### This (action/context references)
 
-```typescript
-type RegisteredComponents = Record<string, RegisteredComponent>;
-```
+- **`This`** – Type: `['this', string?]`
+- **`isThis(value?)`** – Returns whether the string matches `"this"` or `"this::n"`
+- **`isDataThis(value?)`** – Returns whether the string starts with `(this)`
+- **`parseDataThis(value)`** – Strips `(this)` and splits by dot (path segments)
+- **`parseThis(value?)`** – Parses to `['this', n?]` (e.g. `"this::2"` → `['this', '2']`)
 
-#### `StyleKey`
+### Dims (dimension strings)
 
-Defines a style property configuration.
+- **`DimType`** – `'width' | 'height'`
+- **`Dims`** – `[DimType, number]` (e.g. `['width', 0.5]` for 50%)
+- **`DimsString`** – `'w' | 'h' | 'width' | 'height'`
+- **`parseDims(dim)`** – Parses strings like `"w::50"` or `"height::100"` to `[type, 0..1]` or `null`
 
-```typescript
-interface StyleKey {
-  label: string; // Human-readable label
-  value: string; // CSS property name
-  forms: StyleFormType[]; // Applicable form types
-}
-```
+### State (conditions)
 
-### Form Types
+#### Types
 
-#### `StyleFormType`
+- **`Conditions`** – Enum: `equals` (`'eq'`), `notEquals` (`'neq'`)
+- **`SimpleCondition`** – `${string}::${Conditions}::${string}`
+- **`BoolCondition`** – Condition string with `'true'` or `'false'` as value
+- **`ConditionFunc`** – `(a, b) => boolean`
+- **`ValueType`** – `'string' | 'number' | 'boolean' | 'dataProp'`
+- **`ParseConditionResult`** – `{ dataProp, condition, valueProp, valueType }`
 
-Enum representing different categories of style forms.
+#### Regexp
 
-```typescript
-enum StyleFormType {
-  Dimension = 'Dimension', // Width, height, min/max dimensions
-  Image = 'Image', // Background images, object fit
-  Text = 'Text', // Text color, alignment
-  Typography = 'Typography', // Font family, size, weight
-  Position = 'Position', // Top, left, right, bottom
-  Surface = 'Surface', // Background color, opacity
-  ScrollSurface = 'ScrollSurface', // Scrollable surface properties
-  Borders = 'Borders', // Border width, color, radius
-  Shadow = 'Shadow', // Box shadow, elevation
-  Spacing = 'Spacing', // Margin, padding
-  Svg = 'Svg', // SVG-related properties
-}
-```
-
-#### `PropsFormType`
+- **`ConditionStringRegExp`** – Regex used to split condition strings on `::` (respecting quoted segments)
 
-Enum for property form field types.
-
-```typescript
-enum PropsFormType {
-  Text = 'Text', // Text input field
-  Select = 'Select', // Single selection dropdown
-  Switch = 'Switch', // Boolean toggle
-  MultiSelect = 'MultiSelect', // Multiple selection dropdown
-}
-```
+#### Utils
 
-#### `PropsFormField`
+- **`toConditionString(...values)`** – Joins values with `FN_SEPARATOR`
+- **`parseConditionString(value)`** – Splits a condition string into parts (valueType default `'string'`)
+- **`parseCondition(value)`** – Parses `SimpleCondition | BoolCondition` into `ParseConditionResult` (handles booleans and quoted types)
+- **`isCondition(value)`** – Type guard for valid condition strings
+- **`toBool(value)`** – Converts string/boolean to boolean (`"true"` → true)
+- **`toNumber(value)`** – Converts string/boolean to number (booleans → 0/1)
+- **`parseJoin(key?)`** – Splits key by `;` and removes newlines (for multi-key data props)
 
-Configuration for component property form fields.
-
-```typescript
-interface PropsFormField {
-  propsKey: string; // Property key in component props
-  label: string; // Form field label
-  options?: PropsFormFieldOptions; // Options for select fields
-  type: PropsFormType; // Form field type
-  dataProp?: boolean; // Can be bound to data sources
-}
-```
-
-**Example:**
-
-```typescript
-import { PropsFormField, PropsFormType } from '@mapples/types';
-
-const textField: PropsFormField = {
-  propsKey: 'text',
-  label: 'Button Text',
-  type: PropsFormType.Text,
-};
-
-const sizeField: PropsFormField = {
-  propsKey: 'size',
-  label: 'Size',
-  type: PropsFormType.Select,
-  options: [
-    { label: 'Small', value: 'sm' },
-    { label: 'Medium', value: 'md' },
-    { label: 'Large', value: 'lg' },
-  ],
-};
-```
-
-#### `PropsFormFieldOption`
-
-Represents an option in select/multi-select fields.
-
-```typescript
-interface PropsFormFieldOption {
-  label: string; // Display text
-  value: string; // Stored value
-}
-```
+#### Conditions (evaluators)
 
-#### `PropsFormFieldOptions`
+- **`eq`** – `(a, b) => a === b`
+- **`notEq`** – `(a, b) => a !== b`
+- **`conditionMap`** – `Record<Conditions, ConditionFunc>` mapping enum to functions
 
-Union type for form field options.
-
-```typescript
-type PropsFormFieldOptions =
-  | PropsFormFieldOption[] // Array of options
-  | 'typography' // Special typography type
-  | AssetType; // Asset type for asset selection
-```
-
-#### `ActionFormProps`
-
-Configuration for action properties.
-
-```typescript
-interface ActionFormProps {
-  propsKey: string; // Action property key
-  label: string; // Form field label
-}
-```
-
-#### `PropsFieldConfig`
-
-Mapping of form types to their React components.
-
-```typescript
-type PropsFieldConfig = Record<PropsFormType, ComponentType<PropsFormField>>;
-```
-
-## Usage Examples
-
-### Registering a Component
+## Usage examples
 
 ```typescript
 import {
-  RegisteredComponent,
-  PropsFormField,
-  PropsFormType,
-  StyleFormType,
-  StyleKey,
-} from '@mapples/types';
-
-// Define component props
-interface MyButtonProps {
-  text: string;
-  variant: 'primary' | 'secondary';
-  disabled?: boolean;
-}
-
-// Create style keys
-const backgroundColorStyle: StyleKey = {
-  label: 'Background Color',
-  value: 'backgroundColor',
-  forms: [StyleFormType.Surface],
-};
-
-// Create form fields
-const textField: PropsFormField = {
-  propsKey: 'text',
-  label: 'Button Text',
-  type: PropsFormType.Text,
-};
-
-const variantField: PropsFormField = {
-  propsKey: 'variant',
-  label: 'Variant',
-  type: PropsFormType.Select,
-  options: [
-    { label: 'Primary', value: 'primary' },
-    { label: 'Secondary', value: 'secondary' },
-  ],
-};
-
-// Register the component
-const myButtonComponent: RegisteredComponent<MyButtonProps> = {
-  type: 'MyButton',
-  groupId: 'custom',
-  label: 'My Button',
-  Component: MyButton,
-  Icon: MyButtonIcon,
-  initialProps: {
-    text: 'Click me',
-    variant: 'primary',
-  },
-  styleKeys: [backgroundColorStyle],
-  props: [textField, variantField],
-  actionProps: ['onPress'],
-};
-```
+  isThis,
+  isDataThis,
+  parseDataThis,
+  parseThis,
+  parseDims,
+  DATA_THIS,
+  FN_SEPARATOR,
+} from '@mapples/inlang';
 
-### Creating a Component Group
+// This
+isThis('"this"');        // true
+isThis('"this::1"');      // true
+parseThis('"this::2"');  // ['this', '2']
 
-```typescript
-import { RegisteredComponentsGroup } from '@mapples/types';
+// Data this
+isDataThis('(this)');           // true
+isDataThis('(this).user.name'); // true
+parseDataThis('(this).user.name'); // ['user', 'name']
 
-const customGroup: RegisteredComponentsGroup = {
-  id: 'custom',
-  label: 'Custom Components',
-  Icon: CustomIcon,
-};
+// Dims
+parseDims('"w::50"');   // ['width', 0.5]
+parseDims('"h::100"');  // ['height', 1]
+parseDims('"width"');   // ['width', 1]
 ```
 
-### Working with Form Fields
-
 ```typescript
 import {
-  PropsFormField,
-  PropsFormType,
-  PropsFormFieldOptions,
-} from '@mapples/types';
-
-// Text field
-const nameField: PropsFormField = {
-  propsKey: 'name',
-  label: 'Name',
-  type: PropsFormType.Text,
-};
-
-// Select field with options
-const statusField: PropsFormField = {
-  propsKey: 'status',
-  label: 'Status',
-  type: PropsFormType.Select,
-  options: [
-    { label: 'Active', value: 'active' },
-    { label: 'Inactive', value: 'inactive' },
-    { label: 'Pending', value: 'pending' },
-  ],
-};
-
-// Asset selection field
-const imageField: PropsFormField = {
-  propsKey: 'image',
-  label: 'Image',
-  type: PropsFormType.Select,
-  options: 'image', // AssetType
-};
-
-// Typography field
-const fontField: PropsFormField = {
-  propsKey: 'font',
-  label: 'Font',
-  type: PropsFormType.Select,
-  options: 'typography',
-};
-```
-
-## Integration with Other Packages
-
-This types package is used throughout the Mapples ecosystem:
+  parseCondition,
+  isCondition,
+  toBool,
+  toNumber,
+  Conditions,
+  conditionMap,
+} from '@mapples/inlang';
 
-- **@mapples/action**: Uses `Action` and `ActionPayload` types for action management
-- **@mapples/state**: Uses state-related types for state management
-- **@mapples/ui**: Uses `RegisteredComponent` and related types for component registration
-- **@mapples/form**: Uses `PropsFormField` and form-related types for property editing
-- **@mapples/style**: Uses `StyleKey` and `StyleFormType` for styling configuration
-- **@mapples/render**: Uses component types for rendering components
+const r = parseCondition('user.age::eq::18' as any);
+// r.dataProp === 'user.age', r.condition === Conditions.equals, r.valueProp === '18'
 
-## Type Safety
+const br = parseCondition('user.active::eq::true' as any);
+// br.valueProp === true, br.valueType === 'boolean'
 
-All types in this package are designed to provide maximum type safety and IntelliSense support. When working with Mapples components, you'll get:
+isCondition('user.role::eq::admin'); // true
+toBool('true');  // true
+toNumber('42');  // 42
 
-- Autocomplete for all properties
-- Type checking for component props
-- Validation for form field configurations
-- IntelliSense for style properties
+const fn = conditionMap[Conditions.equals];
+fn(1, 1); // true
+```
 
-## Contributing
+## Integration
 
-When adding new types to this package:
+Used by:
 
-1. Follow the existing naming conventions
-2. Add comprehensive TSDoc comments
-3. Include usage examples
-4. Update this README with new types
-5. Ensure all types are exported from the main index file
+- **@mapples/render** – Data props and condition-based visibility
+- **@mapples/form** – Field bindings and conditional logic
+- **@mapples/ui** – Component props and layout hints
 
 ## License
 
 MIT
+
+## Author
+
+Oleksandr Soloviov – [mapples.org](https://mapples.org/people/olek_soloviov)

package/dist/constants.d.ts

@@ -1,4 +1,7 @@
+/** Separator used in "this", dim, and condition strings. @public */
 export declare const FN_SEPARATOR = "::";
+/** Prefix for data-context reference (entire state). @public */
 export declare const DATA_THIS = "(this)";
+/** Separator for object paths (e.g. user.name). @public */
 export declare const DOT_SEPARATOR = ".";
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,OAAO,CAAC;AACjC,eAAO,MAAM,SAAS,WAAW,CAAC;AAClC,eAAO,MAAM,aAAa,MAAM,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,eAAO,MAAM,YAAY,OAAO,CAAC;AAEjC,gEAAgE;AAChE,eAAO,MAAM,SAAS,WAAW,CAAC;AAElC,2DAA2D;AAC3D,eAAO,MAAM,aAAa,MAAM,CAAC"}

package/dist/constants.js

@@ -1,4 +1,7 @@
+/** Separator used in "this", dim, and condition strings. @public */
 export const FN_SEPARATOR = '::';
+/** Prefix for data-context reference (entire state). @public */
 export const DATA_THIS = '(this)';
+/** Separator for object paths (e.g. user.name). @public */
 export const DOT_SEPARATOR = '.';
 //# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC;AACjC,MAAM,CAAC,MAAM,SAAS,GAAG,QAAQ,CAAC;AAClC,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC;AAEjC,gEAAgE;AAChE,MAAM,CAAC,MAAM,SAAS,GAAG,QAAQ,CAAC;AAElC,2DAA2D;AAC3D,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC"}

package/dist/dims.d.ts

@@ -1,5 +1,14 @@
+/** Dimension axis: width or height. @public */
 export type DimType = 'width' | 'height';
+/** Parsed dimension: [axis, multiplier 0..1]. @public */
 export type Dims = [DimType, number];
+/** Allowed dimension string keys. @public */
 export type DimsString = 'w' | 'h' | 'width' | 'height';
+/**
+ * Parses a dimension string like `"w::50"` or `"height::100"` into [type, 0..1].
+ * @param dim - Quoted string e.g. `"w::50"` (50% width), `"height"` (100% height)
+ * @returns Tuple [DimType, number] or null if format is invalid
+ * @public
+ */
 export declare const parseDims: (dim: string) => Dims | null;
 //# sourceMappingURL=dims.d.ts.map

package/dist/dims.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dims.d.ts","sourceRoot":"","sources":["../src/dims.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;AACzC,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AACrC,MAAM,MAAM,UAAU,GAAG,GAAG,GAAG,GAAG,GAAG,OAAO,GAAG,QAAQ,CAAC;AASxD,eAAO,MAAM,SAAS,GAAI,KAAK,MAAM,KAAG,IAAI,GAAG,IAS9C,CAAC"}
+{"version":3,"file":"dims.d.ts","sourceRoot":"","sources":["../src/dims.ts"],"names":[],"mappings":"AAIA,+CAA+C;AAC/C,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEzC,yDAAyD;AACzD,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAErC,6CAA6C;AAC7C,MAAM,MAAM,UAAU,GAAG,GAAG,GAAG,GAAG,GAAG,OAAO,GAAG,QAAQ,CAAC;AASxD;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,KAAK,MAAM,KAAG,IAAI,GAAG,IAS9C,CAAC"}

package/dist/dims.js

@@ -1,14 +1,20 @@
 import { FN_SEPARATOR } from './constants';
-const dimRegExp = new RegExp(`^"(w|h|width|height)(${FN_SEPARATOR}\\d+)?"$`);
+const dimRegExp = new RegExp(`^(w|h|width|height)(${FN_SEPARATOR}\\d+)?$`);
 const mapDimsType = {
     w: 'width',
     h: 'height',
     width: 'width',
     height: 'height',
 };
+/**
+ * Parses a dimension string like `"w::50"` or `"height::100"` into [type, 0..1].
+ * @param dim - Quoted string e.g. `"w::50"` (50% width), `"height"` (100% height)
+ * @returns Tuple [DimType, number] or null if format is invalid
+ * @public
+ */
 export const parseDims = (dim) => {
     if (dimRegExp.test(dim)) {
-        const [type, percent] = dim.slice(1, -1).split(FN_SEPARATOR);
+        const [type, percent] = dim.split(FN_SEPARATOR);
         const value = parseInt(percent || '', 10);
         return [mapDimsType[type], !isNaN(value) ? value / 100 : 1];
     }

package/dist/dims.js.map

@@ -1 +1 @@
-{"version":3,"file":"dims.js","sourceRoot":"","sources":["../src/dims.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,SAAS,GAAG,IAAI,MAAM,CAAC,wBAAwB,YAAY,UAAU,CAAC,CAAC;AAM7E,MAAM,WAAW,GAAG;IAClB,CAAC,EAAE,OAAO;IACV,CAAC,EAAE,QAAQ;IACX,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;CACR,CAAC;AAEX,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,GAAW,EAAe,EAAE;IACpD,IAAI,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC7D,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAE1C,OAAO,CAAC,WAAW,CAAC,IAAkB,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAC"}
+{"version":3,"file":"dims.js","sourceRoot":"","sources":["../src/dims.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,SAAS,GAAG,IAAI,MAAM,CAAC,uBAAuB,YAAY,SAAS,CAAC,CAAC;AAW3E,MAAM,WAAW,GAAG;IAClB,CAAC,EAAE,OAAO;IACV,CAAC,EAAE,QAAQ;IACX,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;CACR,CAAC;AAEX;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,GAAW,EAAe,EAAE;IACpD,IAAI,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAE1C,OAAO,CAAC,WAAW,CAAC,IAAkB,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,11 @@
+/**
+ * @packageDocumentation
+ * @module @mapples/inlang
+ *
+ * Internal language utilities for the Mapples Open Kit: parsing and evaluation
+ * of "this" references, dimension strings, and condition strings used across
+ * data bindings, visibility conditions, and layout.
+ */
 export * from './this';
 export * from './state';
 export * from './dims';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -1,3 +1,11 @@
+/**
+ * @packageDocumentation
+ * @module @mapples/inlang
+ *
+ * Internal language utilities for the Mapples Open Kit: parsing and evaluation
+ * of "this" references, dimension strings, and condition strings used across
+ * data bindings, visibility conditions, and layout.
+ */
 export * from './this';
 export * from './state';
 export * from './dims';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC"}

package/dist/state/conditions.d.ts

@@ -1,5 +1,8 @@
 import { ConditionFunc, Conditions } from './types';
+/** Equality condition: (a, b) => a === b. @public */
 export declare const eq: ConditionFunc;
+/** Not-equals condition: (a, b) => a !== b. @public */
 export declare const notEq: ConditionFunc;
+/** Map from Conditions enum to evaluator functions. @public */
 export declare const conditionMap: Record<Conditions, ConditionFunc>;
 //# sourceMappingURL=conditions.d.ts.map

package/dist/state/conditions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conditions.d.ts","sourceRoot":"","sources":["../../src/state/conditions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEpD,eAAO,MAAM,EAAE,EAAE,aAAiC,CAAC;AACnD,eAAO,MAAM,KAAK,EAAE,aAAiC,CAAC;AAEtD,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,UAAU,EAAE,aAAa,CAG1D,CAAC"}
+{"version":3,"file":"conditions.d.ts","sourceRoot":"","sources":["../../src/state/conditions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEpD,qDAAqD;AACrD,eAAO,MAAM,EAAE,EAAE,aAAiC,CAAC;AAEnD,uDAAuD;AACvD,eAAO,MAAM,KAAK,EAAE,aAAiC,CAAC;AAEtD,+DAA+D;AAC/D,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,UAAU,EAAE,aAAa,CAG1D,CAAC"}

package/dist/state/conditions.js

@@ -1,6 +1,9 @@
 import { Conditions } from './types';
+/** Equality condition: (a, b) => a === b. @public */
 export const eq = (a, b) => a === b;
+/** Not-equals condition: (a, b) => a !== b. @public */
 export const notEq = (a, b) => a !== b;
+/** Map from Conditions enum to evaluator functions. @public */
 export const conditionMap = {
     [Conditions.equals]: eq,
     [Conditions.notEquals]: notEq,

package/dist/state/conditions.js.map

@@ -1 +1 @@
-{"version":3,"file":"conditions.js","sourceRoot":"","sources":["../../src/state/conditions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,UAAU,EAAE,MAAM,SAAS,CAAC;AAEpD,MAAM,CAAC,MAAM,EAAE,GAAkB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;AACnD,MAAM,CAAC,MAAM,KAAK,GAAkB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;AAEtD,MAAM,CAAC,MAAM,YAAY,GAAsC;IAC7D,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,EAAE;IACvB,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,KAAK;CAC9B,CAAC"}
+{"version":3,"file":"conditions.js","sourceRoot":"","sources":["../../src/state/conditions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,UAAU,EAAE,MAAM,SAAS,CAAC;AAEpD,qDAAqD;AACrD,MAAM,CAAC,MAAM,EAAE,GAAkB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;AAEnD,uDAAuD;AACvD,MAAM,CAAC,MAAM,KAAK,GAAkB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;AAEtD,+DAA+D;AAC/D,MAAM,CAAC,MAAM,YAAY,GAAsC;IAC7D,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,EAAE;IACvB,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,KAAK;CAC9B,CAAC"}

package/dist/state/regexp.d.ts

@@ -1,2 +1,7 @@
+/**
+ * Regex to split condition strings on `::` while respecting quoted segments.
+ * Used so values like `"a::b"` are not split on the inner `::`.
+ * @public
+ */
 export declare const ConditionStringRegExp: RegExp;
 //# sourceMappingURL=regexp.d.ts.map

package/dist/state/regexp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"regexp.d.ts","sourceRoot":"","sources":["../../src/state/regexp.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,QAAkC,CAAC"}
+{"version":3,"file":"regexp.d.ts","sourceRoot":"","sources":["../../src/state/regexp.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,QAAkC,CAAC"}

package/dist/state/regexp.js

@@ -1,2 +1,7 @@
+/**
+ * Regex to split condition strings on `::` while respecting quoted segments.
+ * Used so values like `"a::b"` are not split on the inner `::`.
+ * @public
+ */
 export const ConditionStringRegExp = /::(?=(?:[^"]*"[^"]*")*[^"]*$)/;
 //# sourceMappingURL=regexp.js.map

package/dist/state/regexp.js.map

@@ -1 +1 @@
-{"version":3,"file":"regexp.js","sourceRoot":"","sources":["../../src/state/regexp.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG,+BAA+B,CAAC"}
+{"version":3,"file":"regexp.js","sourceRoot":"","sources":["../../src/state/regexp.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,+BAA+B,CAAC"}

package/dist/state/utils.d.ts

@@ -1,5 +1,18 @@
 import { BoolCondition, ParseConditionResult, SimpleCondition } from './types';
+/**
+ * Joins values with FN_SEPARATOR to build a condition string.
+ * @param values - Parts to join (e.g. dataProp, condition, value)
+ * @returns Single string with `::` between parts
+ * @public
+ */
 export declare const toConditionString: (...values: string[]) => string;
+/**
+ * Splits a condition string into parts; valueType is defaulted to 'string'.
+ * For full parsing (booleans, quoted types, dataProp) use parseCondition.
+ * @param value - Raw condition string
+ * @returns ParseConditionResult with valueType 'string'
+ * @public
+ */
 export declare const parseConditionString: (value: string) => ParseConditionResult;
 /**
  * Parses a condition string into its component parts.
@@ -89,5 +102,11 @@ export declare const toBool: (value: string | boolean) => boolean;
  * @public
  */
 export declare const toNumber: (value: string | boolean) => number;
+/**
+ * Splits a multi-key string by `;` and strips newlines. Used for data-prop keys that join multiple paths.
+ * @param key - Optional string (e.g. "user.name;user.email; ")
+ * @returns Array of segments, or undefined if key is undefined
+ * @public
+ */
 export declare const parseJoin: (key?: string) => string[] | undefined;
 //# sourceMappingURL=utils.d.ts.map

package/dist/state/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/state/utils.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,aAAa,EAEb,oBAAoB,EACpB,eAAe,EAEhB,MAAM,SAAS,CAAC;AAWjB,eAAO,MAAM,iBAAiB,GAAI,GAAG,QAAQ,MAAM,EAAE,WAEpD,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,OAAO,MAAM,KAAG,oBAWpD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,cAAc,GACzB,OAAO,eAAe,GAAG,aAAa,KACrC,oBAgCF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,eAKrD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,MAAM,GAAI,OAAO,MAAM,GAAG,OAAO,YAI7C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,MAAM,GAAG,OAAO,WAU/C,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,yBAErC,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/state/utils.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,aAAa,EAEb,oBAAoB,EACpB,eAAe,EAEhB,MAAM,SAAS,CAAC;AAWjB;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,GAAG,QAAQ,MAAM,EAAE,WAEpD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,OAAO,MAAM,KAAG,oBAWpD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,cAAc,GACzB,OAAO,eAAe,GAAG,aAAa,KACrC,oBAgCF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,eAKrD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,MAAM,GAAI,OAAO,MAAM,GAAG,OAAO,YAI7C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,MAAM,GAAG,OAAO,WAU/C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,yBAErC,CAAC"}

package/dist/state/utils.js

@@ -8,9 +8,22 @@ const mapTypes = {
     number: 'number',
     boolean: 'boolean',
 };
+/**
+ * Joins values with FN_SEPARATOR to build a condition string.
+ * @param values - Parts to join (e.g. dataProp, condition, value)
+ * @returns Single string with `::` between parts
+ * @public
+ */
 export const toConditionString = (...values) => {
     return values.join(FN_SEPARATOR);
 };
+/**
+ * Splits a condition string into parts; valueType is defaulted to 'string'.
+ * For full parsing (booleans, quoted types, dataProp) use parseCondition.
+ * @param value - Raw condition string
+ * @returns ParseConditionResult with valueType 'string'
+ * @public
+ */
 export const parseConditionString = (value) => {
     const [dataProp, condition, valueProp] = value
         .trim()
@@ -152,6 +165,12 @@ export const toNumber = (value) => {
         return 0;
     return numValue;
 };
+/**
+ * Splits a multi-key string by `;` and strips newlines. Used for data-prop keys that join multiple paths.
+ * @param key - Optional string (e.g. "user.name;user.email; ")
+ * @returns Array of segments, or undefined if key is undefined
+ * @public
+ */
 export const parseJoin = (key) => {
     return key?.replace(/\n/g, '').split(';');
 };

package/dist/state/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/state/utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/state/utils.ts"],"names":[],"mappings":"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"}

package/dist/this.d.ts

@@ -1,6 +1,34 @@
+/**
+ * Tuple for parsed action/context "this" reference: `['this', optionalIndex]`.
+ * @public
+ */
 export type This = ['this', string?];
+/**
+ * Returns whether the string matches an action "this" reference: `"this"` or `"this::n"`.
+ * @param value - String to test (e.g. from config)
+ * @returns True if the value is a quoted "this" or "this::n" reference
+ * @public
+ */
 export declare const isThis: (value?: string) => boolean;
+/**
+ * Returns whether the string is a data-context reference starting with `(this)`.
+ * @param value - String to test
+ * @returns True if the value starts with DATA_THIS
+ * @public
+ */
 export declare const isDataThis: (value?: string) => boolean | undefined;
+/**
+ * Strips the `(this)` prefix and splits the rest by dot into path segments.
+ * @param value - Full data-this string (e.g. `(this).user.name`)
+ * @returns Array of path segments
+ * @public
+ */
 export declare const parseDataThis: (value: string) => string[];
+/**
+ * Parses a quoted "this" or "this::n" string into a This tuple.
+ * @param value - Quoted string (e.g. `"this"` or `"this::2"`)
+ * @returns `['this']` or `['this', n]`; if value is falsy returns `['this']`
+ * @public
+ */
 export declare const parseThis: (value?: string) => This;
 //# sourceMappingURL=this.d.ts.map

package/dist/this.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"this.d.ts","sourceRoot":"","sources":["../src/this.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAErC,eAAO,MAAM,MAAM,GAAI,QAAQ,MAAM,YAEpC,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,QAAQ,MAAM,wBAExC,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,aAE1C,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,QAAQ,MAAM,KAAG,IAE1C,CAAC"}
+{"version":3,"file":"this.d.ts","sourceRoot":"","sources":["../src/this.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAErC;;;;;GAKG;AACH,eAAO,MAAM,MAAM,GAAI,QAAQ,MAAM,YAEpC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAAI,QAAQ,MAAM,wBAExC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,aAE1C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,QAAQ,MAAM,KAAG,IAE1C,CAAC"}

package/dist/this.js

@@ -1,14 +1,38 @@
 import { DATA_THIS, DOT_SEPARATOR, FN_SEPARATOR } from './constants';
 const actionThisRegExp = new RegExp(`^"this(${FN_SEPARATOR}\\d+)?"$`);
+/**
+ * Returns whether the string matches an action "this" reference: `"this"` or `"this::n"`.
+ * @param value - String to test (e.g. from config)
+ * @returns True if the value is a quoted "this" or "this::n" reference
+ * @public
+ */
 export const isThis = (value) => {
     return actionThisRegExp.test(value || '');
 };
+/**
+ * Returns whether the string is a data-context reference starting with `(this)`.
+ * @param value - String to test
+ * @returns True if the value starts with DATA_THIS
+ * @public
+ */
 export const isDataThis = (value) => {
     return value?.startsWith(DATA_THIS);
 };
+/**
+ * Strips the `(this)` prefix and splits the rest by dot into path segments.
+ * @param value - Full data-this string (e.g. `(this).user.name`)
+ * @returns Array of path segments
+ * @public
+ */
 export const parseDataThis = (value) => {
     return value.replace(DATA_THIS, '').split(DOT_SEPARATOR);
 };
+/**
+ * Parses a quoted "this" or "this::n" string into a This tuple.
+ * @param value - Quoted string (e.g. `"this"` or `"this::2"`)
+ * @returns `['this']` or `['this', n]`; if value is falsy returns `['this']`
+ * @public
+ */
 export const parseThis = (value) => {
     return value ? value.slice(1, -1).split(FN_SEPARATOR) : ['this'];
 };

package/dist/this.js.map

@@ -1 +1 @@
-{"version":3,"file":"this.js","sourceRoot":"","sources":["../src/this.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAErE,MAAM,gBAAgB,GAAG,IAAI,MAAM,CAAC,UAAU,YAAY,UAAU,CAAC,CAAC;AAItE,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,KAAc,EAAE,EAAE;IACvC,OAAO,gBAAgB,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;AAC5C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAc,EAAE,EAAE;IAC3C,OAAO,KAAK,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAa,EAAE,EAAE;IAC7C,OAAO,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;AAC3D,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAc,EAAQ,EAAE;IAChD,OAAO,KAAK,CAAC,CAAC,CAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAC7E,CAAC,CAAC"}
+{"version":3,"file":"this.js","sourceRoot":"","sources":["../src/this.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAErE,MAAM,gBAAgB,GAAG,IAAI,MAAM,CAAC,UAAU,YAAY,UAAU,CAAC,CAAC;AAQtE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,KAAc,EAAE,EAAE;IACvC,OAAO,gBAAgB,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;AAC5C,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAc,EAAE,EAAE;IAC3C,OAAO,KAAK,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAa,EAAE,EAAE;IAC7C,OAAO,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;AAC3D,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAc,EAAQ,EAAE;IAChD,OAAO,KAAK,CAAC,CAAC,CAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAC7E,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mapples/inlang",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {