@mudlet/mudlet-web 0.4.2 → 0.4.3

package/dist-lib/mud/MudSession.d.ts

@@ -316,6 +316,7 @@ export declare class MudSession {
         newEnvironEnabled?: boolean;
         secureTransport?: boolean;
         screenReaderAdvertised?: boolean;
+        osc8HyperlinksEnabled?: boolean;
         nawsEnabled?: boolean;
         subprotocols?: string[];
     }): void;

package/dist-lib/mud/connection/MudClient.d.ts

@@ -75,6 +75,11 @@ export interface MudClientOptions {
      *  READER bit and the NEW-ENVIRON `SCREEN_READER` capability
      *  (`setConfig("advertiseScreenReader", …)`). Default false. */
     screenReaderAdvertised?: boolean;
+    /** Whether OSC 8 hyperlinks are enabled for this profile (Mudlet 5.0's
+     *  `mEnableOSC8Hyperlinks`). Reported as the `OSC_HYPERLINKS_*` NEW-ENVIRON
+     *  capability block — all "0" when off. Default true. The rendering half of
+     *  the toggle lives in the ANSI parser, not here. */
+    osc8HyperlinksEnabled?: boolean;
     /** Whether to negotiate NAWS / window size (telnet option 31). Default true
      *  (matching Mudlet). When true the client offers IAC WILL NAWS on connect
      *  and, once the server accepts (IAC DO NAWS), reports the main output
@@ -228,7 +233,7 @@ export declare class MudClient {
     /** Handed to the telnet sequence parser and mutated in place, so the parser
      *  reads the current setting rather than the one it was built with. */
     private readonly telnetParserOpts;
-    constructor({ url, mccpEnabled, commandEcho, chunkProcessor, promptTimeoutMs, gmcpEnabled, mttsEnabled, msdpEnabled, msspEnabled, charsetEnabled, mspEnabled, mxpEnabled, mnesEnabled, newEnvironEnabled, secureTransport, screenReaderAdvertised, nawsEnabled, fixUnnecessaryLinebreaks, undoServerWrap, undoServerWrapWidth, inputLineStrictUnixEndings, specialForceGAOff, versionInTTYPE, promptForVersionInTTYPE, promptForMXPProcessorOn, specialForceMXPProcessorOn, subprotocols, }: MudClientOptions, eventBus: EventBus<MudClientEvents>);
+    constructor({ url, mccpEnabled, commandEcho, chunkProcessor, promptTimeoutMs, gmcpEnabled, mttsEnabled, msdpEnabled, msspEnabled, charsetEnabled, mspEnabled, mxpEnabled, mnesEnabled, newEnvironEnabled, secureTransport, screenReaderAdvertised, osc8HyperlinksEnabled, nawsEnabled, fixUnnecessaryLinebreaks, undoServerWrap, undoServerWrapWidth, inputLineStrictUnixEndings, specialForceGAOff, versionInTTYPE, promptForVersionInTTYPE, promptForMXPProcessorOn, specialForceMXPProcessorOn, subprotocols, }: MudClientOptions, eventBus: EventBus<MudClientEvents>);
     /** Mudlet-parity character-at-a-time detection (cTelnet::sendData's
      *  `armCharacterModeDetection`). ECHO+SGA on its own is *not* the signature:
      *  an ordinary line-mode server masking a password negotiates exactly the

package/dist-lib/mud/connection/TelnetNegotiator.d.ts

@@ -18,6 +18,12 @@ export interface TelnetNegotiatorFlags {
      *  key. Default false; some MUDs adjust their output (e.g. suppress ASCII
      *  art, add extra room-description detail) when this is set. */
     screenReaderAdvertised: boolean;
+    /** Whether OSC 8 hyperlinks are enabled for this profile — Mudlet 5.0's
+     *  `mEnableOSC8Hyperlinks`. Drives only the `OSC_HYPERLINKS_*` NEW-ENVIRON
+     *  capability block here; the rendering side of the same toggle is a gate in
+     *  the ANSI parser (see hyperlinkConfig's setOsc8HyperlinksEnabled). Default
+     *  true, matching Mudlet. */
+    osc8HyperlinksEnabled: boolean;
     /** Whether the first TTYPE cycle value carries our version after the client
      *  name — Mudlet's `versionInTTYPE` config key (`mVersionInTTYPE`). Default
      *  false: RFC 1091 doesn't permit the period, so Mudlet stopped sending it

package/dist-lib/mud/protocol/mnes.d.ts

@@ -60,6 +60,12 @@ export interface NewEnvironState {
      *  bit, NEW-ENVIRON SCREEN_READER var) — `setConfig("advertiseScreenReader", …)`.
      *  Defaults to false (matching Mudlet's opt-in behaviour). */
     screenReader?: boolean;
+    /** Whether OSC 8 hyperlinks are enabled for this profile (Mudlet 5.0's
+     *  `Host::mEnableOSC8Hyperlinks`). Every `OSC_HYPERLINKS_*` capability
+     *  reports "0" while it is off, exactly as Mudlet's
+     *  `cTelnet::getNewEnvironOSCHyperlinks*` do — a server that would light up
+     *  its links for us must be told we won't render them. Defaults to true. */
+    osc8Hyperlinks?: boolean;
 }
 /** The five core variables MNES standardises (https://tintin.mudhalla.net/protocols/mnes/).
  *  Plain NEW-ENVIRON reports these too, plus the extended capability set below.

package/dist-lib/mud/text/hyperlinkConfig.d.ts

@@ -128,6 +128,10 @@ interface ExtractedQuery {
  * Mudlet's hand-rolled scan; everything else is `&`-delimited `key=value`.
  */
 export declare function extractQuery(uri: string): ExtractedQuery;
