@tutorialkit-rb/astro 1.5.2-rb.0.1.0

package/dist/integrations.d.ts

@@ -0,0 +1,10 @@
+import { type ExpressiveCodePlugin } from 'astro-expressive-code';
+export declare function extraIntegrations({ root, expressiveCodePlugins, }: {
+    root: string;
+    expressiveCodePlugins?: ExpressiveCodePlugin[];
+}): (import("astro").AstroIntegration | {
+    name: string;
+    hooks: {
+        "astro:config:setup": (args: unknown) => Promise<void>;
+    };
+})[];

package/dist/remark/callouts.d.ts

@@ -0,0 +1,3 @@
+import type { Root } from 'mdast';
+import type { Transformer } from 'unified';
+export declare function remarkCalloutsPlugin(): () => Transformer<Root>;

package/dist/remark/import-file.d.ts

@@ -0,0 +1,7 @@
+import type { Root } from 'mdast';
+import type { Transformer } from 'unified';
+interface RemarkImportFilePluginOptions {
+    templatesPath: string;
+}
+export declare function remarkImportFilePlugin(options: RemarkImportFilePluginOptions): () => Transformer<Root>;
+export {};

package/dist/remark/index.d.ts

@@ -0,0 +1,2 @@
+import type { AstroConfigSetupOptions } from '../types.js';
+export declare function updateMarkdownConfig({ updateConfig }: AstroConfigSetupOptions): void;

package/dist/types.d.ts

@@ -0,0 +1,9 @@
+import type { AstroIntegration } from 'astro';
+export type AstroConfigSetupOptions = Parameters<NonNullable<AstroIntegration['hooks']['astro:config:setup']>>[0];
+export type AstroServerSetupOptions = Parameters<Required<AstroIntegration['hooks']>['astro:server:setup']>['0'];
+export type AstroBuildDoneOptions = Parameters<Required<AstroIntegration['hooks']>['astro:build:done']>['0'];
+export type ViteDevServer = AstroServerSetupOptions['server'];
+export type VitePlugin = ViteDevServer['config']['plugins'][0];
+export type Files = Record<string, string | {
+    base64: string;
+}>;

package/dist/utils.d.ts

@@ -0,0 +1,2 @@
+export declare function withResolvers<T>(): PromiseWithResolvers<T>;
+export declare function normalizeImportPath(importPath: string): string;

package/dist/vite-plugins/core.d.ts

@@ -0,0 +1,2 @@
+import type { VitePlugin } from '../types.js';
+export declare const tutorialkitCore: VitePlugin;

package/dist/vite-plugins/css.d.ts

@@ -0,0 +1,4 @@
+import type { AstroIntegrationLogger } from 'astro';
+import type { ViteDevServer, VitePlugin } from '../types.js';
+export declare const userlandCSS: VitePlugin;
+export declare function watchUserlandCSS(server: ViteDevServer, logger: AstroIntegrationLogger): void;

package/dist/vite-plugins/override-components.d.ts

@@ -0,0 +1,78 @@
+/**
+ * A plugin that lets users override TutorialKit's components.
+ *
+ * The virtual module can be imported as:
+ *
+ * ```ts
+ * import { TopBar } from 'tutorialkit:override-components';
+ *
+ * <TopBar />
+ * ```
+ *
+ * User can override the components in `astro.config.ts`:
+ *
+ * ```ts
+ * export default defineConfig({
+ *   integrations: [
+ *     tutorialkit({
+ *       components: {
+ *         TopBar: './CustomTopBar.astro',
+ *         Dialog: './CustomDialog.tsx',
+ *         HeadTags: './CustomHeadLinks.astro',
+ *       },
+ *     }),
+ *   ],
+ * });
+ * ```
+ */
+import type { VitePlugin } from '../types.js';
+export interface OverrideComponentsOptions {
+    /**
+     * Component for overriding the top bar.
+     *
+     * This component has slots that are used to pass TutorialKit's default components:
+     *   - `logo`: Logo of the application
+     *   - `open-in-stackblitz-link`: Link for opening current lesson in StackBlitz
+     *   - `theme-switch`:  Switch for changing the theme
+     *   - `login-button`: For StackBlitz Enterprise user, the login button
+     *
+     * Usage:
+     *
+     * ```jsx
+     *   <slot name="logo" />
+     *   <slot name="open-in-stackblitz-link" />
+     *   <slot name="theme-switch" />
+     *   <slot name="login-button" />
+     * ```
+     */
+    TopBar?: string;
+    /**
+     * Component for overriding confirmation dialogs.
+     *
+     * This component has to be a React component and be the default export of that module.
+     * It will receive same props that `@tutorialkit-rb/react/dialog` supports.
+     */
+    Dialog?: string;
+    /**
+     * Component for overriding title, links and metadata in the `<head>` tag.
+     *
+     * This component has slots that are used to pass TutorialKit's default tags:
+     *
+     * - `title`: The page title
+     * - `links`: Links for the favicon, fonts and other assets
+     * - `meta`:  Metadata and Open Graph tags
+     *
+     * ```jsx
+     * <slot name="title" />
+     * <slot name="links" />
+     * <slot name="meta" />
+     * ```
+     */
+    HeadTags?: string;
+}
+interface Options {
+    components?: OverrideComponentsOptions;
+    defaultRoutes: boolean;
+}
+export declare function overrideComponents({ components, defaultRoutes }: Options): VitePlugin;
+export {};

