@e-llm-studio/instant-learning 1.3.0-alpha.24 → 1.3.0-alpha.240

package/README.md

@@ -1,7 +1,550 @@
 # Instant Learning Library
 
+## Usage & Integration
+
+The library exposes two independently consumable components:
+
+- **`LearningManagement`** — renders the full Learning Management screen (scope tree, learnings, access, change history).
+- **`TeachMePlugin`** — renders the *Teach Me* popup, an AI-assisted rule/learning creation interface. Can be mounted on its own, anywhere.
+
+Install:
+
+```bash
+npm install @e-llm-studio/instant-learning
+```
+
+---
+
+### 1. `LearningManagement`
+
+Renders the Learning Management screen. It uses `@tanstack/react-query` internally, so it **must be wrapped in a `QueryClientProvider`** by the consumer.
+
+#### Import & sample usage
+
+```tsx
+import LearningManagement from '@e-llm-studio/instant-learning';
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+
+const queryClient = new QueryClient();
+
+function App() {
+  return (
+    <QueryClientProvider client={queryClient}>
+      <LearningManagement
+        userDetails={userDetails}                 // logged-in user + access token
+        llmStudioUrl="https://devllmstudio.creativeworkspace.ai"
+        audacyBackendUrl="https://dev-audacy-traffic-manager.techo.camp"
+        config={config}                           // runtime config (BASE_URL, ASSISTANT_NAME, …)
+        rbacConfig={rbacConfig}                   // RBAC / AppSec identifiers
+        auditLogConfig={{ configId: '6a1825e9fb722c37637b9490' }}
+        ilLabels={{
+          setupLabel: 'Learning Setup',
+          ruleTitle: 'Learning Title',
+          ruleDescriptionTitle: 'Learning Description',
+        }}
+        app_integration_id="019eb639-8eca-715a-95c1-efe0ee237ecc"
+        backwardCompatibility={false}
+        cognitiveCompareCompatibility={false}
+        modeDetails={{
+          activeModeName: 'Instant Learning Mode',
+          modeNameFromURL: 'Instant Learning Mode',
+          submodeNameFromURL: '',
+        }}
+      />
+    </QueryClientProvider>
+  );
+}
+```
+
+#### Props
+
+| Prop | Type | Required | Description |
+|---|---|:---:|---|
+| `userDetails` | `User` | ✅ | Logged-in user object. Must include `accessToken` (used for all API calls and as the GraphQL `userDetails` param). |
+| `llmStudioUrl` | `string` | ✅ | Base URL of LLM Studio; used for tiers, IL instance, and rule APIs. |
+| `audacyBackendUrl` | `string` | ✅ | Base URL of the client/product backend. |
+| `config` | `object` (`any`) | ✅ | Runtime config consumed by the rule-creation flow (`BASE_URL`, `BASE_WEBSOCKET_URL`, `ASSISTANT_NAME`, `ORGANIZATION_NAME`, `CHAT_TITLE`, `SOCKET_TIMEOUT`, etc.). |
+| `rbacConfig` | `RbacConfig` | ✅ | RBAC/AppSec identifiers: `applicationName`, `applicationId`, `moduleId`, `applicationModuleId`, `applicationResourceId`, `appsecRbacUrl`, `appsecBaseUrl`. Drives permission resolution. |
+| `auditLogConfig` | `AuditLogConfig` | ✅ | Audit log config — `{ configId: string }`. |
+| `ilLabels` | `{ setupLabel; ruleTitle; ruleDescriptionTitle }` | ✅ | Label overrides for the rule setup form (all three strings required). |
+| `app_integration_id` | `string` | ⚠️ Optional* | Integration context used to load the per-integration remote JSON config (`dt()`/`dtt()` values) and scoped API calls. *Effectively required in non-backward-compat mode — without it the remote config won't load. |
+| `backwardCompatibility` | `boolean` | ❌ Optional | Enables legacy mode (legacy create modal, legacy inherit API). Default `false`. |
+| `cognitiveCompareCompatibility` | `boolean` | ❌ Optional | Enables cognitive-compare behavior. Default `false`. |
+| `modeId` | `string` | ❌ Optional | Mode identifier passed through to the layout / rule content. |
+| `modeDetails` | `{ activeModeName; modeNameFromURL; submodeNameFromURL }` | ❌ Optional | Active mode metadata used for base-mode naming. |
+
+> **Note:** When `backwardCompatibility={false}`, the screen reads its labels/dialogs from the remote config resolved via `app_integration_id` using the `dt()` helper. Missing keys fall back to built-in defaults.
+
+---
+
+### 2. `TeachMePlugin`
+
+Renders the AI-assisted *Teach Me* rule-creation popup. Unlike `LearningManagement`, it **provides its own `QueryClientProvider` internally** — no extra wrapper needed.
+
+#### Import & sample usage
+
+```tsx
+import TeachMePlugin from '@e-llm-studio/instant-learning';
+
+// Required config fields for TeachMePlugin
+const configuration = {
+  BASE_URL: 'https://devllmstudio.creativeworkspace.ai',
+  BASE_WEBSOCKET_URL: 'wss://devllmstudio.creativeworkspace.ai/graphql',
+  ORGANIZATION_NAME: 'techolution',
+  ASSISTANT_NAME: 'preview',
+};
+
+function CreateLearningButton({ open, setOpen, token }) {
+  return (
+    <TeachMePlugin
+      app_integration_id="019ecbcf-98c9-71bb-a663-ea962085c118"
+      isOpen={open}
+      onClose={() => setOpen(false)}
+      token={token}                 // bearer token for API calls
+      mode="ADD"                    // "ADD" | "EDIT"
+      config={configuration}        // required runtime config (see table below)
+      pluginPayload={{
+        initialScope: 'global',     // {scope} value for titles
+        ruleSet: selectedRuleSet,   // optional ruleset context
+        // renderer-specific context (Radio Traffic, etc.):
+        editingRule: null,
+        editingTier: null,
+        editingVariants: null,
+        // optionally inline the config instead of remote-loading:
+        // teachMe: { teachMe, template, learningManagement, agents },
+        // tiers: [...],
+      }}
+    />
+  );
+}
+```
+
+#### Props
+
+| Prop | Type | Required | Description |
+|---|---|:---:|---|
+| `isOpen` | `boolean` | ✅ | Controls popup visibility. |
+| `onClose` | `() => void` | ✅ | Called when the dialog requests to close. |
+| `token` | `string` | ✅ | Bearer token for API calls. |
+| `mode` | `"ADD" \| "EDIT"` | ✅ | Whether the popup is creating a new learning or editing an existing one. |
+| `config` | `object` | ✅ | Runtime config for the chat/socket. See [required `config` fields](#config-fields) below. |
+| `app_integration_id` | `string` | ⚠️ Optional* | Resolves the correct renderer template and remote config. *Optional only in backward-compat mode; otherwise required to load the template/config. |
+| `pluginPayload` | `Record<string, any>` | ❌ Optional | Free-form data passed straight through to the active renderer. Recognized keys: `initialScope` (`{scope}` value), `ruleSet`, `tiers` (sets tiers directly), and `teachMe` (`{ teachMe, template, learningManagement, agents }` to inline config instead of remote-loading). Any other keys are forwarded to the renderer (e.g. `editingRule`, `editingTier`, `editingVariants`, `focusedVariantIndex`, `triggerAddVariant`, `triggerFixGaps`, `copiedRule`, `initialDraftMessage`, `modeId`). |
+
+<a id="config-fields"></a>
+**Required `config` fields**
+
+| Field | Type | Required | Description |
+|---|---|:---:|---|
+| `BASE_URL` | `string` | ✅ | LLM Studio base URL; used for the chat/REST calls. |
+| `BASE_WEBSOCKET_URL` | `string` | ✅ | WebSocket (GraphQL) endpoint used by the live chat. |
+| `ORGANIZATION_NAME` | `string` | ✅ | Organization identifier for the assistant. |
+| `ASSISTANT_NAME` | `string` | ✅ | Name of the assistant that powers the Teach Me flow. |
+
+```ts
+const configuration = {
+  BASE_URL: 'https://devllmstudio.creativeworkspace.ai',
+  BASE_WEBSOCKET_URL: 'wss://devllmstudio.creativeworkspace.ai/graphql',
+  ORGANIZATION_NAME: 'techolution',
+  ASSISTANT_NAME: 'preview',
+};
+```
+
+> **Template resolution:** The renderer is chosen from the `template` key (in `pluginPayload.teachMe.template` or the remote config) via `TemplateRegistry`. Unknown values fall back to `"Default"`. See the v17 changelog entry below for the registry and full config JSON.
+
+---
+
+## Configuration Reference
+
+Both `LearningManagement` and `TeachMePlugin` are **fully label-driven**. The UI text — titles, buttons, dialog copy, placeholders — comes from a JSON config loaded per `appIntegrationId` (or passed inline via `pluginPayload.teachMe`). Values are resolved at runtime with the `dt()` (LMS) and `dtt()` (TeachMe) helpers; any missing key falls back to a built-in default, so you only need to override what you want to change.
+
+### Top-level structure
+
+```json
+{
+  "template": "Default",
+  "agents": { "LearningTerm": "Instruction" },
+  "teachMe": { "...": "TeachMe popup labels" },
+  "learningManagement": { "...": "Learning Management screen labels" }
+}
+```
+
+| Key | Type | Required | Description |
+|---|---|:---:|---|
+| `template` | `string` | ✅ | Renderer key. **Must** be present for any customisation to apply; must match a `TemplateRegistry` key (`"Default"`, `"Radio Traffic Learning"`, `"Guidelines"`, …). Unknown values fall back to `"Default"`. |
+| `agents.LearningTerm` | `string` | ❌ | Word used for a "learning" across the UI (e.g. `"Instruction"`, `"Guideline"`). |
+| `teachMe` | `object` | ❌ | Labels for the Teach Me popup. See [`teachMe` fields](#teachme-fields). |
+| `learningManagement` | `object` | ❌ | Labels for the Learning Management screen (maps to `LMSConfig`). See [`learningManagement` fields](#learningmanagement-fields). |
+
+Placeholders supported in values: `{scope}` / `{scope_name}` / `{parent}` (names), `{count}` / `{N}` (counts), `{variant_name}` (approve/reject dialogs), `{rule_title}` (enable/disable dialogs). They are interpolated at runtime.
+
+<details>
+<summary><strong>📋 Full config JSON (copy-paste starter)</strong> — click to expand</summary>
+
+```json
+{
+  "template": "Default",
+  "agents": {
+    "LearningTerm": "Instruction"
+  },
+  "teachMe": {
+    "welcomeMessage": "Hi! 👋 I'm your Instant Learning Concierge.",
+    "welcomeMessageSubtitle": "I can help you create and manage instructions.\nSelect an option below or type your requirement.",
+    "actions": [
+      { "label": "Add new instruction",  "value": "I would want to add a new Instruction" },
+      { "label": "Update an instruction", "value": "I would want to edit an existing instruction" }
+    ],
+    "chatTitle": "Teach Me ILOTJ - {scope} - Add Instruction",
+    "chatTitleEdit": "Teach Me ILOTJ - {scope} - Edit Instruction",
+    "chatTextareaPlaceholder": "Tell me about the instruction you want to create",
+    "formTitle": "Add Instruction",
+    "setupLabel": "Configure your IL",
+    "ruleTitle": "Main Instruction Name",
+    "scopeLabel": "Define Scope",
+    "tierLabel": "Select Tiers",
+    "ruleDescriptionTitle": "Explanation of the instruction",
+    "whenToApplyTitle": "Trigger Events (When to Apply)",
+    "addWhenToApplyBtnLabel": "Add WTA",
+    "whenNotToApplyTitle": "Exclusion Events (When NOT to Apply)",
+    "addWhenNotToApplyBtnLabel": "Add WNTA",
+    "configTitle": "Advanced Settings",
+    "saveBtnLabel": "Save Instruction",
+    "saveBtnLoadingLabel": "Saving Instruction...",
+    "showScope": false,
+    "showConfiguration": false
+  },
+  "learningManagement": {
+    "pageTitle": "Instruction Management",
+    "middleDrawer": {
+      "scope": "Scope",
+      "addScope": "Add Scope",
+      "addSubScope": "Add Subscope",
+      "subScope": "Subscope",
+      "treeMenu": {
+        "search": "Search for scopes",
+        "submenu": {
+          "learnings": "Instructions",
+          "access": "Access",
+          "changeHistory": "Change History"
+        },
+        "contextMenu": {
+          "addScope": "Add Scope",
+          "rename": "Rename",
+          "delete": "Delete {scope}",
+          "addSubScope": "Add SubScope"
+        }
+      },
+      "addScopeDialog": {
+        "title": "Add Scope",
+        "globalTitle": "Add Global Scope",
+        "subScopeTitle": "Add Subscope",
+        "subtitle": "This scope will be created under {parent} and will inherit its Learnings by default.",
+        "globalSubtitle": "This global scope defines base learnings that apply across all scopes.",
+        "subScopeSubtitle": "This subscope will be created under {parent} and will inherit its Learnings by default.",
+        "scopeName": "Scope Name",
+        "submitButton": "Create Scope",
+        "cancel": "Cancel",
+        "learningApprovalSettings": {
+          "title": "Instruction Approval Settings",
+          "approvalRequired": {
+            "title": "Approval Required before Publishing",
+            "subtitle": "Learnings require approval before publishing"
+          },
+          "publishWithoutApproval": {
+            "title": "Publish Without Approval",
+            "subtitle": "Instructions can be published directly"
+          }
+        }
+      },
+      "scopeDisplayLimit": {
+        "enabled": "true",
+        "count": "3",
+        "compactView": "true",
+        "applyToLevels": "",
+        "viewMoreText": "show {count} more...",
+        "title": "Stations",
+        "description": "Manage the stations assigned to the {scope} scope.",
+        "searchPlaceholder": "Search station...",
+        "onboardBtn": "Onboard a station",
+        "viewText": "View"
+      }
+    },
+    "learnings": {
+      "header": {
+        "title": "{scope} Instructions",
+        "exportButton": "Export",
+        "addNewLearningButton": "Add New Instruction"
+      },
+      "tier": {
+        "showTierHeader": true,
+        "tierHeader": "Tier",
+        "subtitle": "These are the system-wide instructions applied across all documents.",
+        "tierHeaderNoOfLearnings": "Instructions",
+        "deleteDialog": {
+          "title": "Delete Tier {N}?",
+          "description": "This will permanently delete all rules and variants under this tier, including any inherited rules. This action cannot be undone.",
+          "cancel": "Cancel",
+          "submit": "Yes, Delete"
+        },
+        "learning": {
+          "inheritance": "Inheritance",
+          "actions": {
+            "disable": "Disable",
+            "enable": "Enable",
+            "approve": "Approve All",
+            "reject": "Reject All",
+            "delete": "Delete"
+          },
+          "approveDialog": {
+            "title": "Approve Guideline",
+            "desc": "{variant_name} will be published and become active within the selected scope after approval.",
+            "footer": "Take a moment to check the configuration before moving forward.",
+            "cancel": "Cancel",
+            "approveLearning": "Approve Guideline"
+          },
+          "rejectDialog": {
+            "title": "Reject Guideline",
+            "desc": "{variant_name} will not be published or applied within the selected scope. You can provide feedback before rejecting.",
+            "feedbackTitle": "Feedback",
+            "feedbackPlaceholder": "Add feedback or reason for rejection",
+            "deleteCheckboxLabel": "Also delete this guideline",
+            "cancel": "Cancel",
+            "rejectLearning": "Reject Guideline"
+          },
+          "deleteDialog": {
+            "title": "Delete",
+            "desc": "Are you sure you want to delete this rule? This action cannot be undone.",
+            "warningText": "This will permanently delete the rule configuration.",
+            "cancelText": "Cancel",
+            "deleteText": "Delete"
+          }
+        }
+      }
+    },
+    "emptyStateLearning": {
+      "title": "No instructions have been added !",
+      "desc": "Start by adding instructions that should apply across all documents.",
+      "createNewLearning": "Create New Instruction",
+      "createGlobalScope": "Create Global Scope",
+      "noAccessTitle": "Access Restricted",
+      "noAccessDesc": "You do not have access for this application.",
+      "requestAccessButton": "Request Access",
+      "requestSentButton": "Request Sent"
+    }
+  }
+}
+```
+
+</details>
+
+---
+
+### `teachMe` fields
+
+Drives the LHS of the Teach Me popup (greeting, quick actions, form labels). Resolved via `dtt()`.
+
+```json
+"teachMe": {
+  "welcomeMessage": "Hi! 👋 I'm your Instant Learning Concierge.",
+  "welcomeMessageSubtitle": "I can help you create and manage instructions.\nSelect an option below or type your requirement.",
+  "actions": [
+    { "label": "Add new instruction",   "value": "I would want to add a new Instruction" },
+    { "label": "Update an instruction",  "value": "I would want to edit an existing instruction" }
+  ],
+  "chatTitle": "Teach Me ILOTJ - {scope} - Add Instruction",
+  "chatTitleEdit": "Teach Me ILOTJ - {scope} - Edit Instruction",
+  "chatTextareaPlaceholder": "Tell me about the instruction you want to create",
+  "formTitle": "Add Instruction",
+  "setupLabel": "Configure your IL",
+  "ruleTitle": "Main Instruction Name",
+  "scopeLabel": "Define Scope",
+  "tierLabel": "Select Tiers",
+  "ruleDescriptionTitle": "Explanation of the instruction",
+  "whenToApplyTitle": "Trigger Events (When to Apply)",
+  "addWhenToApplyBtnLabel": "Add WTA",
+  "whenNotToApplyTitle": "Exclusion Events (When NOT to Apply)",
+  "addWhenNotToApplyBtnLabel": "Add WNTA",
+  "configTitle": "Advanced Settings",
+  "saveBtnLabel": "Save Instruction",
+  "saveBtnLoadingLabel": "Saving Instruction...",
+  "showScope": false,
+  "showConfiguration": false
+}
+```
+
+| Field | Type | Description | Default |
+|---|---|---|---|
+| `welcomeMessage` | `string` | Primary greeting shown at the top of the chat. | `"Hi! 👋 I'm your Instant Learning Concierge."` |
+| `welcomeMessageSubtitle` | `string` | Subtitle under the greeting. Supports **Markdown** and `\n` line breaks. | `"How would you like to get started?…"` |
+| `actions` | `Array<{ label, value }>` | Quick-action buttons. `label` is the button text; `value` is the message sent to the agent when clicked. | 6 default actions |
+| `chatTitle` | `string` | Popup title in **Add** mode. Supports `{scope}`. | `"Teach Me OTJ - {scope} - Add Learning"` |
+| `chatTitleEdit` | `string` | Popup title in **Edit** mode. Supports `{scope}`. | `"Teach Me OTJ - {scope} - Edit Learning"` |
+| `chatTextareaPlaceholder` | `string` | Placeholder for the freeform chat textarea. | `"Tell me more about this learning.."` |
+| `formTitle` | `string` | Title of the inline rule form section. | `"Rule setup"` |
+| `setupLabel` | `string` | Label for the setup/configuration area. | `"Configure your IL"` |
+| `ruleTitle` | `string` | Label for the rule/learning name field. | `"Main Rule Name"` |
+| `scopeLabel` | `string` | Label for the scope selector. | `"Define Scope"` |
+| `tierLabel` | `string` | Label for the tier selector. | `"Select Tiers"` |
+| `ruleDescriptionTitle` | `string` | Label for the description field. | `"Learning Explanation"` |
+| `whenToApplyTitle` | `string` | Section title for trigger events. | `"Trigger Events (When to Apply)"` |
+| `addWhenToApplyBtnLabel` | `string` | Button to add a "when to apply" entry. | `"Add WTA"` |
+| `whenNotToApplyTitle` | `string` | Section title for exclusion events. | `"Exclusion Events (When NOT to Apply)"` |
+| `addWhenNotToApplyBtnLabel` | `string` | Button to add a "when NOT to apply" entry. | `"Add WNTA"` |
+| `configTitle` | `string` | Title for the advanced settings area. | `"Advanced Settings"` |
+| `saveBtnLabel` | `string` | Save button label. | `"Save Rule"` |
+| `saveBtnLoadingLabel` | `string` | Save button label while saving. | `"Saving Rule..."` |
+| `showScope` | `boolean` | Whether to show the scope selection section. | `false` |
+| `showConfiguration` | `boolean` | Whether to show the advanced configuration section. | `false` |
+
+---
+
+### `learningManagement` fields
+
+Maps to `LMSConfig` and drives the Learning Management screen. Resolved via `dt()`. Grouped below by area.
+
+#### Page & middle drawer
+
+```json
+"learningManagement": {
+  "pageTitle": "Instruction Management",
+  "middleDrawer": {
+    "scope": "Scope",
+    "addScope": "Add Scope",
+    "addSubScope": "Add Subscope",
+    "subScope": "Subscope",
+    "treeMenu": {
+      "search": "Search for scopes",
+      "submenu": { "learnings": "Instructions", "access": "Access", "changeHistory": "Change History" },
+      "contextMenu": { "addScope": "Add Scope", "rename": "Rename", "delete": "Delete {scope}", "addSubScope": "Add SubScope" }
+    },
+    "addScopeDialog": {
+      "title": "Add Scope",
+      "subtitle": "This scope will be created under {parent} and will inherit its Learnings by default.",
+      "scopeName": "Scope Name",
+      "submitButton": "Create Scope",
+      "cancel": "Cancel",
+      "learningApprovalSettings": {
+        "title": "Instruction Approval Settings",
+        "approvalRequired": { "title": "Approval Required before Publishing", "subtitle": "Learnings require approval before publishing" },
+        "publishWithoutApproval": { "title": "Publish Without Approval", "subtitle": "Instructions can be published directly" }
+      }
+    },
+    "scopeDisplayLimit": {
+      "enabled": "true",
+      "count": "3",
+      "compactView": "true",
+      "applyToLevels": "",
+      "viewMoreText": "show {count} more...",
+      "title": "Stations",
+      "description": "Manage the stations assigned to the {scope} scope.",
+      "searchPlaceholder": "Search station...",
+      "onboardBtn": "Onboard a station",
+      "viewText": "View"
+    }
+  }
+}
+```
+
+| Field (path under `middleDrawer`) | Type | Description |
+|---|---|---|
+| `pageTitle` *(sibling of middleDrawer)* | `string` | Title shown in the LMS header. |
+| `scope` | `string` | Heading word for the current scope. |
+| `addScope` / `addSubScope` / `subScope` | `string` | Labels for add-scope, add-subscope buttons and the subscope node. |
+| `treeMenu.search` | `string` | Placeholder for the scope-tree search input. |
+| `treeMenu.submenu.{learnings, access, changeHistory}` | `string` | Tree submenu labels. |
+| `treeMenu.contextMenu.{addScope, rename, delete, addSubScope}` | `string` | Right-click context-menu actions. `delete` supports `{scope}`. |
+| `addScopeDialog.title` / `globalTitle` / `subScopeTitle` | `string` | Dialog title for creating a scope / global scope / subscope. `subScopeTitle` is used when the dialog is opened with `childType="SUBSCOPE"`; falls back to `middleDrawer.addSubScope` if unset. |
+| `addScopeDialog.subtitle` / `globalSubtitle` / `subScopeSubtitle` | `string` | Dialog subtitle. Supports `{parent}`. |
+| `addScopeDialog.scopeName` / `subScopeName` | `string` | Label for the scope-name field / subscope-name field. `subScopeName` falls back to `middleDrawer.subScope + " Name"` if unset. |
+| `addScopeDialog.submitButton` / `cancel` | `string` | Dialog action buttons. |
+| `addScopeDialog.learningApprovalSettings.title` | `string` | Approval-settings section title. |
+| `…approvalRequired.{title, subtitle}` | `string` | Copy for the "approval required" option. |
+| `…publishWithoutApproval.{title, subtitle}` | `string` | Copy for the "publish without approval" option. |
+| `scopeDisplayLimit.enabled` | `string` (`"true"`/`"false"`) | Toggles the per-level display limit. |
+| `scopeDisplayLimit.count` | `string` (number) | How many items to show before collapsing. |
+| `scopeDisplayLimit.compactView` | `string` (`"true"`/`"false"`) | Enables compact rendering. |
+| `scopeDisplayLimit.applyToLevels` | `string` | JSON array of 1-indexed levels to limit, e.g. `"[1,2]"`. Empty = all levels. |
+| `scopeDisplayLimit.viewMoreText` | `string` | "See more" toggle text. Supports `{count}`. |
+| `scopeDisplayLimit.title` | `string` | Word substituted for "Stations" in headers. Supports `{scope}`. |
+| `scopeDisplayLimit.description` | `string` | Description under the Stations header. Supports `{scope}`. |
+| `scopeDisplayLimit.searchPlaceholder` | `string` | Station search placeholder. |
+| `scopeDisplayLimit.onboardBtn` | `string` | "Onboard a station" button label. |
+| `scopeDisplayLimit.viewText` | `string` | Per-station "View" button label. |
+
+#### Learnings, tiers & dialogs
+
+```json
+"learnings": {
+  "header": { "title": "{scope} Instructions", "exportButton": "Export", "addNewLearningButton": "Add New Instruction" },
+  "tier": {
+    "showTierHeader": true,
+    "tierHeader": "Tier",
+    "subtitle": "These are the system-wide instructions applied across all documents.",
+    "tierHeaderNoOfLearnings": "Instructions",
+    "deleteDialog": { "title": "Delete Tier {N}?", "description": "This will permanently delete all rules…", "cancel": "Cancel", "submit": "Yes, Delete" },
+    "learning": {
+      "inheritance": "Inheritance",
+      "actions": { "disable": "Disable", "enable": "Enable", "approve": "Approve All", "reject": "Reject All", "delete": "Delete" },
+      "approveDialog": { "title": "Approve Guideline", "desc": "{variant_name} will be published…", "footer": "Take a moment to check…", "cancel": "Cancel", "approveLearning": "Approve Guideline" },
+      "rejectDialog": { "title": "Reject Guideline", "desc": "{variant_name} will not be published…", "feedbackTitle": "Feedback", "feedbackPlaceholder": "Add feedback…", "deleteCheckboxLabel": "Also delete this guideline", "cancel": "Cancel", "rejectLearning": "Reject Guideline" },
+      "deleteDialog": { "title": "Delete", "desc": "Are you sure…", "warningText": "This will permanently delete…", "cancelText": "Cancel", "deleteText": "Delete" }
+    }
+  }
+}
+```
+
+| Field (path under `learnings`) | Type | Description |
+|---|---|---|
+| `header.title` | `string` | Learnings page title. Supports `{scope}`. |
+| `header.exportButton` | `string` | Export button label. |
+| `header.addNewLearningButton` | `string` | "Add new learning" button label. |
+| `tier.showTierHeader` | `boolean` | Whether the tier header region is shown. |
+| `tier.tierHeader` | `string` | Tier header title. |
+| `tier.subtitle` | `string` | Tier subtitle / description. |
+| `tier.tierHeaderNoOfLearnings` | `string` | Word for the learnings count label. |
+| `tier.deleteDialog.{title, description, cancel, submit}` | `string` | Bulk tier-delete dialog copy. `title` supports `{N}`. |
+| `tier.learning.inheritance` | `string` | Label for the inheritance indicator. |
+| `tier.learning.actions.{disable, enable, approve, reject, delete}` | `string` | Per-learning action labels. |
+| `tier.learning.approveDialog.{title, desc, footer, cancel, approveLearning}` | `string` | Approve dialog copy. `desc` supports `{variant_name}`. |
+| `tier.learning.rejectDialog.{title, desc, feedbackTitle, feedbackPlaceholder, deleteCheckboxLabel, cancel, rejectLearning}` | `string` | Reject dialog copy. `desc` supports `{variant_name}`. |
+| `tier.learning.deleteDialog.{title, desc, warningText, cancelText, deleteText}` | `string` | Single-learning delete dialog copy. |
+
+#### Empty state
+
+```json
+"emptyStateLearning": {
+  "title": "No instructions have been added !",
+  "desc": "Start by adding instructions that should apply across all documents.",
+  "createNewLearning": "Create New Instruction",
+  "createGlobalScope": "Create Global Scope",
+  "noAccessTitle": "Access Restricted",
+  "noAccessDesc": "You do not have access for this application.",
+  "requestAccessButton": "Request Access",
+  "requestSentButton": "Request Sent"
+}
+```
+
+| Field | Type | Required | Description |
+|---|---|:---:|---|
+| `title` | `string` | ✅ | Empty-state heading. |
+| `desc` | `string` | ✅ | Empty-state description. |
+| `createNewLearning` | `string` | ✅ | CTA to create a learning. |
+| `createGlobalScope` | `string` | ✅ | CTA to create a global scope. |
+| `noAccessTitle` | `string` | ❌ | Heading when the user has no access. |
+| `noAccessDesc` | `string` | ❌ | Description when the user has no access. |
+| `requestAccessButton` | `string` | ❌ | "Request access" button label. |
+| `requestSentButton` | `string` | ❌ | "Request sent" state label. |
+
+---
 
 ## Changelog
+### 1.3.0-alpha.31 - 2026, June 10th
+-Hide "Copy to Tier" option
+-Hide Tier Accordian in Learning Management screen
+-Configuring Max hirearchy from ILKB config and its UI changes
+
+### 1.3.0-alpha.31 - 2026, June 10th
+Backward Compatibility support for Save from AI changes
 
 ### 1.3.0-alpha.21 - 2026, June 8th
 **Permissions — Union-based access resolution**
@@ -185,12 +728,14 @@ Patch Fix: Removal of underscore for all labels
 
 ## Alpha Release Commands
 
-1. npm version prerelease --preid=alpha
-
-becomes 0.0.0-alpha.0
+# Create the first alpha version (e.g. 0.1.0-alpha.0)
+npm version prerelease --preid=alpha
 
-2. run this again to bump it: npm version prerelease --preid=alpha
+# Increment the alpha version (e.g. 0.1.0-alpha.1)
+npm version prerelease --preid=alpha
 
-3. during publish: npm publish --tag alpha
+# Publish the package under the alpha tag
+npm publish --tag alpha
 
-4. installation: npm install @e-llm-studio/instant-learning@0.1.0-alpha.1
+# Install a specific alpha version
+npm install @e-llm-studio/instant-learning@0.1.0-alpha.1

package/dist/ComponentRegistry.js

@@ -0,0 +1,2 @@
+import n from"react";import t from"./schema-driven/FallbackField.js";var o={TextInput:{importPath:function(){return import("./schema-driven/components/TextInputField.js")},isContainer:!1},FlexRow:{importPath:function(){return import("./schema-driven/components/GroupEditRow.js")},isContainer:!0},DropdownSection:{importPath:function(){return import("./schema-driven/components/DropdownSectionField.js")},isContainer:!1},ConditionSection:{importPath:function(){return import("./schema-driven/components/ConditionSectionField.js")},isContainer:!1},ConfigSection:{importPath:function(){return import("./schema-driven/components/ConfigSectionField.js")},isContainer:!1},ScopeSection:{importPath:function(){return import("./schema-driven/components/ScopeSectionField.js")},isContainer:!1},PromptTextEditor:{importPath:function(){return import("./schema-driven/components/PromptTextEditorField.js")},isContainer:!1},Accordion:{importPath:function(){return import("./schema-driven/primitives/Accordion.js")},isContainer:!0},VariantListWrapper:{importPath:function(){return import("./schema-driven/components/VariantListField.js")},isContainer:!0},GlobalSetupAccordion:{importPath:function(){return import("./schema-driven/components/GlobalSetupAccordionField.js")},isContainer:!0}},i=function(n){return n in o},r=new Map,e=function(t){return t?i(t)?(r.has(t)||r.set(t,n.lazy(o[t].importPath)),r.get(t)):(console.warn('[componentRegistry] Unknown bpa_ui_component: "'.concat(t,'"')),null):null},c=function(n){var o;return null!==(o=e(n))&&void 0!==o?o:t},a=function(n){return!!n&&i(n)&&!!o[n].isContainer};export{o as componentRegistry,a as isContainerComponent,i as isRegistryComponentName,e as resolveRegistryComponent,c as resolveRegistryComponentOrFallback};
+//# sourceMappingURL=ComponentRegistry.js.map

package/dist/ComponentRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentRegistry.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/ContinueWithTemplateModal.js

@@ -0,0 +1,2 @@
+import{__assign as e}from"tslib";import{jsx as o,jsxs as n}from"react/jsx-runtime";import{Modal as t}from"@mui/material";import{FileText as i,Settings as a,X as r,ChevronRight as l}from"lucide-react";import s from"./ContinueWithTemplateModal.module.css.js";import{EXTERNAL_WORKFLOW_MODAL_DT_PATH as d,EXTERNAL_WORKFLOW_METADATA_DT_PATH as c,MF_EVENTS as u}from"./features/LearningManagement/constants.js";import{useExternalWorkflowStore as m}from"./features/LearningManagement/store/useExternalWorkflowStore.js";import{dtt as p}from"./features/LearningManagement/store/useLMSConfigStore.js";import{guidelineQueryClient as f}from"./features/IL-marketplace/queryClient.js";var g=function(g){var v=g.heading,h=g.options,N=g.stepBadges,C=m(function(e){return e.isContinueModalOpen}),w=m(function(e){return e.closeContinueModal}),M=m(function(e){return e.externalWorkflowMetaData}),B=null!=M?M:{},T=B.handlers,y=B.mfApi,D=B.configureNowPayload,k=null!=N?N:null==M?void 0:M.stepBadges,S=[{id:"save-draft",icon:o(i,{size:20}),title:p("".concat(d,".options.saveDraft.title")),description:p("".concat(d,".options.saveDraft.desc")),onClick:function(){var e,o,n=null!==(o=null!==(e=null==D?void 0:D.value_id)&&void 0!==e?e:null==D?void 0:D.instant_learning_id)&&void 0!==o?o:null==D?void 0:D.id;if(n&&(m.getState().setPendingHighlightGuidelineId(String(n)),f.invalidateQueries({queryKey:["il-marketplace-tab-guidelines"]})),null==T?void 0:T.onSaveDraft)return T.onSaveDraft(D),void w();w()},footerNote:p("".concat(d,".options.saveDraft.footerDesc")),stepBadges:null==k?void 0:k.saveDraft},{id:"configure-now",icon:o(a,{size:20}),title:p("".concat(d,".options.configureNow.title")),description:p("".concat(d,".options.configureNow.desc")),onClick:function(){if(console.log("ContinueWithTemplateModal: Configure Now payload:",D),null==T?void 0:T.onConfigureNow)return T.onConfigureNow(D),void w();!function(){if(!D)return console.error("ContinueWithTemplateModal: configureNowPayload is required for the default Configure Now action."),void w();var o=p("".concat(c,".current_mode")),n={modeType:"submode",eventType:"modeToTrigger",previousMode:{modeName:o,additionalData:{}},modeToTrigger:{modeName:p("".concat(c,".next_mode")),query:"",additionalData:e({urlRelativePath:window.location.pathname.replace(/^\/+/,"")+window.location.search},D),responseOfThisMode:null},nextMode:{modeName:o,queryForNextMode:"",additionalData:{}}};null==y||y.dispatch(u.TRIGGER_SUBMODE,n),w()}()},stepBadges:null==k?void 0:k.configureNow}],b=h&&h.length>0?h:S;return o(t,e({open:C,onClose:w},{children:o("div",e({className:s.overlayCenterer},{children:n("div",e({className:s.modal},{children:[n("div",e({className:s.header},{children:[o("h2",e({className:s.headingText},{children:null!=v?v:p("".concat(d,".heading"))})),o("button",e({type:"button",className:s.closeButton,onClick:w,"aria-label":"Close"},{children:o(r,{size:20})}))]})),o("div",e({className:s.optionsRow},{children:b.map(function(t){return n("button",e({type:"button",onClick:t.onClick,className:s.optionCard},{children:[n("div",e({className:s.optionCardTop},{children:[o("div",e({className:s.optionIconWrap},{children:t.icon})),o(l,{size:18,className:s.optionArrow})]})),o("div",e({className:s.optionTitle},{children:t.title})),o("p",e({className:s.optionDescription},{children:t.description})),t.footerNote&&o("div",e({className:s.optionFooterNote},{children:t.footerNote})),t.stepBadges&&t.stepBadges.length>0&&o("div",e({className:s.stepBadgeRow},{children:t.stepBadges.map(function(i,a){return n("div",e({className:s.stepBadgeItem},{children:[o("span",e({className:s.stepBadge},{children:i})),a<t.stepBadges.length-1&&o(l,{size:14,className:s.stepBadgeSeparator})]}),i)})}))]}),t.id)})}))]}))}))}))};export{g as default};
+//# sourceMappingURL=ContinueWithTemplateModal.js.map

package/dist/ContinueWithTemplateModal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContinueWithTemplateModal.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/ContinueWithTemplateModal.module.css.js

@@ -0,0 +1,2 @@
+import e from"./node_modules/style-inject/dist/style-inject.es.js";var o={overlayCenterer:"ContinueWithTemplateModal-module_overlayCenterer__v-07M",modal:"ContinueWithTemplateModal-module_modal__mI6vW",header:"ContinueWithTemplateModal-module_header__4m-kh",headingText:"ContinueWithTemplateModal-module_headingText__J-DcQ",closeButton:"ContinueWithTemplateModal-module_closeButton__74D3b",optionsRow:"ContinueWithTemplateModal-module_optionsRow__8xzr1",optionCard:"ContinueWithTemplateModal-module_optionCard__TGTgu",optionCardTop:"ContinueWithTemplateModal-module_optionCardTop__DFmo5",optionIconWrap:"ContinueWithTemplateModal-module_optionIconWrap__fhq9d",optionArrow:"ContinueWithTemplateModal-module_optionArrow__4S9xs",optionTitle:"ContinueWithTemplateModal-module_optionTitle__wV7Df",optionDescription:"ContinueWithTemplateModal-module_optionDescription__vgsxL",optionFooterNote:"ContinueWithTemplateModal-module_optionFooterNote__6jUPP",stepBadgeRow:"ContinueWithTemplateModal-module_stepBadgeRow__RdB5r",stepBadgeItem:"ContinueWithTemplateModal-module_stepBadgeItem__MBPyK",stepBadge:"ContinueWithTemplateModal-module_stepBadge__Y7WUx",stepBadgeSeparator:"ContinueWithTemplateModal-module_stepBadgeSeparator__mZygD"};e(".ContinueWithTemplateModal-module_overlayCenterer__v-07M{align-items:center;display:flex;height:100%;justify-content:center;padding:16px;width:100%}.ContinueWithTemplateModal-module_modal__mI6vW{background:#fff;border-radius:16px;box-shadow:0 20px 60px #0f172a2e;max-width:1120px;outline:none;padding:24px 32px 32px;width:100%}.ContinueWithTemplateModal-module_header__4m-kh{align-items:flex-start;display:flex;justify-content:space-between;margin-bottom:20px}.ContinueWithTemplateModal-module_headingText__J-DcQ{color:#111827;font-size:20px;font-weight:600;margin:0;padding-right:16px}.ContinueWithTemplateModal-module_closeButton__74D3b{background:none;border:none;border-radius:6px;color:#6b7280;cursor:pointer;display:flex;padding:4px}.ContinueWithTemplateModal-module_closeButton__74D3b:hover{background:#f3f4f6;color:#111827}.ContinueWithTemplateModal-module_optionsRow__8xzr1{display:grid;gap:16px;grid-template-columns:1fr 1fr}.ContinueWithTemplateModal-module_optionCard__TGTgu{background:#fff;border:1px solid #e3e6ea;border-radius:12px;cursor:pointer;display:flex;flex-direction:column;gap:12px;padding:24px;text-align:left;transition:border-color .15s ease,box-shadow .15s ease}.ContinueWithTemplateModal-module_optionCard__TGTgu:hover{border-color:#9845e8;box-shadow:0 4px 16px #9845e81f}.ContinueWithTemplateModal-module_optionCardTop__DFmo5{align-items:center;display:flex;justify-content:space-between}.ContinueWithTemplateModal-module_optionIconWrap__fhq9d{align-items:center;background:#f5f0ff;border-radius:10px;color:#6d28d9;display:flex;height:40px;justify-content:center;width:40px}.ContinueWithTemplateModal-module_optionArrow__4S9xs{color:#9ca3af}.ContinueWithTemplateModal-module_optionTitle__wV7Df{color:#111827;font-size:17px;font-weight:600}.ContinueWithTemplateModal-module_optionDescription__vgsxL{color:#6b7280;font-size:14px;line-height:1.5;margin:0}.ContinueWithTemplateModal-module_optionFooterNote__6jUPP{color:#6d28d9;font-size:12px;font-weight:500}.ContinueWithTemplateModal-module_stepBadgeRow__RdB5r{align-items:center;display:flex;flex-wrap:wrap;gap:4px;margin-top:4px}.ContinueWithTemplateModal-module_stepBadgeItem__MBPyK{align-items:center;display:flex;gap:4px}.ContinueWithTemplateModal-module_stepBadge__Y7WUx{background:#f3f4f6;border-radius:999px;color:#374151;font-size:11px;font-weight:500;padding:4px 10px}.ContinueWithTemplateModal-module_stepBadgeSeparator__mZygD{color:#9ca3af}@media (max-width:1160px){.ContinueWithTemplateModal-module_modal__mI6vW{max-width:90vw}}@media (max-width:640px){.ContinueWithTemplateModal-module_optionsRow__8xzr1{grid-template-columns:1fr}}");export{o as default};
+//# sourceMappingURL=ContinueWithTemplateModal.module.css.js.map

package/dist/ContinueWithTemplateModal.module.css.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContinueWithTemplateModal.module.css.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}