+/** Enable/disable OSC 8 hyperlink parsing (Mudlet `mEnableOSC8Hyperlinks`). */
+export declare function setOsc8HyperlinksEnabled(enabled: boolean): void;
+/** Whether OSC 8 hyperlinks are currently honoured. */
+export declare function isOsc8HyperlinksEnabled(): boolean;
 /** Session-scoped store of `preset:NAME` definitions. Holds raw config objects
  *  (shorthand un-expanded, as Mudlet does) so a later `?preset=NAME` can deep-
  *  merge an override before expansion. */

package/dist-lib/scripting/ScriptingAPI.d.ts

@@ -41,6 +41,10 @@ declare class ScriptingWindowsAPI {
     isMiniConsole(id: string): boolean;
     move(id: string, x: number, y: number): void;
     setParent(id: string, parent?: string): boolean;
+    /** Re-applies a docking area to a window that is already open — Mudlet's
+     *  Host::openWindow honours the `area` argument on every call, not just
+     *  the one that creates the dock widget. 'main' means floating. */
+    setDockArea(id: string, area: string): void;
     bringToFront(id: string): void;
     sendToBack(id: string): void;
     resize(id: string, width: number, height: number): void;

package/dist-lib/scripting/lua/bindings/commandLine.d.ts

@@ -8,4 +8,4 @@ import type { BindingContext } from './context';
  * user window's embedded input, and a free-floating createCommandLine widget -
  * which cmdLineKind below resolves from the name Lua passed.
  */
-export declare function installCommandLineBindings({ lua, api, channel, emitEvent }: BindingContext): void;
+export declare function installCommandLineBindings({ lua, api, emitEvent }: BindingContext): void;

package/dist-lib/scripting/lua/bindings/output.d.ts

@@ -7,4 +7,4 @@ import type { BindingContext } from './context';
  * Colour channels are validated through the shared 0..255 coercion; Mudlet
  * silently no-ops on an out-of-range channel rather than raising.
  */
-export declare function installOutputBindings({ lua, api, channel }: BindingContext): void;
+export declare function installOutputBindings({ lua, api }: BindingContext): void;

package/dist-lib/storage/schema.d.ts

@@ -210,6 +210,27 @@ export interface ProfileSettings {
      *  (reset). When disabled, those sequences are ignored and the user palette
      *  stands. Off by default — only an explicit `true` enables it. */
     serverRedefineColors?: boolean;
+    /** Mudlet 5.0's `Host::mEnableOSC8Hyperlinks` ("Enable OSC 8 hyperlinks").
+     *  When disabled, an OSC 8 sequence that *opens* a link is ignored so the
+     *  text renders plain, and the whole `OSC_HYPERLINKS_*` NEW-ENVIRON
+     *  capability block reports "0" — the two things Mudlet's toggle drives
+     *  (TBuffer::decodeOSC and cTelnet::getNewEnvironOSCHyperlinks*). A
+     *  *closing* sequence is always honoured, or a link open when the toggle
+     *  flipped would never end. On by default: only an explicit `false`
+     *  disables it, matching Mudlet's `= true` default. Unlike most of these,
+     *  Mudlet exposes no `setConfig` key for it — preferences and the profile
+     *  XML only — so mudix doesn't invent one either. */
+    osc8Hyperlinks?: boolean;
+    /** Mudlet 5.0's `Host::mUndoServerWrap` ("Undo the game's own wrapping",
+     *  experimental). Rejoins the lines a game hard-wrapped itself before
+     *  triggers see them, so a pattern can't be split mid-sentence; the client's
+     *  own wrap then applies for display. Off by default. Also readable and
+     *  writable from Lua as `getConfig`/`setConfig("undoServerWrap", …)`. */
+    undoServerWrap?: boolean;
+    /** The column the game wraps at, for {@link undoServerWrap} — Mudlet's
+     *  `mUndoServerWrapWidth`, bounded 20–500 and defaulting to 80 (very often
+     *  the right answer). `setConfig("undoServerWrapWidth", …)`. */
+    undoServerWrapWidth?: number;
     /** Mudlet "Network packet timeout": how long (ms) to buffer a partial line
      *  (text after the last `\n` of a WebSocket frame) before flushing it as a
      *  prompt. Mitigates spurious mid-line breaks when long MUD lines arrive