package/dist/vite-plugins/store.d.ts

@@ -0,0 +1,2 @@
+import type { VitePlugin } from '../types.js';
+export declare const tutorialkitStore: VitePlugin;

package/dist/webcontainer-files/cache.d.ts

@@ -0,0 +1,21 @@
+import type { AstroIntegrationLogger } from 'astro';
+import type { ViteDevServer } from '../types.js';
+import { FilesMapGraph } from './filesmap.js';
+import { type ContentDirs } from './utils.js';
+export declare class FilesMapCache {
+    private _filesMapGraph;
+    private _logger;
+    private _server;
+    private _dirs;
+    private _cache;
+    private _requestsQueue;
+    private _readiness;
+    private _resolve;
+    private _hotPaths;
+    private _timeoutId;
+    constructor(_filesMapGraph: FilesMapGraph, _logger: AstroIntegrationLogger, _server: ViteDevServer, _dirs: ContentDirs);
+    generateFileMapForPath(filePath: string): void;
+    canHandle(reqURL: string | undefined): Promise<string | false>;
+    private _invalidateCacheForDependencies;
+    private _generateFileMaps;
+}

package/dist/webcontainer-files/cache.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/webcontainer-files/constants.d.ts

@@ -0,0 +1,4 @@
+export declare const IGNORED_FILES: string[];
+export declare const EXTEND_CONFIG_FILEPATH = "/.tk-config.json";
+export declare const FILES_FOLDER_NAME = "_files";
+export declare const SOLUTION_FOLDER_NAME = "_solution";

package/dist/webcontainer-files/filesmap.d.ts

@@ -0,0 +1,38 @@
+import type { AstroIntegrationLogger } from 'astro';
+import type { Files } from '../types';
+export declare class FilesMapGraph {
+    private _nodes;
+    constructor(_nodes?: Map<string, FilesMap>);
+    getFilesMapByFolder(folder: string): FilesMap | undefined;
+    allFilesMap(): IterableIterator<FilesMap>;
+    updateFilesMapByFolder(folder: string, logger: AstroIntegrationLogger): void;
+}
+export declare class FilesMap {
+    readonly path: string;
+    /**
+     * Initialize the graph of nodes by connecting them to one another.
+     * The graph is expected to be acyclic but this function won't throw any
+     * exception if it isn't.
+     *
+     * Instead when a `FilesMap` is turned into a JSON file, a warning will be
+     * printed if a cycle is found.
+     *
+     * @param folders initial folders found after a lookup.
+     */
+    static initGraph(folders: string[], logger: AstroIntegrationLogger): Promise<FilesMapGraph>;
+    private _extend;
+    private _dependents;
+    /**
+     * Construct a new FileMap. To connect it to its graph, call
+     * `FileMap.initGraph` or `init(graph)`.
+     *
+     * @param path resolved path of this file map.
+     */
+    constructor(path: string);
+    update(graph: Map<string, FilesMap>, logger: AstroIntegrationLogger): void;
+    extend(other: FilesMap): void;
+    unlink(): void;
+    allDependents(): Generator<FilesMap>;
+    toFiles(logger: AstroIntegrationLogger): Promise<Files>;
+    private _toFilePathsCheckCycles;
+}

package/dist/webcontainer-files/filesmap.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/webcontainer-files/index.d.ts

