@typespec/html-program-viewer 0.71.0 → 0.72.0-dev.1

package/dist/emitter/index.js

@@ -948,7 +948,7 @@ const TextDirectionProvider = ({
  * The main difference between this function and `slot` is that this function does not return the metadata required for a slot to be considered a properly renderable slot, it only converts the value to a slot properties object
  * @param value - the value of the slot, it can be a slot shorthand or a slot properties object
  */ function resolveShorthand(value) {
-    if (typeof value === 'string' || typeof value === 'number' || Array.isArray(value) || // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    if (typeof value === 'string' || typeof value === 'number' || isIterable(value) || // eslint-disable-next-line @typescript-eslint/no-explicit-any
     React.isValidElement(value)) {
         return {
             children: value
@@ -964,6 +964,8 @@ Slot shorthands can be strings, numbers, arrays or JSX elements`);
     }
     return value;
 }
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const isIterable = (value)=>typeof value === 'object' && value !== null && Symbol.iterator in value;
 
 /**
  * Guard method to ensure a given element is a slot.
@@ -996,6 +998,7 @@ Slot shorthands can be strings, numbers, arrays or JSX elements`);
    * as we're verifying static properties that will not change between environments
    */ if (process.env.NODE_ENV !== 'production') {
         const typedState = state;
+        // eslint-disable-next-line @typescript-eslint/no-deprecated
         for (const slotName of Object.keys(typedState.components)){
             const slotElement = typedState[slotName];
             if (slotElement === undefined) {
@@ -1006,6 +1009,7 @@ Slot shorthands can be strings, numbers, arrays or JSX elements`);
             // FIXME: this slot will still fail to support child render function scenario
             if (!isSlot(slotElement)) {
                 typedState[slotName] = always(slotElement, {
+                    // eslint-disable-next-line @typescript-eslint/no-deprecated
                     elementType: typedState.components[slotName]
                 });
                 // eslint-disable-next-line no-console
@@ -1016,7 +1020,9 @@ Be sure to create slots properly by using "slot.always" or "slot.optional".`);
                 // This means a slot is being declared by using resolveShorthand on the state hook,
                 // but the render method is using the new `assertSlots` method. That scenario can be solved by simply updating the slot element with the proper element type
                 const { [SLOT_ELEMENT_TYPE_SYMBOL]: elementType } = slotElement;
+                // eslint-disable-next-line @typescript-eslint/no-deprecated
                 if (elementType !== typedState.components[slotName]) {
+                    // eslint-disable-next-line @typescript-eslint/no-deprecated
                     slotElement[SLOT_ELEMENT_TYPE_SYMBOL] = typedState.components[slotName];
                     // eslint-disable-next-line no-console
                     console.warn(`@fluentui/react-utilities [${assertSlots.name}]:
@@ -1484,7 +1490,12 @@ function getNativeElementProps(tagName, props, excludedPropNames) {
  * element type.
  *
  * Equivalent to {@link getNativeElementProps}, but more type-safe.
- */ const getIntrinsicElementProps = (/** The slot's default element type (e.g. 'div') */ tagName, /** The component's props object */ props, /** List of native props to exclude from the returned value */ excludedPropNames)=>{
+ *
+ * @param tagName - The slot's default element type (e.g. 'div')
+ * @param props - The component's props object
+ * @param excludedPropNames - List of native props to exclude from the returned value
+ */ const getIntrinsicElementProps = (tagName, // eslint-disable-next-line @typescript-eslint/no-restricted-types -- in order to not introduce Type Restriction CHANGe which is kinda "breaking change from Types POV", we don't enforce our custom `RefAttributes` in this API, to be compatible with scenarios where non v9 interfaces might be used. This may/will change with React 19
+props, excludedPropNames)=>{
     var _props_as;
     // eslint-disable-next-line @typescript-eslint/no-deprecated
     return getNativeElementProps((_props_as = props.as) !== null && _props_as !== void 0 ? _props_as : tagName, props);
@@ -1628,12 +1639,21 @@ function useIdPrefix() {
  * updates all provided refs
  * @param refs - Refs to collectively update with one ref value.
  * @returns A function with an attached "current" prop, so that it can be treated like a RefObject.
- */ function useMergedRefs(...refs) {
+ */ // LegacyRef is actually not supported, but in React v18 types this is leaking directly from forwardRef component declaration
+function useMergedRefs(...refs) {
     'use no memo';
     const mergedCallback = React.useCallback((value)=>{
         // Update the "current" prop hanging on the function.
         mergedCallback.current = value;
         for (const ref of refs){
+            if (typeof ref === 'string' && process.env.NODE_ENV !== 'production') {
+                // eslint-disable-next-line no-console
+                console.error(`@fluentui/react-utilities [useMergedRefs]:
+This hook does not support the usage of string refs. Please use React.useRef instead.
+
+For more info on 'React.useRef', see https://react.dev/reference/react/useRef.
+For more info on string refs, see https://react.dev/blog/2024/04/25/react-19-upgrade-guide#removed-string-refs.`);
+            }
             if (typeof ref === 'function') {
                 ref(value);
             } else if (ref) {

package/dist/{manifest-BJp8WsoA.js → manifest-DvYpHITg.js}

@@ -1,6 +1,6 @@
 const manifest = {
   "version": "1.1.0",
-  "commit": "cc74c72d4dcfd78a6a6a84e5618a16a5bad462c1"
+  "commit": "96088468048e5bc5eb450816a8f047ec68be9646"
 };
 
 export { manifest as default };

package/dist/react/index.js

@@ -26247,23 +26247,36 @@ class Alias extends NodeBase {
      * Resolve the value of this alias within `doc`, finding the last
      * instance of the `source` anchor before this node.
      */
-    resolve(doc) {
+    resolve(doc, ctx) {
+        let nodes;
+        if (ctx?.aliasResolveCache) {
+            nodes = ctx.aliasResolveCache;
+        }
+        else {
+            nodes = [];
+            visit(doc, {
+                Node: (_key, node) => {
+                    if (isAlias(node) || hasAnchor(node))
+                        nodes.push(node);
+                }
+            });
+            if (ctx)
+                ctx.aliasResolveCache = nodes;
+        }
         let found = undefined;
-        visit(doc, {
-            Node: (_key, node) => {
-                if (node === this)
-                    return visit.BREAK;
-                if (node.anchor === this.source)
-                    found = node;
-            }
-        });
+        for (const node of nodes) {
+            if (node === this)
+                break;
+            if (node.anchor === this.source)
+                found = node;
+        }
         return found;
     }
     toJSON(_arg, ctx) {
         if (!ctx)
             return { source: this.source };
         const { anchors, doc, maxAliasCount } = ctx;
-        const source = this.resolve(doc);
+        const source = this.resolve(doc, ctx);
         if (!source) {
             const msg = `Unresolved alias (the anchor must be set before the alias): ${this.source}`;
             throw new ReferenceError(msg);
@@ -26374,8 +26387,7 @@ function createNode(value, tagName, ctx) {
     if (aliasDuplicateObjects && value && typeof value === 'object') {
         ref = sourceObjects.get(value);
         if (ref) {
-            if (!ref.anchor)
-                ref.anchor = onAnchor(value);
+            ref.anchor ?? (ref.anchor = onAnchor(value));
             return new Alias(ref.anchor);
         }
         else {
@@ -26976,10 +26988,9 @@ function plainString(item, ctx, onComment, onChompKeep) {
         (inFlow && /[[\]{},]/.test(value))) {
         return quotedString(value, ctx);
     }
-    if (!value ||
-        /^[\n\t ,[\]{}#&*!|>'"%@`]|^[?-]$|^[?-][ \t]|[\n:][ \t]|[ \t]\n|[\n\t ]#|[\n\t :]$/.test(value)) {
+    if (/^[\n\t ,[\]{}#&*!|>'"%@`]|^[?-]$|^[?-][ \t]|[\n:][ \t]|[ \t]\n|[\n\t ]#|[\n\t :]$/.test(value)) {
         // not allowed:
-        // - empty string, '-' or '?'
+        // - '-' or '?'
         // - start with an indicator character (except [?:-]) or /[?-] /
         // - '\n ', ': ' or ' \n' anywhere
         // - '#' not preceded by a non-space char
@@ -27122,7 +27133,7 @@ function getTagObject(tags, item) {
         tagObj = tags.find(t => t.nodeClass && obj instanceof t.nodeClass);
     }
     if (!tagObj) {
-        const name = obj?.constructor?.name ?? typeof obj;
+        const name = obj?.constructor?.name ?? (obj === null ? 'null' : typeof obj);
         throw new Error(`Tag not resolved for ${name} value`);
     }
     return tagObj;
@@ -27137,7 +27148,7 @@ function stringifyProps(node, tagObj, { anchors, doc }) {
         anchors.add(anchor);
         props.push(`&${anchor}`);
     }
-    const tag = node.tag ? node.tag : tagObj.default ? null : tagObj.tag;
+    const tag = node.tag ?? (tagObj.default ? null : tagObj.tag);
     if (tag)
         props.push(doc.directives.tagString(tag));
     return props.join(' ');
@@ -27163,8 +27174,7 @@ function stringify$1(item, ctx, onComment, onChompKeep) {
     const node = isNode(item)
         ? item
         : ctx.doc.createNode(item, { onTagObj: o => (tagObj = o) });
-    if (!tagObj)
-        tagObj = getTagObject(ctx.doc.schema.tags, node);
+    tagObj ?? (tagObj = getTagObject(ctx.doc.schema.tags, node));
     const props = stringifyProps(node, tagObj, ctx);
     if (props.length > 0)
         ctx.indentAtStart = (ctx.indentAtStart ?? 0) + props.length + 1;
@@ -27423,6 +27433,7 @@ function addPairToJSMap(ctx, map, { key, value }) {
 function stringifyKey(key, jsKey, ctx) {
     if (jsKey === null)
         return '';
+    // eslint-disable-next-line @typescript-eslint/no-base-to-string
     if (typeof jsKey !== 'object')
         return String(jsKey);
     if (isNode(key) && ctx?.doc) {
@@ -34314,7 +34325,7 @@ let manifest;
 try {
     // eslint-disable-next-line @typescript-eslint/ban-ts-comment
     // @ts-ignore
-    manifest = (await import('../manifest-BJp8WsoA.js')).default;
+    manifest = (await import('../manifest-DvYpHITg.js')).default;
 }
 catch {
     const name = "../dist/manifest.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@typespec/html-program-viewer",
-  "version": "0.71.0",
+  "version": "0.72.0-dev.1",
   "author": "Microsoft Corporation",
   "description": "TypeSpec library for emitting an html view of the program.",
   "homepage": "https://typespec.io",
@@ -39,7 +39,7 @@
     "@typespec/compiler": "^1.1.0"
   },
   "dependencies": {
-    "@fluentui/react-components": "~9.63.0",
+    "@fluentui/react-components": "~9.66.1",
     "@fluentui/react-icons": "^2.0.292",
     "@fluentui/react-list": "^9.1.2",
     "react": "~18.3.1",
@@ -51,9 +51,10 @@
     "@testing-library/dom": "^10.4.0",
     "@testing-library/jest-dom": "^6.6.3",
     "@testing-library/react": "^16.2.0",
-    "@types/node": "~22.13.11",
+    "@types/node": "~24.0.3",
     "@types/react": "~18.3.11",
     "@types/react-dom": "~18.3.0",
+    "@typespec/compiler": "^1.1.0",
     "@vitejs/plugin-react": "~4.4.1",
     "@vitest/coverage-v8": "^3.1.2",
     "@vitest/ui": "^3.1.2",
@@ -62,10 +63,9 @@
     "typescript": "~5.8.2",
     "vite": "^6.2.7",
     "vite-plugin-checker": "^0.9.1",
-    "vite-plugin-dts": "4.5.3",
+    "vite-plugin-dts": "4.5.4",
     "vite-plugin-node-polyfills": "^0.23.0",
     "vitest": "^3.1.2",
-    "@typespec/compiler": "^1.1.0",
     "@typespec/react-components": "^0.57.0"
   },
   "scripts": {