@@ -0,0 +1,8 @@
+import type { AstroBuildDoneOptions, AstroServerSetupOptions } from '../types.js';
+export declare class WebContainerFiles {
+    private _watcher;
+    serverSetup(projectRoot: string, { server, logger }: AstroServerSetupOptions): Promise<void>;
+    serverDone(): Promise<void> | undefined;
+    buildAssets(projectRoot: string, { dir, logger }: AstroBuildDoneOptions): Promise<void>;
+    private _folders;
+}

package/dist/webcontainer-files/utils.d.ts

@@ -0,0 +1,6 @@
+export interface ContentDirs {
+    templatesDir: string;
+    contentDir: string;
+}
+export declare function getFilesRef(pathToFolder: string, { contentDir, templatesDir }: ContentDirs): string;
+export declare function getAllFilesMap({ contentDir, templatesDir }: ContentDirs): Promise<string[]>;

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "@tutorialkit-rb/astro",
+  "version": "1.5.2-rb.0.1.0",
+  "description": "TutorialKit integration for Astro (https://astro.build)",
+  "author": "StackBlitz Inc.",
+  "type": "module",
+  "bugs": "https://github.com/stackblitz/tutorialkit/issues",
+  "homepage": "https://github.com/stackblitz/tutorialkit",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Bakaface/tutorialkit.rb",
+    "directory": "packages/astro"
+  },
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./types": "./types.d.ts",
+    "./default-theme.css": "./dist/default/styles/variables.css",
+    "./default/pages/index.astro": "./dist/default/pages/index.astro",
+    "./default/pages/[...slug].astro": "./dist/default/pages/[...slug].astro",
+    "./default/components/TopBar.astro": "./dist/default/components/TopBar.astro",
+    "./default/components/HeadTags.astro": "./dist/default/components/HeadTags.astro",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "types.d.ts"
+  ],
+  "scripts": {
+    "build": "node ./scripts/build.js",
+    "dev": "node ./scripts/build.js --watch",
+    "test": "vitest"
+  },
+  "dependencies": {
+    "@astrojs/mdx": "^3.1.1",
+    "@astrojs/react": "^3.6.0",
+    "@expressive-code/plugin-collapsible-sections": "^0.35.3",
+    "@expressive-code/plugin-line-numbers": "^0.35.3",
+    "@nanostores/react": "0.7.2",
+    "@stackblitz/sdk": "^1.11.0",
+    "@tutorialkit-rb/react": "1.5.2",
+    "@tutorialkit-rb/runtime": "1.5.2",
+    "@tutorialkit-rb/theme": "1.5.2",
+    "@tutorialkit-rb/types": "1.5.2",
+    "@types/react": "^18.3.3",
+    "@unocss/reset": "^0.62.2",
+    "@webcontainer/api": "1.5.1",
+    "astro": "^4.15.0",
+    "astro-expressive-code": "^0.35.3",
+    "chokidar": "3.6.0",
+    "fast-glob": "^3.3.2",
+    "front-matter": "^4.0.2",
+    "hastscript": "^9.0.0",
+    "kleur": "4.1.5",
+    "mdast-util-directive": "^3.0.0",
+    "mdast-util-to-markdown": "^2.1.0",
+    "nanostores": "^0.10.3",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "remark-directive": "^3.0.0",
+    "unified": "^11.0.5",
+    "unist-util-visit": "^5.0.0",
+    "unocss": "^0.59.4",
+    "zod": "3.23.8"
+  },
+  "devDependencies": {
+    "@tutorialkit-rb/types": "1.5.2",
+    "@types/mdast": "^4.0.4",
+    "esbuild": "^0.20.2",
+    "esbuild-node-externals": "^1.13.1",
+    "execa": "^9.2.0",
+    "typescript": "^5.4.5",
+    "vite-plugin-inspect": "0.8.4",
+    "vitest": "^3.0.5"
+  },
+  "peerDependencies": {
+    "astro": "^4.15.0"
+  },
+  "keywords": [
+    "ruby",
+    "rails",
+    "wasm"
+  ]
+}

package/types.d.ts

@@ -0,0 +1,12 @@
+/* eslint-disable @blitz/lines-around-comment */
+
+declare module 'tutorialkit:store' {
+  const tutorialStore: import('@tutorialkit-rb/runtime').TutorialStore;
+
+  export default tutorialStore;
+}
+
+declare module 'tutorialkit:core' {
+  /** Promise that resolves to the webcontainer that's running in the current lesson. */
+  export const webcontainer: Promise<import('@webcontainer/api').WebContainer>;
+}